XR_ANDROID_depth_texture

নামের স্ট্রিং

XR_ANDROID_depth_texture

এক্সটেনশনের ধরন

ইনস্ট্যান্স এক্সটেনশন

রেজিস্টার করা এক্সটেনশন নম্বর

703

সংশোধন

1

অনুমোদনের স্ট্যাটাস

অনুমোদিত নয়

এক্সটেনশন ও ভার্সন ডিপেন্ডেন্সি

OpenXR 1.0

শেষবার পরিবর্তন করার তারিখ

2024-09-11

IP স্ট্যাটাস

IP সংক্রান্ত কোনও দাবি নেই।

কন্ট্রিবিউটর

সুশান্ত কুলকার্নি, Google
কেয়ার্ন ওভারটার্ফ, Google
স্পেন্সার কুইন, Google
লেভানা চেন, Google

এক নজরে

এই এক্সটেনশনটি অ্যাপ্লিকেশনটিকে হেডসেটের চারপাশে বাস্তব-বিশ্বের পরিবেশের গভীরতার মানচিত্রের অনুরোধ করতে এবং তৈরির সময় সমর্থিত গভীরতার রেজোলিউশন জিজ্ঞাসা করতে দেয়।

এই এক্সটেনশনটি অক্লুশন, হিট টেস্ট এবং অন্যান্য নির্দিষ্ট টাস্কের জন্য র এবং স্মুথ ডেপথ দেখানোর উদ্দেশ্যে তৈরি করা হয়েছে যা সঠিক সিন জিওমেট্রিকে কাজে লাগায়, যেমন, জাল ফেস ডিটেকশন।

মনে রাখবেন

রানটাইম ডেপথ ম্যাপ তৈরি করে এবং XrDepthSwapchainANDROID ব্যবহার করে অ্যাপ্লিকেশনের সাথে শেয়ার করে। অ্যাপ্লিকেশনের লাইফটাইম চলাকালীন রানটাইম অবশ্যই xrEnumerateDepthResolutionsANDROID-এর মাধ্যমে রিটার্ন করা ডেপথ ইমেজ রেজোলিউশন পরিবর্তন করবে না।

অনুমতি

ব্যক্তিগতভাবে শনাক্তকরণযোগ্য তথ্য (PII) সংক্রান্ত উদ্বেগ কমাতে এই এক্সটেনশন ডাউনস্যাম্পেল করা ডেপথ টেক্সচার দেখায়। Android অ্যাপ্লিকেশনের ম্যানিফেস্টে android.permission.SCENE_UNDERSTANDING_FINE অনুমতি তালিকাভুক্ত থাকতেই হবে, কারণ এই এক্সটেনশন পরিবেশের জিওমেট্রি প্রকাশ করে। android.permission.SCENE_UNDERSTANDING_FINE অনুমতিকে বিপজ্জনক অনুমতি হিসেবে বিবেচনা করা হয়। এইসব ফাংশন ব্যবহার করার জন্য অ্যাপ্লিকেশনকে রানটাইমে অবশ্যই অনুমতি চাইতে হবে:

• xrCreateDepthSwapchainANDROID

(সুরক্ষা লেভেল: বিপজ্জনক)

সিস্টেমের ক্ষমতা পরীক্ষা করা

XrSystemDepthTrackingPropertiesANDROID স্ট্রাকচার এইভাবে সংজ্ঞায়িত করা হয়:

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

মেম্বারদের বিবরণ

• type হল এই স্ট্রাকচারের XrStructureType।
• next হল NULL অথবা স্ট্রাকচার চেনের পরবর্তী স্ট্রাকচারের পয়েন্টার। কোর OpenXR বা এই এক্সটেনশনে এই ধরনের কোনও স্ট্রাকচার সংজ্ঞায়িত করা নেই।
• supportsDepthTracking হল একটি XrBool32 যা বর্তমান সিস্টেম ডেপথ ট্র্যাকিং সাপোর্ট করে কিনা তা নির্দেশ করে।

xrGetSystemProperties কল করার সময় XrSystemDepthTrackingPropertiesANDROID স্ট্রাকচারের সাথে XrSystemProperties এক্সটেন্ড করার মাধ্যমে সিস্টেম ডেপথ ট্র্যাকিং করতে সক্ষম কিনা তা কোনও অ্যাপ্লিকেশন চেক করতে পারে।

