XR_ANDROID_depth_texture OpenXR एक्सटेंशन

Name String

XR_ANDROID_depth_texture

एक्सटेंशन टाइप

इंस्टेंस एक्सटेंशन

रजिस्टर किया गया एक्सटेंशन नंबर

703

बदलाव

1

एक्सटेंशन और वर्शन की डिपेंडेंसी

OpenXR 1.0

पिछली बार बदलाव करने की तारीख

2024-09-11

आईपी स्टेटस

आईपी पर कोई दावा नहीं किया गया है.

योगदान देने वाले

सुशांत कुलकर्णी, Google

केर्न ओवरटर्फ़, Google

स्पेंसर क्विन, Google

लेवाना चेन, Google

खास जानकारी

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

इस एक्सटेंशन का मकसद, ऑब्स्क्यूज़न, हिट जांच, और ऐसे अन्य खास टास्क के लिए रॉ और स्मूद डेप्थ दिखाना है जिनमें सीन की सटीक ज्यामिति का इस्तेमाल किया जाता है. उदाहरण के लिए, नकली चेहरे का पता लगाना.

चेतावनी:

अनुमतियां
यह एक्सटेंशन, व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) से जुड़ी समस्याओं को कम करने के लिए, कम किए गए डेप्थ टेक्स्चर को दिखाता है. Android ऐप्लिकेशन के मेनिफ़ेस्ट में android.permission.SCENE_UNDERSTANDING अनुमति होनी चाहिए, क्योंकि यह एक्सटेंशन, एनवायरमेंट की ज्यामिति को दिखाता है.

android.permission.SCENE_UNDERSTANDING अनुमति को खतरनाक माना जाता है. इन फ़ंक्शन का इस्तेमाल करने के लिए, ऐप्लिकेशन को रनटाइम के समय अनुमति का अनुरोध करना होगा:
xrCreateDepthSwapchainANDROID
(सुरक्षा का लेवल: खतरनाक)

सिस्टम की क्षमता की जांच करना

XrSystemDepthTrackingPropertiesANDROID स्ट्रक्चर को इस तरह से परिभाषित किया गया है:

typedef struct XrSystemDepthTrackingPropertiesANDROID {
    XrStructureType    type;
    const void*        next;
    XrBool32           supportsDepthTracking;
} XrSystemDepthTrackingPropertiesANDROID;

पैसे चुकाकर बने सदस्यों के ब्यौरे

• type इस स्ट्रक्चर का XrStructureType है.
• next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है. OpenXR के मुख्य वर्शन या इस एक्सटेंशन में, इस तरह के स्ट्रक्चर तय नहीं किए गए हैं.
• supportsDepthTracking एक XrBool32 है, जिससे पता चलता है कि मौजूदा सिस्टम में, गहराई ट्रैकिंग की सुविधा काम करती है या नहीं.

कोई ऐप्लिकेशन, xrGetSystemProperties को कॉल करते समय, XrSystemDepthTrackingPropertiesANDROID स्ट्रक्चर के साथ XrSystemProperties को एक्सटेंड करके, यह जांच कर सकता है कि सिस्टम में डेप्थ ट्रैकिंग की सुविधा है या नहीं.

मान्य इस्तेमाल (इंप्लिसिट)

• XrSystemDepthTrackingPropertiesANDROID का इस्तेमाल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना चाहिए
• type होनी चाहिए XR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROID
• next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए

क्वेरी की गहराई के हिसाब से रिज़ॉल्यूशन

xrEnumerateDepthResolutionsANDROID फ़ंक्शन को इस तरह से परिभाषित किया गया है:

XrResult xrEnumerateDepthResolutionsANDROID(
    XrSession                                   session,
    uint32_t                                    resolutionCapacityInput,
    uint32_t*                                   resolutionCountOutput,
    XrDepthCameraResolutionANDROID*             resolutions);

पैरामीटर की जानकारी

• session, XrSession है, जो काम करने वाले रिज़ॉल्यूशन की जानकारी देता है.
• resolutionCapacityInput, resolutions की क्षमता है या ज़रूरी क्षमता पाने के लिए 0.
• resolutionCountOutput, लिखे गए uint64_t resolutions की संख्या का पॉइंटर है. इसके अलावा, अगर resolutionCapacityInput की संख्या काफ़ी नहीं है, तो resolutionCountOutput ज़रूरी क्षमता का पॉइंटर है.
• resolutions, XrDepthCameraResolutionANDROID के ऐरे का पॉइंटर है. हालांकि, अगर resolutionCapacityInput 0 है, तो यह NULL हो सकता है.
• ज़रूरी resolutions साइज़ को वापस पाने के बारे में पूरी जानकारी के लिए, बफ़र साइज़ पैरामीटर सेक्शन देखें.

