Fırça API'leri

Brush API'leri, fırça darbelerinizin görsel stilini tanımlamanız için gereken araçları sağlar. Çeşitli görünümler elde etmek için farklı renklerde, boyutlarda ve ailelerde fırçalar oluşturabilirsiniz.

Fırça oluşturma

Fırça oluşturmak için Compose Brush Brush.Companion.createWithComposeColor gibi adlandırılmış bağımsız değişkenlere sahip yardımcı yöntemleri 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 vuruşların genel kalınlığı.
  • epsilon: Çizgi oluşturma geometrisi amacıyla iki noktanın görsel olarak farklı kabul edilmesi gereken en küçük mesafe. Epsilon ve kontur noktalarının oranı, konturun bellek maliyeti karşılığında, artefakt olmadan ne kadar yakınlaştırılacağını kontrol eder. Kontur birimleri için iyi bir başlangıç noktası 1 piksel, epsilon için ise 0,1'dir. Daha yüksek epsilon değerleri daha az bellek kullanır ancak üçgen bozulmaları görünmeden önce daha az yakınlaştırmaya izin verir. Kullanım alanınız için doğru değeri bulmak üzere denemeler yapın.
val brush = Brush.createWithComposeColor(
  family = StockBrushes.pressure(),
  colorIntArgb = Color.Black,
  size = 5F,
  epsilon = 0.1F
)

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

Fırçanın özelliklerini değiştirebileceğiniz copyWithComposeColor() yöntemini kullanarak mevcut bir fırçanın kopyasını oluşturabilirsiniz.

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

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

Özel Fırçalar

虽然 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
)
Önceki
Modülünüzü seçin
Sonraki
Çizgi çizme