Как применять маски, смешивать эффекты и оттенки

Элементы Group и Part* также содержат атрибуты tintColor, renderMode и blendMode, которые позволяют настраивать внешний вид разделов циферблата.

Как использовать обтравочные маски с режимом рендеринга

Элемент renderMode был представлен в первой версии формата Watch Face Format для создания обтравочной маски.

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>

Третий вариант для renderMode в дополнение к SOURCE и MASK – ALL. ALL указывает, что элемент должен обрабатываться и как SOURCE, и как MASK. Это может быть полезно в некоторых случаях.

Использовать режим смешивания

Примечание. Эта функция доступна в Watch Face Format версии 3 и выше.

Начиная с версии 3, Watch Face Format позволяет применять режим смешивания при создании элементов Part*.

В отличие от renderMode, где используется специальный механизм для создания источника и маски, blendMode предоставляет общий доступ ко всем эффектам режима смешивания Android Graphics и применяет их в том порядке, в котором элементы появляются в графе сцены.

В обычном режиме, когда в сцене размещаются два элемента 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, чтобы сделать целевой элемент ярче и отразить исходный.

Пример объединения нескольких элементов Part* с помощью режимов смешивания HUE и 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>

Что нужно учесть

В следующих разделах описаны некоторые особенности, которые следует учитывать при использовании эффектов обрезки и смешивания.

Режим смешивания применяется перед режимом рендеринга.

Если узел содержит элементы Part, в которых используется blendMode, и элементы Part, в которых используется renderMode со значением MASK (или ALL), то применяется следующий подход.

  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]".