Fırça API'leri

Brush API'leri, vuruşlarınızın görsel stilini tanımlamanızı sağlayan araçlar sunar. Farklı görünümler elde etmek için farklı renk, boyut ve ailelerde fırçalar oluşturabilirsiniz.

Fırça oluşturma

Fırça oluşturmak için Brush.Companion.createWithComposeColor gibi adlandırılmış bağımsız değişkenlerle Compose Brush tamamlayıcı yöntemlerini kullanın. Bu sınıf, aşağıdaki özellikleri ayarlamanıza olanak tanır:

  • family: Metindeki yazı tipine veya yazı karakterine benzer şekilde fırçanın stili. Kullanılabilir BrushFamily değerleri için StockBrushes bölümüne bakın.
  • color: Fırçanın rengi. Rengi ColorLong kullanarak ayarlayabilirsiniz.
  • size: Fırçayla oluşturulan fırça darbelerinin genel kalınlığı.
  • epsilon: Çizgi oluşturma geometrisi açısından iki noktanın görsel olarak farklı kabul edilmesi gereken en küçük mesafe. Epsilon ve fırça darbesi noktalarının oranı, bellek maliyeti karşılığında bir fırça darbesinin yapaylık olmadan ne kadar yakınlaştırılabileceğini kontrol eder. Kontur birimleri için 1 piksel, epsilon için ise 0,1 iyi bir başlangıç noktasıdır. Daha yüksek epsilon değerleri daha az bellek kullanır ancak üçgen yapaylıklar görünmeden önce daha az yakınlaştırmaya izin verir. Kullanım alanınıza uygun değeri bulmak için denemeler yapın.

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

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

copyWithComposeColor() 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 redBrush = Brush.createWithComposeColor(
    family = StockBrushes.pressurePen(),
    color = 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) {

    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
)

Önceki
Modülünüzü seçin
Sonraki
Çizgi çizme