रॉ डेप्थ एपीआई, ऐसी कैमरा इमेज के लिए डेप्थ का डेटा उपलब्ध कराता है जो फ़ुल डेप्थ एपीआई के डेटा से ज़्यादा सटीक होती है. हालांकि, इसमें हर पिक्सल की जानकारी शामिल नहीं होती. रॉ डेप्थ इमेज और उनसे मेल खाने वाली कॉन्फ़िडेंस इमेज को भी प्रोसेस किया जा सकता है. इससे ऐप्लिकेशन, सिर्फ़ उस डेप्थ डेटा का इस्तेमाल कर पाएंगे जो उनके अलग-अलग इस्तेमाल के उदाहरण के लिए सटीक हो.
मेरे डिवाइस पर यह सुविधा काम नहीं करती
रॉ डेप्थ की सुविधा, डेप्थ एपीआई के साथ काम करने वाले सभी डिवाइसों पर उपलब्ध है. फ़ुल डेप्थ एपीआई की तरह रॉ डेप्थ एपीआई के लिए, काम करने वाले हार्डवेयर डेप्थ सेंसर की ज़रूरत नहीं होती. जैसे, फ़्लाइट का टाइम-ऑफ़-फ़्लाइट (ToF) सेंसर. हालांकि, रॉ डेप्थ एपीआई और फ़ुल डेप्थ एपीआई, दोनों ही ऐसे हार्डवेयर सेंसर का इस्तेमाल करते हैं जो डिवाइस पर काम करते हैं.
रॉ डेप्थ एपीआई बनाम पूरी डेप्थ एपीआई
रॉ डेप्थ एपीआई, ज़्यादा सटीक होने के साथ गहराई का अनुमान देता है. हालांकि, ऐसा हो सकता है कि रॉ डेप्थ वाली इमेज में, कैमरा इमेज के सभी पिक्सल के लिए गहराई के अनुमान शामिल न हों. इसके उलट, पूरी डेप्थ एपीआई हर पिक्सल के लिए अनुमानित डेप्थ की जानकारी देता है. हालांकि, डेप्थ के अनुमान को बेहतर तरीके से इस्तेमाल करने और इंटरपोलेशन की वजह से, हर पिक्सल की डेप्थ का डेटा कम सटीक हो सकता है. दोनों एपीआई में, डेप्थ इमेज का फ़ॉर्मैट और साइज़ एक जैसा है. सिर्फ़ कॉन्टेंट अलग होता है.
नीचे दी गई टेबल में, रॉ डेप्थ एपीआई और फ़ुल डेप्थ एपीआई के बीच के अंतर को दिखाया गया है. इसके लिए, किचन में मौजूद कुर्सी और टेबल की इमेज का इस्तेमाल किया गया है.
| एपीआई | रिटर्न | कैमरे की इमेज | डेप्थ इमेज | कॉन्फ़िडेंस इमेज |
|---|---|---|---|---|
| रॉ डेप्थ एपीआई |
|
|
|
|
| पूरी गहराई से एपीआई |
|
|
|
लागू नहीं |
कॉन्फ़िडेंस इमेज
रॉ डेप्थ एपीआई से मिलने वाली कॉन्फ़िडेंस इमेज में, हल्के पिक्सल का कॉन्फ़िडेंस वैल्यू ज़्यादा होती है. इसमें, सफ़ेद पिक्सल और काले रंग के पिक्सल से कोई कॉन्फ़िडेंस वैल्यू नहीं मिलती. आम तौर पर, कैमरा इमेज में मौजूद उन इलाकों की रॉ डेप्थ कॉन्फ़िडेंस इन जगहों के मुकाबले ज़्यादा होती है जहां ऐसा नहीं होता. जैसे, पेड़. जैसे: खाली दीवार. बिना बनावट वाली सतहें आम तौर पर शून्य मानती हैं.
अगर टारगेट किए गए डिवाइस में, काम करने वाला हार्डवेयर डेप्थ सेंसर मौजूद है, तो इमेज में कैमरे के काफ़ी करीब मौजूद जगहों पर भरोसे की संभावना ज़्यादा होगी. भले ही, उनमें कोई बनावट न हो.
कंप्यूट कॉस्ट
रॉ डेप्थ एपीआई की कंप्यूट लागत, फ़ुल डेप्थ एपीआई के लिए कंप्यूट की कुल लागत का आधा होता है.
उपयोग के उदाहरण
रॉ डेप्थ एपीआई की मदद से, इमेज की गहराई से जुड़ी जानकारी इकट्ठा की जा सकती है. इससे सीन में मौजूद ऑब्जेक्ट की ज्यामिति के बारे में ज़्यादा जानकारी मिलती है. एआर डेप्थ का रॉ डेटा, एआर के अनुभवों को बनाते समय काफ़ी मददगार हो सकता है. इसमें ज्यामिति को समझने वाले टास्क के लिए, ज़्यादा सटीक जानकारी और डेप्थ की ज़रूरत होती है. इस्तेमाल के कुछ उदाहरण:
- 3D रीकंस्ट्रक्शन
- आकलन
- आकार का पता लगाना
ज़रूरी शर्तें
पक्का करें कि आपको एआर के बुनियादी सिद्धांतों के बारे में पता हो साथ ही, आगे बढ़ने से पहले ARCore सेशन को कॉन्फ़िगर करने का तरीका जानें.
डेप्थ की सुविधा चालू करें
नए ARCore सेशन में, देखें कि उपयोगकर्ता के डिवाइस पर 'डेप्थ' सुविधा काम करती है या नहीं. प्रोसेसिंग पावर कम होने की वजह से, ARCore के साथ काम करने वाले सभी डिवाइस, डेप्थ एपीआई के साथ काम नहीं करते. संसाधन सेव करने के लिए, ARCore पर डिफ़ॉल्ट रूप से 'डेप्थ' सेटिंग बंद होती है. अपने ऐप्लिकेशन में डेप्थ एपीआई इस्तेमाल करने के लिए, डेप्थ मोड चालू करें.
int32_t is_depth_supported = 0; // Check whether the user's device supports the Depth API. ArSession_isDepthModeSupported(ar_session, AR_DEPTH_MODE_AUTOMATIC, &is_depth_supported); ArConfig* ar_config = NULL; ArConfig_create(ar_session, &ar_config); if (is_depth_supported) { ArConfig_setDepthMode(ar_session, ar_config, AR_DEPTH_MODE_AUTOMATIC); } CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS); ArConfig_destroy(ar_config);
नई रॉ डेप्थ इमेज पाएं
रॉ डेप्थ की नई रॉ इमेज पाने के लिए, ArFrame_acquireRawDepthImage16Bits() को कॉल करें.
int64_t previous_depth_image_timestamp_ns = -1; int64_t depth_image_timestamp_ns; ArImage* depth_image = NULL; // Acquire the raw depth image for the current frame. ArStatus acquire_image_status = ArFrame_acquireRawDepthImage16Bits(ar_session, ar_frame, &depth_image); if (acquire_image_status == AR_SUCCESS) { // Optional: compare raw depth image timestamps. Use this check if your app // uses only new depth data. ArImage_getTimestamp(ar_session, depth_image, &depth_image_timestamp_ns); if (depth_image_timestamp_ns != previous_depth_image_timestamp_ns) { // Raw depth image is based on new depth data. previous_depth_image_timestamp_ns = depth_image_timestamp_ns; // … } // Release the acquired image. ArImage_release(depth_image); }
रॉ डेप्थ एपीआई के ज़रिए दिखाए गए सभी इमेज पिक्सल में डेप्थ डेटा शामिल नहीं होगा. साथ ही, हर ARCore फ़्रेम में नई रॉ डेप्थ इमेज नहीं होगी. यह पता लगाने के लिए कि मौजूदा फ़्रेम के लिए रॉ डेप्थ इमेज नई है या नहीं, उसके टाइमस्टैंप की तुलना पिछली रॉ डेप्थ इमेज के टाइमस्टैंप से करें. अगर टाइमस्टैंप अलग-अलग हैं, तो रॉ डेप्थ इमेज, डेप्थ के नए डेटा के आधार पर होती है. अगर ऐसा नहीं है, तो डेप्थ इमेज, डेप्थ के पिछले डेटा का फिर से अनुमान दिखाती है.
नई कॉन्फ़िडेंस इमेज पाएं
कॉन्फ़िडेंस इमेज को पाने के लिए, ArFrame_acquireRawDepthConfidenceImage() को कॉल करें. रॉ डेप्थ के हर पिक्सल के सटीक होने के बारे में जानने के लिए, कॉन्फ़िडेंस इमेज का इस्तेमाल किया जा सकता है. कॉन्फ़िडेंस इमेज को Y8 फ़ॉर्मैट में दिखाया जाता है. हर पिक्सल 8-बिट वाला बिना साइन वाला पूर्णांक होता है. 0 सबसे कम कॉन्फ़िडेंस लेवल दिखाता है, जबकि 255 सबसे ज़्यादा कॉन्फ़िडेंस दिखाता है.
// Acquire the raw depth confidence image. ArImage* confidence_image = NULL; ArStatus acquire_image_status = ArFrame_acquireRawDepthConfidenceImage( ar_session, ar_frame, &confidence_image); if (acquire_image_status == AR_SUCCESS) { // … // Release the acquired image. ArImage_release(confidence_image); }