শুধুমাত্র রানটাইম supportsDepthTracking-এর জন্য XR_FALSE রিটার্ন করলে, রানটাইমকে অবশ্যই xrCreateDepthSwapchainANDROID থেকে XR_ERROR_FEATURE_UNSUPPORTED রিটার্ন করতে হবে।

সঠিক ব্যবহার (অন্তর্নিহিত)

• 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 পর্যাপ্ত না হলে প্রয়োজনীয় ক্ষমতার একটি পয়েন্টার।
• resolutions হল XrDepthCameraResolutionANDROID-এর অ্যারের একটি পয়েন্টার, তবে resolutionCapacityInput যদি 0 হয়, তাহলে এটি NULL হতে পারে।
• প্রয়োজনীয় resolutions সাইজ ফিরিয়ে আনার বিস্তারিত বিবরণের জন্য বাফার সাইজ প্যারামিটার বিভাগ দেখুন।

xrEnumerateDepthResolutionsANDROID বর্তমান সেশনে কাজ করে এমন ডেপথ রেজোলিউশন গণনা করে। ডেপথ রেজোলিউশন অবশ্যই সর্বোচ্চ থেকে সর্বনিম্ন রানটাইম প্রেফারেন্সের ক্রমে হতে হবে। অ্যাপ্লিকেশনটি যেন সর্বোত্তম পারফর্ম্যান্স এবং কোয়ালিটির জন্য এটি যে সর্বোচ্চ পছন্দকে সমর্থন করে তা ব্যবহার করে।

সেশনের লাইফটাইমের জন্য এই গণনা থেকে রানটাইমকে অবশ্যই সবসময় অভিন্ন বাফার কন্টেন্ট রিটার্ন করতে হবে।

সঠিক ব্যবহার (অন্তর্নিহিত)

• xrEnumerateDepthResolutionsANDROID কল করার আগে XR_ANDROID_depth_texture এক্সটেনশন অবশ্যই চালু করতে হবে
• session অবশ্যই একটি সঠিক XrSession হ্যান্ডেল হতে হবে
• resolutionCountOutput অবশ্যই uint32_t ভ্যালুর পয়েন্টার হতে হবে
• resolutionCapacityInput যদি 0 না হয়, তাহলে resolutions অবশ্যই resolutionCapacityInput XrDepthCameraResolutionANDROID ভ্যালুর অ্যারের পয়েন্টার হতে হবে

রিটার্ন কোড

হয়ে গেছে

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

ব্যর্থতা

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

XrDepthCameraResolutionANDROID enum, 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,
    XR_DEPTH_CAMERA_RESOLUTION_MAX_ENUM_ANDROID = 0x7FFFFFFF
} XrDepthCameraResolutionANDROID;

Enumerant-এর বিবরণ

• XR_DEPTH_CAMERA_RESOLUTION_80x80_ANDROID — ডেপথ ও কনফিডেন্স ছবির রেজোলিউশন হল ৮০x৮০।
• XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID — ডেপথ ও কনফিডেন্স ইমেজের রেজোলিউশন হল ১৬০x১৬০।
• XR_DEPTH_CAMERA_RESOLUTION_320x320_ANDROID — ডেপথ ও কনফিডেন্স ছবির রেজোলিউশন হল ৩২০x৩২০।

ডেপথ সোয়াপচেন তৈরি করুন

XR_DEFINE_HANDLE(XrDepthSwapchainANDROID)

XrDepthSwapchainANDROID হল একটি ডেপথ সোয়াপচেন হ্যান্ডেল।

xrCreateDepthSwapchainANDROID ফাংশনটি এইভাবে সংজ্ঞায়িত করা হয়েছে:

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

প্যারামিটারের বিবরণ

• session হল XrSession যা ডেপথ সোয়াপচেন তৈরি করে।
• createInfo হল XrDepthSwapchainCreateInfoANDROID স্ট্রাকচারের একটি পয়েন্টার যাতে সোয়াপচেন তৈরি করার জন্য ব্যবহার করা হবে এমন প্যারামিটার থাকে।
• swapchain হল একটি হ্যান্ডেলের পয়েন্টার যেখানে তৈরি করা XrDepthSwapchainANDROID ফেরত দেওয়া হয়।

অ্যাপ্লিকেশনটি xrCreateDepthSwapchainANDROID ফাংশন ব্যবহার করতে পারে, যা গভীরতা এবং কনফিডেন্স ছবি উভয়ই ম্যানেজ করে এমন একটি গভীরতা সোয়াপচেন তৈরি করে।

