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

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.