模組

Ink API 採用模組化設計,因此您只需要使用所需功能。

筆觸

筆劃模組是 Ink API 的基礎,這個模組中的主要資料類型包括:

  • StrokeInputBatch:代表一系列指標輸入內容,包括位置、時間戳記,以及選用的壓力、傾斜度和方向。
  • InProgressStroke:代表正在繪製的筆劃。InProgressStroke 用於以低延遲時間算繪部分筆劃,並在輸入完成後建構最終的 Stroke,之後即可重複使用該物件。 InProgressStroke 由 InProgressStrokes 可組合函式使用。
  • Stroke:最終筆劃的不可變更表示法,具有固定幾何圖形。每個 Stroke 都有ImmutableStrokeInputBatch (輸入點)、Brush (樣式) 和PartitionedMesh (幾何形狀)。您可以在應用程式中儲存、操控及算繪筆劃。

幾何學

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

Brush

brush 模組會定義筆觸樣式。當中包含下列兩項主要元素:

  • Brush:指定筆觸的樣式,包括基本顏色、基本大小和 BrushFamily。BrushFamily 類似於字型系列,可定義筆觸的樣式。舉例來說,BrushFamily 可以代表特定樣式的標記或螢光筆,讓不同大小和顏色的筆觸共用該樣式。
  • StockBrushes:提供原廠函式,用於建立可立即使用的 BrushFamily 例項。

編寫

Compose Authoring 模組可擷取使用者觸控輸入內容,並即時在畫面上以低延遲筆觸呈現。這是透過 InProgressStrokes 可組合函式達成,該函式會處理動作事件,並在繪製筆劃時顯示筆劃。

筆劃完成後,可組合函式會使用 InProgressStrokesFinishedListener 回呼通知用戶端應用程式。應用程式可藉此擷取完成的筆劃,以進行算繪或儲存。

在 Compose 中,InProgressStrokes 會在 onStrokesFinished 參數中採用這個回呼。將完成的筆觸傳遞至另一個可組合函式,使用算繪模組將筆觸提交至畫面。

轉譯

使用 Rendering 模組,即可輕鬆在 Android Canvas 上繪製墨水筆觸。當中提供 Compose 的 CanvasStrokeRenderer 和以檢視區塊為基礎的版面配置 ViewStrokeRenderer。這些算繪器可提升算繪效能,並提供高品質的視覺效果,包括反鋸齒。

如要算繪筆劃,請呼叫 create() 方法取得 CanvasStrokeRenderer 例項,然後呼叫 draw() 方法,將完成 (Stroke) 或進行中 (InProgressStroke) 的筆劃算繪到 Canvas 上。

繪製筆觸時,你可以變形畫布。例如平移、縮放及旋轉。如要正確算繪筆觸,您也必須將 canvas 轉換傳遞至 CanvasStrokeRenderer.draw。

如要避免個別追蹤 canvas 轉換,請改用 ViewStrokeRenderer。

儲存空間

存储模块提供用于高效序列化和反序列化笔画数据的实用程序,主要侧重于 StrokeInputBatch。

该模块使用 Protocol Buffer 和优化的增量压缩技术,与简单的方法相比,可显著节省存储空间。

存储模块简化了笔画的保存、加载和分享。