मॉड्यूल

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

स्ट्रोक

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

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

रेखागणित

Geometry मॉड्यूल, प्रिमिटिव शेप (Box और Vec जैसे खास क्लास का इस्तेमाल करके) के साथ-साथ आर्बिट्ररी शेप (PartitionedMesh का इस्तेमाल करके) पर ज्यामितीय कार्रवाइयों को सपोर्ट करता है. इनमें इंटरसेक्शन का पता लगाना और ट्रांसफ़ॉर्मेशन शामिल है. PartitionedMesh में रेंडरिंग के लिए, अतिरिक्त डेटा भी सेव किया जा सकता है.

ब्रश

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.

लिखना

Compose Authoring मॉड्यूल की मदद से, उपयोगकर्ता के टच इनपुट को कैप्चर किया जा सकता है. साथ ही, इसे रीयल टाइम में स्क्रीन पर कम समय में दिखने वाले स्ट्रोक के तौर पर रेंडर किया जा सकता है. इसे InProgressStrokes कंपोज़ेबल की मदद से हासिल किया जाता है. यह मोशन इवेंट को प्रोसेस करता है और स्ट्रोक को वैसे ही दिखाता है जैसे उन्हें बनाया गया है.

स्ट्रोक पूरा होने के बाद, कंपोज़ेबल, क्लाइंट ऐप्लिकेशन को InProgressStrokesFinishedListener कॉलबैक का इस्तेमाल करके सूचना देता है. इससे ऐप्लिकेशन को रेंडरिंग या स्टोरेज के लिए, पूरे स्ट्रोक वापस पाने की अनुमति मिलती है.

Compose में, InProgressStrokes इस कॉलबैक को onStrokesFinished पैरामीटर में लेता है. रेंडरिंग मॉड्यूल का इस्तेमाल करके, पूरे हो चुके स्ट्रोक को किसी दूसरे कंपोज़ेबल को पास करें, ताकि उन्हें स्क्रीन पर दिखाया जा सके.

रेंडरिंग

रेंडरिंग मॉड्यूल की मदद से, Android Canvas पर इंक स्ट्रोक आसानी से बनाए जा सकते हैं. यह कंपोज़ के लिए CanvasStrokeRenderer और व्यू के आधार पर लेआउट के लिए ViewStrokeRenderer उपलब्ध कराता है. ये रेंडरर, रेंडरिंग की परफ़ॉर्मेंस को ऑप्टिमाइज़ करते हैं. साथ ही, अच्छी क्वालिटी के विज़ुअल डिलीवर करने में मदद करते हैं. इनमें ऐंटीएलियासिंग भी शामिल है.

स्ट्रोक रेंडर करने के लिए, create() तरीके को कॉल करके CanvasStrokeRenderer इंस्टेंस पाएं. इसके बाद, draw() तरीके को कॉल करके, पूरे हो चुके (Stroke) या प्रोसेस में मौजूद (InProgressStroke) स्ट्रोक को Canvas पर रेंडर करें.

स्ट्रोक बनाते समय, कैनवस को बदला जा सकता है. उदाहरण के लिए, पैनिंग, ज़ूमिंग, और रोटेटिंग. स्ट्रोक को सही तरीके से रेंडर करने के लिए, आपको canvas ट्रांसफ़ॉर्म को CanvasStrokeRenderer.draw में पास करना होगा.

canvas ट्रांसफ़ॉर्म को अलग से ट्रैक करने से बचने के लिए, ViewStrokeRenderer का इस्तेमाल करें.

स्टोरेज

डिवाइस का स्टोरेज मॉड्यूल, स्ट्रोक डेटा को बेहतर तरीके से क्रम से लगाने और क्रम से हटाने के लिए उपयोगिता उपलब्ध कराता है. यह मुख्य रूप से StrokeInputBatch पर फ़ोकस करता है.

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

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