La API de Ink está modularizada, por lo que puedes usar solo lo que necesitas.
Brazadas
笔画模块是 Ink API 的基础。此模块中的关键数据类型包括:
StrokeInputBatch:表示一系列指针输入,包括其位置、时间戳,以及可选的压力、倾斜度和方向。InProgressStroke:表示正在绘制的笔画。InProgressStroke用于以低延迟渲染部分笔画,并在输入完成后构建最终的Stroke,之后该对象可以重复使用。InProgressStroke由InProgressStrokes可组合项使用。Stroke:已完成的笔画的不可变表示形式,具有固定的几何形状。每个Stroke都有一个ImmutableStrokeInputBatch(输入点)、一个Brush(样式)和一个PartitionedMesh(几何形状)。您可以在应用中存储、处理和渲染笔画。
Geometría
El módulo Geometry admite operaciones geométricas en formas primitivas (con clases específicas como Box y Vec), así como formas arbitrarias (con PartitionedMesh), incluida la detección y transformación de intersecciones. PartitionedMesh también puede contener datos adicionales para admitir la renderización.
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
El módulo storage proporciona utilidades para serializar y deserializar de manera eficiente los datos de trazos, principalmente enfocándose en StrokeInputBatch.
El módulo usa búferes de protocolo y técnicas de compresión delta optimizadas, lo que genera un ahorro de almacenamiento significativo en comparación con los métodos básicos.
El módulo de almacenamiento simplifica el guardado, la carga y el uso compartido de trazos.