Ink API को मॉड्यूलर बनाया गया है, ताकि आप सिर्फ़ उन सुविधाओं का इस्तेमाल कर सकें जिनकी आपको ज़रूरत है.
स्ट्रोक
स्ट्रोक मॉड्यूल, Ink API का आधार है. इस मॉड्यूल में, मुख्य डेटा टाइप ये हैं:
StrokeInputBatch: यह पॉइंटर इनपुट की सीरीज़ को दिखाता है. इसमें उनकी पोज़िशन, टाइमस्टैंप, और ज़रूरत के मुताबिक दबाव, झुकाव, और ओरिएंटेशन शामिल होता है.InProgressStroke: इससे ऐसे स्ट्रोक के बारे में पता चलता है जिसे अभी बनाया जा रहा है.InProgressStrokeका इस्तेमाल, कम समय में कुछ स्ट्रोक रेंडर करने के लिए किया जाता है. साथ ही, इनपुट पूरा होने के बाद फ़ाइनलStrokeबनाने के लिए किया जाता है. इसके बाद, ऑब्जेक्ट का फिर से इस्तेमाल किया जा सकता है.InProgressStrokeका इस्तेमालInProgressStrokesकंपोज़ेबल करता है.Stroke: यह फ़ाइनल किए गए स्ट्रोक का ऐसा वर्शन होता है जिसे बदला नहीं जा सकता. इसमें तय की गई जियोमेट्री होती है. हरStrokeमेंImmutableStrokeInputBatch(इनपुट पॉइंट),Brush(स्टाइल), औरPartitionedMesh(ज्यामितीय आकार) होता है. अपने ऐप्लिकेशन में स्ट्रोक सेव किए जा सकते हैं, उनमें बदलाव किया जा सकता है, और उन्हें रेंडर किया जा सकता है.
रेखागणित
几何图形模块支持对基本形状(使用 Box 和 Vec 等专用类)以及任意形状(使用 PartitionedMesh)进行几何运算,包括相交检测和转换。 PartitionedMesh 还可以保存其他数据以支持渲染。
ब्रश
brush मॉड्यूल, स्ट्रोक की स्टाइल तय करता है. इसके दो मुख्य हिस्से होते हैं:
Brush: इससे स्ट्रोक की स्टाइल के बारे में पता चलता है. इसमें बेस कलर, बेस साइज़, औरBrushFamilyशामिल हैं.BrushFamily, फ़ॉन्ट फ़ैमिली की तरह होता है. यह स्ट्रोक की स्टाइल तय करता है. उदाहरण के लिए,BrushFamilyकिसी खास स्टाइल के मार्कर या हाइलाइटर को दिखा सकता है. इससे अलग-अलग साइज़ और रंग के स्ट्रोक, उस स्टाइल को शेयर कर सकते हैं.StockBrushes: इसमें फ़ैक्ट्री फ़ंक्शन दिए गए हैं. इनकी मदद से, इस्तेमाल के लिए तैयारBrushFamilyइंस्टेंस बनाए जा सकते हैं.
लिखना
借助 Compose 创作模块,您可以捕获用户触摸输入,并将其实时呈现为屏幕上的低延迟笔画。这是通过 InProgressStrokes 可组合项实现的,该可组合项可处理运动事件并在绘制笔画时显示笔画。
笔画完成后,可组合项会使用 InProgressStrokesFinishedListener 回调通知客户端应用。这允许应用检索完成的笔画以进行渲染或存储。
在 Compose 中,InProgressStrokes 通过 onStrokesFinished 参数接收此回调。将完成的笔画传递给另一个可组合项,以使用渲染模块将其提交到屏幕。
रेंडरिंग
रेंडरिंग मॉड्यूल की मदद से, Android Canvas पर इंक स्ट्रोक आसानी से बनाए जा सकते हैं.
यह कंपोज़ के लिए CanvasStrokeRenderer और व्यू के आधार पर लेआउट के लिए ViewStrokeRenderer उपलब्ध कराता है. ये रेंडरर, रेंडरिंग की परफ़ॉर्मेंस को ऑप्टिमाइज़ करते हैं. साथ ही, अच्छी क्वालिटी के विज़ुअल डिलीवर करने में मदद करते हैं. इनमें ऐंटीएलियासिंग भी शामिल है.
स्ट्रोक रेंडर करने के लिए, create() तरीके को कॉल करके CanvasStrokeRenderer इंस्टेंस पाएं. इसके बाद, draw() तरीके को कॉल करके, पूरे हो चुके (Stroke) या प्रोसेस में मौजूद (InProgressStroke) स्ट्रोक को Canvas पर रेंडर करें.
स्ट्रोक बनाते समय, कैनवस को बदला जा सकता है. उदाहरण के लिए, पैनिंग, ज़ूमिंग, और रोटेटिंग. स्ट्रोक को सही तरीके से रेंडर करने के लिए, आपको canvas ट्रांसफ़ॉर्म को CanvasStrokeRenderer.draw में पास करना होगा.
canvas ट्रांसफ़ॉर्म को अलग से ट्रैक करने से बचने के लिए, ViewStrokeRenderer का इस्तेमाल करें.
स्टोरेज
存储模块提供用于高效序列化和反序列化笔画数据的实用程序,主要侧重于 StrokeInputBatch。
该模块使用 Protocol Buffer 和优化的增量压缩技术,与简单的方法相比,可显著节省存储空间。
存储模块简化了笔画的保存、加载和分享。