PartImage

表示包含一个或多个图像的表盘部分。

此元素在 Wear OS 4 中推出。

语法

<PartImage x="integer" y="integer" width="integer" height="integer"
           pivotX="float" pivotY="float" angle="float-degrees" alpha="integer"
           name="string" scaleX="float" scaleY="float"
           renderMode="[SOURCE | MASK | ALL]"
           tintColor="argb-color | rgb-color">
    <!-- Image-specific child elements. A "PartImage" element can have any
         number of these elements. -->
    <ImageFilters ... />
    <Images>
        <Image ... />
    </Images>
    <Image ... />

    <!-- Child elements that are shared across all "Part" elements. -->
    <Localization .../>
    <Transform .../>
    <Variant .../>
    <Gyro .../>
    <Launch .../>
    <ScreenReader .../>
</PartImage>

属性

PartImage 元素具有以下属性：

必需属性

以下属性是必需属性：

x、y、width、height

用于指定元素的尺寸和位置的整数集合。

这些属性是可转换的。

可选属性

以下属性是可选属性：

pivotX、pivotY

表示元素围绕其旋转的二维轴心点。这两个值都是浮点数，且均会经过调整以符合 $ [0, 1] $ 这一范围。

这些属性是可转换的。

angle

表示元素围绕轴心点顺时针旋转时应遵循的角度值。

此属性是可转换的。

alpha

用于设置此元素应具有的透明度。值 0 表示此元素应是完全透明的。值 255 表示此元素应是完全不透明的。

此属性可转换。

name

用于标识此元素的字符串。如果您需要从表盘文件中的其他位置引用此元素，则该字符串会非常有用。

scaleX

要应用于此元素的横向缩放比例。

此属性可转换。

scaleY

要应用于此元素的纵向缩放比例。

此属性可转换。

renderMode

表示此元素的渲染模式类型。可能的值包括 SOURCE（默认）、MASK 或 ALL。

tintColor

用于对此元素应用色调滤镜。您必须使用 ARGB 格式（#ff000000 = 不透明的黑色）或 RGB 格式（#000000 = 黑色）来指定颜色。

内部元素

PartImage 元素可以包含以下内部元素。所有这些元素都是可选的。其中，除了 Localization、Gyro、Launch 和 ScreenReader 最多分别只能出现 1 次外，其他每个内部元素在 PartImage 元素中的使用次数不受限制。

• ImageFilters
• Images
• Image
• Localization
• Transform
• Variant
• Gyro
• Launch
• ScreenReader