Fırça API'leri

Mürekkep Brush API'leri, tuval üzerinde çizim yapmak için fırçalar oluşturup özelleştirmenin bir yolunu sunar.

Fırça oluşturma

Fırça oluşturmak için Brush.createWithColorLong() gibi adlandırılmış bağımsız değişkenlere sahip Brush fabrika yöntemlerini kullanın. Bu sınıf, aşağıdaki özellikleri ayarlamanıza olanak tanır:

  • family: Fırçanın stili, metindeki yazı tipi veya fonta benzer. Kullanılabilir StockBrushes değerleri için BrushFamily bölümüne bakın.
  • color: Fırçanın rengi. Rengi ColorLong kullanarak ayarlayabilirsiniz.
  • size: Fırçayla oluşturulan konturların temel kalınlığı.
  • epsilon: Çizgideki iki noktanın ayrı kabul edilmesi gereken en küçük mesafe. Bu mesafe, çizginin geometrisinin ayrıntı düzeyini veya doğruluğunu kontrol eder.
    • Daha yüksek değerler, konturu daha fazla basitleştirir. Bu da daha az bellek kullanılmasına ve daha hızlı oluşturulmasına yol açar ancak yakınlaştırıldığında tırtıklı kenarlar gibi görünür eserlere neden olabilir.
    • Daha düşük değerler, yüksek kaliteli yakınlaştırma için daha fazla ayrıntıyı korur ancak bellek kullanımını artırır.
    • 1 piksel birim ölçeğiyle prototip oluşturmak için 0, 1 iyi bir başlangıç noktasıdır. Çeşitli ekran yoğunluklarını destekleyen üretim uygulamaları için yoğunluktan bağımsız birimler (ör. dp) kullanın ve epsilon'u buna göre ayarlayın.
val redBrush = Brush.createWithColorLong(
  family = StockBrushes.pressurePen(),
  colorLong = Color.RED.pack(),
  size = 5F,
  epsilon = 0.1F
)

Fırça özelliklerini değiştirme

copy() yöntemini kullanarak mevcut bir fırçanın kopyasını oluşturabilirsiniz. Bu yöntem, fırçanın özelliklerinden herhangi birini değiştirmenize olanak tanır.

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

Özel fırçalar

StockBrushes, çok yönlü bir dizi ortak fırça sunarken Ink API, benzersiz sanatsal efektler için tamamen yeni fırça davranışları oluşturmaya veya geriye dönük uyumluluk için mevcut fırçaları kopyalamaya yönelik gelişmiş bir yol da sunar.

Özel bir BrushFamily, seri hale getirilmiş biçiminden yüklenir. Gerekli biçim, BrushFamily protokol arabelleğinin gzip ile sıkıştırılmış ikili kodlamasıdır. Bu sayede, özel fırça dosyalarını yükleyip kullanabilirsiniz. Özel BrushFamily seri durumundan çıkarıldıktan sonra, StockBrushes ailelerinden herhangi biri gibi belirli bir renk ve boyutta yeni bir Brush oluşturmak için kullanılabilir.

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
)