java.lang.Object
↳View
↳androidx.wear.tiles.renderer.WearCurvedTextView
Gradle dependencies
compile group: 'androidx.wear', name: 'wear-tiles-renderer', version: '1.0.0-alpha01'
- groupId: androidx.wear
- artifactId: wear-tiles-renderer
- version: 1.0.0-alpha01
Artifact androidx.wear:wear-tiles-renderer:1.0.0-alpha01 it located at Google repository (https://maven.google.com/)
Overview
A WearCurvedTextView is a component allowing developers to easily write curved text following the
curvature of the largest circle that can be inscribed in the view. WearArcLayout could be used to
concatenate multiple curved texts, also layout together with other widgets such as icons.
Summary
Methods |
---|
public void | checkInvalidAttributeAsChild()
|
public void | draw(Canvas canvas)
|
public float | getAnchorAngleDegrees()
Returns the anchor angle used for positioning the text, in degrees. |
public int | getAnchorType()
returns the anchor type for positioning the curved text |
public boolean | getClockwise()
returns the curved text layout direction |
public TextUtils.TruncateAt | getEllipsize()
Returns where, if anywhere, words that are longer than the view is wide should be ellipsized. |
public java.lang.String | getFontFeatureSettings()
Returns the font feature settings. |
public java.lang.String | getFontVariationSettings()
Returns TrueType or OpenType font variation settings. |
public float | getLetterSpacing()
Gets the text letter-space value, which determines the spacing between characters. |
public float | getMaxSweepDegrees()
returns the maximum sweep angle in degrees for rendering the text |
public float | getMinSweepDegrees()
returns the sweep angle in degrees for rendering the text |
public int | getPaintFlags()
Gets the flags on the Paint being used to display the text. |
public float | getSweepAngleDegrees()
|
public java.lang.String | getText()
returns the text to be rendered |
public int | getTextColor()
returns the color for rendering the text |
public float | getTextSize()
returns the text size for rendering the text |
public int | getThicknessPx()
|
public Typeface | getTypeface()
Gets the current Typeface that is used to style the text. |
public boolean | insideClickArea(float x, float y)
|
protected void | onDraw(Canvas canvas)
|
protected void | onLayout(boolean changed, int l, int t, int r, int b)
|
protected void | onSizeChanged(int w, int h, int oldw, int oldh)
|
public boolean | onTouchEvent(MotionEvent event)
|
public void | setAnchorAngleDegrees(float value)
Sets the anchor angle used for positioning the text, in degrees. |
public void | setAnchorType(int value)
Sets the anchor type for positioning the curved text. |
public void | setClockwise(boolean value)
sets the curved text layout direction |
public void | setEllipsize(TextUtils.TruncateAt value)
Causes words in the text that are longer than the view's width to be ellipsized. |
public void | setFontFeatureSettings(java.lang.String value)
Sets font feature settings. |
public void | setFontVariationSettings(java.lang.String value)
Sets TrueType or OpenType font variation settings. |
public void | setLetterSpacing(float value)
Sets text letter-spacing in ems. |
public void | setMaxSweepDegrees(float value)
sets the maximum sweep angle in degrees for rendering the text |
public void | setMinSweepDegrees(float value)
sets the sweep angle in degrees for rendering the text |
public void | setPaintFlags(int flags)
Sets flags on the Paint being used to display the text and reflows the text if they are
different from the old flags. |
public void | setText(java.lang.String value)
sets the text to be rendered |
public void | setTextColor(int value)
sets the color for rendering the text |
public void | setTextSize(float value)
sets the text size for rendering the text |
public void | setTypeface(Typeface value)
Sets the typeface and style in which the text should be displayed. |
public void | setTypeface(Typeface tf, int style)
Sets the typeface and style in which the text should be displayed, and turns on the fake bold
and italic bits in the Paint if the Typeface that you provided does not have all the bits in
the style that you specified. |
from java.lang.Object | clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructors
public
WearCurvedTextView(Context context)
public
WearCurvedTextView(Context context, AttributeSet attrs)
public
WearCurvedTextView(Context context, AttributeSet attrs, int defStyle)
public
WearCurvedTextView(Context context, AttributeSet attrs, int defStyle, int defStyleRes)
Methods
public float
getSweepAngleDegrees()
public int
getThicknessPx()
public void
checkInvalidAttributeAsChild()
public boolean
insideClickArea(float x, float y)
protected void
onSizeChanged(int w, int h, int oldw, int oldh)
protected void
onLayout(boolean changed, int l, int t, int r, int b)
public boolean
onTouchEvent(MotionEvent event)
public void
draw(Canvas canvas)
protected void
onDraw(Canvas canvas)
public int
getAnchorType()
returns the anchor type for positioning the curved text
public void
setAnchorType(int value)
Sets the anchor type for positioning the curved text.
Parameters:
value: the anchor type, one of {ANCHOR_START, ANCHOR_CENTER, ANCHOR_END}
public float
getAnchorAngleDegrees()
Returns the anchor angle used for positioning the text, in degrees.
public void
setAnchorAngleDegrees(float value)
Sets the anchor angle used for positioning the text, in degrees.
public float
getMaxSweepDegrees()
returns the maximum sweep angle in degrees for rendering the text
public void
setMaxSweepDegrees(float value)
sets the maximum sweep angle in degrees for rendering the text
public float
getMinSweepDegrees()
returns the sweep angle in degrees for rendering the text
public void
setMinSweepDegrees(float value)
sets the sweep angle in degrees for rendering the text
public java.lang.String
getText()
returns the text to be rendered
public void
setText(java.lang.String value)
sets the text to be rendered
public float
getTextSize()
returns the text size for rendering the text
public void
setTextSize(float value)
sets the text size for rendering the text
public Typeface
getTypeface()
Gets the current Typeface that is used to style the text.
public void
setTypeface(Typeface value)
Sets the typeface and style in which the text should be displayed. Note that not all Typeface
families actually have bold and italic variants
public void
setTypeface(Typeface tf, int style)
Sets the typeface and style in which the text should be displayed, and turns on the fake bold
and italic bits in the Paint if the Typeface that you provided does not have all the bits in
the style that you specified.
public boolean
getClockwise()
returns the curved text layout direction
public void
setClockwise(boolean value)
sets the curved text layout direction
public int
getTextColor()
returns the color for rendering the text
public void
setTextColor(int value)
sets the color for rendering the text
public TextUtils.TruncateAt
getEllipsize()
Returns where, if anywhere, words that are longer than the view is wide should be ellipsized.
public void
setEllipsize(TextUtils.TruncateAt value)
Causes words in the text that are longer than the view's width to be ellipsized. Use null to
turn off ellipsizing.
public float
getLetterSpacing()
Gets the text letter-space value, which determines the spacing between characters. The value
returned is in ems. Normally, this value is 0.0.
Returns:
The text letter-space value in ems.
public void
setLetterSpacing(float value)
Sets text letter-spacing in ems. Typical values for slight expansion will be around 0.05.
Negative values tighten text.
Parameters:
value: A text letter-space value in ems.
public java.lang.String
getFontFeatureSettings()
Returns the font feature settings. The format is the same as the CSS font-feature-settings
attribute: https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop
Returns:
the currently set font feature settings. Default is null.
public void
setFontFeatureSettings(java.lang.String value)
Sets font feature settings. The format is the same as the CSS font-feature-settings
attribute: https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop
Parameters:
value: font feature settings represented as CSS compatible string. This value may be
null.
public java.lang.String
getFontVariationSettings()
Returns TrueType or OpenType font variation settings.
public void
setFontVariationSettings(java.lang.String value)
Sets TrueType or OpenType font variation settings.
Parameters:
value: font variation settings. You can pass null or empty string as no variation
settings. This value may be null
public int
getPaintFlags()
Gets the flags on the Paint being used to display the text.
Returns:
The flags on the Paint being used to display the text.
See also: Paint
public void
setPaintFlags(int flags)
Sets flags on the Paint being used to display the text and reflows the text if they are
different from the old flags.
See also: Paint
Source
/*
* Copyright 2021 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.tiles.renderer;
import static java.lang.Math.cos;
import static java.lang.Math.max;
import static java.lang.Math.min;
import static java.lang.Math.round;
import static java.lang.Math.sin;
import android.annotation.SuppressLint;
import android.content.Context;
import android.content.res.ColorStateList;
import android.content.res.Resources;
import android.content.res.TypedArray;
import android.graphics.Canvas;
import android.graphics.Color;
import android.graphics.Paint;
import android.graphics.Path;
import android.graphics.Rect;
import android.graphics.Typeface;
import android.os.Build;
import android.text.StaticLayout;
import android.text.TextPaint;
import android.text.TextUtils;
import android.util.AttributeSet;
import android.view.MotionEvent;
import android.view.View;
import androidx.annotation.ColorInt;
import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.annotation.RequiresApi;
import androidx.annotation.RestrictTo;
/**
* A WearCurvedTextView is a component allowing developers to easily write curved text following the
* curvature of the largest circle that can be inscribed in the view. WearArcLayout could be used to
* concatenate multiple curved texts, also layout together with other widgets such as icons.
*
* @hide
*/
@RestrictTo(RestrictTo.Scope.LIBRARY)
// TODO(b/174649543): Replace this with the actual androidx.wear.widget.WearCurvedTextView when
// we've reconciled the two.
public final class WearCurvedTextView extends View implements WearArcLayout.ArcLayoutWidget {
private static final float UNSET_ANCHOR_DEGREE = -1f;
private static final int UNSET_ANCHOR_TYPE = -1;
private static final float MIN_SWEEP_DEGREE = 0f;
private static final float MAX_SWEEP_DEGREE = 359.9f;
private static final float DEFAULT_TEXT_SIZE = 24f;
@ColorInt private static final int DEFAULT_TEXT_COLOR = Color.WHITE;
private static final int DEFAULT_TEXT_STYLE = Typeface.NORMAL;
private static final boolean DEFAULT_CLOCKWISE = true;
private static final int FONT_WEIGHT_MAX = 1000;
private static final float ITALIC_SKEW_X = -0.25f;
// make 0 degree at 12 o'clock, since canvas assumes 0 degree is 3 o'clock
private static final float ANCHOR_DEGREE_OFFSET = -90f;
private final Path mPath = new Path();
private final Path mBgPath = new Path();
private final TextPaint mPaint = new TextPaint();
private final Rect mBounds = new Rect();
private final Rect mBgBounds = new Rect();
private boolean mDirty = true;
private String mTextToDraw = "";
private float mPathRadius = 0f;
private float mTextSweepDegrees = 0f;
private float mBackgroundSweepDegrees = MAX_SWEEP_DEGREE;
private int mLastUsedTextAlignment = -1;
private float mLocalRotateAngle = 0f;
private int mAnchorType = UNSET_ANCHOR_TYPE;
private float mAnchorAngleDegrees = UNSET_ANCHOR_DEGREE;
private float mMinSweepDegrees = MIN_SWEEP_DEGREE;
private float mMaxSweepDegrees = MAX_SWEEP_DEGREE;
private String mText = "";
private float mTextSize = DEFAULT_TEXT_SIZE;
@Nullable private Typeface mTypeface = null;
private boolean mClockwise = DEFAULT_CLOCKWISE;
@ColorInt private int mTextColor = DEFAULT_TEXT_COLOR;
@Nullable private TextUtils.TruncateAt mEllipsize = null;
private float mLetterSpacing = 0f;
@Nullable private String mFontFeatureSettings = null;
@Nullable private String mFontVariationSettings = null;
// If true, it means we got the touch_down event and are receiving the touch events that follow.
private boolean mHandlingTouch = false;
public WearCurvedTextView(@NonNull Context context) {
this(context, null);
}
public WearCurvedTextView(@NonNull Context context, @Nullable AttributeSet attrs) {
this(context, attrs, android.R.attr.textViewStyle);
}
public WearCurvedTextView(
@NonNull Context context, @Nullable AttributeSet attrs, int defStyle) {
this(context, attrs, defStyle, 0);
}
public WearCurvedTextView(
@NonNull Context context, @Nullable AttributeSet attrs, int defStyle, int defStyleRes) {
super(context, attrs, defStyle, defStyleRes);
mPaint.setAntiAlias(true);
TextAppearanceAttributes attributes = new TextAppearanceAttributes();
attributes.mTextColor = ColorStateList.valueOf(DEFAULT_TEXT_COLOR);
final Resources.Theme theme = context.getTheme();
TypedArray a =
theme.obtainStyledAttributes(
attrs, R.styleable.TextViewAppearance, defStyle, defStyleRes);
TypedArray appearance = null;
int ap = a.getResourceId(R.styleable.TextViewAppearance_android_textAppearance, -1);
a.recycle();
if (ap != -1) {
appearance = theme.obtainStyledAttributes(ap, R.styleable.TextAppearance);
}
if (appearance != null) {
readTextAppearance(appearance, attributes, true);
appearance.recycle();
}
a =
context.obtainStyledAttributes(
attrs, R.styleable.WearCurvedTextView, defStyle, defStyleRes);
// overrride the value in the appearance with explicitly specified attribute values
readTextAppearance(a, attributes, false);
// read the other supported TextView attributes
if (a.hasValue(R.styleable.WearCurvedTextView_android_text)) {
mText = a.getString(R.styleable.WearCurvedTextView_android_text);
}
int textEllipsize = a.getInt(R.styleable.WearCurvedTextView_android_ellipsize, 0);
switch (textEllipsize) {
case 1:
mEllipsize = TextUtils.TruncateAt.START;
break;
case 2:
mEllipsize = TextUtils.TruncateAt.MIDDLE;
break;
case 3:
mEllipsize = TextUtils.TruncateAt.END;
break;
default:
mEllipsize = null;
}
// read the custom WearCurvedTextView attributes
mMaxSweepDegrees =
a.getFloat(R.styleable.WearCurvedTextView_maxSweepDegrees, MAX_SWEEP_DEGREE);
mMaxSweepDegrees = min(mMaxSweepDegrees, MAX_SWEEP_DEGREE);
mMinSweepDegrees =
a.getFloat(R.styleable.WearCurvedTextView_minSweepDegrees, MIN_SWEEP_DEGREE);
if (mMinSweepDegrees > mMaxSweepDegrees) {
throw new IllegalArgumentException(
"MinSweepDegrees cannot be bigger than MaxSweepDegrees");
}
mAnchorType = a.getInt(R.styleable.WearCurvedTextView_anchorPosition, UNSET_ANCHOR_TYPE);
mAnchorAngleDegrees =
a.getFloat(R.styleable.WearCurvedTextView_anchorAngleDegrees, UNSET_ANCHOR_DEGREE);
mAnchorAngleDegrees = mAnchorAngleDegrees % 360f;
mClockwise = a.getBoolean(R.styleable.WearCurvedTextView_clockwise, DEFAULT_CLOCKWISE);
a.recycle();
applyTextAppearance(attributes);
mPaint.setTextSize(mTextSize);
}
@Override
public float getSweepAngleDegrees() {
return mBackgroundSweepDegrees;
}
@Override
public int getThicknessPx() {
return round(mPaint.getFontMetrics().descent - mPaint.getFontMetrics().ascent);
}
/**
* @throws IllegalArgumentException if the anchorType and/or anchorAngleDegrees attributes were
* set for a widget in WearArcLayout
*/
@Override
public void checkInvalidAttributeAsChild() {
if (mAnchorType != UNSET_ANCHOR_TYPE) {
throw new IllegalArgumentException(
"WearCurvedTextView shall not set anchorType value when added into"
+ "WearArcLayout");
}
if (mAnchorAngleDegrees != UNSET_ANCHOR_DEGREE) {
throw new IllegalArgumentException(
"WearCurvedTextView shall not set anchorAngleDegrees value when added into "
+ "WearArcLayout");
}
}
@Override
public boolean insideClickArea(float x, float y) {
float radius2 =
min(getWidth(), getHeight()) / 2f
- (mClockwise ? getPaddingTop() : getPaddingBottom());
float radius1 = radius2 - mPaint.getFontMetrics().descent + mPaint.getFontMetrics().ascent;
float dx = x - getWidth() / 2;
float dy = y - getHeight() / 2;
float r2 = dx * dx + dy * dy;
if (r2 < radius1 * radius1 || r2 > radius2 * radius2) {
return false;
}
// Since we are symmetrical on the Y-axis, we can constrain the angle to the x>=0 quadrants.
float angle = (float) Math.toDegrees(Math.atan2(Math.abs(dx), -dy));
return angle < mBackgroundSweepDegrees / 2;
}
@Override
protected void onSizeChanged(int w, int h, int oldw, int oldh) {
super.onSizeChanged(w, h, oldw, oldh);
doUpdate();
}
@Override
protected void onLayout(boolean changed, int l, int t, int r, int b) {
super.onLayout(changed, l, t, r, b);
mPaint.getTextBounds(mText, 0, mText.length(), mBounds);
// Note that ascent is negative.
mPathRadius =
min(getWidth(), getHeight()) / 2f
+ (mClockwise
? mPaint.getFontMetrics().ascent - getPaddingTop()
: -mPaint.getFontMetrics().descent - getPaddingBottom());
mTextSweepDegrees =
min(getWidthSelf() / mPathRadius / (float) Math.PI * 180f, MAX_SWEEP_DEGREE);
mBackgroundSweepDegrees = max(min(mMaxSweepDegrees, mTextSweepDegrees), mMinSweepDegrees);
}
private float getWidthSelf() {
return (float) mBounds.width() + getPaddingLeft() + getPaddingRight();
}
private String ellipsize(int ellipsizedWidth) {
StaticLayout.Builder layoutBuilder =
StaticLayout.Builder.obtain(mText, 0, mText.length(), mPaint, ellipsizedWidth);
layoutBuilder.setEllipsize(mEllipsize);
layoutBuilder.setMaxLines(1);
StaticLayout layout = layoutBuilder.build();
// Cut text that it's too big even if no ellipsize mode is provided.
if (mEllipsize == null) {
return mText.substring(0, layout.getLineEnd(0));
}
int ellipsisCount = layout.getEllipsisCount(0);
if (ellipsisCount == 0) {
return mText;
}
int ellipsisStart = layout.getEllipsisStart(0);
char[] textToDrawArray = mText.toCharArray();
textToDrawArray[ellipsisStart] = '\u2026'; // ellipsis "..."
for (int i = ellipsisStart + 1; i < ellipsisStart + ellipsisCount; i++) {
if (i >= 0 && i < mText.length()) {
textToDrawArray[i] = '\uFEFF'; // 0-width space
}
}
return new String(textToDrawArray);
}
private void updatePathsIfNeeded(boolean withBackground) {
// The dirty flag is not set when properties we inherit from View are modified
if (!mDirty && ((int) getTextAlignment() == mLastUsedTextAlignment)) {
return;
}
mDirty = false;
mLastUsedTextAlignment = (int) getTextAlignment();
if (mTextSweepDegrees <= mMaxSweepDegrees) {
mTextToDraw = mText;
} else {
mTextToDraw =
ellipsize(
(int) (Math.toRadians(mMaxSweepDegrees) * mPathRadius)
- getPaddingLeft()
- getPaddingRight());
mTextSweepDegrees = mMaxSweepDegrees;
}
float clockwiseFactor = mClockwise ? 1f : -1f;
float alignmentFactor = 0.5f;
switch (getTextAlignment()) {
case TEXT_ALIGNMENT_TEXT_START:
case TEXT_ALIGNMENT_VIEW_START:
alignmentFactor = 0f;
break;
case TEXT_ALIGNMENT_TEXT_END:
case TEXT_ALIGNMENT_VIEW_END:
alignmentFactor = 1f;
break;
default:
alignmentFactor = 0.5f; // TEXT_ALIGNMENT_CENTER
}
float anchorTypeFactor;
switch (mAnchorType) {
case WearArcLayout.ANCHOR_START:
anchorTypeFactor = 0.5f;
break;
case WearArcLayout.ANCHOR_END:
anchorTypeFactor = -0.5f;
break;
case WearArcLayout.ANCHOR_CENTER: // Center is the default.
default:
anchorTypeFactor = 0f;
}
mLocalRotateAngle =
(mAnchorAngleDegrees == UNSET_ANCHOR_DEGREE ? 0f : mAnchorAngleDegrees)
+ clockwiseFactor * anchorTypeFactor * mBackgroundSweepDegrees;
// Always draw the curved text on top center, then rotate the canvas to the right position
float backgroundStartAngle =
-clockwiseFactor * 0.5f * mBackgroundSweepDegrees + ANCHOR_DEGREE_OFFSET;
float textStartAngle =
backgroundStartAngle
+ clockwiseFactor
* (float)
(alignmentFactor
* (mBackgroundSweepDegrees
- mTextSweepDegrees)
+ Math.toDegrees(getPaddingLeft() / mPathRadius));
float centerX = getWidth() / 2f;
float centerY = getHeight() / 2f;
mPath.reset();
mPath.addArc(
centerX - mPathRadius,
centerY - mPathRadius,
centerX + mPathRadius,
centerY + mPathRadius,
textStartAngle,
clockwiseFactor * mTextSweepDegrees);
if (withBackground) {
mBgPath.reset();
// NOTE: Ensure that if the code to compute these radius* change, containsPoint() is
// also updated.
float radius1 = mPathRadius - clockwiseFactor * mPaint.getFontMetrics().descent;
float radius2 = mPathRadius - clockwiseFactor * mPaint.getFontMetrics().ascent;
mBgPath.arcTo(
centerX - radius2,
centerY - radius2,
centerX + radius2,
centerY + radius2,
backgroundStartAngle,
clockwiseFactor * mBackgroundSweepDegrees,
false);
mBgPath.arcTo(
centerX - radius1,
centerY - radius1,
centerX + radius1,
centerY + radius1,
backgroundStartAngle + clockwiseFactor * mBackgroundSweepDegrees,
-clockwiseFactor * mBackgroundSweepDegrees,
false);
mBgPath.close();
float angle = backgroundStartAngle;
float x0 = (float) (centerX + radius2 * cos(Math.toRadians(angle)));
float x1 = (float) (centerX + radius1 * cos(Math.toRadians(angle)));
float y0 = (float) (centerX + radius2 * sin(Math.toRadians(angle)));
float y1 = (float) (centerX + radius1 * sin(Math.toRadians(angle)));
angle = backgroundStartAngle + clockwiseFactor * mBackgroundSweepDegrees;
float x2 = (float) (centerX + radius2 * cos(Math.toRadians(angle)));
float x3 = (float) (centerX + radius1 * cos(Math.toRadians(angle)));
// Background axis-aligned bounding box calculation. Note that, we always center the
// text on the top-center of the view.
// top: always will be centerY - outerRadius
// bottom: the max y of end points of the outer and inner arc contains the text
// left: if over -90 degrees, centerX - outerRadius, otherwise the min x of start,
// end points of the outer and inner arc contains the text
// right: if over 90 degrees, centerX + outerRadius, otherwise the max x of start,
// end points of the outer and inner arc contains the text
float outerRadius = max(radius1, radius2);
mBgBounds.top = (int) (centerY - outerRadius);
mBgBounds.bottom = (int) max(y0, y1);
mBgBounds.left =
mBackgroundSweepDegrees >= 180.0f
? (int) (centerX - outerRadius)
: (int) min(x0, min(x1, min(x2, x3)));
mBgBounds.right =
mBackgroundSweepDegrees >= 180.0f
? (int) (centerX + outerRadius)
: (int) max(x0, max(x1, max(x2, x3)));
}
}
@Override
// We only filter events and defer to super.onTouchEvent()
@SuppressLint("ClickableViewAccessibility")
public boolean onTouchEvent(@NonNull MotionEvent event) {
if (!mHandlingTouch && event.getAction() != MotionEvent.ACTION_DOWN) {
return false;
}
float x0 = event.getX() - getWidth() / 2;
float y0 = event.getY() - getHeight() / 2;
double rotAngle = -Math.toRadians(mLocalRotateAngle);
float tempX = (float) ((x0 * cos(rotAngle) - y0 * sin(rotAngle)) + getWidth() / 2);
y0 = (float) ((x0 * sin(rotAngle) + y0 * cos(rotAngle)) + getHeight() / 2);
x0 = tempX;
// Should we start handling the touch events?
if (!mHandlingTouch && insideClickArea(x0, y0)) {
mHandlingTouch = true;
}
// We just started or are in the middle of handling events, forward to View to handle.
if (mHandlingTouch) {
if (event.getAction() == MotionEvent.ACTION_UP
|| event.getAction() == MotionEvent.ACTION_CANCEL) {
// We should end handling events now
mHandlingTouch = false;
}
event.offsetLocation(x0 - event.getX(), y0 - event.getY());
return super.onTouchEvent(event);
}
return false;
}
@Override
public void draw(@NonNull Canvas canvas) {
canvas.save();
boolean withBackground = getBackground() != null;
updatePathsIfNeeded(withBackground);
canvas.rotate(mLocalRotateAngle, getWidth() / 2f, getHeight() / 2f);
if (withBackground) {
canvas.clipPath(mBgPath);
getBackground().setBounds(mBgBounds);
}
super.draw(canvas);
canvas.restore();
}
@Override
protected void onDraw(@NonNull Canvas canvas) {
mPaint.setColor(mTextColor);
mPaint.setStyle(Paint.Style.FILL);
canvas.drawTextOnPath(mTextToDraw, mPath, 0f, 0f, mPaint);
}
/**
* Sets the Typeface taking into account the given attributes.
*
* @param familyName family name string, e.g. "serif"
* @param typefaceIndex an index of the typeface enum, e.g. SANS, SERIF.
* @param style a typeface style
* @param weight a weight value for the Typeface or -1 if not specified.
*/
private void setTypefaceFromAttrs(
@Nullable String familyName, int typefaceIndex, int style, int weight) {
// typeface is ignored when font family is set
if (mTypeface == null && familyName != null) {
// Lookup normal Typeface from system font map.
Typeface normalTypeface = Typeface.create(familyName, Typeface.NORMAL);
resolveStyleAndSetTypeface(normalTypeface, style, weight);
} else if (mTypeface != null) {
resolveStyleAndSetTypeface(mTypeface, style, weight);
} else { // both typeface and familyName is null.
switch (typefaceIndex) {
case 1:
resolveStyleAndSetTypeface(Typeface.SANS_SERIF, style, weight);
break;
case 2:
resolveStyleAndSetTypeface(Typeface.SERIF, style, weight);
break;
case 3:
resolveStyleAndSetTypeface(Typeface.MONOSPACE, style, weight);
break;
default:
resolveStyleAndSetTypeface(null, style, weight);
}
}
}
private void resolveStyleAndSetTypeface(@Nullable Typeface tf, int style, int weight) {
if (weight >= 0 && Build.VERSION.SDK_INT >= 28) {
int clampedWeight = min(FONT_WEIGHT_MAX, weight);
boolean italic = (style & Typeface.ITALIC) != 0;
mTypeface = Api28Impl.createTypeface(tf, clampedWeight, italic);
mPaint.setTypeface(mTypeface);
} else {
setTypeface(tf, style);
}
}
/** Set of attribute that can be defined in a Text Appearance. */
private static class TextAppearanceAttributes {
@Nullable ColorStateList mTextColor = null;
float mTextSize = DEFAULT_TEXT_SIZE;
@Nullable String mFontFamily = null;
boolean mFontFamilyExplicit = false;
int mTypefaceIndex = -1;
int mTextStyle = DEFAULT_TEXT_STYLE;
int mFontWeight = -1;
float mLetterSpacing = 0f;
@Nullable String mFontFeatureSettings = null;
@Nullable String mFontVariationSettings = null;
TextAppearanceAttributes() {}
}
/** Sets the textColor, size, style, font etc from the specified TextAppearanceAttributes */
private void applyTextAppearance(WearCurvedTextView this, TextAppearanceAttributes attributes) {
if (attributes.mTextColor != null) {
mTextColor = attributes.mTextColor.getDefaultColor();
}
if (attributes.mTextSize != -1f) {
mTextSize = attributes.mTextSize;
}
setTypefaceFromAttrs(
attributes.mFontFamily,
attributes.mTypefaceIndex,
attributes.mTextStyle,
attributes.mFontWeight);
mPaint.setLetterSpacing(attributes.mLetterSpacing);
mLetterSpacing = attributes.mLetterSpacing;
// setFontFeatureSettings does accept null, but is not annotated as such. Empty string does
// the
// same thing though.
mPaint.setFontFeatureSettings(attributes.mFontFeatureSettings);
mFontFeatureSettings = attributes.mFontFeatureSettings;
if (Build.VERSION.SDK_INT >= 26 && attributes.mFontVariationSettings != null) {
Api26Impl.paintSetFontVariationSettings(mPaint, attributes.mFontVariationSettings);
}
mFontVariationSettings = attributes.mFontVariationSettings;
}
/**
* Read the Text Appearance attributes from a given TypedArray and set its values to the given
* set. If the TypedArray contains a value that already set in the given attributes, that will
* be overridden.
*/
private static void readTextAppearance(
TypedArray appearance, TextAppearanceAttributes attributes, boolean isTextAppearance) {
int attrIndex =
isTextAppearance
? R.styleable.TextAppearance_android_textColor
: R.styleable.WearCurvedTextView_android_textColor;
if (appearance.hasValue(attrIndex)) {
attributes.mTextColor = appearance.getColorStateList(attrIndex);
}
attributes.mTextSize =
appearance.getDimensionPixelSize(
isTextAppearance
? R.styleable.TextAppearance_android_textSize
: R.styleable.WearCurvedTextView_android_textSize,
(int) attributes.mTextSize);
attributes.mTextStyle =
appearance.getInt(
isTextAppearance
? R.styleable.TextAppearance_android_textStyle
: R.styleable.WearCurvedTextView_android_textStyle,
attributes.mTextStyle);
// make sure that the typeface attribute is read before fontFamily attribute
attributes.mTypefaceIndex =
appearance.getInt(
isTextAppearance
? R.styleable.TextAppearance_android_typeface
: R.styleable.WearCurvedTextView_android_typeface,
attributes.mTypefaceIndex);
if (attributes.mTypefaceIndex != -1 && !attributes.mFontFamilyExplicit) {
attributes.mFontFamily = null;
}
attrIndex =
isTextAppearance
? R.styleable.TextAppearance_android_fontFamily
: R.styleable.WearCurvedTextView_android_fontFamily;
if (appearance.hasValue(attrIndex)) {
attributes.mFontFamily = appearance.getString(attrIndex);
attributes.mFontFamilyExplicit = !isTextAppearance;
}
attributes.mFontWeight =
appearance.getInt(
isTextAppearance
? R.styleable.TextAppearance_android_textFontWeight
: R.styleable.WearCurvedTextView_android_textFontWeight,
attributes.mFontWeight);
attributes.mLetterSpacing =
appearance.getFloat(
isTextAppearance
? R.styleable.TextAppearance_android_letterSpacing
: R.styleable.WearCurvedTextView_android_letterSpacing,
attributes.mLetterSpacing);
attrIndex =
isTextAppearance
? R.styleable.TextAppearance_android_fontFeatureSettings
: R.styleable.WearCurvedTextView_android_fontFeatureSettings;
if (appearance.hasValue(attrIndex)) {
attributes.mFontFeatureSettings = appearance.getString(attrIndex);
}
attrIndex =
isTextAppearance
? R.styleable.TextAppearance_android_fontVariationSettings
: R.styleable.WearCurvedTextView_android_fontVariationSettings;
if (appearance.hasValue(attrIndex)) {
attributes.mFontVariationSettings = appearance.getString(attrIndex);
}
}
private void doUpdate() {
mDirty = true;
requestLayout();
postInvalidate();
}
private void doRedraw() {
mDirty = true;
postInvalidate();
}
/** returns the anchor type for positioning the curved text */
public int getAnchorType() {
return mAnchorType;
}
/**
* Sets the anchor type for positioning the curved text.
*
* @param value the anchor type, one of {ANCHOR_START, ANCHOR_CENTER, ANCHOR_END}
*/
public void setAnchorType(@WearArcLayout.AnchorType int value) {
mAnchorType = value;
doUpdate();
}
/** Returns the anchor angle used for positioning the text, in degrees. */
public float getAnchorAngleDegrees() {
return mAnchorAngleDegrees;
}
/** Sets the anchor angle used for positioning the text, in degrees. */
public void setAnchorAngleDegrees(float value) {
mAnchorAngleDegrees = value;
doRedraw();
}
/** returns the maximum sweep angle in degrees for rendering the text */
public float getMaxSweepDegrees() {
return mMaxSweepDegrees;
}
/** sets the maximum sweep angle in degrees for rendering the text */
public void setMaxSweepDegrees(float value) {
if (value < mMinSweepDegrees) {
throw new IllegalArgumentException(
"MaxSweepDegrees cannot be smaller than MinSweepDegrees");
}
mMaxSweepDegrees = min(value, MAX_SWEEP_DEGREE);
doUpdate();
}
/** returns the sweep angle in degrees for rendering the text */
public float getMinSweepDegrees() {
return mMinSweepDegrees;
}
/** sets the sweep angle in degrees for rendering the text */
public void setMinSweepDegrees(float value) {
if (value > mMaxSweepDegrees) {
throw new IllegalArgumentException(
"MinSweepDegrees cannot be bigger than MaxSweepDegrees");
}
mMinSweepDegrees = value;
doUpdate();
}
/** returns the text to be rendered */
@Nullable
public String getText() {
return mText;
}
/** sets the text to be rendered */
public void setText(@Nullable String value) {
mText = value == null ? "" : value;
doUpdate();
}
/** returns the text size for rendering the text */
public float getTextSize() {
return mTextSize;
}
/** sets the text size for rendering the text */
public void setTextSize(float value) {
mTextSize = value;
mPaint.setTextSize(mTextSize);
doUpdate();
}
/** Gets the current Typeface that is used to style the text. */
@Nullable
public Typeface getTypeface() {
return mTypeface;
}
/**
* Sets the typeface and style in which the text should be displayed. Note that not all Typeface
* families actually have bold and italic variants
*/
public void setTypeface(@Nullable Typeface value) {
mTypeface = value;
doUpdate();
}
/**
* Sets the typeface and style in which the text should be displayed, and turns on the fake bold
* and italic bits in the Paint if the Typeface that you provided does not have all the bits in
* the style that you specified.
*/
public void setTypeface(@Nullable Typeface tf, int style) {
if (style > 0) {
if (tf == null) {
tf = Typeface.defaultFromStyle(style);
} else {
tf = Typeface.create(tf, style);
}
if (!tf.equals(mPaint.getTypeface())) {
mPaint.setTypeface(tf);
mTypeface = tf;
}
// now compute what (if any) algorithmic styling is needed
int typefaceStyle = tf != null ? tf.getStyle() : 0;
int need = style & ~typefaceStyle;
mPaint.setFakeBoldText((need & Typeface.BOLD) != 0);
mPaint.setTextSkewX(((need & Typeface.ITALIC) != 0) ? ITALIC_SKEW_X : 0f);
} else {
mPaint.setFakeBoldText(false);
mPaint.setTextSkewX(0f);
if ((tf != null && !tf.equals(mPaint.getTypeface()))
|| (tf == null && mPaint.getTypeface() != null)) {
mPaint.setTypeface(tf);
mTypeface = tf;
}
}
doUpdate();
}
/** returns the curved text layout direction */
public boolean getClockwise() {
return mClockwise;
}
/** sets the curved text layout direction */
public void setClockwise(boolean value) {
mClockwise = value;
doUpdate();
}
/** returns the color for rendering the text */
@ColorInt
public int getTextColor() {
return mTextColor;
}
/** sets the color for rendering the text */
public void setTextColor(@ColorInt int value) {
mTextColor = value;
doRedraw();
}
/**
* Returns where, if anywhere, words that are longer than the view is wide should be ellipsized.
*/
@Nullable
public TextUtils.TruncateAt getEllipsize() {
return mEllipsize;
}
/**
* Causes words in the text that are longer than the view's width to be ellipsized. Use null to
* turn off ellipsizing.
*/
public void setEllipsize(@Nullable TextUtils.TruncateAt value) {
mEllipsize = value;
doRedraw();
}
/**
* Gets the text letter-space value, which determines the spacing between characters. The value
* returned is in ems. Normally, this value is 0.0.
*
* @return The text letter-space value in ems.
*/
public float getLetterSpacing() {
return mLetterSpacing;
}
/**
* Sets text letter-spacing in ems. Typical values for slight expansion will be around 0.05.
* Negative values tighten text.
*
* @param value A text letter-space value in ems.
*/
public void setLetterSpacing(float value) {
mLetterSpacing = value;
doUpdate();
}
/**
* Returns the font feature settings. The format is the same as the CSS font-feature-settings
* attribute: https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop
*
* @return the currently set font feature settings. Default is null.
*/
@Nullable
public String getFontFeatureSettings() {
return mFontFeatureSettings;
}
/**
* Sets font feature settings. The format is the same as the CSS font-feature-settings
* attribute: https://www.w3.org/TR/css-fonts-3/#font-feature-settings-prop
*
* @param value font feature settings represented as CSS compatible string. This value may be
* null.
*/
public void setFontFeatureSettings(@Nullable String value) {
mFontFeatureSettings = value;
doUpdate();
}
/** Returns TrueType or OpenType font variation settings. */
@Nullable
public String getFontVariationSettings() {
return mFontVariationSettings;
}
/**
* Sets TrueType or OpenType font variation settings.
*
* @param value font variation settings. You can pass null or empty string as no variation
* settings. This value may be null
*/
public void setFontVariationSettings(@Nullable String value) {
mFontVariationSettings = value;
doUpdate();
}
/**
* Gets the flags on the Paint being used to display the text.
*
* @return The flags on the Paint being used to display the text.
* @see Paint#getFlags
*/
public int getPaintFlags() {
return mPaint.getFlags();
}
/**
* Sets flags on the Paint being used to display the text and reflows the text if they are
* different from the old flags.
*
* @see Paint#setFlags
*/
public void setPaintFlags(int flags) {
if (mPaint.getFlags() != flags) {
mPaint.setFlags(flags);
doUpdate();
}
}
/** Nested class to avoid verification errors for methods induces in API level 26 */
@RequiresApi(26)
private static class Api26Impl {
private Api26Impl() {}
static void paintSetFontVariationSettings(Paint paint, String fontVariationSettings) {
paint.setFontVariationSettings(fontVariationSettings);
}
}
/** Nested class to avoid verification errors for methods induces in API level 28 */
@RequiresApi(28)
private static class Api28Impl {
private Api28Impl() {}
static Typeface createTypeface(@Nullable Typeface family, int weight, boolean italic) {
return Typeface.create(family, weight, italic);
}
}
}