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 scene 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
type
adalah XrStructureType dari struktur ini.next
adalahNULL
atau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.supportsDepthTracking
adalahXrBool32
yang 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_texture
harus diaktifkan sebelum menggunakan XrSystemDepthTrackingPropertiesANDROID type
harus berupaXR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROID
next
harus berupaNULL
atau 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
session
adalah XrSession yang menghitung resolusi kedalaman yang didukung.resolutionCapacityInput
adalah kapasitasresolutions
, atau 0 untuk mengambil kapasitas yang diperlukan.resolutionCountOutput
adalah pointer ke jumlahuint64_t
resolutions
yang ditulis, atau pointer ke kapasitas yang diperlukan jikaresolutionCapacityInput
tidak memadai.resolutions
adalah pointer ke array XrDepthCameraResolutionANDROID, tetapi dapat berupaNULL
jikaresolutionCapacityInput
adalah 0.- Lihat bagian Parameter Ukuran Buffer untuk mengetahui penjelasan
mendetail tentang pengambilan ukuran
resolutions
yang 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_texture
harus diaktifkan sebelum memanggil xrEnumerateDepthResolutionsANDROID session
harus berupa nama sebutan channel XrSession yang validresolutionCountOutput
harus berupa pointer ke nilaiuint32_t
- Jika
resolutionCapacityInput
bukan 0,resolutions
harus berupa pointer ke array nilairesolutionCapacityInput
XrDepthCameraResolutionANDROID
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
session
adalah XrSession yang membuat swapchain kedalaman.createInfo
adalah pointer ke struktur XrDepthSwapchainCreateInfoANDROID yang berisi parameter yang akan digunakan untuk membuat swapchain.swapchain
adalah 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_texture
harus diaktifkan sebelum memanggil xrCreateDepthSwapchainANDROID session
harus berupa nama sebutan channel XrSession yang validcreateInfo
harus berupa pointer ke struktur XrDepthSwapchainCreateInfoANDROID yang validswapchain
harus 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
type
adalah XrStructureType dari struktur ini.next
adalahNULL
atau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.resolution
adalah XrDepthCameraResolutionANDROID tempat tekstur kedalaman dan keyakinan harus dibuat.createFlags
adalah satu atau beberapa XrDepthSwapchainCreateFlagsANDROID.
Struktur XrDepthSwapchainCreateInfoANDROID menyediakan opsi pembuatan untuk XrDepthSwapchainANDROID saat diteruskan ke xrCreateDepthSwapchainANDROID.
Penggunaan yang Valid (Implisit)
- Ekstensi
XR_ANDROID_depth_texture
harus diaktifkan sebelum menggunakan XrDepthSwapchainCreateInfoANDROID type
harus berupaXR_TYPE_DEPTH_SWAPCHAIN_CREATE_INFO_ANDROID
next
harus berupaNULL
atau pointer yang valid ke struktur berikutnya dalam rantai strukturresolution
harus berupa nilai XrDepthCameraResolutionANDROID yang validcreateFlags
harus berupa kombinasi yang valid dari nilai XrDepthSwapchainCreateFlagBitsANDROIDcreateFlags
tidak 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
swapchain
adalah handle XrDepthSwapchainANDROID yang sebelumnya dibuat olehxrCreateDepthSwapchainANDROID
.
Fungsi xrDestroyDepthSwapchainANDROID menghancurkan depth swapchain.
Penggunaan yang Valid (Implisit)
- Ekstensi
XR_ANDROID_depth_texture
harus diaktifkan sebelum memanggil xrDestroyDepthSwapchainANDROID swapchain
harus 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
depthSwapchain
adalah XrDepthSwapchainANDROID untuk mendapatkan gambar.depthImageCapacityInput
adalah kapasitas arraydepthImages
, atau 0 untuk menunjukkan permintaan guna mengambil kapasitas yang diperlukan.depthImageCountOutput
adalah pointer ke jumlahdepthImages
yang ditulis, atau pointer ke kapasitas yang diperlukan jikadepthImageCapacityInput
tidak memadai.depthImages
adalah pointer ke array struktur XrDepthSwapchainImageANDROID. Nilainya dapat berupaNULL
jikadepthImageCapacityInput
adalah 0.- Lihat bagian Parameter Ukuran Buffer untuk mengetahui penjelasan
mendetail tentang pengambilan ukuran
depthImages
yang 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_texture
harus diaktifkan sebelum memanggil xrEnumerateDepthSwapchainImagesANDROID depthSwapchain
harus berupa handle XrDepthSwapchainANDROID yang validdepthImageCountOutput
harus berupa pointer ke nilaiuint32_t
- Jika
depthImageCapacityInput
bukan 0,depthImages
harus berupa pointer ke array strukturdepthImageCapacityInput
XrDepthSwapchainImageANDROID
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
type
adalah XrStructureType dari struktur ini.next
adalahNULL
atau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.rawDepthImage
adalahNULL
atau pointer ke gambar kedalaman mentah untuk tampilan kiri dan kanan. Nilainya memiliki satuan meter. Nilai khusus:0.0
menunjukkan piksel kedalaman yang tidak valid atau kosong dalam kedalaman mentah,Inf
menunjukkan kedalaman yang diketahui yang secara efektif sangat jauh,rawDepthConfidenceImage
adalahNULL
atau pointer ke gambar kedalaman kepercayaan mentah untuk tampilan kiri dan kanan.smoothDepthImage
adalahNULL
atau pointer untuk menghaluskan gambar kedalaman untuk tampilan kiri dan kanan. Nilainya memiliki satuan meter. Nilai khusus:0.0
menunjukkan piksel kedalaman yang tidak valid atau kosong dalam kedalaman halus,Inf
menunjukkan kedalaman yang diketahui yang secara efektif sangat jauh.smoothDepthConfidenceImage
adalahNULL
atau 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
resolution
adalahXR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID
, gambar kedalaman akan memiliki ukuran2*160*160*sizeof(float)
. - Nilai
rawDepthImage
harusNULL
jika XrDepthSwapchainCreateInfoANDROID::createFlags belum menetapkanXR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID
. - Nilai
rawDepthConfidenceImage
harusNULL
jika XrDepthSwapchainCreateInfoANDROID::createFlags belum menetapkanXR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID
. - Nilai
smoothDepthImage
harusNULL
jika XrDepthSwapchainCreateInfoANDROID::createFlags belum menetapkanXR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID
. - Nilai
smoothDepthConfidenceImage
harusNULL
jika XrDepthSwapchainCreateInfoANDROID::createFlags belum menetapkanXR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID
.
Penggunaan yang Valid (Implisit)
- Ekstensi
XR_ANDROID_depth_texture
harus diaktifkan sebelum menggunakan XrDepthSwapchainImageANDROID type
harus berupaXR_TYPE_DEPTH_SWAPCHAIN_IMAGE_ANDROID
next
harus berupaNULL
atau pointer yang valid ke struktur berikutnya dalam rantai struktur
Fungsi xrAcquireDepthSwapchainImagesANDROID ditentukan sebagai:
XrResult xrAcquireDepthSwapchainImagesANDROID(
XrDepthSwapchainANDROID depthSwapchain,
const XrDepthAcquireInfoANDROID* acquireInfo,
XrDepthAcquireResultANDROID* acquireResult);
Deskripsi Parameter
depthSwapchain
adalah handle XrDepthSwapchainANDROID untuk gambar kedalaman.acquireInfo
adalah XrDepthAcquireInfoANDROID yang berisi informasi tentang cara mendapatkan gambar kedalaman.acquireResult
adalah 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_texture
harus diaktifkan sebelum memanggil xrAcquireDepthSwapchainImagesANDROID depthSwapchain
harus berupa handle XrDepthSwapchainANDROID yang validacquireInfo
harus berupa pointer ke struktur XrDepthAcquireInfoANDROID yang validacquireResult
harus 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
type
adalah XrStructureType dari struktur ini.next
adalahNULL
atau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.space
adalah XrSpace yang menentukan frame referensi pose yang ditampilkan di XrDepthAcquireResultANDROID::views.displayTime
adalahXrTime
yang 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_texture
harus diaktifkan sebelum menggunakan XrDepthAcquireInfoANDROID type
harus berupaXR_TYPE_DEPTH_ACQUIRE_INFO_ANDROID
next
harus berupaNULL
atau pointer yang valid ke struktur berikutnya dalam rantai strukturspace
harus 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
type
adalah XrStructureType dari struktur ini.next
adalahNULL
atau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.acquiredIndex
adalah indeks tekstur yang diperoleh ke dalam array XrDepthSwapchainImageANDROID yang dihitung oleh xrEnumerateDepthSwapchainImagesANDROID.exposureTimestamp
adalahXrTime
yang menentukan waktu pembuatan peta kedalaman.views
adalah 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_texture
harus diaktifkan sebelum menggunakan XrDepthAcquireResultANDROID type
harus berupaXR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROID
next
harus berupaNULL
atau pointer yang valid ke struktur berikutnya dalam rantai struktur- Setiap elemen
views
tertentu 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
type
adalah XrStructureType dari struktur ini.next
adalahNULL
atau pointer ke struktur berikutnya dalam rantai struktur. Tidak ada struktur semacam itu yang ditentukan di OpenXR inti atau ekstensi ini.fov
adalah XrFovf yang menentukan bidang pandang yang digunakan untuk membuat tampilan ini. Tampilan tidak pernah dibalik secara horizontal maupun vertikal.pose
adalah XrPosef yang menentukan pose tempat peta kedalaman dirender. Frame referensi ditentukan dalam XrDepthAcquireInfoANDROID.
Penggunaan yang Valid (Implisit)
- Ekstensi
XR_ANDROID_depth_texture
harus diaktifkan sebelum menggunakan XrDepthViewANDROID type
harus berupaXR_TYPE_DEPTH_VIEW_ANDROID
next
harus berupaNULL
atau 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,
.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
// ...
}
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