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

Строка имени

XR_ANDROID_depth_texture

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

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

Зарегистрированный внутренний номер

703

Редакция

1

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

ОпенXR 1.0

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

2024-09-11

IP-статус

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

Авторы

Сушант Кулкарни, 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 для создания цепочки подкачки глубины, которая управляет как глубиной, так и достоверностью изображений.

Возвращенный дескриптор цепочки обмена глубины может впоследствии использоваться в вызовах 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::resolve и XrDepthSwapchainCreateInfoANDROID::createFlags при вызове xrCreateDepthSwapchainANDROID . Для каждого изображения глубины:

  • Значения изображений располагаются в памяти в порядке строк, без заполнения между строками.
  • Первое значение находится вверху слева, а последнее значение — внизу справа.
  • Размер указанной памяти определяется значением xrEnumerateDepthSwapchainImagesANDROID и задается XrDepthSwapchainCreateInfoANDROID::resolve при вызове 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 для получения последнего доступного индекса изображения цепочки обмена, например 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 г. (Левана Чен)
    • Первоначальное описание расширения