Die Ink Brush APIs bieten eine Möglichkeit, Pinsel zum Zeichnen auf einem Canvas zu erstellen und anzupassen.
Pinsel erstellen
Verwenden Sie zum Erstellen eines Pinsels die Factory-Methoden Brush mit benannten Argumenten wie Brush.createWithColorLong(). Mit dieser Klasse können Sie die folgenden Attribute festlegen:
family: Der Stil des Pinsels, analog zu einer Schriftart im Text. MöglicheBrushFamily-Werte finden Sie unterStockBrushes.color: Die Farbe des Pinsels. Sie können die Farbe mit einemColorLongfestlegen.size: Die Basisstärke von Strichen, die mit dem Pinsel erstellt werden.epsilon: Der kleinste Abstand, bei dem zwei Punkte im Strich als unterschiedlich betrachtet werden müssen. Dies steuert den Detaillierungsgrad oder die Genauigkeit der Strichgeometrie.- Höhere Werte vereinfachen den Strich stärker, was weniger Speicherplatz benötigt und schneller gerendert wird. Beim Zoomen können jedoch sichtbare Artefakte wie gezackte Kanten auftreten.
- Bei niedrigeren Werten bleiben mehr Details für das Zoomen in hoher Qualität erhalten, aber der Speicherverbrauch steigt.
- Für Prototypen mit einer Einheitsskala von 1 px ist 0, 1 ein guter Ausgangspunkt. Verwenden Sie für Produktions-Apps, die verschiedene Bildschirmdichten unterstützen, dichteunabhängige Einheiten (z. B. „dp“) und passen Sie „epsilon“ entsprechend an.
val redBrush = Brush.createWithColorLong(
family = StockBrushes.pressurePen(),
colorLong = Color.RED.pack(),
size = 5F,
epsilon = 0.1F
)
Pinseleigenschaften ändern
Mit der Methode copy() können Sie eine Kopie eines vorhandenen Pinsels erstellen. Mit dieser Methode können Sie beliebige Eigenschaften des Pinsels ändern.
val blueBrush = redBrush.copy(colorLong = Color.BLUE.pack())
Benutzerdefinierte Pinsel
While StockBrushes provides a versatile set of
common brushes, Ink API also offers an advanced path for creating entirely new
brush behaviors for unique artistic effects or to replicate specific existing
brushes for backward compatibility.
A custom BrushFamily is loaded from its serialized format. The required format
is the gzipped binary encoding of the
BrushFamily protocol buffer. This lets you load and use
custom brush files today. Once deserialized, the custom BrushFamily can be
used to create a new Brush with a specific color and size, just like any of
the StockBrushes families.
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 )