Элементы Group и Part* также содержат атрибуты tintColor, renderMode и blendMode, которые позволяют настраивать внешний вид разделов циферблата.
Как использовать обтравочные маски с режимом рендеринга
Элемент renderMode был представлен в первой версии формата Watch Face Format для создания обтравочной маски.
renderMode можно применить к элементам Group и Part* в иерархии сцены. Рендерер циферблата рисует элементы по порядку, проходя по дереву сцены.
Если к узлу применяется renderMode, эффект распространяется только на родительский элемент Group этого узла. Другие узлы в графе не затрагиваются.
Если значение renderMode не указано, по умолчанию применяется SOURCE, то есть элемент отрисовывается непосредственно на экране. Однако если в родительском узле есть один или несколько элементов с атрибутом MASK (или ALL), то используется другой подход:
- Создается холст за пределами экрана.
- Все дочерние элементы с заданным значением
SOURCE(по умолчанию) будут отрисованы.- Все дочерние элементы, которые являются частью маски (
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), то применяется следующий подход.
- Источник компонуется, в том числе с применением режимов
blendMode. - Затем маска применяется к элементам, для которых задано свойство
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]".