Namensstring
XR_ANDROID_depth_texture 
Erweiterungstyp
Instanzerweiterung
Registrierte Erweiterungsnummer
703
Revision
1
Erweiterungs- und Versionsabhängigkeiten
Datum der letzten Änderung
2024-09-11
IP-Status
Es sind keine Ansprüche aufgrund von Urheberrechten bekannt.
Mitwirkende
Sushant Kulkarni, Google
Cairn Overturf, Google
Spencer Quin, Google
Levana Chen, Google
Übersicht
Mit dieser Erweiterung kann die Anwendung Tiefenkarten der realen Umgebung um das Headset herum anfordern und bei der Erstellung unterstützte Tiefenauflösungen abfragen.
Diese Erweiterung soll Roh- und geglättete Tiefen für Okklusion, Treffertests und andere spezielle Aufgaben bereitstellen, bei denen eine genaue Szenengeometrie verwendet wird, z. B. die Erkennung von gefälschten Gesichtern.
Systemkapazität prüfen
Die Struktur XrSystemDepthTrackingPropertiesANDROID ist so definiert:
typedef struct XrSystemDepthTrackingPropertiesANDROID {
    XrStructureType    type;
    const void*        next;
    XrBool32           supportsDepthTracking;
} XrSystemDepthTrackingPropertiesANDROID;
Beschreibungen von Mitgliedern
- typeist der XrStructureType dieser Struktur.
- nextist- NULLoder ein Zeiger auf die nächste Struktur in einer Strukturkette. Solche Strukturen sind in OpenXR oder dieser Erweiterung nicht definiert.
- supportsDepthTrackingist ein- XrBool32, das angibt, ob das aktuelle System das Tiefen-Tracking unterstützt.
Eine Anwendung kann prüfen, ob das System Tiefenerfassung unterstützt, indem sie die Struktur XrSystemProperties beim Aufruf von xrGetSystemProperties um XrSystemDepthTrackingPropertiesANDROID erweitert.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor XrSystemDepthTrackingPropertiesANDROID verwendet werden kann.
- typemuss- XR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROIDsein.
- nextmuss- NULLoder ein gültiger Zeiger auf die nächste Struktur in einer Strukturkette sein.
Lösungen für die Abfragetiefe
Die Funktion xrEnumerateDepthResolutionsANDROID ist so definiert:
XrResult xrEnumerateDepthResolutionsANDROID(
    XrSession                                   session,
    uint32_t                                    resolutionCapacityInput,
    uint32_t*                                   resolutionCountOutput,
    XrDepthCameraResolutionANDROID*             resolutions);
