String Nama
XR_ANDROID_depth_texture 
Jenis Ekstensi
Ekstensi instance
Registered Extension Number
703
Revisi
1
Dependensi Ekstensi dan Versi
Tanggal Terakhir Diubah
2024-09-11
Status IP
Tidak ada klaim IP yang diketahui.
Kontributor
Sushant Kulkarni, Google
Cairn Overturf, Google
Spencer Quin, Google
Levana Chen, Google
Ringkasan
Ekstensi ini memungkinkan aplikasi meminta peta kedalaman lingkungan dunia nyata di sekitar headset dan membuat kueri resolusi kedalaman yang didukung saat pembuatan.
Ekstensi ini dimaksudkan untuk mengekspos kedalaman mentah dan halus untuk oklusi, pengujian hit, dan tugas spesifik lainnya yang menggunakan geometri tampilan yang akurat, misalnya, deteksi wajah palsu.
Memeriksa kemampuan sistem
Struktur XrSystemDepthTrackingPropertiesANDROID ditentukan sebagai:
typedef struct XrSystemDepthTrackingPropertiesANDROID {
    XrStructureType    type;
    const void*        next;
    XrBool32           supportsDepthTracking;
} XrSystemDepthTrackingPropertiesANDROID;
Deskripsi Anggota
- typeadalah XrStructureType dari struktur ini.
- nextadalah- NULLatau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.
- supportsDepthTrackingadalah- XrBool32yang menunjukkan apakah sistem saat ini mendukung pelacakan kedalaman.
Aplikasi dapat memeriksa apakah sistem mampu melakukan pelacakan kedalaman dengan memperluas XrSystemProperties dengan struktur XrSystemDepthTrackingPropertiesANDROID saat memanggil xrGetSystemProperties.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum menggunakan XrSystemDepthTrackingPropertiesANDROID
- typeharus berupa- XR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROID
- nextharus berupa- NULLatau pointer yang valid ke struktur berikutnya dalam rantai struktur
Resolusi kedalaman kueri
Fungsi xrEnumerateDepthResolutionsANDROID ditentukan sebagai:
XrResult xrEnumerateDepthResolutionsANDROID(
    XrSession                                   session,
    uint32_t                                    resolutionCapacityInput,
    uint32_t*                                   resolutionCountOutput,
    XrDepthCameraResolutionANDROID*             resolutions);
Deskripsi Parameter
- sessionadalah XrSession yang menghitung resolusi kedalaman yang didukung.
- resolutionCapacityInputadalah kapasitas- resolutions, atau 0 untuk mengambil kapasitas yang diperlukan.
- resolutionCountOutputadalah pointer ke jumlah- uint64_t- resolutionsyang ditulis, atau pointer ke kapasitas yang diperlukan jika- resolutionCapacityInputtidak memadai.
- resolutionsadalah pointer ke array XrDepthCameraResolutionANDROID, tetapi dapat berupa- NULLjika- resolutionCapacityInputadalah 0.
- Lihat bagian Parameter Ukuran Buffer untuk mengetahui penjelasan
mendetail tentang pengambilan ukuran resolutionsyang diperlukan.
xrEnumerateDepthResolutionsANDROID menghitung resolusi kedalaman yang didukung oleh sesi saat ini. Resolusi kedalaman harus berurutan dari preferensi runtime tertinggi ke terendah. Aplikasi harus menggunakan preferensi tertinggi yang didukungnya untuk performa dan kualitas yang optimal.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum memanggil xrEnumerateDepthResolutionsANDROID
- sessionharus berupa nama sebutan channel XrSession yang valid
- resolutionCountOutputharus berupa pointer ke nilai- uint32_t
- Jika resolutionCapacityInputbukan 0,resolutionsharus berupa pointer ke array nilairesolutionCapacityInputXrDepthCameraResolutionANDROID
Kode Status
- 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
Enum XrDepthCameraResolutionANDROID menjelaskan resolusi kedalaman yang didukung saat membuat 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;
Deskripsi Enumerant
- XR_DEPTH_CAMERA_RESOLUTION_80x80_ANDROID— Resolusi gambar kedalaman dan keyakinan adalah 80x80.
- XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID— Resolusi gambar kedalaman dan keyakinan adalah 160x160.
- XR_DEPTH_CAMERA_RESOLUTION_320x320_ANDROID— Resolusi gambar kedalaman dan keyakinan adalah 320x320.
Membuat swapchain kedalaman
XR_DEFINE_HANDLE(XrDepthSwapchainANDROID)
XrDepthSwapchainANDROID adalah handle depth swapchain.
Fungsi xrCreateDepthSwapchainANDROID ditentukan sebagai:
XrResult xrCreateDepthSwapchainANDROID(
    XrSession                                   session,
    const XrDepthSwapchainCreateInfoANDROID*    createInfo,
    XrDepthSwapchainANDROID*                    swapchain);
