模块

Ink API 已模块化,因此您可以仅使用所需的功能。

笔画

笔画模块是 Ink API 的基础。此模块中的关键数据类型包括:

  • StrokeInputBatch:表示一系列指针输入,包括其位置、时间戳,以及可选的压力、倾斜度和方向。
  • InProgressStroke:表示正在绘制的笔画。InProgressStroke 用于以低延迟渲染部分笔画,并在输入完成后构建最终的 Stroke,之后该对象可以重复使用。 `InProgressStrokeInProgressStrokesView 使用。
  • Stroke:已完成的笔画的不可变表示形式,具有固定的几何形状。每个 Stroke 都有一个 ImmutableStrokeInputBatch(输入点)、一个 Brush(样式)和一个 PartitionedMesh(几何形状)。您可以在应用中存储、处理和渲染笔画。

几何体

几何图形模块支持对基本形状(使用 BoxVec 等专用类)以及任意形状(使用 PartitionedMesh)进行几何运算,包括相交检测和转换。 PartitionedMesh 还可以保存其他数据以支持渲染。

笔刷

brush 模块定义了笔画的样式。它包含两个主要部分:

  • Brush:指定笔画的样式,包括基准颜色、基准大小和 BrushFamilyBrushFamily 类似于字体系列,用于定义笔画的样式。例如,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 和优化的增量压缩技术,与简单的方法相比,可显著节省存储空间。

存储模块简化了笔画的保存、加载和分享。