Brush API 可为您提供用于定义笔画视觉样式的工具。您可以创建具有不同颜色、大小和系列的笔刷,以实现各种外观效果。
创建画笔
如需创建画笔,请使用带有命名实参(例如 Brush.Companion.createWithComposeColor)的 Compose Brush 辅助方法。此类可让您设置以下属性:
family:笔刷的样式,类似于文本中的字体。 如需了解可用的BrushFamily值,请参阅StockBrushes。color:画笔的颜色。您可以使用ColorLong设置颜色。size:使用画笔创建的笔画的整体粗细。epsilon:为了生成笔画几何图形,应将两个点视为在视觉上不同的最小距离。epsilon 和笔画点的比率控制着笔画在不产生伪影的情况下可放大的程度,但会消耗内存。笔画单位的良好起点是 1 px,而 epsilon 的良好起点是 0.1。较高的 epsilon 值会使用较少的内存,但允许的缩放程度较低,之后会出现三角形伪影。 通过实验找出适合您使用场景的值。
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 可用于创建具有特定颜色和大小的新 Brush,就像任何 StockBrushes 系列一样。