xrEnumerateDepthResolutionsANDROID, मौजूदा सेशन में काम करने वाले डेप्थ रिज़ॉल्यूशन की जानकारी देता है. डेप्थ रिज़ॉल्यूशन, रनटाइम की प्राथमिकता के हिसाब से सबसे ज़्यादा से सबसे कम के क्रम में होने चाहिए. ऐप्लिकेशन को सबसे अच्छी परफ़ॉर्मेंस और क्वालिटी के लिए, सबसे ज़्यादा प्राथमिकता का इस्तेमाल करना चाहिए.

मान्य इस्तेमाल (इंप्लिसिट)

• xrEnumerateDepthResolutionsANDROID को कॉल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना चाहिए
• session यह एक मान्य XrSession हैंडल होना चाहिए
• resolutionCountOutput, uint32_t वैल्यू का पॉइंटर होना चाहिए
• अगर resolutionCapacityInput 0 नहीं है, तो resolutions resolutionCapacityInputXrDepthCameraResolutionANDROID वैल्यू के ऐरे का पॉइंटर होना चाहिए

रिटर्न कोड

सफलता

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

प्रोसेस पूरी नहीं हो सकी

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_VALIDATION_FAILURE
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_SESSION_LOST
• XR_ERROR_SIZE_INSUFFICIENT

XrDepthCameraResolutionANDROID एनम, XrDepthSwapchainANDROID बनाते समय, काम करने वाले डेप्थ रिज़ॉल्यूशन के बारे में बताता है.

typedef enum XrDepthCameraResolutionANDROID {
    XR_DEPTH_CAMERA_RESOLUTION_80x80_ANDROID = 0,
    XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID = 1,
    XR_DEPTH_CAMERA_RESOLUTION_320x320_ANDROID = 2
    } XrDepthCameraResolutionANDROID;

एनोमेरेंट की जानकारी

• XR_DEPTH_CAMERA_RESOLUTION_80x80_ANDROID — डीपथ और कॉन्फ़िडेंस इमेज का रिज़ॉल्यूशन 80x80 होना चाहिए.
• XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID — डीपथ और कॉन्फ़िडेंस इमेज का रिज़ॉल्यूशन 160x160 होना चाहिए.
• XR_DEPTH_CAMERA_RESOLUTION_320x320_ANDROID — डेप्थ और कॉन्फ़िडेंस इमेज का रिज़ॉल्यूशन 320x320 है.

डेप्थ स्वैपचैन बनाना

XR_DEFINE_HANDLE(XrDepthSwapchainANDROID)

XrDepthSwapchainANDROID, डेप्थ स्वैपचैन हैंडल है.

xrCreateDepthSwapchainANDROID फ़ंक्शन को इस तरह परिभाषित किया गया है:

XrResult xrCreateDepthSwapchainANDROID(
    XrSession                                   session,
    const XrDepthSwapchainCreateInfoANDROID*    createInfo,
    XrDepthSwapchainANDROID*                    swapchain);

पैरामीटर की जानकारी

• session वह XrSession है जो डेप्थ स्वैपचैन बनाता है.

• createInfo, XrDepthSwapchainCreateInfoANDROID स्ट्रक्चर का एक पॉइंटर है. इसमें ऐसे पैरामीटर होते हैं जिनका इस्तेमाल, स्वैपचैन बनाने के लिए किया जाता है.

• swapchain, उस हैंडल का पॉइंटर है जिसमें बनाया गया XrDepthSwapchainANDROID दिखाया जाता है.

ऐप्लिकेशन, डेप्थ स्वैपचैन बनाने के लिए xrCreateDepthSwapchainANDROID फ़ंक्शन का इस्तेमाल कर सकता है. यह डेप्थ और कॉन्फ़िडेंस इमेज, दोनों को मैनेज करता है.

एपीआई कॉल में, डीपथ स्वैपचैन हैंडल का इस्तेमाल किया जा सकता है. XrDepthSwapchainANDROID हैंडल को आखिर में xrDestroyDepthSwapchainANDROID फ़ंक्शन का इस्तेमाल करके खाली करना ज़रूरी है.

