DDS_PIXELFORMAT estrutura

Formato de pixel do Surface.

Sintaxe

struct DDS_PIXELFORMAT {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwFourCC;
  DWORD dwRGBBitCount;
  DWORD dwRBitMask;
  DWORD dwGBitMask;
  DWORD dwBBitMask;
  DWORD dwABitMask;
};

Members

dwSize

Tipo: DWORD

Tamanho da estrutura; Definido como 32 (bytes).

dwBandeiras

Tipo: DWORD

Valores que indicam que tipo de dados estão na superfície.

Flag	Description	Valor
DDPF_ALPHAPIXELS	A textura contém dados alfa; dwRGBAlphaBitMask contém dados válidos.	0x1
DDPF_ALPHA	Usado em alguns arquivos DDS mais antigos apenas para dados não compactados do canal alfa (dwRGBBitCount contém a contagem de bits do canal alfa; dwABitMask contém dados válidos)	0x2
DDPF_FOURCC	dwFourCC contém dados válidos.	0x4
DDPF_RGB	A textura contém dados RGB não comprimidos; dwRGBBitCount e as máscaras RGB (dwRBitMask, dwGBitMask, dwBBitMask) contêm dados válidos.	0x40
DDPF_YUV	Usado em alguns arquivos DDS mais antigos para dados não compactados YUV (dwRGBBitCount contém a contagem de bits YUV; dwRBitMask contém a máscara Y, dwGBitMask contém a máscara U, dwBBitMask contém a máscara V)	0x200
DDPF_LUMINANCE	Usado em alguns arquivos DDS mais antigos para dados não compactados de cor de canal único (dwRGBBitCount contém a contagem de bits do canal de luminância; dwRBitMask contém a máscara de canal). Pode ser combinado com DDPF_ALPHAPIXELS para um arquivo DDS de dois canais.	0x20000

dwFourCC

Tipo: DWORD

Códigos de quatro caracteres para especificar formatos compactados ou personalizados. Os valores possíveis incluem: DXT1, DXT2, DXT3, DXT4 ou DXT5. Um FourCC de DX10 indica o prescense do cabeçalho estendido DDS_HEADER_DXT10 e o membro dxgiFormat dessa estrutura indica o formato verdadeiro. Ao usar um código de quatro caracteres, dwFlags deve incluir DDPF_FOURCC.

dwRGBBitCount

Tipo: DWORD

Número de bits num formato RGB (possivelmente incluindo alfa). Válido quando dwFlags inclui DDPF_RGB, DDPF_LUMINANCE ou DDPF_YUV.

dwRBitMask

Tipo: DWORD

Máscara vermelha (ou luminância ou Y) para ler dados de cores. Por exemplo, dado o formato A8R8G8B8, a máscara vermelha seria 0x00ff0000.

dwGBitMask

Tipo: DWORD

Máscara verde (ou U) para leitura de dados de cores. Por exemplo, dado o formato A8R8G8B8, a máscara verde seria 0x0000ff00.

dwBBitMask

Tipo: DWORD

Máscara azul (ou V) para leitura de dados de cores. Por exemplo, dado o formato A8R8G8B8, a máscara azul seria 0x000000ff.

dwABitMask

Tipo: DWORD

Máscara alfa para leitura de dados alfa. dwFlags deve incluir DDPF_ALPHAPIXELS ou DDPF_ALPHA. Por exemplo, dado o formato A8R8G8B8, a máscara alfa seria 0xff000000.

Observações

Para armazenar formatos DXGI, como dados de ponto flutuante, use um dwFlags de DDPF_FOURCC e defina dwFourCC como 'D','X','1','0'. Use o cabeçalho da extensão DDS_HEADER_DXT10 para armazenar o formato DXGI no membro dxgiFormat .

Observe que há variantes não padrão de arquivos DDS onde dwFlags tem DDPF_FOURCC e o valor dwFourCC é definido diretamente como um D3DFORMAT ou DXGI_FORMAT valor de enumeração. Não é possível desambiguar os valores D3DFORMAT versus DXGI_FORMAT usando este esquema não padrão, portanto, o cabeçalho de extensão DX10 é recomendado.

Requerimentos

Consulte também

Referência para DDS