मॉड्यूल

Ink API को मॉड्यूलर बनाया गया है, ताकि आप सिर्फ़ उन सुविधाओं का इस्तेमाल कर सकें जिनकी आपको ज़रूरत है.

स्ट्रोक

स्ट्रोक मॉड्यूल, Ink API का आधार है. इस मॉड्यूल में, मुख्य डेटा टाइप ये हैं:

• StrokeInputBatch: यह पॉइंटर इनपुट की सीरीज़ को दिखाता है. इसमें उनकी पोज़िशन, टाइमस्टैंप, और ज़रूरत के मुताबिक दबाव, झुकाव, और ओरिएंटेशन शामिल होता है.
• InProgressStroke: इससे ऐसे स्ट्रोक के बारे में पता चलता है जिसे अभी बनाया जा रहा है. InProgressStroke का इस्तेमाल, कम समय में कुछ स्ट्रोक रेंडर करने के लिए किया जाता है. साथ ही, इनपुट पूरा होने के बाद फ़ाइनल Stroke बनाने के लिए किया जाता है. इसके बाद, ऑब्जेक्ट का फिर से इस्तेमाल किया जा सकता है. InProgressStroke का इस्तेमाल InProgressStrokes कंपोज़ेबल करता है.
• Stroke: यह फ़ाइनल किए गए स्ट्रोक का ऐसा वर्शन होता है जिसे बदला नहीं जा सकता. इसमें तय की गई जियोमेट्री होती है. हर Stroke में ImmutableStrokeInputBatch (इनपुट पॉइंट), Brush (स्टाइल), और PartitionedMesh (ज्यामितीय आकार) होता है. अपने ऐप्लिकेशन में स्ट्रोक सेव किए जा सकते हैं, उनमें बदलाव किया जा सकता है, और उन्हें रेंडर किया जा सकता है.

रेखागणित

Geometry मॉड्यूल, प्रिमिटिव शेप (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 पर फ़ोकस करता है.

यह मॉड्यूल, प्रोटोकॉल बफ़र और ऑप्टिमाइज़ की गई डेल्टा कंप्रेशन तकनीकों का इस्तेमाल करता है. इससे, सामान्य तरीकों की तुलना में स्टोरेज की काफ़ी बचत होती है.

स्टोरेज मॉड्यूल की मदद से, स्ट्रोक को आसानी से सेव, लोड, और शेयर किया जा सकता है.