Brush API

API Tinta Brush menyediakan cara untuk membuat dan menyesuaikan kuas untuk menggambar di kanvas.

Membuat kuas

Untuk membuat kuas, gunakan metode factory Brush dengan argumen bernama seperti Brush.createWithColorLong(). Class ini memungkinkan Anda 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 dasar goresan yang dibuat dengan kuas.
  • epsilon: Jarak terkecil di mana dua titik dalam goresan harus dianggap berbeda, yang mengontrol tingkat detail atau keakuratan geometri goresan.
    • Nilai yang lebih tinggi akan menyederhanakan goresan lebih banyak, yang menggunakan lebih sedikit memori dan merender lebih cepat, tetapi dapat menghasilkan artefak yang terlihat seperti tepi bergerigi saat di-zoom.
    • Nilai yang lebih rendah mempertahankan lebih banyak detail untuk zoom berkualitas tinggi, tetapi meningkatkan penggunaan memori.
    • Untuk membuat prototipe dengan skala unit 1 px, 0,1 adalah titik awal yang baik. Untuk aplikasi produksi yang mendukung berbagai kepadatan layar, gunakan unit yang tidak bergantung pada kepadatan (seperti dp) dan sesuaikan epsilon dengan tepat.
val redBrush = Brush.createWithColorLong(
  family = StockBrushes.pressurePen(),
  colorLong = Color.RED.pack(),
  size = 5F,
  epsilon = 0.1F
)

Mengubah properti kuas

Anda dapat membuat salinan kuas yang ada menggunakan metode copy(). Metode ini memungkinkan Anda mengubah properti kuas.

val blueBrush = redBrush.copy(colorLong = Color.BLUE.pack())

Kuas kustom

Meskipun StockBrushes menyediakan serangkaian kuas umum yang serbaguna, Ink API juga menawarkan jalur lanjutan untuk membuat perilaku kuas yang benar-benar baru untuk efek artistik yang unik atau untuk mereplikasi kuas tertentu yang sudah ada untuk kompatibilitas mundur.

BrushFamily kustom dimuat dari format berserialnya. Format yang diperlukan adalah encoding biner yang di-gzip dari protocol buffer BrushFamily. Dengan begitu, Anda dapat memuat dan menggunakan file kuas kustom sekarang. Setelah dideserialisasi, BrushFamily kustom dapat digunakan untuk membuat Brush baru dengan warna dan ukuran tertentu, seperti kelompok StockBrushes lainnya.

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
)