Brush API

API Brush memberi Anda alat untuk menentukan gaya visual goresan Anda. Anda dapat membuat kuas dengan berbagai warna, ukuran, dan jenis untuk mendapatkan berbagai tampilan.

Membuat kuas

Untuk membuat kuas, gunakan metode pendamping Brush Compose dengan argumen bernama seperti Brush.Companion.createWithComposeColor. Dengan class ini, Anda dapat menetapkan properti berikut:

  • family: Gaya kuas, serupa dengan typeface atau font dalam teks. Lihat StockBrushes untuk mengetahui nilai BrushFamily yang tersedia.
  • color: Warna kuas. Anda dapat menyetel warna menggunakan ColorLong.
  • size: Ketebalan keseluruhan goresan yang dibuat dengan kuas.
  • epsilon: Jarak terkecil yang membuat dua titik harus dianggap berbeda secara visual untuk tujuan geometri pembuatan goresan. Rasio epsilon dan titik goresan mengontrol seberapa jauh goresan dapat diperbesar tanpa artefak, dengan biaya memori. Titik awal yang baik untuk unit stroke adalah 1 px, dan titik awal yang baik untuk epsilon adalah 0,1. Nilai epsilon yang lebih tinggi menggunakan lebih sedikit memori, tetapi memungkinkan lebih sedikit zoom sebelum artefak segitiga muncul. Lakukan eksperimen untuk menemukan nilai yang tepat untuk kasus penggunaan Anda.
val brush = Brush.createWithComposeColor(
  family = StockBrushes.pressure(),
  colorIntArgb = Color.Black,
  size = 5F,
  epsilon = 0.1F
)

Mengubah properti kuas

Anda dapat membuat salinan kuas yang ada menggunakan metode copyWithComposeColor(), yang memungkinkan Anda mengubah properti kuas.

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

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

Kuas Kustom

虽然 StockBrushes 提供了一组通用的多功能笔刷，但 Ink API 还提供了一种高级方法，用于创建全新的笔刷行为，以实现独特的艺术效果，或复制特定的现有笔刷以实现向后兼容性。

自定义 BrushFamily 从其序列化格式加载。所需格式为 BrushFamily 协议缓冲区的 gzip 压缩二进制编码。这样一来，您就可以立即加载和使用自定义笔刷文件。反序列化后，自定义 BrushFamily 可用于创建具有特定颜色和大小的新 Brush，就像任何 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
)
Sebelumnya
Memilih modul
Berikutnya
Menggambar goresan