Parameterbeschreibungen
- sessionist die XrSession, in der die unterstützten Tiefenauflösungen aufgelistet sind.
- resolutionCapacityInputist die Kapazität der- resolutionsoder 0, um die erforderliche Kapazität abzurufen.
- resolutionCountOutputist ein Verweis auf die Anzahl der geschriebenen- uint64_t- resolutionsoder ein Verweis auf die erforderliche Kapazität, falls- resolutionCapacityInputnicht ausreicht.
- resolutionsist ein Verweis auf ein Array von XrDepthCameraResolutionANDROID, kann aber auch- NULLsein, wenn- resolutionCapacityInput= 0 ist.
- Eine ausführliche Beschreibung zum Abrufen der erforderlichen resolutions-Größe findest du im Abschnitt Parameter für die Puffergröße.
xrEnumerateDepthResolutionsANDROID listet die von der aktuellen Sitzung unterstützten Tiefenauflösungen auf. Die Tiefenauflösungen sollten in der Reihenfolge von der höchsten bis zur niedrigsten Laufzeitpräferenz sortiert sein. Die Anwendung sollte die höchste Einstellung verwenden, die sie unterstützt, um eine optimale Leistung und Qualität zu erzielen.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor xrEnumerateDepthResolutionsANDROID aufgerufen wird.
- sessionmuss ein gültiger XrSession-Alias sein
- resolutionCountOutputmuss ein Verweis auf einen- uint32_t-Wert sein
- Wenn resolutionCapacityInputnicht 0 ist, mussresolutionsein Verweis auf ein Array mitresolutionCapacityInputXrDepthCameraResolutionANDROID-Werten sein.
Rückgabecodes
- 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
Die XrDepthCameraResolutionANDROID-Enumeration beschreibt die unterstützten Tiefenauflösungen beim Erstellen einer 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;
Beschreibungen von Aufzählungen
- XR_DEPTH_CAMERA_RESOLUTION_80x80_ANDROID– Die Auflösung der Bilder für Tiefe und Konfidenz ist 80 × 80.
- XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID– Die Auflösung der Tiefen- und Konfidenzbilder beträgt 160 × 160.
- XR_DEPTH_CAMERA_RESOLUTION_320x320_ANDROID– Die Auflösung der Tiefen- und Konfidenzbilder beträgt 320 × 320.
Depth-Swapchain erstellen
XR_DEFINE_HANDLE(XrDepthSwapchainANDROID)
Ein XrDepthSwapchainANDROID ist ein Depth-Swapchain-Handle.
Die Funktion xrCreateDepthSwapchainANDROID ist so definiert:
XrResult xrCreateDepthSwapchainANDROID(
    XrSession                                   session,
    const XrDepthSwapchainCreateInfoANDROID*    createInfo,
    XrDepthSwapchainANDROID*                    swapchain);
Parameterbeschreibungen
- sessionist die XrSession, die den Depth-Swapchain erstellt.
- createInfoist ein Verweis auf ein XrDepthSwapchainCreateInfoANDROID-Objekt, das die Parameter zum Erstellen der Swapchain enthält.
- swapchainist ein Verweis auf einen Handle, über den die erstellte XrDepthSwapchainANDROID zurückgegeben wird.
Die Anwendung kann die Funktion xrCreateDepthSwapchainANDROID verwenden, um einen Depth-Swapchain zu erstellen, der sowohl Tiefen- als auch Konfidenzbilder verwaltet.
Der zurückgegebene Depth-Swapchain-Handle kann in API-Aufrufen verwendet werden. Der XrDepthSwapchainANDROID-Handle muss schließlich mit der Funktion xrDestroyDepthSwapchainANDROID freigegeben werden.
Gültige Verwendung (implizit)
- Die XR_ANDROID_depth_texture-Erweiterung muss aktiviert sein, bevor xrCreateDepthSwapchainANDROID aufgerufen wird.
- sessionmuss ein gültiger XrSession-Alias sein.
- createInfomuss ein Verweis auf eine gültige XrDepthSwapchainCreateInfoANDROID-Struktur sein.
- swapchainmuss ein Verweis auf einen XrDepthSwapchainANDROID-Handle sein.
Rückgabecodes
- 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
Die Struktur XrDepthSwapchainCreateInfoANDROID ist so definiert:
typedef struct XrDepthSwapchainCreateInfoANDROID {
    XrStructureType                       type;
    const void*                           next;
    XrDepthCameraResolutionANDROID        resolution;
    XrDepthSwapchainCreateFlagsANDROID    createFlags;
} XrDepthSwapchainCreateInfoANDROID;
Beschreibungen von Mitgliedern
- typeist der XrStructureType dieser Struktur.
- nextist- NULLoder ein Zeiger auf die nächste Struktur in einer Strukturkette. Solche Strukturen sind in OpenXR oder dieser Erweiterung nicht definiert.
- resolutionist die XrDepthCameraResolutionANDROID, in der die Tiefen- und Konfidenztexturen erstellt werden sollen.
- createFlagsist ein oder mehrere XrDepthSwapchainCreateFlagsANDROID.
Die Struktur XrDepthSwapchainCreateInfoANDROID bietet Erstellungsoptionen für die XrDepthSwapchainANDROID, wenn sie an xrCreateDepthSwapchainANDROID übergeben wird.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor XrDepthSwapchainCreateInfoANDROID verwendet werden kann.
- typemuss- XR_TYPE_DEPTH_SWAPCHAIN_CREATE_INFO_ANDROIDsein.
- nextmuss- NULLoder ein gültiger Zeiger auf die nächste Struktur in einer Strukturkette sein.
- resolutionmuss ein gültiger Wert für XrDepthCameraResolutionANDROID sein.
- createFlagsmuss eine gültige Kombination von XrDepthSwapchainCreateFlagBitsANDROID-Werten sein.
- createFlagsdarf nicht 0 sein.
Mit XrDepthSwapchainCreateFlagsANDROID werden Erstellungsoptionen für XrDepthSwapchainANDROID angegeben.
typedef XrFlags64 XrDepthSwapchainCreateFlagsANDROID;
Gültige Bits für XrDepthSwapchainCreateFlagsANDROID werden durch XrDepthSwapchainCreateFlagBitsANDROID definiert, das folgendermaßen angegeben wird:
// 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;
Die Funktion xrDestroyDepthSwapchainANDROID ist so definiert:
XrResult xrDestroyDepthSwapchainANDROID(
    XrDepthSwapchainANDROID                     swapchain);