Deskripsi Parameter
- sessionadalah XrSession yang membuat swapchain kedalaman.
- createInfoadalah pointer ke struktur XrDepthSwapchainCreateInfoANDROID yang berisi parameter yang akan digunakan untuk membuat swapchain.
- swapchainadalah pointer ke handle tempat XrDepthSwapchainANDROID yang dibuat ditampilkan.
Aplikasi dapat menggunakan fungsi xrCreateDepthSwapchainANDROID untuk membuat depth swapchain yang mengelola gambar kedalaman dan keyakinan.
Handle swapchain kedalaman yang ditampilkan mungkin akan digunakan dalam panggilan API. Handle XrDepthSwapchainANDROID harus pada akhirnya dibebaskan menggunakan fungsi xrDestroyDepthSwapchainANDROID.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum memanggil xrCreateDepthSwapchainANDROID
- sessionharus berupa nama sebutan channel XrSession yang valid
- createInfoharus berupa pointer ke struktur XrDepthSwapchainCreateInfoANDROID yang valid
- swapchainharus berupa pointer ke handle XrDepthSwapchainANDROID
Kode Status
- 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
Struktur XrDepthSwapchainCreateInfoANDROID ditentukan sebagai:
typedef struct XrDepthSwapchainCreateInfoANDROID {
    XrStructureType                       type;
    const void*                           next;
    XrDepthCameraResolutionANDROID        resolution;
    XrDepthSwapchainCreateFlagsANDROID    createFlags;
} XrDepthSwapchainCreateInfoANDROID;
Deskripsi Anggota
- typeadalah XrStructureType dari struktur ini.
- nextadalah- NULLatau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.
- resolutionadalah XrDepthCameraResolutionANDROID tempat tekstur kedalaman dan kepercayaan harus dibuat.
- createFlagsadalah satu atau beberapa XrDepthSwapchainCreateFlagsANDROID.
Struktur XrDepthSwapchainCreateInfoANDROID menyediakan opsi pembuatan untuk XrDepthSwapchainANDROID saat diteruskan ke xrCreateDepthSwapchainANDROID.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum menggunakan XrDepthSwapchainCreateInfoANDROID
- typeharus berupa- XR_TYPE_DEPTH_SWAPCHAIN_CREATE_INFO_ANDROID
- nextharus berupa- NULLatau pointer yang valid ke struktur berikutnya dalam rantai struktur
- resolutionharus berupa nilai XrDepthCameraResolutionANDROID yang valid
- createFlagsharus berupa kombinasi yang valid dari nilai XrDepthSwapchainCreateFlagBitsANDROID
- createFlagstidak boleh 0
XrDepthSwapchainCreateFlagsANDROID menentukan opsi pembuatan untuk XrDepthSwapchainANDROID.
typedef XrFlags64 XrDepthSwapchainCreateFlagsANDROID;
Bit yang valid untuk XrDepthSwapchainCreateFlagsANDROID ditentukan oleh XrDepthSwapchainCreateFlagBitsANDROID, yang ditentukan sebagai:
// 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;
Fungsi xrDestroyDepthSwapchainANDROID ditentukan sebagai:
XrResult xrDestroyDepthSwapchainANDROID(
    XrDepthSwapchainANDROID                     swapchain);