मान्य इस्तेमाल (इंप्लिसिट)

• xrCreateDepthSwapchainANDROID को कॉल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना चाहिए
• session यह एक मान्य XrSession हैंडल होना चाहिए
• createInfo XrDepthSwapchainCreateInfoANDROID स्ट्रक्चर के लिए, मान्य पॉइंटर होना चाहिए
• swapchain XrDepthSwapchainANDROID हैंडल का पॉइंटर होना चाहिए

रिटर्न कोड

सफलता

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

प्रोसेस पूरी नहीं हो सकी

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_SESSION_LOST
• XR_ERROR_OUT_OF_MEMORY
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_LIMIT_REACHED

XrDepthSwapchainCreateInfoANDROID स्ट्रक्चर को इस तरह परिभाषित किया गया है:

typedef struct XrDepthSwapchainCreateInfoANDROID {
    XrStructureType                       type;
    const void*                           next;
    XrDepthCameraResolutionANDROID        resolution;
    XrDepthSwapchainCreateFlagsANDROID    createFlags;
} XrDepthSwapchainCreateInfoANDROID;

पैसे चुकाकर बने सदस्यों के ब्यौरे

• type इस स्ट्रक्चर का XrStructureType है.
• next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है. OpenXR के मुख्य वर्शन या इस एक्सटेंशन में, इस तरह के स्ट्रक्चर तय नहीं किए गए हैं.
• resolution, XrDepthCameraResolutionANDROID है. इसमें, डेप्थ और कॉन्फ़िडेंस टेक्सचर बनाने चाहिए.
• createFlags एक या एक से ज़्यादा XrDepthSwapchainCreateFlagsANDROID है.

XrDepthSwapchainCreateInfoANDROID स्ट्रक्चर, xrCreateDepthSwapchainANDROID में पास किए जाने पर, XrDepthSwapchainANDROID बनाने के विकल्प उपलब्ध कराता है.

मान्य इस्तेमाल (इंप्लिसिट)

• XrDepthSwapchainCreateInfoANDROID का इस्तेमाल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना ज़रूरी है
• type होनी चाहिए XR_TYPE_DEPTH_SWAPCHAIN_CREATE_INFO_ANDROID
• next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए
• resolution XrDepthCameraResolutionANDROID की मान्य वैल्यू होनी चाहिए
• createFlags XrDepthSwapchainCreateFlagBitsANDROID वैल्यू का मान्य कॉम्बिनेशन होना चाहिए
• createFlags को 0 नहीं होना चाहिए

XrDepthSwapchainCreateFlagsANDROID, XrDepthSwapchainANDROID बनाने के विकल्पों के बारे में बताता है.

typedef XrFlags64 XrDepthSwapchainCreateFlagsANDROID;

XrDepthSwapchainCreateFlagsANDROID के लिए मान्य बिट, XrDepthSwapchainCreateFlagBitsANDROID से तय किए जाते हैं. इन बिट के बारे में यहां बताया गया है:

// Flag bits for XrDepthSwapchainCreateFlagsANDROID
static const XrDepthSwapchainCreateFlagsANDROID XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID = 0x00000001;
static const XrDepthSwapchainCreateFlagsANDROID XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID = 0x00000002;
static const XrDepthSwapchainCreateFlagsANDROID XR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID = 0x00000004;
static const XrDepthSwapchainCreateFlagsANDROID XR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID = 0x00000008;

xrDestroyDepthSwapchainANDROID फ़ंक्शन को इस तरह से परिभाषित किया गया है:

XrResult xrDestroyDepthSwapchainANDROID(
    XrDepthSwapchainANDROID                     swapchain);

पैरामीटर की जानकारी

• swapchain, XrDepthSwapchainANDROID हैंडल है, जिसे पहले xrCreateDepthSwapchainANDROID ने बनाया था.

xrDestroyDepthSwapchainANDROID फ़ंक्शन, डेप्थ स्वैपचैन को मिटा देता है.

मान्य इस्तेमाल (इंप्लिसिट)

• xrDestroyDepthSwapchainANDROID को कॉल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना चाहिए
• swapchain यह एक मान्य XrDepthSwapchainANDROID हैंडल होना चाहिए

थ्रेड की सुरक्षा

• swapchain और किसी भी चाइल्ड हैंडल का ऐक्सेस, बाहरी तौर पर सिंक होना ज़रूरी है

