XR_ANDROID_depth_texture

Name String

XR_ANDROID_depth_texture

擴充功能類型

執行個體擴充功能

擴充功能註冊編號

703

修訂版本

1

批准狀態

未批准

擴充功能和版本依附元件

OpenXR 1.0

上次修改日期

2024-09-11

IP 狀態

沒有已知的智慧財產權聲明。

著作人

Sushant Kulkarni, Google
Cairn Overturf, Google
Spencer Quin, Google
Levana Chen, Google

總覽

透過這項擴充功能,應用程式可要求取得頭戴式裝置周圍真實環境的深度圖,並在建立時查詢支援的深度解析度。

這項擴充功能旨在提供原始和流暢的深度資訊,用於遮蔽、點擊測試和其他特定工作,例如仿冒臉部偵測,這些工作需要準確的場景幾何圖形。

注意事項

深度圖是由執行階段產生,並使用 XrDepthSwapchainANDROID 與應用程式共用。在應用程式的生命週期內,執行階段「不得」變更透過 xrEnumerateDepthResolutionsANDROID 傳回的深度圖像解析度。

權限

這項擴充功能會提供降取樣的深度紋理,降低個人識別資訊 (PII) 相關疑慮。Android 應用程式必須在資訊清單中列出 android.permission.SCENE_UNDERSTANDING_FINE 權限,因為這項擴充功能會公開環境的幾何圖形。android.permission.SCENE_UNDERSTANDING_FINE 權限視為危險權限。應用程式必須在執行階段要求權限,才能使用下列函式:

(防護等級:危險)

檢查系統功能

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。

有效用途 (隱含)

查詢深度解析

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 會列舉目前工作階段支援的深度解析度。深度解析度應按照執行階段偏好設定,由高到低排序。應用程式應使用支援的最高偏好設定,以獲得最佳效能和品質。

在工作階段的生命週期內,執行階段必須一律從這個列舉傳回相同的緩衝區內容。

有效用途 (隱含)

  • 必須先啟用 XR_ANDROID_depth_texture 擴充功能,才能呼叫 xrEnumerateDepthResolutionsANDROID
  • 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 列舉會說明建立 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;

列舉說明

  • XR_DEPTH_CAMERA_RESOLUTION_80x80_ANDROID:深度和信賴度圖片的解析度為 80x80。
  • XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID:深度和信賴度圖片的解析度為 160x160。
  • XR_DEPTH_CAMERA_RESOLUTION_320x320_ANDROID:深度和信賴度圖片的解析度為 320x320。

建立深度交換鏈

XR_DEFINE_HANDLE(XrDepthSwapchainANDROID)

XrDepthSwapchainANDROID 是深度交換鏈控制代碼。

xrCreateDepthSwapchainANDROID 函式的定義如下:

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

參數說明

應用程式可以使用 xrCreateDepthSwapchainANDROID 函式建立深度交換鏈,管理深度和信賴度圖片。

  • 如果系統不支援深度追蹤,執行階段必須傳回 XR_ERROR_FEATURE_UNSUPPORTED。
  • 如果呼叫端應用程式未獲得必要權限,執行階段必須傳回 XR_ERROR_PERMISSION_INSUFFICIENT。
  • 如果 XrDepthSwapchainCreateInfoANDROID 中指定的深度解析度不受支援,執行階段必須傳回 XR_ERROR_VALIDATION_FAILURE。
  • 只有在建立 swapchain 時為 createInfo 設定對應的位元,執行階段才應建立深度信賴度圖片。

傳回的深度 Swapchain 控制代碼可能會在後續的 API 呼叫中使用。XrDepthSwapchainANDROID 控制代碼必須最終透過 xrDestroyDepthSwapchainANDROID 函式釋放。

有效用途 (隱含)

傳回代碼

成功

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

成員說明

XrDepthSwapchainCreateInfoANDROID 結構會提供 XrDepthSwapchainANDROID 的建立選項,並傳遞至 xrCreateDepthSwapchainANDROID。

有效用途 (隱含)

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

參數說明

xrDestroyDepthSwapchainANDROID 函式會刪除深度交換鏈。呼叫後,執行階段「可能」會釋出所有相關記憶體和資源。

