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)

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

While StockBrushes provides a versatile set of common brushes, Ink API also offers an advanced path for creating entirely new brush behaviors for unique artistic effects or to replicate specific existing brushes for backward compatibility.

A custom BrushFamily is loaded from its serialized format. The required format is the gzipped binary encoding of the BrushFamily protocol buffer. This lets you load and use custom brush files today. Once deserialized, the custom BrushFamily can be used to create a new Brush with a specific color and size, just like any of the StockBrushes families.

class CustomBrushes(val context: Context) {

  private const val TAG = "CustomBrushes"

  val brushes by lazy { loadCustomBrushes(context) }

  @OptIn(ExperimentalInkCustomBrushApi::class)
  private fun loadCustomBrushes(): List<CustomBrush> {
    val brushFiles = mapOf(
        "Calligraphy" to (R.raw.calligraphy to R.drawable.draw_24px),
        "Flag Banner" to (R.raw.flag_banner to R.drawable.flag_24px),
        "Graffiti" to (R.raw.graffiti to R.drawable.format_paint_24px),
    // ...
    )

    val loadedBrushes = brushFiles.mapNotNull { (name, pair) ->
      val (resourceId, icon) = pair
      val brushFamily = context.resources.openRawResource(resourceId).use
      { inputStream ->
          BrushFamily.decode(inputStream)
      }
      CustomBrush(name, icon, brushFamily.copy(clientBrushFamilyId = name))     
    }
    return loadedBrushes
  }
}

data class CustomBrush(
  val name: String,
  val icon: Int,
  val brushFamily: BrushFamily
)