Moduli

L'API Ink è modulare, quindi puoi utilizzare solo ciò che ti serve.

Bracciate

Il modulo tratti funge da base dell'API Ink. I tipi di dati chiave all'interno di questo modulo sono:

• StrokeInputBatch: rappresenta una serie di input del puntatore, inclusi posizione, timestamp e, facoltativamente, pressione, inclinazione e orientamento.
• InProgressStroke: Rappresenta un tratto in fase di disegno. InProgressStroke viene utilizzato per eseguire il rendering di tratti parziali con bassa latenza e per creare il Stroke finale una volta completato l'input, dopodiché l'oggetto può essere riutilizzato. InProgressStroke è utilizzato dal componibile InProgressStrokes.
• Stroke: una rappresentazione immutabile di un tratto finalizzato con geometria fissa. Ogni Stroke ha un ImmutableStrokeInputBatch (punti di input), uno Brush (stile) e una PartitionedMesh (forma geometrica). Puoi archiviare, manipolare e visualizzare i tratti all'interno dell'applicazione.

Geometria

Il modulo Geometry supporta operazioni geometriche su forme primitive (utilizzando classi dedicate come Box e Vec), nonché forme arbitrarie (utilizzando PartitionedMesh), tra cui il rilevamento e la trasformazione delle intersezioni. PartitionedMesh può contenere anche dati aggiuntivi per supportare il rendering.

Pennello

Il modulo brush definisce lo stile dei tratti. È costituito da due parti principali:

• Brush: specifica lo stile di un tratto, inclusi colore di base, dimensione di base e BrushFamily. BrushFamily è analogo a una famiglia di caratteri e definisce lo stile di un tratto. Ad esempio, un BrushFamily può rappresentare uno stile specifico di pennarello o evidenziatore, consentendo a tratti di dimensioni e colori diversi di condividere lo stesso stile.
• StockBrushes: fornisce funzioni di fabbrica per la creazione di istanze BrushFamily pronte all'uso.

Authoring

Il modulo Compose Authoring ti consente di acquisire l'input tocco dell'utente e di eseguirne il rendering come tratti a bassa latenza sullo schermo in tempo reale. Ciò si ottiene tramite il componente componibile InProgressStrokes, che elabora gli eventi di movimento e mostra i tratti man mano che vengono disegnati.

Una volta completato un tratto, il componente composable invia una notifica all'applicazione client utilizzando un callback InProgressStrokesFinishedListener. Ciò consente all'applicazione di recuperare i tratti completati per il rendering o l'archiviazione.

In Compose, InProgressStrokes accetta questo callback nel parametro onStrokesFinished. Passa i tratti finiti a un altro componibile per visualizzarli sullo schermo utilizzando il modulo di rendering.

Rendering

Il modulo Rendering semplifica il disegno di tratti di inchiostro su un Canvas Android. Fornisce CanvasStrokeRenderer per Compose e ViewStrokeRenderer per i layout basati sulle visualizzazioni. Questi renderer ottimizzano le prestazioni di rendering e contribuiscono a fornire immagini di alta qualità, incluso l'antialiasing.

Per eseguire il rendering dei tratti, chiama il metodo create() per ottenere un'istanza CanvasStrokeRenderer, quindi chiama il metodo draw() per eseguire il rendering dei tratti finiti (Stroke) o in corso (InProgressStroke) su un Canvas.

Puoi trasformare il canvas quando disegni un tratto. Alcuni esempi includono panoramica, zoom e rotazione. Per eseguire il rendering del tratto correttamente, devi anche passare la trasformazione canvas a CanvasStrokeRenderer.draw.

Per evitare di monitorare separatamente la trasformazione canvas, utilizza ViewStrokeRenderer.

Spazio di archiviazione

Il modulo storage fornisce utilità per serializzare e deserializzare in modo efficiente i dati dei tratti, concentrandosi principalmente su StrokeInputBatch.

Il modulo utilizza protocol buffers e tecniche di compressione delta ottimizzate, con un conseguente risparmio significativo dello spazio di archiviazione rispetto ai metodi semplici.

Il modulo di archiviazione semplifica il salvataggio, il caricamento e la condivisione dei tratti.