रिटर्न कोड

सफलता

• XR_SUCCESS

प्रोसेस पूरी नहीं हो सकी

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_HANDLE_INVALID

डेप्थ टेक्सचर ऐक्सेस करना

xrEnumerateDepthSwapchainImagesANDROID फ़ंक्शन को इस तरह से परिभाषित किया गया है:

XrResult xrEnumerateDepthSwapchainImagesANDROID(
    XrDepthSwapchainANDROID                     depthSwapchain,
    uint32_t                                    depthImageCapacityInput,
    uint32_t*                                   depthImageCountOutput,
    XrDepthSwapchainImageANDROID*               depthImages);

पैरामीटर की जानकारी

• depthSwapchain, इमेज पाने के लिए XrDepthSwapchainANDROID है.
• depthImageCapacityInput, depthImages कलेक्शन की क्षमता है या ज़रूरी क्षमता पाने के अनुरोध के लिए 0.
• depthImageCountOutput, लिखे गए depthImages की संख्या का पॉइंटर है या depthImageCapacityInput के अपर्याप्त होने पर, ज़रूरी क्षमता का पॉइंटर है.
• depthImages, XrDepthSwapchainImageANDROID स्ट्रक्चर के ऐरे का पॉइंटर है. अगर depthImageCapacityInput 0 है, तो यह NULL हो सकता है.
• ज़रूरी depthImages साइज़ को वापस पाने के बारे में पूरी जानकारी के लिए, बफ़र साइज़ पैरामीटर सेक्शन देखें.

xrEnumerateDepthSwapchainImagesANDROID, XrDepthSwapchainImageANDROID स्ट्रक्चर के ऐरे को भरता है. ये संसाधन, XrDepthSwapchainANDROID के लाइफ़टाइम के लिए एक जैसे और मान्य रहेंगे. यह फ़ंक्शन, xrEnumerateSwapchainImages फ़ंक्शन की तरह काम करता है.

मान्य इस्तेमाल (इंप्लिसिट)

• xrEnumerateDepthSwapchainImagesANDROID को कॉल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना चाहिए
• depthSwapchain XrDepthSwapchainANDROID के लिए, मान्य हैंडल होना चाहिए
• depthImageCountOutput, uint32_t वैल्यू का पॉइंटर होना चाहिए
• अगर depthImageCapacityInput 0 नहीं है, तो depthImages को depthImageCapacityInput XrDepthSwapchainImageANDROID स्ट्रक्चर के ऐरे का पॉइंटर होना ज़रूरी है

रिटर्न कोड

सफलता

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

प्रोसेस पूरी नहीं हो सकी

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_VALIDATION_FAILURE
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_SESSION_LOST
• XR_ERROR_SIZE_INSUFFICIENT

XrDepthSwapchainImageANDROID स्ट्रक्चर को इस तरह परिभाषित किया गया है:

typedef struct XrDepthSwapchainImageANDROID {
    XrStructureType    type;
    void*              next;
    const float*       rawDepthImage;
    const uint8_t*     rawDepthConfidenceImage;
    const float*       smoothDepthImage;
    const uint8_t*     smoothDepthConfidenceImage;
} XrDepthSwapchainImageANDROID;

पैसे चुकाकर बने सदस्यों के ब्यौरे

• type इस स्ट्रक्चर का XrStructureType है.
• next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है. OpenXR के मुख्य वर्शन या इस एक्सटेंशन में, इस तरह के स्ट्रक्चर तय नहीं किए गए हैं.
• rawDepthImage, NULL या बाईं और दाईं ओर के व्यू, दोनों के लिए रॉ डेप्थ इमेज का पॉइंटर है. वैल्यू की इकाइयां मीटर होती हैं. खास वैल्यू: 0.0, रॉ डेप्थ में अमान्य या खाली डेप्थ पिक्सल को दिखाता है. Inf, ऐसी डेप्थ को दिखाता है जो असल में बहुत दूर है,
• rawDepthConfidenceImage, NULL या बाएं और दाएं, दोनों व्यू के लिए गहराई की अनुमानित रॉ इमेज का पॉइंटर है.
• smoothDepthImage, NULL या बाईं और दाईं ओर के व्यू, दोनों के लिए बेहतर डेप्थ इमेज पाने के लिए पॉइंटर है. वैल्यू की इकाइयां मीटर होती हैं. खास वैल्यू: 0.0 यह स्मूद डेप्थ में अमान्य या खाली डेप्थ पिक्सल दिखाता है. Inf यह ऐसी डेप्थ दिखाता है जो असल में बहुत दूर है.
• smoothDepthConfidenceImage, NULL या बाईं और दाईं ओर के व्यू, दोनों के लिए, डेप्थ कॉन्फ़िडेंस इमेज को स्मूद करने वाला पॉइंटर है.

