Ink API 已模块化,因此您可以仅使用所需的功能。
笔画
笔画模块是 Ink API 的基础。此模块中的关键数据类型包括:
StrokeInputBatch:表示一系列指针输入,包括其位置、时间戳,以及可选的压力、倾斜度和方向。InProgressStroke:表示正在绘制的笔画。InProgressStroke用于以低延迟渲染部分笔画,并在输入完成后构建最终的Stroke,之后可以重复使用该对象。InProgressStroke由InProgressStrokes可组合项使用。Stroke:已完成的笔画的不可变表示形式,具有固定的几何形状。每个Stroke都有一个ImmutableStrokeInputBatch(输入点)、一个Brush(样式)和一个PartitionedMesh(几何形状)。您可以在应用中存储、处理和渲染笔画。
几何体
几何图形模块支持对基本形状(使用 Box 和 Vec 等专用类)以及任意形状(使用 PartitionedMesh)进行几何运算,包括相交检测和转换。 PartitionedMesh 还可以保存其他数据以支持渲染。
笔刷
brush 模块定义了笔画的样式。它包含两个主要部分:
Brush:指定笔画的样式,包括基准颜色、基准大小和BrushFamily。BrushFamily类似于字体系列,用于定义笔画的样式。例如,BrushFamily可以表示某种特定样式的标记或荧光笔,从而使不同大小和颜色的笔画共享该样式。StockBrushes:提供用于创建即用型BrushFamily实例的工厂函数。
编写
借助 Compose 创作模块,您可以捕获用户触摸输入,并将其实时呈现为屏幕上的低延迟笔画。这是通过 InProgressStrokes 可组合项实现的,该可组合项可处理运动事件并在绘制笔画时显示笔画。
笔画完成后,可组合项会使用 InProgressStrokesFinishedListener 回调通知客户端应用。这允许应用检索完成的笔画以进行渲染或存储。
在 Compose 中,InProgressStrokes 通过 onStrokesFinished 参数接收此回调。将完成的笔画传递给另一个可组合项,以使用渲染模块将其提交到屏幕。
渲染
渲染模块可简化在 Android Canvas 上绘制墨水笔画的过程。
它为 Compose 提供 CanvasStrokeRenderer,为基于视图的布局提供 ViewStrokeRenderer。这些渲染器可优化渲染性能,并有助于呈现高质量的视觉效果,包括抗锯齿。
如需渲染笔画,请调用 create() 方法以获取 CanvasStrokeRenderer 实例,然后调用 draw() 方法,以将已完成 (Stroke) 或正在进行 (InProgressStroke) 的笔画渲染到 Canvas 上。
您可以在绘制笔画时转换画布。例如平移、缩放和旋转。为了正确渲染描边,您还必须将 canvas 转换传递给 CanvasStrokeRenderer.draw。
为避免单独跟踪 canvas 转换,请改用 ViewStrokeRenderer。
存储
存储模块提供用于高效序列化和反序列化笔画数据的实用程序,主要侧重于 StrokeInputBatch。
该模块使用 Protocol Buffer 和优化的增量压缩技术,与简单的方法相比,可显著节省存储空间。
存储模块简化了笔画的保存、加载和分享。