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.

Android becerileri

GitHub'da göster

Özel mürekkep fırçaları oluşturma

Jetpack Compose'da özel uçlar, dinamik davranışlar, dokular ve katmanlarla özel BrushFamily stilleri tasarlamak için ink-custom-brush-builder Android becerisinden yararlanın.

Beceriyi Android KSA'dan yüklemek için şu komutu çalıştırın:

android skills add ink-custom-brush-builder

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
)
InkApiBrushApis.kt

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)
InkApiBrushApis.kt

Özel Fırçalar

StockBrushes, çok yönlü bir ortak fırça seti 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 belirli fırçaları kopyalamaya yönelik gelişmiş bir yol da sunar.

Özel bir BrushFamily, serileştirilmiş 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ı hemen yükleyip kullanabilirsiniz. Serileştirme kaldırıldıktan sonra özel BrushFamily, tıpkı StockBrushes ailelerinden herhangi biri gibi belirli bir renk ve boyutta yeni bir Brush oluşturmak için kullanılabilir.

Not: Bu arayüz deneyseldir ve değişikliğe tabidir.

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