XrDepthSwapchainImageANDROID, XrDepthSwapchainANDROID से पढ़ी जा सकने वाली डेप्थ इमेज दिखाता है. इन्हें xrCreateDepthSwapchainANDROID को कॉल करते समय, XrDepthSwapchainCreateInfoANDROID::resolution और XrDepthSwapchainCreateInfoANDROID::createFlags में बताए गए तरीके से असाइन किया जाता है. हर डीप इमेज के लिए:

• इमेज की वैल्यू, मेमोरी में पंक्ति के क्रम में सेट की जाती हैं. साथ ही, लाइनों के बीच कोई पैडिंग नहीं होती.
• पहली वैल्यू सबसे ऊपर बाईं ओर और आखिरी वैल्यू सबसे नीचे दाईं ओर होती है.
• जिस मेमोरी का रेफ़रंस दिया गया है उसका साइज़, xrEnumerateDepthSwapchainImagesANDROID की वैल्यू से तय होता है. साथ ही, xrCreateDepthSwapchainANDROID को कॉल करते समय, XrDepthSwapchainCreateInfoANDROID::resolution से सेट किया जाता है. उदाहरण के लिए, अगर resolution XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID है, तो डेप्थ इमेज का साइज़ 2*160*160*sizeof(float) होगा.
• अगर XrDepthSwapchainCreateInfoANDROID::createFlags ने XR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID को सेट नहीं किया है, तो rawDepthImage की वैल्यू NULL होनी चाहिए.
• अगर XrDepthSwapchainCreateInfoANDROID::createFlags ने XR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID को सेट नहीं किया है, तो rawDepthConfidenceImage की वैल्यू NULL होनी चाहिए.
• अगर XrDepthSwapchainCreateInfoANDROID::createFlags ने XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID को सेट नहीं किया है, तो smoothDepthImage की वैल्यू NULL होनी चाहिए.
• अगर XrDepthSwapchainCreateInfoANDROID::createFlags ने XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID को सेट नहीं किया है, तो smoothDepthConfidenceImage की वैल्यू NULL होनी चाहिए.

मान्य इस्तेमाल (इंप्लिसिट)

• XrDepthSwapchainImageANDROID का इस्तेमाल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन को चालू करना ज़रूरी है
• type होनी चाहिए XR_TYPE_DEPTH_SWAPCHAIN_IMAGE_ANDROID
• next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए

xrAcquireDepthSwapchainImagesANDROID फ़ंक्शन को इस तरह से परिभाषित किया गया है:

XrResult xrAcquireDepthSwapchainImagesANDROID(
    XrDepthSwapchainANDROID                     depthSwapchain,
    const XrDepthAcquireInfoANDROID*            acquireInfo,
    XrDepthAcquireResultANDROID*                acquireResult);

पैरामीटर की जानकारी

• depthSwapchain, डेप्थ इमेज के लिए XrDepthSwapchainANDROID हैंडल है.
• acquireInfo एक XrDepthAcquireInfoANDROID है, जिसमें डेप्थ इमेज हासिल करने के तरीके के बारे में जानकारी होती है.
• acquireResult, XrDepthAcquireResultANDROID है, जिसमें ऐक्सेस की गई डीप इमेज की जानकारी होती है.

ऐप्लिकेशन, xrAcquireDepthSwapchainImagesANDROID फ़ंक्शन का इस्तेमाल करके, सबसे नई उपलब्ध स्वैपचैन इमेज का इंडेक्स हासिल कर सकते हैं. जैसे, XrDepthAcquireResultANDROID::acquiredIndex. यह इंडेक्स, XrDepthSwapchainImageANDROID कलेक्शन में डाला जाता है. इस कलेक्शन को xrEnumerateDepthSwapchainImagesANDROID फ़ंक्शन से एनोटेट किया जाता है. XrDepthAcquireResultANDROID में, डेप्थ डेटा का विश्लेषण करने के लिए ज़रूरी जानकारी भी शामिल होती है. जैसे, फ़ील्ड ऑफ़ व्यू और पोज़. xrAcquireDepthSwapchainImagesANDROID को अगली बार कॉल करने तक, इमेज कलेक्शन में मौजूद स्लॉट से पढ़ना सुरक्षित है.