• সিস্টেমে ডেপথ ট্র্যাকিং কাজ না করলে, রানটাইম অবশ্যই XR_ERROR_FEATURE_UNSUPPORTED রিটার্ন করবে।
• কলিং অ্যাপকে প্রয়োজনীয় অনুমতি না দেওয়া হলে রানটাইমকে অবশ্যই XR_ERROR_PERMISSION_INSUFFICIENT রিটার্ন করতে হবে।
• XrDepthSwapchainCreateInfoANDROID-এ উল্লেখ করা ডেপথ রেজোলিউশন কাজ না করলে, রানটাইমকে XR_ERROR_VALIDATION_FAILURE রিটার্ন করতেই হবে।
• রানটাইম শুধুমাত্র তখনই ডেপথ কনফিডেন্স ইমেজ তৈরি করবে যখন সোয়াপচেন তৈরির সময় createInfo-এর জন্য সংশ্লিষ্ট বিট সেট করা থাকবে।

ফেরত আসা ডেপথ সোয়াপচেন হ্যান্ডেল হয়ত পরে API কলে ব্যবহার করা হতে পারে। XrDepthSwapchainANDROID হ্যান্ডেল অবশ্যই xrDestroyDepthSwapchainANDROID ফাংশনের মাধ্যমে শেষ পর্যন্ত ফ্রি করতে হবে।

সঠিক ব্যবহার (অন্তর্নিহিত)

• xrCreateDepthSwapchainANDROID কল করার আগে XR_ANDROID_depth_texture এক্সটেনশন অবশ্যই চালু করতে হবে
• session অবশ্যই একটি সঠিক XrSession হ্যান্ডেল হতে হবে
• createInfo অবশ্যই একটি সঠিক XrDepthSwapchainCreateInfoANDROID স্ট্রাকচারের পয়েন্টার হতে হবে
• swapchain অবশ্যই XrDepthSwapchainANDROID হ্যান্ডেলের পয়েন্টার হতে হবে

রিটার্ন কোড

হয়ে গেছে

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

ব্যর্থতা

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

XrDepthSwapchainCreateInfoANDROID স্ট্রাকচার এইভাবে সংজ্ঞায়িত করা হয়:

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

মেম্বারদের বিবরণ

• type হল এই স্ট্রাকচারের XrStructureType।
• next হল NULL অথবা স্ট্রাকচার চেনের পরবর্তী স্ট্রাকচারের পয়েন্টার। কোর OpenXR বা এই এক্সটেনশনে এই ধরনের কোনও স্ট্রাকচার সংজ্ঞায়িত করা নেই।
• resolution হল XrDepthCameraResolutionANDROID যার মাধ্যমে ডেপথ ও কনফিডেন্স টেক্সচার তৈরি করা হয়।
• createFlags হল এক বা একাধিক XrDepthSwapchainCreateFlagsANDROID .

XrDepthSwapchainCreateInfoANDROID স্ট্রাকচার XrDepthSwapchainANDROID-এর জন্য তৈরি করার বিকল্প প্রদান করে যখন xrCreateDepthSwapchainANDROID-এ পাস করা হয়।

সঠিক ব্যবহার (অন্তর্নিহিত)

• 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;

ফ্ল্যাগ সম্পর্কিত বিবরণ

• 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 — ইঙ্গিত করে যে সোয়াপচেন র ডেপথ কনফিডেন্স ছবি প্রদান করবে।

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
• XR_ERROR_RUNTIME_FAILURE

ডেপথ টেক্সচার অ্যাক্সেস করুন

xrEnumerateDepthSwapchainImagesANDROID ফাংশনটি এইভাবে সংজ্ঞায়িত করা হয়েছে:

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

প্যারামিটারের বিবরণ

• depthSwapchain হল XrDepthSwapchainANDROID যেখান থেকে ছবি পাওয়া যায়।
• depthImageCapacityInput হল depthImages অ্যারের ক্যাপাসিটি, অথবা প্রয়োজনীয় ক্যাপাসিটি ফিরিয়ে আনার অনুরোধ জানাতে 0।
• depthImageCountOutput হল depthImages-এর সংখ্যার একটি পয়েন্টার, অথবা depthImageCapacityInput অপর্যাপ্ত হলে প্রয়োজনীয় ক্ষমতার একটি পয়েন্টার।
• depthImages হল XrDepthSwapchainImageANDROID স্ট্রাকচারের অ্যারের একটি পয়েন্টার। depthImageCapacityInput ০ হলে এটি 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_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_SESSION_LOST
• XR_ERROR_SIZE_INSUFFICIENT
• XR_ERROR_VALIDATION_FAILURE

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 বা রানটাইম দ্বারা বরাদ্দ করা বাম এবং ডান উভয় ভিউয়ের জন্য মসৃণ গভীরতার আত্মবিশ্বাসের চিত্রগুলির পয়েন্টার।

