Modüller

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

Vuruşlar

Vuruşlar modülü, Ink API'nin temelini oluşturur. Bu modüldeki önemli veri türleri şunlardır:

• StrokeInputBatch: Konum, zaman damgası ve isteğe bağlı olarak basınç, eğim ve yön dahil olmak üzere bir dizi işaretçi girişini temsil eder.
• InProgressStroke: Aktif olarak çizilen bir konturu temsil eder. InProgressStroke, düşük gecikmeyle kısmi vuruşlar oluşturmak ve giriş tamamlandıktan sonra nihai Stroke'yi oluşturmak için kullanılır. Ardından nesne yeniden kullanılabilir. InProgressStroke, InProgressStrokes composable'ı tarafından kullanılır.
• Stroke: Geometrisi sabitlenmiş, sonlandırılmış bir konturun değişmez gösterimi. Her Stroke, ImmutableStrokeInputBatch (giriş noktaları), Brush (stil) ve PartitionedMesh (geometrik şekil) içerir. Uygulamanızda konturları depolayabilir, değiştirebilir ve oluşturabilirsiniz.

Geometri

Geometry modülü, kesişim algılama ve dönüştürme dahil olmak üzere, ilkel şekiller (Box ve Vec gibi özel sınıflar kullanılarak) ve rastgele şekiller (PartitionedMesh kullanılarak) üzerinde geometrik işlemleri destekler. PartitionedMesh, oluşturmayı desteklemek için ek veriler de içerebilir.

Fırça

brush modülü, konturların stilini tanımlar. İki ana bölümden oluşur:

• Brush: Temel renk, temel boyut ve BrushFamily dahil olmak üzere bir konturun stilini belirtir. BrushFamily, yazı tipi ailesine benzer ve konturun stilini tanımlar. Örneğin, BrushFamily belirli bir işaretleyici veya vurgulayıcı stilini temsil edebilir. Bu sayede, farklı boyut ve renklerdeki çizgiler bu stili paylaşabilir.
• StockBrushes: Kullanıma hazır BrushFamily örnekleri oluşturmak için fabrika işlevleri sağlar.

Yazma

Oluşturma Yazma modülü, kullanıcı dokunma girişini yakalamanıza ve bunu ekranda düşük gecikmeli vuruşlar olarak gerçek zamanlı şekilde oluşturmanıza olanak tanır. Bu, hareket etkinliklerini işleyen ve fırça darbelerini çizildikleri sırada gösteren InProgressStrokes composable ile sağlanır.

Bir vuruş tamamlandığında composable, InProgressStrokesFinishedListener geri çağırma işlevini kullanarak istemci uygulamasını bilgilendirir. Bu sayede uygulama, oluşturma veya depolama için tamamlanmış vuruşları alabilir.

Compose'da InProgressStrokes, onStrokesFinished parametresinde bu geri çağırmayı alır. Bitmiş konturları, rendering modülünü kullanarak ekrana aktarmak için başka bir composable'a iletin.

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.