Watch Face Format version <button value="5" default="">Version 5</button> <button value="4">Version 4</button> <button value="3">Version 3</button> <button value="2">Version 2</button> <button value="1">Version 1</button>

*** ** * ** ***

Specifies a circular or curved text configuration.

Introduced in Wear OS 4.

## Syntax

```xml
<TextCircular centerX="float" centerY="float"
              direction="CLOCKWISE | COUNTER_CLOCKWISE" width="float"
              height="float" startAngle="float-degrees"
              endAngle="float-degrees" align="START | CENTER | END"
              ellipsis="boolean" >
    <!-- Possible inner elements. The PartText element syntax shows a
         more complete example. -->
    <Transform .../>
    <Font ... />
    <BitmapFont ... />
</TextCircular>
```

## Attributes

The `TextCircular` element has the following attributes. Some attributes are
required while others are optional.

### Required attributes

The following attributes are required:

`centerX` and `centerY`

:   A pair of floating-point values that specify the position of the element's
    center.

    These attributes are [transformable](https://developer.android.com/training/wearables/wff/common/transform/transform).

`width` and `height`

:   A pair of floating-point values that specify the element's size.

`startAngle` and `endAngle`

:   A pair of floating-point values that specify the angle of the text's starting
    side and the angle of the text's ending side, respectively. An angle of 0
    degrees represents the 12 o'clock position on the watch face.

    For example, to curve text around the top quarter of the watch face, use a
    `startAngle` of `335.0` and an `endAngle` of `45.0`.

    These attributes are [transformable](https://developer.android.com/training/wearables/wff/common/transform/transform).

### Optional attributes

The following attributes are optional:

`direction`

:   Indicates the direction in which the text is written:

    - `CLOCKWISE` (default): Show text in the clockwise direction.
    - `COUNTER_CLOCKWISE`: Show text in the counterclockwise direction.

`align`

:   Determines the text's alignment within its parent element:

    - `START`: left- or top-aligned (right-aligned when the current language uses an RTL text direction)
    - `CENTER`: center-aligned
    - `END`: right- or bottom-aligned (left-aligned when the current language uses an RTL text direction)

    The default value is `CENTER`.

`ellipsis`

:   A boolean value that indicates whether to show an ellipsis if the text is too
    long to fit in the parent element. The default is `FALSE`.

`verticalAlign`

:   How to align the text vertically within the bounding box:

    - `TOP`: the text top edge is aligned on the top of the bounding box.
    - `BOTTOM`: the text bottom edge is aligned on the bottom of the bounding box.
    - `CENTER`: the text center is aligned on the center of the bounding box.
    - `CENTER_ON_BASELINE`: the text baseline is aligned on the center of the bounding box.

`isAutoSize`
:   Downscales the font size to fit the bounds of the containing
    `PartText`, with a minimum font size of 12px, or the [Font](https://developer.android.com/training/wearables/wff/group/part/text/font) `minSize` since
    v5. If used in conjunction with `ellipsis`, first the text is scaled down, then
    if the text still exceeds the bounds, the ellipsis is applied.

## Inner elements

The `Text` element can contain any number of the following inner elements:

- [`Transform`](https://developer.android.com/training/wearables/wff/common/transform/transform)
- [`Font`](https://developer.android.com/training/wearables/wff/group/part/text/bitmap-font)
- [`BitmapFont`](https://developer.android.com/training/wearables/wff/group/part/text/font)
- [`Reference`](https://developer.android.com/training/wearables/wff/common/reference/reference)

## Recommended for you

- Note: link text is displayed when JavaScript is off
- [TextCircular](https://developer.android.com/training/wearables/wff/v2/group/part/text/text-circular)
- [Arc](https://developer.android.com/training/wearables/wff/group/part/draw/shape/arc)
- [Text](https://developer.android.com/training/wearables/wff/group/part/text/text)