APIs de pincel

Las APIs de Brush te proporcionan las herramientas para definir el estilo visual de tus trazos. Puedes crear pinceles con diferentes colores, tamaños y familias para lograr una variedad de aspectos.

Habilidades de Android

Ver en GitHub

Crea pinceles de tinta personalizados

Usa la habilidad de Android de ink-custom-brush-builder para diseñar estilos personalizados de BrushFamily en Jetpack Compose con puntas, comportamientos dinámicos, texturas y capas personalizados.

Para instalar la habilidad desde la Android CLI, ejecuta lo siguiente:

android skills add ink-custom-brush-builder

Crea un pincel

Para crear un pincel, usa los métodos complementarios Brush de Compose con argumentos con nombre, como Brush.Companion.createWithComposeColor. Esta clase te permite establecer las siguientes propiedades:

• family: Es el estilo del pincel, similar a un tipo de letra o una fuente en el texto. Consulta StockBrushes para conocer los valores de BrushFamily disponibles.
• color: Es el color del pincel. Puedes establecer el color con un ColorLong.
• size: Es el grosor general de los trazos creados con el pincel.
• epsilon: Es la distancia más pequeña por la que se deben considerar dos puntos visualmente distintos para los fines de la geometría de generación de trazos. La proporción de épsilon y puntos de trazo controla cuánto se puede acercar un trazo sin artefactos, a costa de la memoria. Un buen punto de partida para las unidades de trazo es 1 px, y un buen punto de partida para épsilon es 0.1. Los valores de épsilon más altos usan menos memoria, pero permiten menos zoom antes de que aparezcan artefactos de triángulos. Experimenta para encontrar el valor adecuado para tu caso de uso.

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

Modifica las propiedades del pincel

Puedes crear una copia de un pincel existente con el método copyWithComposeColor(), que te permite cambiar cualquiera de las propiedades del pincel.

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

val blueBrush = redBrush.copyWithComposeColor(color = Color.Blue)
InkApiBrushApis.kt

Pinceles personalizados

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