estrutura DDS_HEADER_DXT10

Extensão de cabeçalho DDS para lidar com matrizes de recursos, formatos de pixel DXGI que não são mapeados para as estruturas de formato de pixel herdadas do Microsoft DirectDraw e metadados adicionais.

Sintaxe

typedef struct {
  DXGI_FORMAT              dxgiFormat;
  D3D10_RESOURCE_DIMENSION resourceDimension;
  UINT                     miscFlag;
  UINT                     arraySize;
  UINT                     miscFlags2;
} DDS_HEADER_DXT10;

Membros

dxgiFormat

Tipo: DXGI_FORMAT

O formato de pixel de superfície (consulte DXGI_FORMAT).

resourceDimension

Tipo: D3D10_RESOURCE_DIMENSION

Identifica o tipo de recurso. Os seguintes valores para esse membro são um subconjunto dos valores na enumeração D3D10_RESOURCE_DIMENSION ou D3D11_RESOURCE_DIMENSION :

Tipo	Descrição	Valor
DDS_DIMENSION_TEXTURE1D (D3D10_RESOURCE_DIMENSION_TEXTURE1D)	O recurso é uma textura 1D. O membro dwWidth do DDS_HEADER especifica o tamanho da textura. Normalmente, você define o membro dwHeight de DDS_HEADER como 1; você também deve definir o sinalizador DDSD_HEIGHT no membro dwFlags do DDS_HEADER.	2
DDS_DIMENSION_TEXTURE2D (D3D10_RESOURCE_DIMENSION_TEXTURE2D)	O recurso é uma textura 2D com uma área especificada pelos membros dwWidth e dwHeight de DDS_HEADER. Você também pode usar esse tipo para identificar uma textura de mapa de cubo. Para obter mais informações sobre como identificar uma textura de mapa de cubo, consulte miscFlag e arraySize members.	3
DDS_DIMENSION_TEXTURE3D (D3D10_RESOURCE_DIMENSION_TEXTURE3D)	O recurso é uma textura 3D com um volume especificado pelos membros dwWidth, dwHeight e dwDepth de DDS_HEADER. Você também deve definir o sinalizador DDSD_DEPTH no membro dwFlags do DDS_HEADER.	4

miscFlag

Tipo: UINT

Identifica outras opções menos comuns para recursos. O seguinte valor para esse membro é um subconjunto dos valores na enumeração D3D10_RESOURCE_MISC_FLAG ou D3D11_RESOURCE_MISC_FLAG :

Tipo	Descrição	Valor
DDS_RESOURCE_MISC_TEXTURECUBE	Indica que uma textura 2D é uma textura de mapa de cubo.	0x4

arraySize

Tipo: UINT

O número de elementos na matriz.

Para uma textura 2D que também é uma textura de mapa de cubo, esse número representa o número de cubos. Esse número é o mesmo que o número no membro NumCubes de D3D10_TEXCUBE_ARRAY_SRV1 ou D3D11_TEXCUBE_ARRAY_SRV). Nesse caso, o arquivo DDS contém texturas arraySize*6 2D. Para obter mais informações sobre esse caso, consulte a descrição miscFlag .

Para uma textura 3D, você deve definir esse número como 1.

miscFlags2

Tipo: UINT

Contém metadados adicionais (antes era reservado). Os 3 bits inferiores indicam o modo alfa do recurso associado. Os 29 bits superiores são reservados e normalmente são 0.

Tipo	Descrição	Valor
DDS_ALPHA_MODE_UNKNOWN	O conteúdo do canal alfa é desconhecido. Esse é o valor para arquivos herdados, que normalmente se supõe ser alfa "reto".	0x0
DDS_ALPHA_MODE_STRAIGHT	Presume-se que qualquer conteúdo de canal alfa use alfa reto.	0x1
DDS_ALPHA_MODE_PREMULTIPLIED	Qualquer conteúdo de canal alfa está usando alfa pré-multiplicado. Os únicos formatos de arquivo herdados que indicam essas informações são 'DX2' e 'DX4'.	0x2
DDS_ALPHA_MODE_OPAQUE	Qualquer conteúdo de canal alfa está definido como totalmente opaco.	0x3
DDS_ALPHA_MODE_CUSTOM	Qualquer conteúdo de canal alfa está sendo usado como um 4º canal e não se destina a representar transparência (reto ou pré-multiplicado).	0x4

Observação

As bibliotecas de utilitários D3DX 10 e D3DX 11 herdadas falharão ao carregar qualquer . Arquivo DDS com miscFlags2 não igual a zero.

Comentários

Use essa estrutura junto com um DDS_HEADER para armazenar uma matriz de recursos em um arquivo DDS. Para obter mais informações, consulte matrizes de textura.

Esse cabeçalho estará presente se o membro dwFourCC da estrutura DDS_PIXELFORMAT estiver definido como 'DX10'.

Requisitos

Confira também

Referência para DDS