Module

Die Ink API ist modularisiert, sodass Sie nur die Funktionen verwenden können, die Sie benötigen.

Schläge

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

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

Geometrie

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

Pinsel

Das Modul brush definiert den Stil von Strichen. Sie besteht aus zwei Hauptteilen:

  • Brush: Gibt den Stil eines Strichs an, einschließlich der Grundfarbe, der Grundgröße und BrushFamily. BrushFamily entspricht einer Schriftfamilie und definiert den Stil eines Strichs. Ein BrushFamily kann beispielsweise einen bestimmten Markierungs- oder Highlighterstil darstellen, sodass Striche mit unterschiedlichen Größen und Farben diesen Stil gemeinsam nutzen können.
  • StockBrushes: Stellt Factory-Funktionen zum Erstellen von einsatzbereiten BrushFamily-Instanzen bereit.

Autorentool

Mit dem Modul Authoring können Sie die Eingabe des Nutzerzeigers erfassen und in Echtzeit als Striche mit geringer Latenz auf dem Bildschirm rendern. Sie stellt eine InProgressStrokesView bereit, die Bewegungsereignisse verarbeitet und die Striche beim Zeichnen anzeigt.

Sobald ein Strich fertig ist, benachrichtigt die Ansicht die Clientanwendung über einen registrierten Callback (InProgressStrokesFinishedListener). Über den Callback kann die Anwendung den fertigen Strich zum Rendern oder Speichern abrufen.

Rendering

Mit dem Rendering-Modul können Sie Tuschestriche auf einem Android-Canvas zeichnen. Es bietet CanvasStrokeRenderer für Compose und ViewStrokeRenderer für auf Views basierende Layouts. Diese Renderer sind für das leistungsstarke Rendern konzipiert und tragen dazu bei, hochwertige Grafiken zu liefern, einschließlich Antialiasing.

Rufen Sie zum Rendern von Strichen die Methode create() auf, um eine CanvasStrokeRenderer-Instanz zu erhalten. Rufen Sie dann die Methode draw() auf, um entweder fertige (Stroke) oder laufende (InProgressStroke) Striche auf einem Canvas zu rendern.

Sie können die Arbeitsfläche transformieren, während Sie einen Strich zeichnen. Beispiele hierfür sind Schwenken, Zoomen und Drehen. Damit der Strich richtig gerendert wird, müssen Sie auch die canvas-Transformation an CanvasStrokeRenderer.draw übergeben.

Wenn Sie die canvas-Transformation nicht separat erfassen möchten, verwenden Sie stattdessen ViewStrokeRenderer.

Speicher

The storage module provides utilities for efficiently serializing and deserializing stroke data, primarily focusing on StrokeInputBatch.

The module uses protocol buffers and optimized delta compression techniques, resulting in significant storage savings compared to naive methods.

The storage module simplifies saving, loading, and sharing strokes.