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