有效用途 (隱含)

執行緒安全

  • 存取 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 為 0,則可以是 NULL。
  • 如要進一步瞭解如何擷取必要的 depthImages 大小,請參閱「緩衝區大小參數」一節。

xrEnumerateDepthSwapchainImagesANDROID 會填入 XrDepthSwapchainImageANDROID 結構陣列。資源必須保持不變,且在 XrDepthSwapchainANDROID 的生命週期內有效。這個函式的運作方式與 xrEnumerateSwapchainImages 類似。

在交換鏈的生命週期內,執行階段必須一律從這個列舉傳回相同的緩衝區內容。

有效用途 (隱含)

傳回代碼

成功

  • 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,或指向執行階段分配的左右檢視畫面平滑深度信賴度圖片的指標。

圖像緩衝區指標僅在交換鏈的生命週期內有效。交換鏈刪除後,指標會視為懸空。

XrDepthSwapchainImageANDROID 代表可讀取 XrDepthSwapchainANDROID 的深度圖片,分配方式如 XrDepthSwapchainCreateInfoANDROID :: resolution 和 XrDepthSwapchainCreateInfoANDROID :: createFlags 所述,同時呼叫 xrCreateDepthSwapchainANDROID。針對每張深度圖片:

有效用途 (隱含)

xrAcquireDepthSwapchainImagesANDROID 函式的定義如下:

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

參數說明

應用程式可以使用 xrAcquireDepthSwapchainImagesANDROID 函式,取得最新的可用交換鏈圖片索引,也就是 XrDepthAcquireResultANDROID :: acquiredIndex,並將其放入由 xrEnumerateDepthSwapchainImagesANDROID 列舉的 XrDepthSwapchainImageANDROID 陣列中。傳回的 XrDepthAcquireResultANDROID 也包含其他資訊,例如解讀深度資料所需的視野和姿勢。在下次呼叫 xrAcquireDepthSwapchainImagesANDROID 之前,可以安全地從圖片陣列中取得的版位讀取資料。

在工作階段中,任何一組對應的 xrBeginFrame 和 xrEndFrame 呼叫之間,最多只能呼叫一次 xrAcquireDepthSwapchainImagesANDROID。

有效用途 (隱含)

傳回代碼

成功

  • 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 中傳回姿勢的時間。應用程式應傳遞目前影格的預測顯示時間。

有效用途 (隱含)

XrDepthAcquireResultANDROID 結構定義如下:

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

成員說明

  • type 是這個結構的 XrStructureType。
  • next 是 NULL,或指向結構鏈中下一個結構的指標。核心 OpenXR 或這個擴充功能中未定義這類結構。
  • acquiredIndex 是 xrEnumerateDepthSwapchainImagesANDROID 列舉的 XrDepthSwapchainImageANDROID 陣列中,所取得紋理的索引。
  • exposureTimestamp 是 XrTime,用於指定擷取深度圖的時間。
  • views 是由兩個 XrDepthViewANDROID 組成的陣列,分別代表左右眼,其中索引 0 代表左眼,索引 1 代表右眼。

有效用途 (隱含)

XrDepthViewANDROID 結構定義如下:

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

成員說明

  • type 是這個結構的 XrStructureType。
  • next 是 NULL,或指向結構鏈中下一個結構的指標。核心 OpenXR 或這個擴充功能中未定義這類結構。
  • fov 是 XrFovf,用於指定產生這個檢視畫面時使用的視野。檢視畫面不會水平或垂直翻轉。
  • pose 是 XrPosef,用於指定深度圖的算繪姿勢。參考框架是在 XrDepthAcquireInfoANDROID 中指定。

有效用途 (隱含)

深度追蹤程式碼範例

以下程式碼範例示範如何取得深度圖片,並使用深度值將深度圖片座標對應至舞台空間。

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
    // ...
}

新物件類型

新指令

新結構

新列舉

新位元遮罩

新列舉常數

  • 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

問題

版本記錄

  • 修訂版本 1,2024-09-09 (Levana Chen)

    • 初始擴充功能說明