套用遮罩、混合效果和色調

Group 和 Part* 元素也提供 tintColor, renderMode 和 blendMode 屬性,可有效調整錶面各部分的外觀。

搭配轉譯模式使用剪輯遮罩

WFF 第 1 版推出 renderMode,用於實現剪輯遮罩。

renderMode 可套用至場景階層中的 Group 和 Part* 元素。錶面轉譯器會在周遊場景樹狀結構時,依序繪製元素。

將 renderMode 套用至節點時,效果只會套用至該節點的父項 Group。圖表中其他位置的節點則不受影響。

如未指定 renderMode,預設值為 SOURCE,表示元素會直接繪製到螢幕上。不過,如果父項節點中有一或多個元素指定了 MASK (或 ALL),則會採用不同的方法:

  1. 建立螢幕外畫布
  2. 所有已設定 SOURCE (預設) 的子項元素都會繪製
    1. 遮罩 (MASK, ALL) 的所有子元素都會套用至畫布,裁剪產生的圖片。

請注意,這表示系統不會考量父項節點中的元素順序。

在以下範例中,Scene 父項包含三個子項:

  • 第一和第三個元素是 MASK 元素,因此會合併形成遮罩層
  • 第二個元素是唯一的非遮罩層

<PartDraw x="175" y="50" width="100" height="100" renderMode="MASK">
    <Ellipse x="0" y="0" width="100" height="100">
        <Fill color="#FFFFFF" />
    </Ellipse>
</PartDraw>

<PartDraw x="0" y="0" width="450" height="450">
    <Rectangle x="0" y="0" width="450" height="450">
        <Fill color="#ff0000">
            <LinearGradient startX="0" startY="0" endX="450" endY="450"
                colors="#FFFF00 #00FFFF #FF00FF" positions="0.25 0.5 0.75" />
        </Fill>
    </Rectangle>
</PartDraw>

<PartText x="75" y="250" width="300" height="80" renderMode="MASK">
    <Text align="CENTER">
        <Font family="pacifico" size="72" weight="BOLD" color="#FFFFFF">Hello!</Font>
    </Text>
</PartText>

除了 SOURCE 和 MASK 之外,renderMode 的第三個選項是 ALL。ALL 指定元素應同時視為 SOURCE 和 MASK,這在某些情況下可能很有用。

使用混合模式

注意:這項功能適用於錶面格式第 3 版以上。

從第 3 版開始,錶面格式可讓您在組合 Part* 元素時套用混合模式。

renderMode 導入了分別建構來源和遮罩的特殊機制,而 blendMode 則不同,可讓您存取所有 Android 圖形混合模式效果,並按照元素在場景圖中顯示的順序套用效果。

在正常運作下,當兩個 Part* 元素放置在場景中時,最上層的元素會遮蓋或部分遮蓋下層元素,因為預設的 blendMode 為 SRC_OVER。

<PartDraw x="125" y="115" width="150" height="150">
    <Rectangle x="0" y="0" width="150" height="150">
        <Fill color="#ffd3ba" />
    </Rectangle>
</PartDraw>
<PartText x="135" y="160" width="300" height="120">
    <Text align="START">
        <Font family="pacifico" size="96" weight="BOLD" color="#fb5607">Hello!</Font>
    </Text>
</PartText>

為了示範如何使用混合模式,選擇 SRC_ATOP 會捨棄未覆蓋目的地像素的來源像素。也就是說,PartText 是來源,目的地則是 PartDraw。

因此,文字只會繪製在矩形上方,而不會繪製在錶面的其他位置:

<PartDraw x="125" y="115" width="150" height="150">
    <Rectangle x="0" y="0" width="150" height="150">
        <Fill color="#ffd3ba" />
    </Rectangle>
</PartDraw>
<PartText x="135" y="160" width="300" height="120" blendMode="SRC_ATOP">
    <Text align="START">
        <Font family="pacifico" size="96" weight="BOLD" color="#fb5607">Hello!</Font>
    </Text>