Deskripsi Parameter
- swapchainadalah handle XrDepthSwapchainANDROID yang sebelumnya dibuat oleh- xrCreateDepthSwapchainANDROID.
Fungsi xrDestroyDepthSwapchainANDROID menghancurkan depth swapchain.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum memanggil xrDestroyDepthSwapchainANDROID
- swapchainharus berupa handle XrDepthSwapchainANDROID yang valid
Keamanan Thread
- Akses ke swapchain, dan setiap nama sebutan turunan, harus disinkronkan secara eksternal
Kode Status
- XR_SUCCESS
- XR_ERROR_FUNCTION_UNSUPPORTED
- XR_ERROR_HANDLE_INVALID
Mengakses tekstur kedalaman
Fungsi xrEnumerateDepthSwapchainImagesANDROID ditentukan sebagai:
XrResult xrEnumerateDepthSwapchainImagesANDROID(
    XrDepthSwapchainANDROID                     depthSwapchain,
    uint32_t                                    depthImageCapacityInput,
    uint32_t*                                   depthImageCountOutput,
    XrDepthSwapchainImageANDROID*               depthImages);
Deskripsi Parameter
- depthSwapchainadalah XrDepthSwapchainANDROID untuk mendapatkan gambar.
- depthImageCapacityInputadalah kapasitas array- depthImages, atau 0 untuk menunjukkan permintaan guna mengambil kapasitas yang diperlukan.
- depthImageCountOutputadalah pointer ke jumlah- depthImagesyang ditulis, atau pointer ke kapasitas yang diperlukan jika- depthImageCapacityInputtidak memadai.
- depthImagesadalah pointer ke array struktur XrDepthSwapchainImageANDROID. Nilainya dapat berupa- NULLjika- depthImageCapacityInputadalah 0.
- Lihat bagian Parameter Ukuran Buffer untuk mengetahui penjelasan
mendetail tentang pengambilan ukuran depthImagesyang diperlukan.
xrEnumerateDepthSwapchainImagesANDROID mengisi array struktur XrDepthSwapchainImageANDROID. Resource akan konstan dan valid selama masa aktif XrDepthSwapchainANDROID. Fungsi ini berperilaku secara analog dengan xrEnumerateSwapchainImages.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum memanggil xrEnumerateDepthSwapchainImagesANDROID
- depthSwapchainharus berupa handle XrDepthSwapchainANDROID yang valid
- depthImageCountOutputharus berupa pointer ke nilai- uint32_t
- Jika depthImageCapacityInputbukan 0,depthImagesharus berupa pointer ke array strukturdepthImageCapacityInputXrDepthSwapchainImageANDROID
Kode Status
- 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
Struktur XrDepthSwapchainImageANDROID ditentukan sebagai:
typedef struct XrDepthSwapchainImageANDROID {
    XrStructureType    type;
    void*              next;
    const float*       rawDepthImage;
    const uint8_t*     rawDepthConfidenceImage;
    const float*       smoothDepthImage;
    const uint8_t*     smoothDepthConfidenceImage;
} XrDepthSwapchainImageANDROID;
Deskripsi Anggota
- typeadalah XrStructureType dari struktur ini.
- nextadalah- NULLatau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.
- rawDepthImageadalah- NULLatau pointer ke gambar kedalaman mentah untuk tampilan kiri dan kanan. Nilainya memiliki satuan meter. Nilai khusus:- 0.0menunjukkan piksel kedalaman yang tidak valid atau kosong dalam kedalaman mentah,- Infmenunjukkan kedalaman yang diketahui yang secara efektif sangat jauh,
- rawDepthConfidenceImageadalah- NULLatau pointer ke gambar kedalaman kepercayaan mentah untuk tampilan kiri dan kanan.
- smoothDepthImageadalah- NULLatau pointer untuk menghaluskan gambar kedalaman untuk tampilan kiri dan kanan. Nilainya memiliki satuan meter. Nilai khusus:- 0.0menunjukkan piksel kedalaman yang tidak valid atau kosong dalam kedalaman yang halus,- Infmenunjukkan kedalaman yang diketahui yang secara efektif sangat jauh.
- smoothDepthConfidenceImageadalah- NULLatau pointer untuk menghaluskan gambar kedalaman kepercayaan untuk tampilan kiri dan kanan.
XrDepthSwapchainImageANDROID mewakili gambar kedalaman dari XrDepthSwapchainANDROID yang dapat dibaca, yang dialokasikan seperti yang dijelaskan dalam XrDepthSwapchainCreateInfoANDROID::resolution dan XrDepthSwapchainCreateInfoANDROID::createFlags saat memanggil xrCreateDepthSwapchainANDROID. Untuk setiap gambar kedalaman:
- Nilai gambar disusun dalam memori dalam urutan baris utama, tanpa padding di antara baris.
- Nilai pertama adalah kiri atas dan nilai terakhir adalah kanan bawah.
- Ukuran memori yang ditunjuk ditentukan oleh nilai
xrEnumerateDepthSwapchainImagesANDROID dan ditetapkan oleh
XrDepthSwapchainCreateInfoANDROID::resolution saat memanggil
xrCreateDepthSwapchainANDROID. Misalnya, jika resolutionadalahXR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID, gambar kedalaman akan memiliki ukuran2*160*160*sizeof(float).
- Nilai rawDepthImageharusNULLjika XrDepthSwapchainCreateInfoANDROID::createFlags belum menetapkanXR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID.
- Nilai rawDepthConfidenceImageharusNULLjika XrDepthSwapchainCreateInfoANDROID::createFlags belum menetapkanXR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID.
- Nilai smoothDepthImageharusNULLjika XrDepthSwapchainCreateInfoANDROID::createFlags belum menetapkanXR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID.
- Nilai smoothDepthConfidenceImageharusNULLjika XrDepthSwapchainCreateInfoANDROID::createFlags belum menetapkanXR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum menggunakan XrDepthSwapchainImageANDROID
- typeharus berupa- XR_TYPE_DEPTH_SWAPCHAIN_IMAGE_ANDROID
- nextharus berupa- NULLatau pointer yang valid ke struktur berikutnya dalam rantai struktur
Fungsi xrAcquireDepthSwapchainImagesANDROID ditentukan sebagai:
XrResult xrAcquireDepthSwapchainImagesANDROID(
    XrDepthSwapchainANDROID                     depthSwapchain,
    const XrDepthAcquireInfoANDROID*            acquireInfo,
    XrDepthAcquireResultANDROID*                acquireResult);
