加权笔触

自 2.0 版本起

一种具有单个线段的笔触图案，可以采用指定的粗细和颜色。特别适用于渲染 GOAL_PROGRESS、RANGED_VALUE 和 WEIGHTED_ELEMENTS 复杂功能。

语法

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

属性

WeightedStroke 元素具有以下属性

必需属性

以下属性是必需的

colors

加权笔划每个元素的颜色，以空格分隔的十六进制值列表表示，例如：#FF0000 #00FF00 #0000FF。

当用于渲染提供颜色数据的 GOAL_PROGRESS 或 RANGED_VALUE 复杂功能数据，或与 WEIGHTED_ELEMENTS 一起使用时，可以使用 [COMPLICATION.GOAL_PROGRESS_COLORS]、[COMPLICATION.RANGED_VALUE_COLORS] 或 [COMPLICATION.WEIGHTED_ELEMENTS_COLORS] 直接填充 colors。

thickness

笔划粗细，表示为 浮点型尺寸。

此属性是 可变换的。

可选属性

以下属性是可选的

weights

空格分隔的值列表，用于确定每个权重占据的弧度比例，例如 1.0 2.0 3.0，其中第三个元素占据第一个元素角度的 3 倍。

当用于表示来自 WEIGHTED_ELEMENTS 复杂功能的数据时，可以直接传入 [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS]。

discreteGap

每个元素之间的角度。默认为 0.0。

interpolate

设置为 true 时，weights 列表中的每个元素 *N* 都有一个从 colors 列表的色彩 *N* 到色彩 *N+1* 的颜色渐变，而不是纯色。

当用于表示来自 GOAL_PROGRESS 或 RANGED_VALUE 复杂功能的数据时，您可以直接传入 [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] 或 [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] 字段的值。当用于表示 WEIGHTED_ELEMENTS 复杂功能数据时，请将 interpolate 设置为 false。

默认为 false。

cap

确定笔划边缘的形状。支持的值为

• BUTT 使笔划以路径结束，而不是超出路径。
• ROUND 使笔划以半圆形突出，中心位于路径的末端。
• SQUARE 使笔划以正方形突出，中心位于路径的末端。

内部元素

WeightedStroke 元素可以包含以下元素

• 变换