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.nextadalahNULLatau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.supportsDepthTrackingadalahXrBool32yang 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 berupaXR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROIDnextharus berupaNULLatau 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 kapasitasresolutions, atau 0 untuk mengambil kapasitas yang diperlukan.resolutionCountOutputadalah pointer ke jumlahuint64_tresolutionsyang ditulis, atau pointer ke kapasitas yang diperlukan jikaresolutionCapacityInputtidak memadai.resolutionsadalah pointer ke array XrDepthCameraResolutionANDROID, tetapi dapat berupaNULLjikaresolutionCapacityInputadalah 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 validresolutionCountOutputharus berupa pointer ke nilaiuint32_t- Jika
resolutionCapacityInputbukan 0,resolutionsharus berupa pointer ke array nilairesolutionCapacityInputXrDepthCameraResolutionANDROID
Kode Status
XR_SUCCESSXR_SESSION_LOSS_PENDING
XR_ERROR_FUNCTION_UNSUPPORTEDXR_ERROR_VALIDATION_FAILUREXR_ERROR_RUNTIME_FAILUREXR_ERROR_HANDLE_INVALIDXR_ERROR_INSTANCE_LOSTXR_ERROR_SESSION_LOSTXR_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 validcreateInfoharus berupa pointer ke struktur XrDepthSwapchainCreateInfoANDROID yang validswapchainharus berupa pointer ke handle XrDepthSwapchainANDROID
Kode Status
XR_SUCCESSXR_SESSION_LOSS_PENDING
XR_ERROR_FUNCTION_UNSUPPORTEDXR_ERROR_RUNTIME_FAILUREXR_ERROR_INSTANCE_LOSTXR_ERROR_SESSION_LOSTXR_ERROR_OUT_OF_MEMORYXR_ERROR_HANDLE_INVALIDXR_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.nextadalahNULLatau 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 berupaXR_TYPE_DEPTH_SWAPCHAIN_CREATE_INFO_ANDROIDnextharus berupaNULLatau pointer yang valid ke struktur berikutnya dalam rantai strukturresolutionharus berupa nilai XrDepthCameraResolutionANDROID yang validcreateFlagsharus berupa kombinasi yang valid dari nilai XrDepthSwapchainCreateFlagBitsANDROIDcreateFlagstidak 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 olehxrCreateDepthSwapchainANDROID.
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_UNSUPPORTEDXR_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 arraydepthImages, atau 0 untuk menunjukkan permintaan guna mengambil kapasitas yang diperlukan.depthImageCountOutputadalah pointer ke jumlahdepthImagesyang ditulis, atau pointer ke kapasitas yang diperlukan jikadepthImageCapacityInputtidak memadai.depthImagesadalah pointer ke array struktur XrDepthSwapchainImageANDROID. Nilainya dapat berupaNULLjikadepthImageCapacityInputadalah 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 validdepthImageCountOutputharus berupa pointer ke nilaiuint32_t- Jika
depthImageCapacityInputbukan 0,depthImagesharus berupa pointer ke array strukturdepthImageCapacityInputXrDepthSwapchainImageANDROID
Kode Status
XR_SUCCESSXR_SESSION_LOSS_PENDING
XR_ERROR_FUNCTION_UNSUPPORTEDXR_ERROR_VALIDATION_FAILUREXR_ERROR_RUNTIME_FAILUREXR_ERROR_HANDLE_INVALIDXR_ERROR_INSTANCE_LOSTXR_ERROR_SESSION_LOSTXR_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.nextadalahNULLatau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.rawDepthImageadalahNULLatau 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,rawDepthConfidenceImageadalahNULLatau pointer ke gambar kedalaman kepercayaan mentah untuk tampilan kiri dan kanan.smoothDepthImageadalahNULLatau 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.smoothDepthConfidenceImageadalahNULLatau 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 berupaXR_TYPE_DEPTH_SWAPCHAIN_IMAGE_ANDROIDnextharus berupaNULLatau 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 validacquireInfoharus berupa pointer ke struktur XrDepthAcquireInfoANDROID yang validacquireResultharus berupa pointer ke struktur XrDepthAcquireResultANDROID
Kode Status
XR_SUCCESSXR_SESSION_LOSS_PENDING
XR_ERROR_FUNCTION_UNSUPPORTEDXR_ERROR_VALIDATION_FAILUREXR_ERROR_RUNTIME_FAILUREXR_ERROR_HANDLE_INVALIDXR_ERROR_INSTANCE_LOSTXR_ERROR_SESSION_LOSTXR_ERROR_DEPTH_NOT_AVAILABLE_ANDROIDXR_ERROR_CALL_ORDER_INVALIDXR_ERROR_LIMIT_REACHEDXR_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.nextadalahNULLatau 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.displayTimeadalahXrTimeyang 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 berupaXR_TYPE_DEPTH_ACQUIRE_INFO_ANDROIDnextharus berupaNULLatau pointer yang valid ke struktur berikutnya dalam rantai strukturspaceharus 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.nextadalahNULLatau 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.exposureTimestampadalahXrTimeyang 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 berupaXR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROIDnextharus berupaNULLatau 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.nextadalahNULLatau 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 berupaXR_TYPE_DEPTH_VIEW_ANDROIDnextharus berupaNULLatau 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_ANDROIDXR_TYPE_DEPTH_VIEW_ANDROIDXR_TYPE_DEPTH_ACQUIRE_INFO_ANDROIDXR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROIDXR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROIDXR_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.