Parameterbeschreibungen
- swapchainist ein XrDepthSwapchainANDROID-Handle, der zuvor von- xrCreateDepthSwapchainANDROIDerstellt wurde.
Die Funktion xrDestroyDepthSwapchainANDROID zerstört den Depth-Swapchain.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor xrDestroyDepthSwapchainANDROID aufgerufen wird.
- swapchainmuss ein gültiger XrDepthSwapchainANDROID-Handle sein.
Threadsicherheit
- Der Zugriff auf swapchainund alle untergeordneten Handles muss extern synchronisiert werden.
Rückgabecodes
- XR_SUCCESS
- XR_ERROR_FUNCTION_UNSUPPORTED
- XR_ERROR_HANDLE_INVALID
Auf Tiefentextur zugreifen
Die Funktion xrEnumerateDepthSwapchainImagesANDROID ist so definiert:
XrResult xrEnumerateDepthSwapchainImagesANDROID(
    XrDepthSwapchainANDROID                     depthSwapchain,
    uint32_t                                    depthImageCapacityInput,
    uint32_t*                                   depthImageCountOutput,
    XrDepthSwapchainImageANDROID*               depthImages);
Parameterbeschreibungen
- depthSwapchainist die XrDepthSwapchainANDROID, von der Bilder abgerufen werden.
- depthImageCapacityInputist die Kapazität des- depthImages-Arrays oder 0, um eine Anfrage zum Abrufen der erforderlichen Kapazität anzugeben.
- depthImageCountOutputist ein Verweis auf die Anzahl der geschriebenen- depthImagesoder ein Verweis auf die erforderliche Kapazität, falls- depthImageCapacityInputnicht ausreicht.
- depthImagesist ein Verweis auf ein Array von XrDepthSwapchainImageANDROID-Strukturen. Es kann- NULLsein, wenn- depthImageCapacityInput0 ist.
- Eine ausführliche Beschreibung zum Abrufen der erforderlichen depthImages-Größe findest du im Abschnitt Parameter für die Puffergröße.
xrEnumerateDepthSwapchainImagesANDROID füllt ein Array von XrDepthSwapchainImageANDROID-Strukturen. Die Ressourcen sind konstant und gültig für die gesamte Lebensdauer der XrDepthSwapchainANDROID. Diese Funktion verhält sich analog zu xrEnumerateSwapchainImages.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor xrEnumerateDepthSwapchainImagesANDROID aufgerufen wird.
- depthSwapchainmuss ein gültiger XrDepthSwapchainANDROID-Handle sein
- depthImageCountOutputmuss ein Verweis auf einen- uint32_t-Wert sein.
- Wenn depthImageCapacityInputnicht 0 ist, mussdepthImagesein Verweis auf ein Array vondepthImageCapacityInputXrDepthSwapchainImageANDROID-Strukturen sein.
Rückgabecodes
- 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
Die Struktur XrDepthSwapchainImageANDROID ist so definiert:
typedef struct XrDepthSwapchainImageANDROID {
    XrStructureType    type;
    void*              next;
    const float*       rawDepthImage;
    const uint8_t*     rawDepthConfidenceImage;
    const float*       smoothDepthImage;
    const uint8_t*     smoothDepthConfidenceImage;
} XrDepthSwapchainImageANDROID;
Beschreibungen von Mitgliedern
- typeist der XrStructureType dieser Struktur.
- nextist- NULLoder ein Zeiger auf die nächste Struktur in einer Strukturkette. Solche Strukturen sind in OpenXR oder dieser Erweiterung nicht definiert.
- rawDepthImageist- NULLoder der Verweis auf Rohtiefebilder für die linke und rechte Ansicht. Die Werte werden in Metern angegeben. Spezialwerte:- 0.0gibt ein ungültiges oder leeres Tiefenpixel in der Rohtiefe an,- Infgibt eine bekannte Tiefe an, die effektiv unendlich weit entfernt ist.
- rawDepthConfidenceImageist- NULLoder der Verweis auf Rohdaten für die Tiefenschärfe sowohl für die linke als auch die rechte Ansicht.
- smoothDepthImageist- NULLoder der Zeiger, um Tiefenbilder sowohl für die linke als auch die rechte Ansicht zu glätten. Die Werte werden in Metern angegeben. Sonderwerte:- 0.0gibt ein ungültiges oder leeres Tiefenpixel in der glatten Tiefe an,- Infgibt eine bekannte Tiefe an, die praktisch unendlich weit entfernt ist.
- smoothDepthConfidenceImageist- NULLoder der Zeiger, um Bilder mit Tiefenschärfe sowohl für die linke als auch die rechte Ansicht zu glätten.
XrDepthSwapchainImageANDROID stellt die Tiefenbilder aus einem lesbaren XrDepthSwapchainANDROID dar, die wie in XrDepthSwapchainCreateInfoANDROID::resolution und XrDepthSwapchainCreateInfoANDROID::createFlags beschrieben beim Aufruf von xrCreateDepthSwapchainANDROID zugewiesen werden. Für jedes Tiefenbild:
- Die Bildwerte werden im Speicher in Zeilenvorrang-Reihenfolge ohne Zwischenraum zwischen den Zeilen angeordnet.
- Der erste Wert ist links oben und der letzte Wert rechts unten.
- Die Größe des Speichers, auf den verwiesen wird, wird durch den Wert von xrEnumerateDepthSwapchainImagesANDROID bestimmt und durch XrDepthSwapchainCreateInfoANDROID::resolution beim Aufruf von xrCreateDepthSwapchainANDROID festgelegt. Wenn resolutionbeispielsweiseXR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROIDist, haben die Tiefenbilder die Größe2*160*160*sizeof(float).
- Der Wert von rawDepthImagemussNULLsein, wennXR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROIDnicht in XrDepthSwapchainCreateInfoANDROID::createFlags festgelegt wurde.
- Der Wert von rawDepthConfidenceImagemussNULLsein, wennXR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROIDnicht in XrDepthSwapchainCreateInfoANDROID::createFlags festgelegt wurde.
- Der Wert von smoothDepthImagemussNULLsein, wennXR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROIDnicht in XrDepthSwapchainCreateInfoANDROID::createFlags festgelegt wurde.
- Der Wert von smoothDepthConfidenceImagemussNULLsein, wennXR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROIDnicht in XrDepthSwapchainCreateInfoANDROID::createFlags festgelegt wurde.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor XrDepthSwapchainImageANDROID verwendet werden kann.
- typemuss- XR_TYPE_DEPTH_SWAPCHAIN_IMAGE_ANDROIDsein.
- nextmuss- NULLoder ein gültiger Zeiger auf die nächste Struktur in einer Strukturkette sein.
Die Funktion xrAcquireDepthSwapchainImagesANDROID ist so definiert:
XrResult xrAcquireDepthSwapchainImagesANDROID(
    XrDepthSwapchainANDROID                     depthSwapchain,
    const XrDepthAcquireInfoANDROID*            acquireInfo,
    XrDepthAcquireResultANDROID*                acquireResult);
