Brush API

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

Keterampilan Android

Lihat di GitHub

Membuat kuas Tinta kustom

Gunakan ink-custom-brush-builder Android skill untuk mendesain gaya BrushFamily kustom di Jetpack Compose dengan ujung kustom, perilaku dinamis, tekstur, dan lapisan.

Untuk menginstal skill dari Android CLI, jalankan:

android skills add ink-custom-brush-builder

Membuat kuas

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

• family: Gaya kuas, yang mirip dengan typeface atau font dalam teks. Lihat StockBrushes untuk mengetahui nilai BrushFamily yang tersedia.
• color: Warna kuas. Anda dapat menetapkan 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 banyak goresan dapat diperbesar tanpa artefak, dengan mengorbankan memori. Titik awal yang baik untuk unit goresan 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.pressurePen(),
    color = Color.Black,
    size = 5F,
    epsilon = 0.1F
)
InkApiBrushApis.kt

Mengubah properti kuas

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

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

val blueBrush = redBrush.copyWithComposeColor(color = Color.Blue)
InkApiBrushApis.kt

Kuas Kustom

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

BrushFamily kustom dimuat dari format serialnya. Format yang diperlukan adalah encoding biner gzipped dari buffering protokol BrushFamily. Dengan begitu, Anda dapat memuat dan menggunakan file kuas kustom sekarang juga. Setelah dideserialisasi, BrushFamily kustom dapat digunakan untuk membuat Brush baru dengan warna dan ukuran tertentu, sama seperti keluarga StockBrushes.

Catatan: Antarmuka ini bersifat eksperimental dan dapat berubah sewaktu-waktu.

class CustomBrushes(val context: Context) {

    companion object {
        private const val TAG = "CustomBrushes"
    }

    val brushes by lazy { loadCustomBrushes() }

    @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)
        }
        return loadedBrushes
    }
}

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