复杂功能边界区域


复杂功能边界区域用于定义复杂功能的渲染区域。表盘编辑器中显示边界区域的轮廓。边界区域外的任何内容都将被裁剪。

边界区域还决定了用户可以在表盘中选择复杂功能的区域。

在 Wear OS 4 中引入。

边界框

一个BoundingBox元素定义了复杂功能的矩形边界区域。

语法

<BoundingBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

属性

BoundingBox元素具有以下属性

必需属性

以下属性是必需的

xywidthheight
指定元素大小和位置的整数集合。

可选属性

以下属性是可选的

outlinePadding
指定应用于边界区域外部的填充的浮点数。这用于在表盘编辑器中创建更大的轮廓。默认为 0。

圆角边界框

一个BoundingRoundBox元素定义了具有圆角的矩形边界区域,用于复杂功能。

语法

<BoundingRoundBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" cornerRadius="float" />

属性

BoundingRoundBox元素具有以下属性

必需属性

以下属性是必需的

xywidthheight
指定元素大小和位置的整数集合。

可选属性

以下属性是可选的

cornerRadius

圆角半径。此值定义矩形角的圆角程度。

outlinePadding
指定应用于边界区域外部的填充的浮点数。这用于在表盘编辑器中创建更大的轮廓。默认为 0。

BoundingOval

一个BoundingOval元素定义了复杂功能的圆形边界区域。

语法

<BoundingOval x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

属性

The BoundingOval元素具有以下属性

必需属性

以下属性是必需的

xywidthheight
指定元素大小和位置的整数集合。

可选属性

以下属性是可选的

outlinePadding
指定应用于边界区域外部的填充的浮点数。这用于在表盘编辑器中创建更大的轮廓。默认为 0。

BoundingArc

一个BoundingArc元素定义了复杂功能的弧形边界区域。

语法

<BoundingArc centerX="float" centerY="float" width="float"
                height="float" thickness="float" isRoundEdge="boolean"
                startAngle="float" endAngle="float"
                direction="CLOCKWISE | COUNTER_CLOCKWISE"
                outlinePadding="float" />

属性

The BoundingArc元素具有以下属性

必需属性

以下属性是必需的

centerX, centerY, width, height
一组属性,用于定义弧形的包含椭圆。弧线按比例缩放以适合指定的椭圆内。所有属性都定义为浮点数。
thickness
弧线的厚度,以浮点数表示。
startAngle
弧线开始处的起始角度(以度为单位)。0度角对应于手表上的12点位置。
endAngle
弧线结束处的结束角度。

可选属性

以下属性是可选的

isRoundEdge
确定弧线末端的端盖是平的还是圆的。默认为FALSE。
direction
弧线的旋转方向。默认为CLOCKWISE
outlinePadding
指定应用于边界区域外部的填充的浮点数。这用于在表盘编辑器中创建更大的轮廓。默认为 0。