Módulos

La API de Ink está modularizada, por lo que puedes usar solo lo que necesitas.

Brazadas

El módulo trazos sirve como base de la API de Ink. Los tipos de datos clave de este módulo son los siguientes:

• StrokeInputBatch: Representa una serie de entradas de puntero, incluidas su posición, marca de tiempo y, de manera opcional, presión, inclinación y orientación.
• InProgressStroke: Representa un trazo que se está dibujando de forma activa. InProgressStroke se usa para renderizar trazos parciales con baja latencia y para compilar el objeto Stroke final una vez que se completa la entrada, después de lo cual se puede reutilizar el objeto. El elemento InProgressStroke se usa en el elemento InProgressStrokes componible.
• Stroke: Es una representación inmutable de un trazo finalizado con geometría fija. Cada Stroke tiene un ImmutableStrokeInputBatch (puntos de entrada), un Brush (estilo) y una PartitionedMesh (forma geométrica). Puedes almacenar, manipular y renderizar trazos dentro de tu aplicación.

Geometría

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

Pincel

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

• Brush：指定笔画的样式，包括基准颜色、基准大小和 BrushFamily。BrushFamily 类似于字体系列，用于定义笔画的样式。例如，BrushFamily 可以表示某种特定样式的标记或荧光笔，从而使不同大小和颜色的笔画共享该样式。
• StockBrushes：提供用于创建即用型 BrushFamily 实例的工厂函数。

Autoría

借助 Compose 创作模块，您可以捕获用户触摸输入，并将其实时呈现为屏幕上的低延迟笔画。这是通过 InProgressStrokes 可组合项实现的，该可组合项可处理运动事件并在绘制笔画时显示笔画。

笔画完成后，可组合项会使用 InProgressStrokesFinishedListener 回调通知客户端应用。这允许应用检索完成的笔画以进行渲染或存储。

在 Compose 中，InProgressStrokes 通过 onStrokesFinished 参数接收此回调。将完成的笔画传递给另一个可组合项，以使用渲染模块将其提交到屏幕。

Renderización

El módulo Rendering simplifica el dibujo de trazos de tinta en un Canvas de Android. Proporciona CanvasStrokeRenderer para Compose y ViewStrokeRenderer para diseños basados en vistas. Estos renderizadores optimizan el rendimiento de la renderización y ayudan a ofrecer elementos visuales de alta calidad, incluido el suavizado.

Para renderizar trazos, llama al método create() para obtener una instancia de CanvasStrokeRenderer y, luego, llama al método draw() para renderizar trazos terminados (Stroke) o en curso (InProgressStroke) en un Canvas.

Puedes transformar el lienzo cuando dibujas un trazo. Algunos ejemplos incluyen el desplazamiento horizontal, el zoom y la rotación. Para renderizar el trazo correctamente, también debes pasar la transformación canvas a CanvasStrokeRenderer.draw.

Para evitar hacer un seguimiento de la transformación canvas por separado, usa ViewStrokeRenderer.

Almacenamiento

存储模块提供用于高效序列化和反序列化笔画数据的实用程序，主要侧重于 StrokeInputBatch。

该模块使用 Protocol Buffer 和优化的增量压缩技术，与简单的方法相比，可显著节省存储空间。

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