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
| Requisito | Valor |
|---|---|
| parâmetro |
|