public class

RangedValueLayoutHelper

extends LayoutHelper

 java.lang.Object

androidx.wear.watchface.complications.rendering.utils.LayoutHelper

↳androidx.wear.watchface.complications.rendering.utils.RangedValueLayoutHelper

Gradle dependencies

compile group: 'androidx.wear.watchface', name: 'watchface-complications-rendering', version: '1.1.0-rc01'

  • groupId: androidx.wear.watchface
  • artifactId: watchface-complications-rendering
  • version: 1.1.0-rc01

Artifact androidx.wear.watchface:watchface-complications-rendering:1.1.0-rc01 it located at Google repository (https://maven.google.com/)

Overview

Layout helper for TYPE_RANGED_VALUE.

Summary

Constructors
publicRangedValueLayoutHelper()

Methods
public voidgetIconBounds(Rect outRect)

public voidgetRangedValueBounds(Rect outRect)

public Layout.AlignmentgetShortTextAlignment()

public voidgetShortTextBounds(Rect outRect)

public intgetShortTextGravity()

public Layout.AlignmentgetShortTitleAlignment()

public voidgetShortTitleBounds(Rect outRect)

public intgetShortTitleGravity()

public voidsetComplicationData(android.support.wearable.complications.ComplicationData data)

public voidsetHeight(int height)

public voidsetWidth(int width)

from LayoutHelpergetBounds, getComplicationData, getLargeImageBounds, getLongTextAlignment, getLongTextBounds, getLongTextGravity, getLongTitleAlignment, getLongTitleBounds, getLongTitleGravity, getSmallImageBounds, hasIcon, hasLongTitle, hasShortText, hasShortTitle, hasSmallImage, update
from java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors

public RangedValueLayoutHelper()

Methods

public void setWidth(int width)

Parameters:

width: The width to apply to the layout's bounds

public void setHeight(int height)

Parameters:

height: The height to apply to the layout's bounds

public void setComplicationData(android.support.wearable.complications.ComplicationData data)

Parameters:

data: The android.support.wearable.complications.ComplicationData to associate with this LayoutHelper

public void getRangedValueBounds(Rect outRect)

Parameters:

outRect: that receives the computed bounds for the ranged value

public void getIconBounds(Rect outRect)

Parameters:

outRect: that receives the computed bounds for the icon

public Layout.Alignment getShortTextAlignment()

Returns:

The to use with short text

public int getShortTextGravity()

Returns:

Gravity to use with short text

public void getShortTextBounds(Rect outRect)

Parameters:

outRect: that receives the computed bounds for the short title text

public Layout.Alignment getShortTitleAlignment()

Returns:

The to use with short title text

public int getShortTitleGravity()

Returns:

Gravity to use with short title text

public void getShortTitleBounds(Rect outRect)

Parameters:

outRect: that receives the computed bounds for the short title text

Source

/*
 * Copyright 2020 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package androidx.wear.watchface.complications.rendering.utils;

import static androidx.wear.watchface.complications.rendering.utils.LayoutUtils.getBottomHalf;
import static androidx.wear.watchface.complications.rendering.utils.LayoutUtils.getCentralSquare;
import static androidx.wear.watchface.complications.rendering.utils.LayoutUtils.getLeftPart;
import static androidx.wear.watchface.complications.rendering.utils.LayoutUtils.getRightPart;
import static androidx.wear.watchface.complications.rendering.utils.LayoutUtils.getTopHalf;
import static androidx.wear.watchface.complications.rendering.utils.LayoutUtils.isWideRectangle;
import static androidx.wear.watchface.complications.rendering.utils.LayoutUtils.scaledAroundCenter;

import android.graphics.Rect;
import android.support.wearable.complications.ComplicationData;
import android.text.Layout;
import android.view.Gravity;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.annotation.RestrictTo;

/**
 * Layout helper for {@link ComplicationData#TYPE_RANGED_VALUE}.
 *
 * @hide
 */
@RestrictTo(RestrictTo.Scope.LIBRARY)
public class RangedValueLayoutHelper extends LayoutHelper {

    /** As ranged value indicator is circle, this is used to calculate the inner square of it. */
    private static final float INNER_SQUARE_SIZE_FRACTION = (float) (1.0f / Math.sqrt(2.0f));

    /** Padding applied to inner square of the ranged value indicator. */
    private static final float INNER_SQUARE_PADDING_FRACTION = 0.15f;

    /** Padding applied to icon inside the ranged value indicator. */
    private static final float ICON_PADDING_FRACTION = 0.15f;

    /** Used to apply padding to ranged value indicator. */
    private static final float RANGED_VALUE_SIZE_FRACTION = 0.95f;

    /** Used to draw a short text complication inside ranged value for non-wide rectangles. */
    private final ShortTextLayoutHelper mShortTextLayoutHelper = new ShortTextLayoutHelper();

    /** Used to avoid calculating inner square of the ranged value every time it's needed. */
    private final Rect mRangedValueInnerSquare = new Rect();

    /** Used to avoid allocating a Rect object whenever needed. */
    private final Rect mBounds = new Rect();

    private void updateShortTextLayoutHelper() {
        if (getComplicationData() != null) {
            getRangedValueBounds(mRangedValueInnerSquare);
            scaledAroundCenter(
                    mRangedValueInnerSquare,
                    mRangedValueInnerSquare,
                    (1 - INNER_SQUARE_PADDING_FRACTION * 2) * INNER_SQUARE_SIZE_FRACTION);
            mShortTextLayoutHelper.update(
                    mRangedValueInnerSquare.width(),
                    mRangedValueInnerSquare.height(),
                    getComplicationData());
        }
    }

    @Override
    public void setWidth(int width) {
        super.setWidth(width);
        updateShortTextLayoutHelper();
    }

    @Override
    public void setHeight(int height) {
        super.setHeight(height);
        updateShortTextLayoutHelper();
    }

    @Override
    public void setComplicationData(@Nullable ComplicationData data) {
        super.setComplicationData(data);
        updateShortTextLayoutHelper();
    }

    @Override
    public void getRangedValueBounds(@NonNull Rect outRect) {
        getBounds(outRect);
        if (!hasShortText() || !isWideRectangle(outRect)) {
            getCentralSquare(outRect, outRect);
            scaledAroundCenter(outRect, outRect, RANGED_VALUE_SIZE_FRACTION);
        } else {
            getLeftPart(outRect, outRect);
            scaledAroundCenter(outRect, outRect, RANGED_VALUE_SIZE_FRACTION);
        }
    }

    @Override
    public void getIconBounds(@NonNull Rect outRect) {
        if (!hasIcon()) {
            outRect.setEmpty();
        } else {
            getBounds(outRect);
            if (!hasShortText() || isWideRectangle(outRect)) {
                // Show only an icon inside ranged value indicator
                scaledAroundCenter(outRect, mRangedValueInnerSquare, 1 - ICON_PADDING_FRACTION * 2);
            } else {
                // Draw a short text complication inside ranged value bounds
                mShortTextLayoutHelper.getIconBounds(outRect);
                outRect.offset(mRangedValueInnerSquare.left, mRangedValueInnerSquare.top);
            }
        }
    }

    @NonNull
    @Override
    public Layout.Alignment getShortTextAlignment() {
        getBounds(mBounds);
        if (isWideRectangle(mBounds)) {
            return Layout.Alignment.ALIGN_NORMAL;
        } else {
            // Draw a short text complication inside ranged value bounds
            return mShortTextLayoutHelper.getShortTextAlignment();
        }
    }

    @Override
    public int getShortTextGravity() {
        getBounds(mBounds);
        if (isWideRectangle(mBounds)) {
            if (hasShortTitle()) {
                return Gravity.BOTTOM;
            } else {
                return Gravity.CENTER_VERTICAL;
            }
        } else {
            // Draw as a square short text complication inside ranged value bounds
            return mShortTextLayoutHelper.getShortTextGravity();
        }
    }

    @Override
    public void getShortTextBounds(@NonNull Rect outRect) {
        if (!hasShortText()) {
            outRect.setEmpty();
        } else {
            getBounds(outRect);
            if (isWideRectangle(outRect)) {
                if (!hasShortTitle() || hasIcon()) {
                    getRightPart(outRect, outRect);
                } else {
                    getRightPart(outRect, outRect);
                    getTopHalf(outRect, outRect);
                }
            } else {
                // Draw a short text complication inside ranged value bounds
                mShortTextLayoutHelper.getShortTextBounds(outRect);
                outRect.offset(mRangedValueInnerSquare.left, mRangedValueInnerSquare.top);
            }
        }
    }

    @NonNull
    @Override
    public Layout.Alignment getShortTitleAlignment() {
        return getShortTextAlignment();
    }

    @Override
    public int getShortTitleGravity() {
        return Gravity.TOP;
    }

    @Override
    public void getShortTitleBounds(@NonNull Rect outRect) {
        // As title is meaningless without text, return empty rectangle in that case too.
        if (!hasShortTitle() || !hasShortText()) {
            outRect.setEmpty();
        } else {
            getBounds(outRect);
            if (isWideRectangle(outRect)) {
                getRightPart(outRect, outRect);
                getBottomHalf(outRect, outRect);
            } else {
                // Draw a short text complication inside ranged value bounds
                mShortTextLayoutHelper.getShortTitleBounds(outRect);
                outRect.offset(mRangedValueInnerSquare.left, mRangedValueInnerSquare.top);
            }
        }
    }
}