Modul

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

Gaya Renang

Modul stroke berfungsi sebagai dasar Ink API. Jenis data utama dalam modul ini adalah:

• StrokeInputBatch: Mewakili serangkaian input penunjuk, termasuk posisi, stempel waktu, dan secara opsional tekanan, kemiringan, dan orientasi.
• InProgressStroke: Mewakili goresan yang sedang digambar secara aktif. InProgressStroke digunakan untuk merender goresan sebagian dengan latensi rendah dan untuk membuat Stroke akhir setelah input selesai, setelah itu objek dapat digunakan kembali. InProgressStroke digunakan oleh composable InProgressStrokes.
• Stroke: Representasi goresan akhir yang tidak dapat diubah dengan geometri tetap. Setiap Stroke memiliki ImmutableStrokeInputBatch (titik input), Brush (gaya), dan PartitionedMesh (bentuk geometris). Anda dapat menyimpan, memanipulasi, dan merender guratan dalam aplikasi Anda.

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

The Compose Authoring module lets you capture user touch input and render it as low-latency strokes on the screen in real time. This is achieved through the InProgressStrokes composable, which processes motion events and displays the strokes as they are drawn.

Once a stroke is completed, the composable notifies the client application using an InProgressStrokesFinishedListener callback. This allows the application to retrieve the finished strokes for rendering or storage.

In Compose, InProgressStrokes takes this callback in the onStrokesFinished parameter. Pass the finished strokes to another composable to commit them to the screen using the rendering module.

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.