stosować maski, efekty mieszania i odcienie.

Elementy Group i Part* udostępniają też atrybuty tintColor, renderMode i blendMode, które są skutecznymi sposobami dostosowywania wyglądu sekcji tarczy zegarka.

Używanie masek przycinających w trybie renderowania

Element renderMode został wprowadzony w wersji 1 WFF, aby umożliwić tworzenie maski przycinającej.

renderMode można zastosować do elementów Group i Part* w hierarchii sceny. Mechanizm renderowania tarczy zegarka rysuje elementy w kolejności, w jakiej przechodzi przez drzewo sceny.

Gdy do węzła zostanie zastosowany efekt renderMode, będzie on działać tylko w obrębie elementu nadrzędnego Group tego węzła. Nie ma to wpływu na inne węzły w grafie.

Jeśli nie określono właściwości renderMode, domyślnie jest to SOURCE, co oznacza, że element jest rysowany bezpośrednio na ekranie. Jeśli jednak w węźle nadrzędnym występuje co najmniej 1 element z określonym atrybutem MASK (lub ALL), stosowane jest inne podejście:

  1. Tworzony jest element canvas poza ekranem.
  2. Wszystkie elementy podrzędne z ustawioną wartością SOURCE (która jest domyślna) są rysowane.
    1. Wszystkie elementy podrzędne, które są częścią maski (MASK, ALL), są stosowane do obszaru roboczego, aby przyciąć wynikowy obraz.

Pamiętaj, że oznacza to, że kolejność elementów w węźle nadrzędnym nie jest brana pod uwagę.

W tym przykładzie element nadrzędny Scene zawiera 3 elementy podrzędne:

  • Pierwszy i trzeci element to elementy MASK, więc są połączone, tworząc warstwę maskującą.
  • Drugi element jest jedyną warstwą, która nie jest 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>

Trzecią opcją dla renderMode, oprócz SOURCE i MASK, jest ALL. ALL określa, że element powinien być traktowany zarówno jako SOURCE, jak i MASK, co może być przydatne w niektórych sytuacjach.

Używanie trybu mieszania

Uwaga: ta funkcja jest dostępna w wersji 3 i nowszych formatu tarczy zegarka.

Od wersji 3 Format tarczy zegarka umożliwia stosowanie trybu mieszania podczas tworzenia elementów Part*.

W przeciwieństwie do elementu renderMode, który wprowadza specjalny mechanizm do tworzenia odpowiednio źródła i maski, element blendMode zapewnia ogólny dostęp do wszystkich efektów trybu mieszania grafiki Androida i stosuje efekty w kolejności, w jakiej elementy pojawiają się w grafie sceny.

W normalnych warunkach, gdy na scenie umieszczone są 2 elementy Part*, górny element zasłania lub częściowo zasłania dolny, ponieważ domyślna wartość blendMode to 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>

Aby zademonstrować użycie trybów mieszania, wybierz SRC_ATOP, co spowoduje odrzucenie pikseli źródłowych, które nie pokrywają pikseli docelowych. PartText to źródło, a PartDraw to miejsce docelowe.

W rezultacie tekst jest rysowany tylko na prostokącie, a nie w innym miejscu na tarczy zegarka:

<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>

Można zastosować bardziej złożone efekty, takie jak użycie COLOR_DODGE zamiast SRC_ATOP, co powoduje, że miejsce docelowe jest jaśniejsze, aby odzwierciedlać źródło.

Przykład połączenia kilku elementów Part* za pomocą trybów mieszania HUE i COLOR_BURN:

<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>

Uwagi

W sekcjach poniżej opisano kwestie, o których należy pamiętać podczas korzystania z efektów przycinania i mieszania.

Tryb mieszania jest stosowany przed trybem renderowania

Jeśli węzeł zawiera zarówno elementy Part z atrybutem blendMode, jak i elementy Part z atrybutem renderMode ustawionym na MASK (lub ALL), stosowane jest następujące podejście.

  1. Źródło jest kompozycją, w tym z zastosowaniem trybów blendMode
  2. Maska jest następnie stosowana do tych elementów, które określają rendermode="MASK"

Jeśli na przykład weźmiemy pod uwagę poprzedni przykład i dodamy maskę prostokątną, kolejność zamaskowanych elementów nie ma znaczenia:

<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>

Wydajność

Użycie renderMode i blendMode wymaga dodatkowych obliczeń i kroków rysowania. W zależności od urządzenia, na którym działa tarcza zegarka, niektóre z tych operacji mogą być wykonywane wydajnie na obsługiwanym sprzęcie, ale może to nie być możliwe na starszych urządzeniach.

Z tego powodu używaj elementów renderMode i blendMode z rozwagą i pamiętaj o wpływie, jaki mogą mieć na ogólną wydajność tarczy zegarka.

Używanie odcieni

Atrybut tintColor można zastosować do całego elementu Part*, Group lub poszczególnych wskazówek, takich jak HourHand i MinuteHand, na przykład:

<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>

Może to być przydatne do stylizowania całej sekcji tarczy zegarka, w tym do stosowania stylu z ustawień użytkownika, na przykład: tintcolor="[CONFIGURATION.myThemeColor.0]".