XR_ANDROID_Deep_texture Расширение OpenXR

Имя Строка

XR_ANDROID_depth_texture

Тип расширения

Расширение экземпляра

Зарегистрированный добавочный номер

703

Пересмотр

1

Зависимости расширений и версий

OpenXR 1.0

Дата последнего изменения

2024-09-11

Статус ИС

Нет известных претензий на права интеллектуальной собственности.

Участники

Сушант Кулкарни, Google

Керн Овертерф, Google

Спенсер Куин, Google

Левана Чен, Google

Обзор

Это расширение позволяет приложению запрашивать карты глубины реального окружения вокруг гарнитуры и запрашивать поддерживаемые разрешения глубины при создании.

Это расширение предназначено для предоставления сырой и плавной глубины для окклюзии, тестов попадания и других специальных задач, использующих точную геометрию сцены, например, для обнаружения поддельных лиц.

Проверить возможности системы

Структура XrSystemDepthTrackingPropertiesANDROID определяется следующим образом:

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

Описания участников

  • type — XrStructureType этой структуры.
  • next — NULL или указатель на следующую структуру в цепочке структур. Такие структуры не определены в ядре OpenXR или в этом расширении.
  • supportsDepthTracking — это XrBool32 указывающий, поддерживает ли текущая система отслеживание глубины.

Приложение может проверить, способна ли система отслеживать глубину, расширив XrSystemProperties с помощью структуры XrSystemDepthTrackingPropertiesANDROID при вызове xrGetSystemProperties .

Допустимое использование (подразумеваемое)

Глубина разрешения запроса

Функция xrEnumerateDepthResolutionsANDROID определяется как:

XrResult xrEnumerateDepthResolutionsANDROID(
    XrSession                                   session,
    uint32_t                                    resolutionCapacityInput,
    uint32_t*                                   resolutionCountOutput,
    XrDepthCameraResolutionANDROID*             resolutions);

Описание параметров

  • session — это XrSession , который перечисляет поддерживаемые разрешения глубины.
  • resolutionCapacityInput — это емкость resolutions или 0 для получения требуемой емкости.
  • resolutionCountOutput — указатель на количество записанных resolutions uint64_t или указатель на требуемую емкость в случае, если resolutionCapacityInput недостаточно.
  • resolutions — это указатель на массив XrDepthCameraResolutionANDROID , но может быть NULL , если resolutionCapacityInput равен 0.
  • Подробное описание получения требуемого размера 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_VALIDATION_FAILURE
  • XR_ERROR_RUNTIME_FAILURE
  • XR_ERROR_HANDLE_INVALID
  • XR_ERROR_INSTANCE_LOST
  • XR_ERROR_SESSION_LOST
  • XR_ERROR_SIZE_INSUFFICIENT

Перечисление 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
    } 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);

Описание параметров

  • session — это XrSession , который создает цепочку обмена глубиной.

  • createInfo — это указатель на структуру XrDepthSwapchainCreateInfoANDROID , содержащую параметры, которые будут использоваться для создания цепочки обмена.

  • swapchain — это указатель на дескриптор, в котором возвращается созданный XrDepthSwapchainANDROID .

Приложение может использовать функцию xrCreateDepthSwapchainANDROID для создания цепочки обмена глубиной, которая управляет как изображениями глубины, так и изображениями достоверности.

Возвращенный дескриптор глубины swapchain может впоследствии использоваться в вызовах API. Дескриптор XrDepthSwapchainANDROID должен быть в конечном итоге освобожден с помощью функции xrDestroyDepthSwapchainANDROID .

Допустимое использование (подразумеваемое)

Коды возврата

Успех

  • 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

Структура XrDepthSwapchainCreateInfoANDROID определяется следующим образом:

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

Описания участников

  • type — XrStructureType этой структуры.
  • next — NULL или указатель на следующую структуру в цепочке структур. Такие структуры не определены в ядре OpenXR или в этом расширении.
  • resolution — это XrDepthCameraResolutionANDROID , в котором должны быть созданы текстуры глубины и достоверности.
  • createFlags — это один или несколько XrDepthSwapchainCreateFlagsANDROID .

Структура XrDepthSwapchainCreateInfoANDROID предоставляет параметры создания для XrDepthSwapchainANDROID при передаче в xrCreateDepthSwapchainANDROID .

Допустимое использование (подразумеваемое)

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;

Функция xrDestroyDepthSwapchainANDROID определяется как:

XrResult xrDestroyDepthSwapchainANDROID(
    XrDepthSwapchainANDROID                     swapchain);

Описание параметров

  • swapchain — это дескриптор XrDepthSwapchainANDROID , ранее созданный xrCreateDepthSwapchainANDROID .

Функция xrDestroyDepthSwapchainANDROID уничтожает цепочку обмена глубин.

Допустимое использование (подразумеваемое)