Deskripsi Parameter
- depthSwapchainadalah handle XrDepthSwapchainANDROID untuk gambar kedalaman.
- acquireInfoadalah XrDepthAcquireInfoANDROID yang berisi informasi tentang cara mendapatkan gambar kedalaman.
- acquireResultadalah XrDepthAcquireResultANDROID yang ditampilkan dan berisi informasi tentang gambar kedalaman yang diperoleh.
Aplikasi dapat menggunakan fungsi xrAcquireDepthSwapchainImagesANDROID untuk memperoleh indeks gambar swapchain terbaru yang tersedia, seperti XrDepthAcquireResultANDROID::acquiredIndex, ke dalam array XrDepthSwapchainImageANDROID yang dihitung oleh xrEnumerateDepthSwapchainImagesANDROID. XrDepthAcquireResultANDROID yang ditampilkan juga berisi informasi lain seperti bidang pandang dan pose yang diperlukan untuk menafsirkan data kedalaman. Anda dapat membaca dari slot yang diperoleh dalam array gambar hingga panggilan berikutnya ke xrAcquireDepthSwapchainImagesANDROID.
Harus tidak lebih dari satu panggilan ke xrAcquireDepthSwapchainImagesANDROID di antara setiap pasangan panggilan xrBeginFrame dan xrEndFrame yang sesuai dalam sesi.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum memanggil xrAcquireDepthSwapchainImagesANDROID
- depthSwapchainharus berupa handle XrDepthSwapchainANDROID yang valid
- acquireInfoharus berupa pointer ke struktur XrDepthAcquireInfoANDROID yang valid
- acquireResultharus berupa pointer ke struktur XrDepthAcquireResultANDROID
Kode Status
- 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
Struktur XrDepthAcquireInfoANDROID ditentukan sebagai:
typedef struct XrDepthAcquireInfoANDROID {
    XrStructureType    type;
    const void*        next;
    XrSpace            space;
    XrTime             displayTime;
} XrDepthAcquireInfoANDROID;
Deskripsi Anggota
- typeadalah XrStructureType dari struktur ini.
- nextadalah- NULLatau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.
- spaceadalah XrSpace yang menentukan frame referensi pose yang ditampilkan di XrDepthAcquireResultANDROID::views.
- displayTimeadalah- XrTimeyang menentukan waktu yang digunakan untuk menghitung pose untuk pose yang ditampilkan di XrDepthAcquireResultANDROID::views. Aplikasi harus meneruskan perkiraan waktu tampilannya untuk frame saat ini.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum menggunakan XrDepthAcquireInfoANDROID
- typeharus berupa- XR_TYPE_DEPTH_ACQUIRE_INFO_ANDROID
- nextharus berupa- NULLatau pointer yang valid ke struktur berikutnya dalam rantai struktur
- spaceharus berupa nama sebutan XrSpace yang valid
Struktur XrDepthAcquireResultANDROID ditentukan sebagai:
typedef struct XrDepthAcquireResultANDROID {
    XrStructureType       type;
    const void*           next;
    uint32_t              acquiredIndex;
    XrTime                exposureTimestamp;
    XrDepthViewANDROID    views[2];
} XrDepthAcquireResultANDROID;
Deskripsi Anggota
- typeadalah XrStructureType dari struktur ini.
- nextadalah- NULLatau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.
- acquiredIndexadalah indeks tekstur yang diperoleh ke dalam array XrDepthSwapchainImageANDROID yang dihitung oleh xrEnumerateDepthSwapchainImagesANDROID.
- exposureTimestampadalah- XrTimeyang menentukan waktu saat peta kedalaman diambil.
- viewsadalah array dari dua XrDepthViewANDROID, satu untuk setiap mata, dengan indeks 0 adalah mata kiri dan indeks 1 adalah mata kanan.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum menggunakan XrDepthAcquireResultANDROID
- typeharus berupa- XR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROID
- nextharus berupa- NULLatau pointer yang valid ke struktur berikutnya dalam rantai struktur
- Setiap elemen viewstertentu harus berupa struktur XrDepthViewANDROID yang valid
Struktur XrDepthViewANDROID ditentukan sebagai:
typedef struct XrDepthViewANDROID {
    XrStructureType    type;
    const void*        next;
    XrFovf             fov;
    XrPosef            pose;
} XrDepthViewANDROID;
Deskripsi Anggota
- typeadalah XrStructureType dari struktur ini.
- nextadalah- NULLatau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.
- fovadalah XrFovf yang menentukan bidang pandang yang digunakan untuk membuat tampilan ini. Tampilan tidak pernah dibalik secara horizontal maupun vertikal.
- poseadalah XrPosef yang menentukan pose tempat peta kedalaman dirender. Frame referensi ditentukan dalam XrDepthAcquireInfoANDROID.
Penggunaan yang Valid (Implisit)
- Ekstensi XR_ANDROID_depth_textureharus diaktifkan sebelum menggunakan XrDepthViewANDROID
- typeharus berupa- XR_TYPE_DEPTH_VIEW_ANDROID
- nextharus berupa- NULLatau pointer yang valid ke struktur berikutnya dalam rantai struktur
Contoh kode untuk pelacakan kedalaman
Kode contoh berikut menunjukkan cara mendapatkan gambar kedalaman.
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,
        .displayTime = 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
    // ...
}
Jenis Objek Baru
Konstanta Enum Baru
Enumerasi XrObjectType diperluas dengan:
- XR_OBJECT_TYPE_DEPTH_SWAPCHAIN_ANDROID
Enumerasi XrResult diperluas dengan:
- XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID
Enumerasi XrStructureType diperluas dengan:
- 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
Enum Baru
Struktur Baru
- XrDepthSwapchainCreateInfoANDROID
- XrDepthSwapchainImageANDROID
- XrDepthAcquireInfoANDROID
- XrDepthViewANDROID
- XrDepthAcquireResultANDROID
- XrSystemDepthTrackingPropertiesANDROID
Fungsi Baru
- xrCreateDepthSwapchainANDROID
- xrDestroyDepthSwapchainANDROID
- xrEnumerateDepthSwapchainImagesANDROID
- xrEnumerateDepthResolutionsANDROID
- xrAcquireDepthSwapchainImagesANDROID
Masalah
Histori Versi
- Revisi 1, 09-09-2024 (Levana Chen)
- Deskripsi ekstensi awal
 
OpenXR™ dan logo OpenXR adalah merek dagang yang dimiliki oleh The Khronos Group Inc. dan terdaftar sebagai merek dagang di China, Uni Eropa, Jepang, dan Inggris Raya.
