API-интерфейсы кистей

API-интерфейсы Brush предоставляют вам инструменты для определения визуального стиля ваших мазков. Вы можете создавать кисти разных цветов, размеров и семейств, чтобы добиться разнообразных результатов.

Создайте кисть

Для создания кисти используйте вспомогательные методы класса Compose Brush с именованными аргументами, например, Brush.Companion.createWithComposeColor . Этот класс позволяет задавать следующие свойства:

• family : Стиль кисти, аналогичный шрифту в тексте. Доступные значения BrushFamily см. в StockBrushes .
• color : Цвет кисти. Цвет можно задать с помощью ColorLong .
• size : Общая толщина мазков, создаваемых кистью.
• epsilon : Наименьшее расстояние, при котором две точки должны считаться визуально различимыми для целей генерации геометрии штриха. Соотношение эпсилона и количества точек штриха определяет, насколько можно увеличить масштаб штриха без появления артефактов, но за счет объема памяти. Хорошей отправной точкой для единиц штриха является 1 пиксель, а хорошей отправной точкой для эпсилона — 0,1. Более высокие значения эпсилона используют меньше памяти, но позволяют уменьшить масштаб до появления треугольных артефактов. Экспериментируйте, чтобы найти подходящее значение для вашего случая.

val brush = Brush.createWithComposeColor(
  family = StockBrushes.pressure(),
  colorIntArgb = Color.Black,
  size = 5F,
  epsilon = 0.1F
)

Изменить свойства кисти

Вы можете создать копию существующей кисти, используя метод copyWithComposeColor() , который позволяет изменять любые свойства кисти.

val redBrush = Brush.createWithComposeColor(
  family = StockBrushes.pressurePen(),
  colorIntArgb = Color.RED,
  size = 5F,
  epsilon = 0.1F
)

val blueBrush = redBrush.copyWithComposeColor(color = Color.BLUE)

Пользовательские кисти

Хотя StockBrushes предоставляет универсальный набор распространенных кистей, Ink API также предлагает расширенный путь для создания совершенно новых свойств кистей для уникальных художественных эффектов или для копирования определенных существующих кистей для обратной совместимости.

Пользовательское BrushFamily загружается из сериализованного формата. Требуемый формат — это сжатый в формате gzip двоичный код буфера протокола BrushFamily . Это позволяет загружать и использовать пользовательские файлы кистей уже сегодня. После десериализации пользовательское BrushFamily можно использовать для создания новой Brush с определенным цветом и размером, как и любое из семейств StockBrushes .