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

與元素旋轉方向相關的 2D 樞紐點。兩個值都是浮點數，可在 $ [0, 1] $ 範圍內視需求調整。

這些屬性可轉換。

angle

元素應以順時針方向從樞紐點旋轉的角度數值。

此屬性可轉換。

alpha

此屬性可設定元素應具備的透明度。如果值為 0，表示元素應完全透明；如果值為 255，則表示元素應完全不透明。

此屬性可轉換。

name

用於識別此元素的字串。如果需要從錶面檔案的其他位置參照這個元素，此屬性就能派上用場。

scaleX

要套用至此元素的水平縮放比例係數。

此屬性可轉換。

scaleY

要套用至此元素的垂直縮放比例係數。

此屬性可轉換。

renderMode

元素的算繪模式類型。可能的值包括：SOURCE (預設值)、MASK 或 ALL。

tintColor

此屬性可為元素套用色調顏色濾鏡。必須使用 ARGB 格式 (#ff000000 = 不透明黑) 或 RGB 格式 (#000000 = 黑) 指定顏色。

內部元素

PartImage 元素可包含下列內部元素。這些元素全都是選用元素，且一個 PartImage 元素可包含任意數量的個別內部元素 (Localization、Gyro、Launch 和 ScreenReader 例外，這些元素最多只能出現 1 次)。

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