किसी सेशन में, xrBeginFrame और xrEndFrame कॉल के बीच, xrAcquireDepthSwapchainImagesANDROID को एक से ज़्यादा बार कॉल नहीं किया जाना चाहिए.

मान्य इस्तेमाल (इंप्लिसिट)

• xrAcquireDepthSwapchainImagesANDROID को कॉल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना चाहिए
• depthSwapchain XrDepthSwapchainANDROID के लिए, मान्य हैंडल होना चाहिए
• acquireInfo यह, मान्य XrDepthAcquireInfoANDROID स्ट्रक्चर का पॉइंटर होना चाहिए
• acquireResult XrDepthAcquireResultANDROID स्ट्रक्चर का पॉइंटर होना चाहिए

रिटर्न कोड

सफलता

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

प्रोसेस पूरी नहीं हो सकी

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_VALIDATION_FAILURE
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_SESSION_LOST
• XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID
• XR_ERROR_CALL_ORDER_INVALID
• XR_ERROR_LIMIT_REACHED
• XR_ERROR_TIME_INVALID

XrDepthAcquireInfoANDROID स्ट्रक्चर को इस तरह परिभाषित किया गया है:

typedef struct XrDepthAcquireInfoANDROID {
    XrStructureType    type;
    const void*        next;
    XrSpace            space;
    XrTime             displayTime;
} XrDepthAcquireInfoANDROID;

पैसे चुकाकर बने सदस्यों के ब्यौरे

• type इस स्ट्रक्चर का XrStructureType है.
• next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है. OpenXR के मुख्य वर्शन या इस एक्सटेंशन में, इस तरह के स्ट्रक्चर तय नहीं किए गए हैं.
• space एक XrSpace है, जो XrDepthAcquireResultANDROID::views में दिखाए गए पोज़ के रेफ़रंस फ़्रेम की जानकारी देता है.
• displayTime एक XrTime है, जो XrDepthAcquireResultANDROID::views में, रिटर्न किए गए पॉज़ के लिए पॉज़ का हिसाब लगाने में लगने वाले समय की जानकारी देता है. मौजूदा फ़्रेम के लिए, ऐप्लिकेशन के दिखने का अनुमानित समय बढ़ना चाहिए.

मान्य इस्तेमाल (इंप्लिसिट)

• XrDepthAcquireInfoANDROID का इस्तेमाल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना ज़रूरी है
• type होनी चाहिए XR_TYPE_DEPTH_ACQUIRE_INFO_ANDROID
• next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए
• space यह XrSpace का मान्य हैंडल होना चाहिए

XrDepthAcquireResultANDROID स्ट्रक्चर को इस तरह परिभाषित किया गया है:

typedef struct XrDepthAcquireResultANDROID {
    XrStructureType       type;
    const void*           next;
    uint32_t              acquiredIndex;
    XrTime                exposureTimestamp;
    XrDepthViewANDROID    views[2];
} XrDepthAcquireResultANDROID;

पैसे चुकाकर बने सदस्यों के ब्यौरे

• type इस स्ट्रक्चर का XrStructureType है.
• next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है. OpenXR के मुख्य वर्शन या इस एक्सटेंशन में, इस तरह के स्ट्रक्चर तय नहीं किए गए हैं.
• acquiredIndex, xrEnumerateDepthSwapchainImagesANDROID से एनोटेट किए गए XrDepthSwapchainImageANDROID कलेक्शन में, हासिल किए गए टेक्सचर का इंडेक्स है.
• exposureTimestamp, XrTime है, जो उस समय के बारे में बताता है जब डेप्थ मैप कैप्चर किया गया था.
• views, दो XrDepthViewANDROID का एक कलेक्शन है. इसमें हर आंख के लिए एक XrDepthViewANDROID है. इंडेक्स 0, बाईं आंख और इंडेक्स 1, दाईं आंख है.

मान्य इस्तेमाल (इंप्लिसिट)

• XrDepthAcquireResultANDROID का इस्तेमाल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना ज़रूरी है
• type होनी चाहिए XR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROID
• next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए
• views का कोई भी एलिमेंट, मान्य XrDepthViewANDROID स्ट्रक्चर होना चाहिए

