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>

*** ** * ** ***

*Since version 2 as a style for `Arc`, version 3 as a style for `Line`*

A stroke pattern with individual segments, which can take specified weights and
colors. Of particular use for rendering [GOAL_PROGRESS](https://developer.android.com/training/wearables/wff/common/transform/transform), [RANGED_VALUE](https://developer.android.com/training/wearables/wff/common/transform/transform)
and [WEIGHTED_ELEMENTS](https://developer.android.com/training/wearables/wff/common/transform/transform) complications.

## Syntax

```xml
<WeightedStroke colors="argb-color-list" thickness="float"
    weights="weight-list" discreteGap="float" interpolate="boolean"
    cap="BUTT | ROUND | SQUARE" />
```

## Attributes

The `WeightedStroke` element has the following attributes:

### Required attributes

The following attributes are required:

`colors`

:   The colors of each element of the weighted stroke, as a space-separated list
    of hex values, for example: `#FF0000 #00FF00 #0000FF`.

:   When used to render `GOAL_PROGRESS` or `RANGED_VALUE` complication data that
    supplies color data, or with `WEIGHTED_ELEMENTS`, `colors` can be populated
    directly with
    `[COMPLICATION.GOAL_PROGRESS_COLORS]`, `[COMPLICATION.RANGED_VALUE_COLORS]`, or
    `[COMPLICATION.WEIGHTED_ELEMENTS_COLORS]`.

`thickness`

:   The thickness of the stroke expressed as a [float dimension](https://developer.android.com/training/wearables/wff/common/attributes/dimension-type).

    This attribute is [transformable](https://developer.android.com/training/wearables/wff/common/transform/transform).

### Optional attributes

The following attributes are optional:

`weights`

:   A space-separated list of values, which determine the proportion of the arc or
    line taken up by each weight, for example `1.0 2.0 3.0`, where the third element
    takes up 3 times the angle or length of the first element.

:   When used to represent data from `WEIGHTED_ELEMENTS` complication, the
    `[COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS]` can be passed in directly.

`discreteGap`

:   When used on an arc, the angle between each element. When used on a line, the
    length between each element. Defaults to `0.0`.

`interpolate`

:   When set to `true`, each element *N* from the `weights` list has a color
    gradient from color *N* to color *N+1* of the `colors` list, as opposed to a
    solid color.

:   When used to represent data from `GOAL_PROGRESS` or `RANGED_VALUE`
    complications, you can pass in values for the
    `[COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE]` or
    `[COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE]` fields directly. When used in
    representing `WEIGHTED_ELEMENTS` complication data, set `interpolate` to
    `false`.

:   Defaults to `false`.

`cap`

:   Determine the shape of the edge of the stroke. Supported values are:

    - `BUTT` causes the stroke to end with the path, and not project beyond it.
    - `ROUND`causes the stroke to project out as a semicircle, with the center at the end of the path.
    - `SQUARE` causes the stroke to project out as a square, with the center at the end of the path.

`join`
:   Determines how the outer edges of stroke joints are rendered. Supported values are:

    - `MITER`: Extends the outer edges of the lines until they meet at a sharp point. Default value.
    - `ROUND`: Rounds the corner off with a circular arc.
    - `BEVEL`: Flattens the corner with a straight diagonal cut, preventing sharp points without the curvature of a round join.

## Inner elements

The `WeightedStroke` element can contain the following elements:

- [`Transform`](https://developer.android.com/training/wearables/wff/common/transform/transform)
- [`Reference`](https://developer.android.com/training/wearables/wff/common/reference/reference)

## Recommended for you

- Note: link text is displayed when JavaScript is off
- [WeightedStroke](https://developer.android.com/training/wearables/wff/v2/group/part/draw/style/weighted-stroke)
- [Complication](https://developer.android.com/training/wearables/wff/complication/complication)
- [Stroke](https://developer.android.com/training/wearables/wff/v2/group/part/draw/style/stroke)