XR_ANDROID_viewport_feathering

名称字符串

XR_ANDROID_viewport_feathering

扩展程序类型

实例扩展程序

已注册的扩展程序编号

807

修订版本

1

批准状态

未批准

扩展程序和版本依赖项

OpenXR 1.0

上次修改日期

2026-05-06

IP 状态

没有已知的 IP 权利主张。

创作贡献者

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

概览

虽然具有大 FOV 的设备可以毫无问题地显示应用的完整内容，但具有小 FOV（50 到 70）的设备只能显示部分内容，其余内容将在显示屏边缘被截断。在周边进行硬裁剪可能会给用户带来限制感和干扰感，最终导致不适。羽化是一种在视野范围边缘应用淡出效果的技术。此扩展程序会公开由运行时应用的羽化区域，然后应用可以在不受羽化影响的安全区域内布置界面元素。

获取羽化区域

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)

    • 初始扩展程序说明。