Parameterbeschreibungen
- depthSwapchainist ein XrDepthSwapchainANDROID-Handle für das Tiefenbild.
- acquireInfoist ein XrDepthAcquireInfoANDROID, das Informationen zum Erfassen des Tiefenbilds enthält.
- acquireResultist das zurückgegebene XrDepthAcquireResultANDROID mit Informationen zum erfassten Tiefenbild.
Anwendungen können die Funktion xrAcquireDepthSwapchainImagesANDROID verwenden, um den neuesten verfügbaren Swapchain-Bildindex, z. B. XrDepthAcquireResultANDROID::acquiredIndex, in das XrDepthSwapchainImageANDROID-Array zu übernehmen, das von xrEnumerateDepthSwapchainImagesANDROID aufgezählt wird. Die zurückgegebene XrDepthAcquireResultANDROID enthält auch andere Informationen wie das Sichtfeld und die Pose, die für die Interpretation der Tiefendaten erforderlich sind. Es ist sicher, bis zum nächsten Aufruf von xrAcquireDepthSwapchainImagesANDROID aus dem erfassten Steckplatz im Bildarray zu lesen.
Zwischen jedem Paar entsprechender xrBeginFrame- und xrEndFrame-Aufrufe in einer Sitzung darf es nur einen Aufruf von xrAcquireDepthSwapchainImagesANDROID geben.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor xrAcquireDepthSwapchainImagesANDROID aufgerufen wird.
- depthSwapchainmuss ein gültiger XrDepthSwapchainANDROID-Handle sein
- acquireInfomuss ein Verweis auf eine gültige XrDepthAcquireInfoANDROID-Struktur sein.
- acquireResultmuss ein Zeiger auf eine XrDepthAcquireResultANDROID-Struktur sein.
Rückgabecodes
- 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
Die Struktur XrDepthAcquireInfoANDROID ist so definiert:
typedef struct XrDepthAcquireInfoANDROID {
    XrStructureType    type;
    const void*        next;
    XrSpace            space;
    XrTime             displayTime;
} XrDepthAcquireInfoANDROID;
Beschreibungen von Mitgliedern
- typeist der XrStructureType dieser Struktur.
- nextist- NULLoder ein Zeiger auf die nächste Struktur in einer Strukturkette. Solche Strukturen sind in OpenXR oder dieser Erweiterung nicht definiert.
- spaceist ein XrSpace, der den Referenzrahmen der zurückgegebenen Pose in XrDepthAcquireResultANDROID::views definiert.
- displayTimeist ein- XrTime, das die Zeit angibt, die zum Berechnen der Pose für die zurückgegebene Pose in XrDepthAcquireResultANDROID::views verwendet wurde. Anwendungen sollten die geschätzte Auslieferungszeit für den aktuellen Frame anpassen.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor XrDepthAcquireInfoANDROID verwendet werden kann.
- typemuss- XR_TYPE_DEPTH_ACQUIRE_INFO_ANDROIDsein.
- nextmuss- NULLoder ein gültiger Zeiger auf die nächste Struktur in einer Strukturkette sein.
- spacemuss ein gültiger XrSpace-Handle sein
Die Struktur XrDepthAcquireResultANDROID ist so definiert:
typedef struct XrDepthAcquireResultANDROID {
    XrStructureType       type;
    const void*           next;
    uint32_t              acquiredIndex;
    XrTime                exposureTimestamp;
    XrDepthViewANDROID    views[2];
} XrDepthAcquireResultANDROID;
Beschreibungen von Mitgliedern
- typeist der XrStructureType dieser Struktur.
- nextist- NULLoder ein Zeiger auf die nächste Struktur in einer Strukturkette. Solche Strukturen sind in OpenXR oder dieser Erweiterung nicht definiert.
- acquiredIndexist der Index der erfassten Textur im XrDepthSwapchainImageANDROID-Array, das von xrEnumerateDepthSwapchainImagesANDROID aufgezählt wird.
- exposureTimestampist der- XrTime, der den Zeitpunkt angibt, zu dem die Tiefenkarte aufgenommen wurde.
- viewsist ein Array mit zwei XrDepthViewANDROID, jeweils eine für das linke und das rechte Auge. Dabei ist Index 0 das linke und Index 1 das rechte Auge.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor XrDepthAcquireResultANDROID verwendet werden kann.
- typemuss- XR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROIDsein.
- nextmuss- NULLoder ein gültiger Zeiger auf die nächste Struktur in einer Strukturkette sein.
- Jedes Element von viewsmuss eine gültige XrDepthViewANDROID-Struktur sein.
Die Struktur XrDepthViewANDROID ist so definiert:
typedef struct XrDepthViewANDROID {
    XrStructureType    type;
    const void*        next;
    XrFovf             fov;
    XrPosef            pose;
} XrDepthViewANDROID;
Beschreibungen von Mitgliedern
- typeist der XrStructureType dieser Struktur.
- nextist- NULLoder ein Zeiger auf die nächste Struktur in einer Strukturkette. Solche Strukturen sind in OpenXR oder dieser Erweiterung nicht definiert.
- fovist ein XrFovf, das das Sichtfeld angibt, das zum Generieren dieser Ansicht verwendet wurde. Die Ansicht wird weder horizontal noch vertikal gespiegelt.
- poseist ein XrPosef, das die Pose angibt, aus der die Tiefenkarte gerendert wurde. Der Referenzrahmen wird in XrDepthAcquireInfoANDROID angegeben.
Gültige Verwendung (implizit)
- Die Erweiterung XR_ANDROID_depth_texturemuss aktiviert sein, bevor XrDepthViewANDROID verwendet werden kann.
- typemuss- XR_TYPE_DEPTH_VIEW_ANDROIDsein.
- nextmuss- NULLoder ein gültiger Zeiger auf die nächste Struktur in einer Strukturkette sein.
Beispielcode für das Tiefen-Tracking
Im folgenden Beispielcode wird gezeigt, wie Sie Tiefenbilder erfassen.
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
    // ...
}
Neue Objekttypen
Neue Enum-Konstanten
Die Aufzählung XrObjectType wurde um Folgendes erweitert:
- XR_OBJECT_TYPE_DEPTH_SWAPCHAIN_ANDROID
Die Aufzählung XrResult wurde um Folgendes erweitert:
- XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID
Die Aufzählung XrStructureType wurde um folgende Elemente erweitert:
- 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
Neue Enums
Neue Gebäude
- XrDepthSwapchainCreateInfoANDROID
- XrDepthSwapchainImageANDROID
- XrDepthAcquireInfoANDROID
- XrDepthViewANDROID
- XrDepthAcquireResultANDROID
- XrSystemDepthTrackingPropertiesANDROID
Neue Funktionen
- xrCreateDepthSwapchainANDROID
- xrDestroyDepthSwapchainANDROID
- xrEnumerateDepthSwapchainImagesANDROID
- xrEnumerateDepthResolutionsANDROID
- xrAcquireDepthSwapchainImagesANDROID
Probleme
Versionsverlauf
- Revision 1, 09.09.2024 (Levana Chen)
- Erste Beschreibung der Erweiterung
 
OpenXR™ und das OpenXR-Logo sind Marken der Khronos Group Inc. und sind als Marke in China, der Europäischen Union, Japan und dem Vereinigten Königreich eingetragen.
