Compartilhar via

estrutura DDS_HEADER_DXT10

  • Artigo

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

Requisito Valor
parâmetro
Dds.h

Confira também

Referência para DDS