Modul

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

Gaya Renang

The strokes module serves as the foundation of the Ink API. Key data types within this module are:

  • StrokeInputBatch: Represents a series of pointer inputs, including their position, timestamp, and optionally pressure, tilt, and orientation.
  • InProgressStroke: Represents a stroke that is actively being drawn. InProgressStroke is used to render partial strokes with low latency and to build the final Stroke once input is complete, after which the object can be reused. `InProgressStroke is used by InProgressStrokesView.
  • Stroke: An immutable representation of a finalized stroke with fixed geometry. Each Stroke has an ImmutableStrokeInputBatch (input points), a Brush (style), and a PartitionedMesh (geometric shape). You can store, manipulate, and render strokes within your application.

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

Modul Penulisan memungkinkan Anda merekam input penunjuk pengguna dan merendernya sebagai goresan latensi rendah di layar secara real time. Objek ini menyediakan InProgressStrokesView, yang memproses peristiwa gerakan dan menampilkan goresan saat digambar.

Setelah goresan selesai, tampilan akan memberi tahu aplikasi klien melalui callback terdaftar (InProgressStrokesFinishedListener). Callback ini memungkinkan aplikasi mengambil goresan yang telah selesai untuk dirender atau disimpan.

Rendering

Modul Rendering membantu Anda menggambar goresan tinta di Canvas Android. Library ini menyediakan CanvasStrokeRenderer untuk Compose dan ViewStrokeRenderer untuk tata letak berbasis tampilan. Renderer ini dirancang untuk rendering berperforma tinggi dan membantu memberikan visual berkualitas tinggi, termasuk antialiasing.

Untuk merender goresan, panggil metode create() untuk mendapatkan instance CanvasStrokeRenderer. Kemudian, panggil metode draw() untuk merender goresan yang sudah selesai (Stroke) atau sedang berlangsung (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.