</PartText>

您可以套用更複雜的效果,例如使用 COLOR_DODGE 而非 SRC_ATOP,這會使目的地更亮,以反映來源。

以下範例說明如何使用 HUE 和 COLOR_BURN 混合模式,結合多個 Part* 元素:

<Group name="container" x="75" y="100" width="300" height="300">
    <PartDraw x="25" y="15" width="150" height="150">
        <Rectangle x="0" y="0" width="150" height="150">
            <Fill color="#ffd3ba" />
        </Rectangle>
    </PartDraw>
    <PartDraw x="100" y="15" width="150" height="150" blendMode="HUE">
        <Ellipse x="0" y="0" width="150" height="150">
            <Fill color="#219ebc" />
        </Ellipse>
    </PartDraw>
    <PartText x="35" y="60" width="300" height="120" blendMode="COLOR_BURN">
        <Text align="START">
            <Font family="pacifico" size="96" weight="BOLD" color="#fb5607">Hello!</Font>
        </Text>
    </PartText>
</Group>

注意事項

以下各節說明使用裁剪和混合效果時,需要注意的事項。

混合模式會在轉譯模式前套用

如果節點同時包含使用 blendMode 的 Part 元素,以及使用 renderMode 設為 MASK (或 ALL) 的 Part 元素,則會採取下列方法。

  1. 來源會經過合成,包括套用 blendMode 模式
  2. 然後,系統會從指定 rendermode="MASK" 的元素套用遮罩

舉例來說,假設使用先前用過的範例,並加入矩形遮罩,請注意遮罩元素的順序並不重要:

<Group name="container" x="75" y="100" width="300" height="300">
    <PartDraw x="25" y="15" width="150" height="150">
        <Rectangle x="0" y="0" width="150" height="150">
            <Fill color="#ffd3ba" />
        </Rectangle>
    </PartDraw>
    <PartDraw x="100" y="15" width="150" height="150" blendMode="HUE">
        <Ellipse x="0" y="0" width="150" height="150">
            <Fill color="#219ebc" />
        </Ellipse>
    </PartDraw>
    <PartDraw x="100" y="15" width="150" height="150" renderMode="MASK">
        <Rectangle x="0" y="0" width="150" height="150">
            <Fill color="#ffffff" />
        </Rectangle>
    </PartDraw>
    <PartText x="35" y="60" width="300" height="120" blendMode="COLOR_BURN">
        <Text align="START">
            <Font family="pacifico" size="96" weight="BOLD" color="#fb5607">Hello!</Font>
        </Text>
    </PartText>
</Group>

效能

使用 renderMode 和 blendMode 都需要額外的運算和繪圖步驟。視錶面執行的裝置而定,部分作業可在支援的硬體上有效執行,但在舊版裝置上可能無法執行。

因此,請謹慎使用 renderMode 和 blendMode,並留意使用這些元素對錶面整體效能可能造成的影響。

使用色調

tintColor 可套用至整個 Part* 元素、Group 或個別指針,例如 HourHand 和 MinuteHand,例如:

<Group x="75" y="100" width="350" height="350" name="group1" tintColor="#ffd3ba">
    <PartDraw x="25" y="0" width="100" height="100">
        <Rectangle x="0" y="0" width="100" height="100">
            <Fill color="#ffffff" />
        </Rectangle>
    </PartDraw>
    <PartDraw x="150" y="0" width="100" height="100">
        <Ellipse x="25" y="0" width="100" height="100">
            <Fill color="#ffffff" />
        </Ellipse>
    </PartDraw>
    <PartText x="0" y="150" width="300" height="80">
        <Text align="CENTER">
            <Font family="pacifico" size="72" weight="BOLD" color="#ffffff">Hello!</Font>
        </Text>
    </PartText>
</Group>

這項功能可用於設定整個錶面部分的樣式,包括套用使用者設定中的樣式,例如:tintcolor="[CONFIGURATION.myThemeColor.0]"。