XrDepthViewANDROID स्ट्रक्चर को इस तरह परिभाषित किया गया है:

typedef struct XrDepthViewANDROID {
    XrStructureType    type;
    const void*        next;
    XrFovf             fov;
    XrPosef            pose;
} XrDepthViewANDROID;

पैसे चुकाकर बने सदस्यों के ब्यौरे

• type इस स्ट्रक्चर का XrStructureType है.
• next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है. OpenXR के मुख्य वर्शन या इस एक्सटेंशन में, इस तरह के स्ट्रक्चर तय नहीं किए गए हैं.
• fov एक XrFovf है, जो फ़ील्ड ऑफ़ व्यू के बारे में बताता है. इसका इस्तेमाल इस व्यू को जनरेट करने के लिए किया जाता है. व्यू को कभी भी हॉरिज़ॉन्टल या वर्टिकल तौर पर फ़्लिप नहीं किया जाता.
• pose एक XrPosef है, जिसमें उस पोज़ की जानकारी होती है जिससे डेप्थ मैप रेंडर किया गया था. रेफ़रंस फ़्रेम के बारे में जानकारी, XrDepthAcquireInfoANDROID में दी गई है.

मान्य इस्तेमाल (इंप्लिसिट)

• XrDepthViewANDROID का इस्तेमाल करने से पहले, XR_ANDROID_depth_texture एक्सटेंशन चालू होना ज़रूरी है
• type होनी चाहिए XR_TYPE_DEPTH_VIEW_ANDROID
• next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए

डेप्थ ट्रैकिंग के लिए कोड का उदाहरण

यहां दिए गए उदाहरण में, डीप इमेज पाने का तरीका बताया गया है.

XrInstance instance;  // previously initialized
XrSystemId systemId;  // previously initialized
XrSession session; // previously initialized
XrSpace stageSpace; // space created for XR_REFERENCE_SPACE_TYPE_STAGE.

// The function pointers are previously initialized using xrGetInstanceProcAddr.
PFN_xrCreateDepthSwapchainANDROID xrCreateDepthSwapchainANDROID; // previously initialized
PFN_xrDestroyDepthSwapchainANDROID xrDestroyDepthSwapchainANDROID; // previously initialized
PFN_xrEnumerateDepthSwapchainImagesANDROID xrEnumerateDepthSwapchainImagesANDROID; // previously initialized
PFN_xrEnumerateDepthResolutionsANDROID xrEnumerateDepthResolutionsANDROID; // previously initialized
PFN_xrAcquireDepthSwapchainImagesANDROID xrAcquireDepthSwapchainImagesANDROID; // previously initialized

// Inspect system capability
XrSystemProperties properties{XR_TYPE_SYSTEM_PROPERTIES};
XrSystemDepthTrackingPropertiesANDROID depthTrackingProperties{XR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROID};
properties.next = &depthTrackingProperties;
CHK_XR(xrGetSystemProperties(instance, systemId, &properties));
if (!depthTrackingProperties.supportsDepthTracking) {
  // depth tracking is not supported.
  return;
}

// Query the supported depth resolution.
XrDepthCameraResolutionANDROID supportedDepthResolution;
uint32_t supportedResolutionCount = 0;
CHK_XR(xrEnumerateDepthResolutionsANDROID(
    session, 1, &supportedResolutionCount, &supportedDepthResolution));

// Define metadata to access the raw and smooth depth along with confidences.
XrDepthSwapchainCreateInfoANDROID swapchainCreateInfo = {
  .type = XR_TYPE_DEPTH_SWAPCHAIN_CREATE_INFO_ANDROID,
  .next = nullptr,
  .createFlags =
    XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID |
    XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID |
    XR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID |
    XR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID,

  // Use the resolution supported by the runtime.
  .resolution = supportedDepthResolution,
};

XrDepthSwapchainANDROID depthSwapchain;
CHK_XR(xrCreateDepthSwapchainANDROID(
    session, &swapchainCreateInfo, &depthSwapchain));

// Enumerate depth images.
uint32_t imageCountOutput = 0;
CHK_XR(xrEnumerateDepthSwapchainImagesANDROID(
    depthSwapchain, 0, &imageCountOutput, nullptr));
