Modul

Ink API dimodularisasi, sehingga Anda hanya dapat menggunakan apa yang Anda butuhkan.

Gaya Renang

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

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

Geometri

Modul Geometry mendukung operasi geometris pada bentuk dasar (menggunakan class khusus seperti Box dan Vec), serta bentuk arbitrer (menggunakan PartitionedMesh), termasuk deteksi dan transformasi persimpangan. PartitionedMesh juga dapat menyimpan data tambahan untuk mendukung rendering.

Kuas

Modul brush menentukan gaya goresan. Framework ini terdiri dari dua bagian utama:

• Brush: Menentukan gaya goresan, termasuk warna dasar, ukuran dasar, dan BrushFamily. BrushFamily serupa dengan jenis font, yang menentukan gaya goresan. Misalnya, BrushFamily dapat merepresentasikan gaya penanda atau penyorot tertentu, sehingga memungkinkan goresan dengan ukuran dan warna yang berbeda untuk berbagi gaya tersebut.
• StockBrushes: Menyediakan fungsi factory untuk membuat instance BrushFamily yang siap digunakan.

Pembuatan

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

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

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

Rendering

Modul Rendering menyederhanakan penggambaran goresan tinta ke Canvas Android. Library ini menyediakan CanvasStrokeRenderer untuk Compose dan ViewStrokeRenderer untuk tata letak berbasis tampilan. Renderer ini mengoptimalkan performa rendering dan membantu memberikan visual berkualitas tinggi, termasuk antialiasing.

Untuk merender goresan, panggil metode create() untuk mendapatkan instance CanvasStrokeRenderer, lalu panggil metode draw() untuk merender goresan yang sudah selesai (Stroke) atau sedang dalam proses (InProgressStroke) ke Canvas.

Anda dapat mengubah kanvas saat menggambar goresan. Contohnya mencakup menggeser, melakukan zoom, dan memutar. Untuk merender goresan dengan benar, Anda juga harus meneruskan transformasi canvas ke CanvasStrokeRenderer.draw.

Untuk menghindari pelacakan transformasi canvas secara terpisah, gunakan ViewStrokeRenderer.

Penyimpanan

Modul storage menyediakan utilitas untuk membuat serialisasi dan deserialisasi data goresan secara efisien, terutama berfokus pada StrokeInputBatch.

Modul ini menggunakan buffer protokol dan teknik kompresi delta yang dioptimalkan, sehingga menghasilkan penghematan penyimpanan yang signifikan dibandingkan dengan metode biasa.

Modul penyimpanan menyederhanakan penyimpanan, pemuatan, dan berbagi goresan.