ইমেজ বাফার পয়েন্টার শুধুমাত্র সোয়াপচেনের লাইফ চলাকালীন বৈধ হবে। Swapchain নষ্ট হয়ে গেলে, পয়েন্টারগুলিকে ড্যাংলিং হিসেবে বিবেচনা করা হবে।

XrDepthSwapchainImageANDROID, XrDepthSwapchainANDROID থেকে ডেপথ ইমেজ দেখায়, যা xrCreateDepthSwapchainANDROID কল করার সময় XrDepthSwapchainCreateInfoANDROID :: resolution এবং XrDepthSwapchainCreateInfoANDROID :: createFlags-এ যেভাবে বর্ণনা করা হয়েছে সেইভাবে বরাদ্দ করা হয়। প্রতিটি ডেপথ ইমেজের জন্য:

• ছবির ভ্যালু মেমরিতে সারি-প্রধান ক্রমে সাজানো থাকে, সারির মধ্যে কোনও প্যাডিং থাকে না।
• প্রথম ভ্যালু হল উপরে বাঁদিকে এবং শেষ ভ্যালু হল নিচে ডানদিকে।
• মেমরির সাইজ xrEnumerateDepthSwapchainImagesANDROID-এর ভ্যালু দ্বারা নির্ধারিত হয় এবং xrCreateDepthSwapchainANDROID কল করার সময় XrDepthSwapchainCreateInfoANDROID :: resolution দ্বারা সেট করা হয়। যেমন, XrDepthSwapchainCreateInfoANDROID :: resolution যদি XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID হয়, তাহলে ডেপথ ইমেজের সাইজ হবে 2*160*160*sizeof(float)।
• rawDepthImage-এর ভ্যালু NULL হতেই হবে যদি XrDepthSwapchainCreateInfoANDROID :: createFlags-এ XR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID অন্তর্ভুক্ত না থাকে।
• rawDepthConfidenceImage-এর ভ্যালু NULL হতেই হবে যদি XrDepthSwapchainCreateInfoANDROID :: createFlags-এ XR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID অন্তর্ভুক্ত না থাকে।
• smoothDepthImage-এর ভ্যালু 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 অন্তর্ভুক্ত না থাকে।

সঠিক ব্যবহার (অন্তর্নিহিত)

• 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 ফাংশন ব্যবহার করতে পারে যাতে লেটেস্ট উপলভ্য swapchain ইমেজ ইনডেক্স, অর্থাৎ XrDepthAcquireResultANDROID :: acquiredIndex , xrEnumerateDepthSwapchainImagesANDROID দ্বারা গণনা করা XrDepthSwapchainImageANDROID অ্যারেতে পাওয়া যায়। ফেরত আসা XrDepthAcquireResultANDROID-এ অন্যান্য তথ্যও থাকে, যেমন ফিল্ড অফ ভিউ এবং পোজ, যা ডেপথ ডেটা ব্যাখ্যা করার জন্য প্রয়োজন। xrAcquireDepthSwapchainImagesANDROID-এ পরবর্তী কল না করা পর্যন্ত ইমেজ অ্যারেতে অ্যাকোয়ার করা স্লট থেকে পড়া নিরাপদ।

একটি সেশনে xrBeginFrame এবং xrEndFrame কলের যেকোনও জোড়ার মধ্যে xrAcquireDepthSwapchainImagesANDROID-এ একাধিক কল থাকলে চলবে না।

