部件图像

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

在 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 元素具有以下属性

必需属性

以下属性是必需的

xywidthheight

一组整数,用于指定元素的大小和位置。

这些属性是可变换的

可选属性

以下属性是可选的

pivotXpivotY

These attributes are [transformable][6].

:一个二维枢轴点,元素围绕该点旋转。这两个值都是浮点数,已缩放以适合范围 $[0, 1]$。

角度

元素应围绕其枢轴点顺时针旋转的度数。

此属性是可变换的

alpha(透明度)

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

此属性是可变换的

名称

标识此元素的字符串。如果您需要从表盘文件的另一个位置引用此元素,这将非常有用。

scaleX(水平缩放)

应用于此元素的水平缩放比例。

此属性是可变换的

scaleY(垂直缩放)

应用于此元素的垂直缩放比例。

此属性是可变换的

renderMode(渲染模式)

元素的渲染模式类型。可能的值为:SOURCE(默认值)、MASKALL

tintColor(色调颜色)

将色调颜色滤镜应用于元素。必须使用 ARGB 格式(#ff000000 = 不透明黑色)或 RGB 格式(#000000 = 黑色)指定颜色。

内部元素

PartImage 元素可以包含以下内部元素。所有元素都是可选的,PartImage 元素可以包含无限数量的每个内部元素——除了 LocalizationGyroLaunchScreenReader,每个最多只能出现 1 次。

  • 注意:当 JavaScript 关闭时,将显示链接文本。
  • 部件图像