APIs do Brush

As APIs Brush oferecem as ferramentas para definir o estilo visual dos seus traços. Você pode criar pincéis com diferentes cores, tamanhos e famílias para conseguir uma variedade de estilos.

Criar um pincel

Para criar um pincel, use os métodos complementares Brush do Compose com argumentos nomeados, como Brush.Companion.createWithComposeColor. Com essa classe, é possível definir as seguintes propriedades:

• family: o estilo do pincel, análogo a um tipo ou fonte em texto. Consulte StockBrushes para conferir os valores de BrushFamily disponíveis.
• color: a cor do pincel. É possível definir a cor usando um ColorLong.
• size: a espessura geral dos traços criados com o pincel.
• epsilon: a menor distância para que dois pontos sejam considerados visualmente distintos para fins de geometria de geração de traços. A proporção de epsilon e pontos de traço controla o quanto um traço pode ser ampliado sem artefatos, ao custo de memória. Um bom ponto de partida para unidades de traço é 1 px, e para epsilon é 0,1. Valores mais altos de epsilon usam menos memória, mas permitem menos zoom antes que artefatos de triângulo apareçam. Faça testes para encontrar o valor certo para seu caso de uso.

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

Modificar propriedades do pincel

É possível criar uma cópia de um pincel usando o método copyWithComposeColor(), que permite mudar qualquer uma das propriedades do pincel.

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

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

Pincéis personalizados

Embora StockBrushes ofereça um conjunto versátil de pincéis comuns, a API Ink também oferece um caminho avançado para criar comportamentos de pincel totalmente novos para efeitos artísticos exclusivos ou para replicar pincéis específicos existentes para compatibilidade com versões anteriores.

Um BrushFamily personalizado é carregado do formato serializado. O formato obrigatório é a codificação binária compactada com gzip do buffer de protocolo BrushFamily. Isso permite carregar e usar arquivos de pincel personalizados hoje mesmo. Depois de desserializado, o BrushFamily personalizado pode ser usado para criar um novo Brush com uma cor e um tamanho específicos, assim como qualquer uma das famílias StockBrushes.

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
)