• আগে থেকে অ্যাকোয়ার করা সোয়াপচেন ছবি এখনও রানটাইম ব্যবহার করলে, রানটাইম ব্লক হতে পারে।
• xrBeginFrame-এর আগে বা xrEndFrame-এর পরে xrAcquireDepthSwapchainImagesANDROID কল করা হলে, রানটাইমকে XR_ERROR_CALL_ORDER_INVALID রিটার্ন করতেই হবে।
• প্রতি ফ্রেমে একাধিকবার xrAcquireDepthSwapchainImagesANDROID কল করা হলে, রানটাইমকে XR_ERROR_LIMIT_REACHED রিটার্ন করতেই হবে - অর্থাৎ, একটি চলমান সেশনে, xrBeginFrame-এ কল করার পরে যার সাথে কোনও xrEndFrame যুক্ত নেই।
• এনভায়রনমেন্ট ডেপথ ডেটা এখনও উপলভ্য না হলে, রানটাইম হয়ত XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID রিটার্ন করবে। এটি হলে, অ্যাপ্লিকেশনটি পরবর্তী ফ্রেমে আবার xrAcquireDepthSwapchainImagesANDROID কল করতে হবে।

সঠিক ব্যবহার (অন্তর্নিহিত)

• xrAcquireDepthSwapchainImagesANDROID কল করার আগে XR_ANDROID_depth_texture এক্সটেনশন চালু করতেই হবে
• depthSwapchain অবশ্যই একটি সঠিক XrDepthSwapchainANDROID হ্যান্ডেল হতে হবে
• acquireInfo অবশ্যই একটি সঠিক XrDepthAcquireInfoANDROID স্ট্রাকচারের পয়েন্টার হতে হবে
• acquireResult অবশ্যই XrDepthAcquireResultANDROID স্ট্রাকচারের পয়েন্টার হতে হবে

রিটার্ন কোড

হয়ে গেছে

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

ব্যর্থতা

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

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 হল XrDepthSwapchainImageANDROID অ্যারেতে প্রাপ্ত টেক্সচারের ইনডেক্স যা xrEnumerateDepthSwapchainImagesANDROID দ্বারা গণনা করা হয়।
• exposureTimestamp হল XrTime যা ডেপথ ম্যাপ ক্যাপচার করার সময় নির্দিষ্ট করে।
• views হল দুটি XrDepthViewANDROID-এর অ্যারে, প্রতিটি চোখের জন্য একটি করে, যেখানে ইন্ডেক্স ০ হল বাঁ চোখ এবং ইন্ডেক্স ১ হল ডান চোখ।

সঠিক ব্যবহার (অন্তর্নিহিত)

• 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

float tanf(float);

// 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,
  // Use the resolution supported by the runtime.
  .resolution = supportedDepthResolution,
  .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,
};

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,
        .displayTime = time
    };
    XrDepthAcquireResultANDROID acquireResult = {
        .type = XR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROID,
    };
    CHK_XR(xrAcquireDepthSwapchainImagesANDROID(
        depthSwapchain, &acquireInfo, &acquireResult));

    // Each value in a depth image corresponds to a point in the real world.
    // The sample code below 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.acquiredIndex];

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

    // Get depth value from left eye.
    // A right depth value is 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 = (tanD + (tanU - tanD)*t)*depthL;

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

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

নতুন অবজেক্টের ধরন

• XrDepthSwapchainANDROID

নতুন কমান্ড

• xrAcquireDepthSwapchainImagesANDROID
• xrCreateDepthSwapchainANDROID
• xrDestroyDepthSwapchainANDROID
• xrEnumerateDepthResolutionsANDROID
• xrEnumerateDepthSwapchainImagesANDROID

নতুন স্ট্রাকচার

• XrDepthAcquireInfoANDROID
• XrDepthAcquireResultANDROID
• XrDepthSwapchainCreateInfoANDROID
• XrDepthSwapchainImageANDROID
• XrDepthViewANDROID

• XrSystemProperties এক্সটেন্ড করা হচ্ছে :

  • XrSystemDepthTrackingPropertiesANDROID

নতুন Enum

• XrDepthCameraResolutionANDROID
• XrDepthSwapchainCreateFlagBitsANDROID

নতুন বিটমাস্ক

• XrDepthSwapchainCreateFlagsANDROID

নতুন Enum কনস্ট্যান্ট

• XR_ANDROID_DEPTH_TEXTURE_EXTENSION_NAME
• XR_ANDROID_depth_texture_SPEC_VERSION

• XrObjectType এক্সটেন্ড করা হচ্ছে :

  • XR_OBJECT_TYPE_DEPTH_SWAPCHAIN_ANDROID

• XrResult এক্সটেন্ড করা হচ্ছে :

  • XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID

• XrStructureType এক্সটেন্ড করা হচ্ছে :

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

ইস্যু

ভার্সনের ইতিহাস

• Revision 1, 2024-09-09 (Levana Chen)

  • প্রাথমিক এক্সটেনশনের বিবরণ