std::vector<XrDepthSwapchainImageANDROID> depthImages(imageCountOutput);
for (int i = 0; i < imageCountOutput; i++) {
  depthImages[i].type = XR_TYPE_DEPTH_SWAPCHAIN_IMAGE_ANDROID;
}
CHK_XR(xrEnumerateDepthSwapchainImagesANDROID(
  depthSwapchain, imageCountOutput, &imageCountOutput, depthImages.data()));

while (1) {
    // ...
    // For every frame in frame loop
    // ...

    XrFrameState frameState;  // previously returned from xrWaitFrame
    const XrTime time = frameState.predictedDisplayTime;

    XrDepthAcquireInfoANDROID acquireInfo = {
        .type = XR_TYPE_DEPTH_ACQUIRE_INFO_ANDROID,
        .space = stageSpace,
        .time = time};
    XrDepthAcquireResultANDROID acquireResult = {
        .type = XR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROID,
    };
    CHK_XR(xrAcquireDepthImagesANDROID(
        depthSwapchain, &acquireInfo, &acquireResult));

    // Each value in a depth image corresponds to a point in the real world.
    // The sample code in this section shows how to find the stageSpace position
    // of the point corresponding to a particular value in the depth image.

    // For this sample code, assume we are using a right handed coordinate system
    // with +X to the right, +Y up and -Z forward.

    XrDepthSwapchainImageANDROID *image =
        &depthImages[acquireResult.acquireIndex];

    // Assume supported resolution is XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID.
    const int imageResolution = 160;
    int imageY = // value in [0, imageResolution)
    int imageX = // value in [0, imageResolution)

    // Get depth value from left eye.
    // A right depth value would be obtained with the following expression:
    // depthR = image->rawDepthImage[imageResolution*imageResolution+i*imageResolution+j]
    float depthL = image->rawDepthImage[imageY*imageResolution + imageX];
    XrDepthViewANDROID viewL = acquireResult.views[0];

    float tanL = tanf(viewL.fov.angleLeft);
    float tanR = tanf(viewL.fov.angleRight);
    float tanU = tanf(viewL.fov.angleUp);
    float tanD = tanf(viewL.fov.angleDown);

    float s = (imageX + 0.5f) / (float)imageResolution;
    float t = (imageY + 0.5f) / (float)imageResolution;

    // Calculate the depth camera space position of the point
    // corresponding to this depth value.
    XrVector3f posInCameraSpace;
    posInCameraSpace.z = -depthL;
    posInCameraSpace.x = (tanL + (tanR - tanL)*s)*depthL;
    posInCameraSpace.y = (tanB + (tanU - tanB)*t)*depthL;

    XrPosef depthCameraPoseL = viewL.pose;
    // Transform posInCameraSpace by depthCameraPoseL

    // ...
    // Finish frame loop
    // ...
}

नए ऑब्जेक्ट टाइप

• XrDepthSwapchainANDROID

नए Enum काॅन्सटेंट

XrObjectType एनोटेशन को इनके साथ जोड़ा गया है:

• XR_OBJECT_TYPE_DEPTH_SWAPCHAIN_ANDROID

XrResult एनोटेशन को इनके साथ जोड़ा गया है:

• XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID

XrStructureType एनोटेशन को इनके साथ जोड़ा गया है:

• XR_TYPE_DEPTH_SWAPCHAIN_CREATE_INFO_ANDROID
• XR_TYPE_DEPTH_VIEW_ANDROID
• XR_TYPE_DEPTH_ACQUIRE_INFO_ANDROID
• XR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROID
• XR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROID
• XR_TYPE_DEPTH_SWAPCHAIN_IMAGE_ANDROID

नए Enums

• XrDepthSwapchainCreateFlagsANDROID
• XrDepthCameraResolutionANDROID

नए स्ट्रक्चर

• XrDepthSwapchainCreateInfoANDROID
• XrDepthSwapchainImageANDROID
• XrDepthAcquireInfoANDROID
• XrDepthViewANDROID
• XrDepthAcquireResultANDROID
• XrSystemDepthTrackingPropertiesANDROID

नए फ़ंक्शन

• xrCreateDepthSwapchainANDROID
• xrDestroyDepthSwapchainANDROID
• xrEnumerateDepthSwapchainImagesANDROID
• xrEnumerateDepthResolutionsANDROID
• xrAcquireDepthSwapchainImagesANDROID

समस्याएं

वर्शन का इतिहास

• पहला बदलाव, 09-09-2024 (लेवाना चेन)
  • एक्सटेंशन के बारे में शुरुआती जानकारी