Brush API

Brush API を使用すると、ストロークのビジュアル スタイルを定義するツールを利用できます。さまざまな色、サイズ、ファミリーのブラシを作成して、さまざまなルックを実現できます。

ブラシを作成する

ブラシを作成するには、Compose の Brush コンパニオン メソッドを Brush.Companion.createWithComposeColor などの名前付き引数とともに使用します。このクラスでは、次のプロパティを設定できます。

• family: ブラシのスタイル。テキストの書体やフォントに似ています。使用可能な BrushFamily 値については、StockBrushes をご覧ください。
• color: ブラシの色。色は ColorLong を使用して設定できます。
• size: ブラシで作成されたストロークの全体的な太さ。
• epsilon: ストローク生成ジオメトリの目的で、2 つのポイントが視覚的に区別されると見なされる最小距離。イプシロンとストローク ポイントの比率は、メモリを消費する代わりに、アーティファクトなしでストロークを拡大できる量を制御します。ストローク単位の適切な開始点は 1 ピクセル、イプシロンの適切な開始点は 0.1 です。イプシロン値が大きいほど、使用するメモリは少なくなりますが、三角形のアーティファクトが表示される前にズームできる範囲が狭くなります。ユースケースに適した値を見つけるためにテストします。

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

ブラシのプロパティを変更する

copyWithComposeColor() メソッドを使用すると、既存のブラシのコピーを作成して、ブラシのプロパティを変更できます。

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

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

カスタムブラシ

StockBrushes は汎用性の高い一般的なブラシのセットを提供しますが、Ink API は、独自の芸術的な効果を生み出すため、または下位互換性のために特定の既存のブラシを複製するために、まったく新しいブラシの動作を作成する高度なパスも提供します。

カスタム BrushFamily はシリアル化された形式から読み込まれます。必要な形式は、BrushFamily プロトコル バッファの gzip 圧縮されたバイナリ エンコードです。これにより、カスタム ブラシファイルを読み込んで使用できるようになります。逆シリアル化されたカスタム BrushFamily は、StockBrushes ファミリーと同様に、特定の色とサイズで新しい Brush を作成するために使用できます。