XR_ANDROID_viewport_feathering

String de nome

XR_ANDROID_viewport_feathering

Tipo de extensão

Extensão de instância

Número de ramal registrado

807

Revisão

1

Status de ratificação

Não ratificado

Dependências de extensão e versão

OpenXR 1.0

Data da última modificação

2026-05-06

Status do IP

Nenhuma reivindicação de PI conhecida.

Colaboradores

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

Visão geral

Enquanto dispositivos com FOV grande podem mostrar todo o conteúdo de um aplicativo sem problemas, dispositivos com FOV pequeno(50 a 70) só conseguem mostrar parte do conteúdo, e o restante é cortado nas bordas da tela. Um corte rígido ao redor do perímetro pode parecer restritivo e distrair o usuário, causando desconforto. O esfumaçamento é uma técnica para aplicar um efeito de esmaecimento na borda do perímetro do campo de visão. Essa extensão expõe a área de suavização aplicada pelo ambiente de execução. Um aplicativo pode, então, organizar os elementos da interface na área segura que não é afetada pela suavização.

Receber área suavizada

A estrutura XrViewportFeatheringConfigViewANDROID é definida como:

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

Descrições dos membros

  • type é o XrStructureType dessa estrutura.
  • next é NULL ou um ponteiro para a próxima estrutura em uma cadeia de estruturas.
  • insetLeft é o número de pixels no lado esquerdo da visualização que é afetado pelo efeito de difusão.
  • insetRight é o número de pixels no lado direito da visualização que é afetado pelo efeito de difusão.
  • insetTop é o número de pixels na parte de cima da visualização afetada pelo efeito de difusão.
  • insetBottom é o número de pixels na parte de baixo da visualização que é afetada pelo efeito de difusão.

Quando essa extensão está ativada, um aplicativo pode transmitir uma estrutura XrViewportFeatheringConfigViewANDROID na cadeia XrViewConfigurationView :: next ao chamar xrEnumerateViewConfigurationViews para receber informações sobre as inserções suavizadas de cada lado da visualização.

Uso válido (implícito)

Novas estruturas

Novas constantes de tipo enumerado

  • XR_ANDROID_VIEWPORT_FEATHERING_EXTENSION_NAME
  • XR_ANDROID_viewport_feathering_SPEC_VERSION

  • Estendendo XrStructureType :

    • XR_TYPE_VIEWPORT_FEATHERING_CONFIG_VIEW_ANDROID

Problemas

Histórico de versões

  • Revisão 1, 06/05/2026 (Brian Chen)

    • Descrição inicial da extensão.