estrutura DXVA_Highlight (dxva.h)

Artigo
02/06/2025

A estrutura DXVA_Highlight é enviada pelo decodificador de host para o acelerador para especificar uma área retangular realçada de uma subpictura e criar uma superfície de mistura alfa com dados DCCMD e uma superfície DPXD.

Sintaxe

typedef struct _DXVA_Highlight {
  WORD wHighlightActive;
  WORD wHighlightIndices;
  WORD wHighlightAlphas;
  RECT HighlightRect;
} DXVA_Highlight, *LPDXVA_Highlight;

Membros

wHighlightActive

Indica se uma área de realce retangular está ativa. Zero indica inativo e 1 indica ativo. Se inativos, os dados de realce não devem ter efeito sobre o conteúdo da imagem misturada.

wHighlightIndices

Contém quatro índices de paleta. Cada índice de paleta consiste em 4 bits. Cada índice de 2 bits na área retangular realçada do DXPD é usado para selecionar entre esses quatro índices de paleta. Os 4 bits mais significativos são para o índice 3, os próximos 4 bits são para o índice 2, os próximos 4 bits são para o índice 1 e os 4 bits menos significativos são para o índice 0.

wHighlightAlphas

Contém quatro valores de opacidade. Cada valor de opacidade consiste em 4 bits. Cada índice de 2 bits na área retangular realçada do DXPD é usado para selecionar entre esses quatro valores de opacidade. Os 4 bits mais significativos são para o índice 3, os próximos 4 bits são para o índice 2, os próximos 4 bits são para o índice 1 e os 4 bits menos significativos são para o índice 0.

Esses valores de opacidade de 4 bits são conhecidos como uma variável SampleAlpha4 e são interpretados da seguinte maneira:

O valor zero indica que o conteúdo gráfico no local correspondente é transparente (de modo que a entrada de paleta indexada pelos bits correspondentes de wHighlightIndices não tenha efeito na imagem combinada resultante). Para um valor zero, a combinação especificada é usar o conteúdo da imagem de vídeo sem alteração.
O valor 15 indica que o conteúdo gráfico no local correspondente é opaco (de modo que a entrada de paleta indexada pelos bits correspondentes de wHighlightIndices determina completamente a imagem combinada resultante).
Para valores não zero, a mistura especificada é encontrada usando a seguinte expressão:
( ( (SampleAlpha4 + 1) x (valor gráfico) ) + ( ( (15 - SampleAlpha4) x (valor da imagem) ) + 8 ) >> 4

HighlightRect

Especifica uma estrutura RECT que define a área do retângulo de realce.

As seguintes restrições se aplicam às dimensões RECT:

esquerda e superior deve ser maior ou igual a zero.
direita e inferior deve ser maior que esquerda e superior, respectivamente.
direita não deve exceder 720 e inferior não deve exceder 576.

Observações

A estrutura DXVA_Highlight é formulada de maneira compatível com a especificação de vídeo do DVD, conforme especificado pelo Fórum de DVD.

Observação Há uma diferença entre a maneira como a especificação do DVD define uma área retangular de subpicture e a convenção usada pela Microsoft. Esta seção segue a convenção da Microsoft para que um retângulo de largura 10 e altura 10 no canto superior esquerdo da imagem seja definido por superior = 0, esquerdo = 0, direita = 10, inferior = 10. A especificação do DVD define direita = 9 e inferior = 9.

Requisitos

Requisito	Valor
cabeçalho	dxva.h (inclua Dxva.h)

Consulte também

RECT

Partilhar via