Безопасность потока

  • Доступ к swapchain и любым дочерним дескрипторам должен быть синхронизирован извне.

Коды возврата

Успех

  • XR_SUCCESS

Отказ

  • XR_ERROR_FUNCTION_UNSUPPORTED
  • XR_ERROR_HANDLE_INVALID

Доступ к текстурам глубины

Функция xrEnumerateDepthSwapchainImagesANDROID определяется следующим образом: 

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

Описание параметров

  • depthSwapchain — это XrDepthSwapchainANDROID , с которого можно получать изображения.
  • depthImageCapacityInput — это емкость массива depthImages или 0 для указания запроса на извлечение требуемой емкости.
  • depthImageCountOutput — указатель на количество записанных depthImages или указатель на требуемую емкость в случае, если depthImageCapacityInput недостаточно.
  • depthImages — указатель на массив структур XrDepthSwapchainImageANDROID . Может быть NULL , если depthImageCapacityInput равен 0.
  • Подробное описание получения требуемого размера depthImages см. в разделе «Параметры размера буфера».

xrEnumerateDepthSwapchainImagesANDROID заполняет массив структур XrDepthSwapchainImageANDROID . Ресурсы будут постоянными и действительными в течение всего срока службы XrDepthSwapchainANDROID . Эта функция ведет себя аналогично xrEnumerateSwapchainImages .

Допустимое использование (подразумеваемое)

Коды возврата

Успех

  • 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

Структура 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 . Для каждого изображения глубины:

  • Значения изображений располагаются в памяти построчно, без отступов между строками.
  • Первое значение — верхнее левое, последнее значение — нижнее правое.
  • Размер указываемой памяти определяется значением xrEnumerateDepthSwapchainImagesANDROID и устанавливается с помощью XrDepthSwapchainCreateInfoANDROID::resolution при вызове xrCreateDepthSwapchainANDROID . Например, если resolution равно XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID , изображения глубины будут иметь размер 2*160*160*sizeof(float) .
  • Значение rawDepthImage должно быть NULL , если XrDepthSwapchainCreateInfoANDROID::createFlags не установил XR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID .
  • Значение rawDepthConfidenceImage должно быть NULL , если XrDepthSwapchainCreateInfoANDROID::createFlags не установил XR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID .
  • Значение smoothDepthImage должно быть NULL , если XrDepthSwapchainCreateInfoANDROID::createFlags не установил XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID .
  • Значение smoothDepthConfidenceImage должно быть NULL , если XrDepthSwapchainCreateInfoANDROID::createFlags не установил XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID .

Допустимое использование (подразумеваемое)

Функция xrAcquireDepthSwapchainImagesANDROID определяется следующим образом: 

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

Описание параметров

  • depthSwapchain — это дескриптор XrDepthSwapchainANDROID для изображения глубины.
  • acquireInfo — это XrDepthAcquireInfoANDROID , содержащий информацию о том, как получить изображение глубины.
  • acquireResult — это возвращаемый XrDepthAcquireResultANDROID , содержащий информацию о полученном изображении глубины.

Приложения могут использовать функцию xrAcquireDepthSwapchainImagesANDROID для получения последнего доступного индекса изображения swapchain, например XrDepthAcquireResultANDROID::acquiredIndex , в массив XrDepthSwapchainImageANDROID , перечисленный xrEnumerateDepthSwapchainImagesANDROID . Возвращаемый XrDepthAcquireResultANDROID также содержит другую информацию, например поле зрения и позу, которые необходимы для интерпретации данных глубины. Можно безопасно читать из полученного слота в массиве изображений до следующего вызова xrAcquireDepthSwapchainImagesANDROID .

Между любой парой соответствующих вызовов xrBeginFrame и xrEndFrame в сеансе должно быть не более одного вызова xrAcquireDepthSwapchainImagesANDROID .

Допустимое использование (подразумеваемое)

Коды возврата

Успех

  • 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

Структура 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 — это индекс полученной текстуры в массиве XrDepthSwapchainImageANDROID , перечисленном с помощью xrEnumerateDepthSwapchainImagesANDROID .
  • 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

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

Новые типы объектов

Новые константы перечисления

Перечисление XrObjectType расширено с помощью:

  • XR_OBJECT_TYPE_DEPTH_SWAPCHAIN_ANDROID

Перечисление XrResult расширено:

  • XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID

Перечисление XrStructureType расширено:

  • 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

Новые перечисления

Новые структуры

Новые функции

Проблемы

История версий

  • Редакция 1, 9 сентября 2024 г. (Левана Чен)
    • Первоначальное описание расширения

OpenXR™ и логотип OpenXR являются товарными знаками компании Khronos Group Inc. и зарегистрированы в качестве товарного знака в Китае, Европейском Союзе, Японии и Великобритании.