Brush-APIs

Die Brush-APIs bieten Ihnen die Tools, mit denen Sie den visuellen Stil Ihrer Striche definieren können. Sie können Pinsel mit verschiedenen Farben, Größen und Familien erstellen, um unterschiedliche Looks zu erzielen.

Pinsel erstellen

Verwenden Sie zum Erstellen eines Pinsels die Compose-Companion-Methoden Brush mit benannten Argumenten wie Brush.Companion.createWithComposeColor. Mit dieser Klasse können Sie die folgenden Attribute festlegen:

• family: Der Stil des Pinsels, analog zu einer Schriftart im Text. Mögliche BrushFamily-Werte finden Sie unter StockBrushes.
• color: Die Farbe des Pinsels. Sie können die Farbe mit einem ColorLong festlegen.
• size: Die Gesamtstärke der mit dem Pinsel erstellten Striche.
• epsilon: Der kleinste Abstand, bei dem zwei Punkte für die Generierung von Strichgeometrie als visuell unterschiedlich betrachtet werden sollten. Das Verhältnis von Epsilon und Strichpunkten steuert, wie stark ein Strich vergrößert werden kann, ohne dass Artefakte entstehen. Dies geht jedoch auf Kosten des Arbeitsspeichers. Ein guter Ausgangspunkt für Stricheinheiten ist 1 px und für Epsilon 0, 1. Höhere Epsilon-Werte erfordern weniger Arbeitsspeicher, ermöglichen aber weniger Zoom, bevor Dreieckartefakte auftreten. Experimentieren Sie, um den richtigen Wert für Ihren Anwendungsfall zu finden.

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

Pinseleigenschaften ändern

Sie können mit der Methode copyWithComposeColor() eine Kopie eines vorhandenen Pinsels erstellen und so die Eigenschaften des Pinsels ändern.

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

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

Benutzerdefinierte Pinsel

StockBrushes bietet eine vielseitige Auswahl an gängigen Pinseln. Die Ink API bietet aber auch einen erweiterten Pfad zum Erstellen völlig neuer Pinselverhaltensweisen für einzigartige künstlerische Effekte oder zum Replizieren bestimmter vorhandener Pinsel zur Abwärtskompatibilität.

Ein benutzerdefiniertes BrushFamily wird aus seinem serialisierten Format geladen. Das erforderliche Format ist die gezippte binäre Codierung des BrushFamily-Protokollpuffers. So können Sie bereits jetzt benutzerdefinierte Pinseldateien laden und verwenden. Nach der Deserialisierung kann das benutzerdefinierte BrushFamily verwendet werden, um ein neues Brush mit einer bestimmten Farbe und Größe zu erstellen, genau wie bei den StockBrushes-Familien.