XR_ANDROID_viewport_feathering

Name String

XR_ANDROID_viewport_feathering

Erweiterungstyp

Instanzerweiterung

Registrierte Durchwahl

807

Revision

1

Ratification Status

Nicht ratifiziert

Erweiterungs- und Versionsabhängigkeiten

OpenXR 1.0

Datum der letzten Änderung

2026-05-06

IP-Status

Keine bekannten Ansprüche auf geistiges Eigentum.

Mitwirkende

Brian Chen, Google
Kyle Chen, Google
Nihav Jain, Google
Spencer Quin, Google

Übersicht

Geräte mit großem Sichtfeld können den gesamten Inhalt einer Anwendung problemlos anzeigen. Geräte mit kleinem Sichtfeld(50 bis 70) können dagegen nur einen Teil des Inhalts anzeigen, der Rest wird an den Rändern des Displays abgeschnitten. Ein harter Clip am Rand kann für den Nutzer einschränkend und ablenkend wirken und schließlich zu Unbehagen führen. Feathering ist eine Technik, mit der am Rand des Sichtfelds ein Ausblenden angewendet wird. Diese Erweiterung zeigt den von der Laufzeit angewendeten weichen Bereich an. Eine Anwendung kann dann die UI-Elemente im sicheren Bereich anordnen, der nicht von der weichen Kante betroffen ist.

Weiche Kante abrufen

Die Struktur XrViewportFeatheringConfigViewANDROID ist so definiert:

typedef struct XrViewportFeatheringConfigViewANDROID {
    XrStructureType    type;
    void*              next;
    uint32_t           insetLeft;
    uint32_t           insetRight;
    uint32_t           insetTop;
    uint32_t           insetBottom;
} XrViewportFeatheringConfigViewANDROID;

Mitgliederbeschreibungen

  • type ist der XrStructureType dieser Struktur.
  • next ist NULL oder ein Zeiger auf die nächste Struktur in einer Strukturkette.
  • insetLeft ist die Anzahl der Pixel auf der linken Seite der Ansicht, die von der weichen Kante betroffen sind.
  • insetRight ist die Anzahl der Pixel auf der rechten Seite der Ansicht, die von der weichen Kante betroffen sind.
  • insetTop ist die Anzahl der Pixel auf der Oberseite der Ansicht, die von der weichen Kante betroffen sind.
  • insetBottom ist die Anzahl der Pixel auf der Unterseite der Ansicht, die von der weichen Kante betroffen sind.

Wenn diese Erweiterung aktiviert ist, kann eine Anwendung beim Aufrufen von xrEnumerateViewConfigurationViews eine XrViewportFeatheringConfigViewANDROID-Struktur in der XrViewConfigurationView :: next-Kette übergeben, um Informationen zu den weichen Einrückungen für jede Seite der Ansicht abzurufen.

Gültige Verwendung (implizit)

Neue Gebäude

Neue Enum-Konstanten

  • XR_ANDROID_VIEWPORT_FEATHERING_EXTENSION_NAME
  • XR_ANDROID_viewport_feathering_SPEC_VERSION

  • Erweiterung von XrStructureType :

    • XR_TYPE_VIEWPORT_FEATHERING_CONFIG_VIEW_ANDROID

Probleme

Versionsverlauf

  • Version 1, 06.05.2026 (Brian Chen)

    • Erste Beschreibung der Erweiterung.