XR_ANDROID_viewport_feathering

Name String

XR_ANDROID_viewport_feathering

擴充功能類型

執行個體擴充功能

擴充功能註冊編號

807

修訂版本

1

批准狀態

未批准

擴充功能和版本依附元件

OpenXR 1.0

上次修改日期

2026-05-06

IP 狀態

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

著作人

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

總覽

視野較大的裝置可以完整顯示應用程式內容，但視野較小(50 到 70) 的裝置只能顯示部分內容，其餘內容會在螢幕邊緣遭到截斷。如果周圍有硬性裁剪，可能會讓使用者感到受限和分心，最終導致不適。羽化是一種在視野周邊邊緣套用淡出效果的技術。這項擴充功能會顯示執行階段套用的羽化區域，應用程式可以在不受羽化影響的安全區域內，配置 UI 元素。

取得羽化區域

XrViewportFeatheringConfigViewANDROID 結構定義如下：

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

成員說明

  • type 是這個結構的 XrStructureType。
  • next 是 NULL，或指向結構鏈中下一個結構的指標。
  • insetLeft 是檢視畫面左側受羽化效果影響的像素數量。
  • insetRight 是檢視畫面右側受羽化效果影響的像素數量。
  • insetTop 是檢視畫面頂端受羽化效果影響的像素數量。
  • insetBottom 是檢視畫面底部受羽化效果影響的像素數量。

啟用這項擴充功能後，應用程式可以在呼叫 xrEnumerateViewConfigurationViews 時，在 XrViewConfigurationView :: next 鏈結中傳入 XrViewportFeatheringConfigViewANDROID 結構，以取得檢視畫面各側羽化內嵌的資訊。

有效用途 (隱含)

新結構

新列舉常數

  • XR_ANDROID_VIEWPORT_FEATHERING_EXTENSION_NAME
  • XR_ANDROID_viewport_feathering_SPEC_VERSION

  • 擴充 XrStructureType：

    • XR_TYPE_VIEWPORT_FEATHERING_CONFIG_VIEW_ANDROID

問題

版本記錄

  • 修訂版本 1，2026-05-06 (Brian Chen)

    • 初始擴充功能說明。