Modüller

Ink API modüler hale getirildiğinden yalnızca ihtiyacınız olanı kullanabilirsiniz.

Vuruşlar

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 the InProgressStrokes composable.
  • 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

The Geometry module supports geometric operations on primitive shapes (using dedicated classes like Box and Vec), as well as arbitrary shapes (using PartitionedMesh), including intersection detection and transformation. PartitionedMesh can also hold additional data to support rendering.

Fırça

The brush module defines the style of strokes. It consists of two main parts:

  • Brush: Specifies the style of a stroke including base color, base size, and BrushFamily. BrushFamily is analogous to a font family, it defines a stroke's style. For example, a BrushFamily can represent a specific style of marker or highlighter, allowing strokes with different sizes and colors to share that style.
  • StockBrushes: Provides factory functions for creating ready-to-use BrushFamily instances.

Yazma

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.

Oluşturma

Oluşturma modülü, Android'de mürekkep darbeleri çizme işlemini kolaylaştırır. Canvas Oluşturma için CanvasStrokeRenderer, görüntülemeye dayalı düzenler için ViewStrokeRenderer sağlar. Bu oluşturucular, oluşturma performansını optimize eder ve kenarları yumuşatma da dahil olmak üzere yüksek kaliteli görseller sunmaya yardımcı olur.

Konturları oluşturmak için create() yöntemini çağırarak bir CanvasStrokeRenderer örneği alın ve ardından draw() yöntemini çağırarak tamamlanmış (Stroke) veya devam eden (InProgressStroke) konturları Canvas üzerine oluşturun.

Fırça darbesi çizerken tuvali dönüştürebilirsiniz. Örnek olarak kaydırma, yakınlaştırma ve döndürme verilebilir. Konturun doğru şekilde oluşturulması için canvas dönüşümünü CanvasStrokeRenderer.draw'ye de aktarmanız gerekir.

canvas dönüşümünün ayrı olarak izlenmesini önlemek için bunun yerine ViewStrokeRenderer kullanın.

Depolama

Depolama modülü, öncelikle StrokeInputBatch'ye odaklanarak kontur verilerini verimli bir şekilde serileştirme ve seri durumdan çıkarma için yardımcı programlar sağlar.

Modül, protokol arabellekleri ve optimize edilmiş delta sıkıştırma tekniklerini kullanır. Bu sayede, basit yöntemlere kıyasla depolama alanında önemli ölçüde tasarruf sağlanır.

Depolama modülü, vuruşları kaydetme, yükleme ve paylaşma işlemlerini kolaylaştırır.