estructura de DDS_HEADER_DXT10

Extensión de encabezado DDS para controlar matrices de recursos, formatos de píxeles DXGI que no se asignan a las estructuras de formato de píxeles de Microsoft DirectDraw heredadas y metadatos adicionales.

Sintaxis

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

Miembros

dxgiFormat

Tipo: DXGI_FORMAT

Formato de píxeles de superficie (vea DXGI_FORMAT).

resourceDimension

Tipo: D3D10_RESOURCE_DIMENSION

Identifica el tipo de recurso. Los valores siguientes para este miembro son un subconjunto de los valores de la enumeración D3D10_RESOURCE_DIMENSION o D3D11_RESOURCE_DIMENSION :

Tipo	Descripción	Valor
DDS_DIMENSION_TEXTURE1D (D3D10_RESOURCE_DIMENSION_TEXTURE1D)	El recurso es una textura 1D. El miembro dwWidth de DDS_HEADER especifica el tamaño de la textura. Normalmente, establece el miembro dwHeight de DDS_HEADER en 1; También debe establecer la marca DDSD_HEIGHT en el miembro dwFlags de DDS_HEADER.	2
DDS_DIMENSION_TEXTURE2D (D3D10_RESOURCE_DIMENSION_TEXTURE2D)	El recurso es una textura 2D con un área especificada por los miembros dwWidth y dwHeight de DDS_HEADER. También puede usar este tipo para identificar una textura de mapa de cubo. Para obtener más información sobre cómo identificar una textura de mapa de cubo, consulte miscFlag y arraySize members.	3
DDS_DIMENSION_TEXTURE3D (D3D10_RESOURCE_DIMENSION_TEXTURE3D)	El recurso es una textura 3D con un volumen especificado por los miembros dwWidth, dwHeight y dwDepth de DDS_HEADER. También debe establecer la marca DDSD_DEPTH en el miembro dwFlags de DDS_HEADER.	4

miscFlag

Tipo: UINT

Identifica otras opciones menos comunes para los recursos. El siguiente valor para este miembro es un subconjunto de los valores de la enumeración D3D10_RESOURCE_MISC_FLAG o D3D11_RESOURCE_MISC_FLAG :

Tipo	Descripción	Valor
DDS_RESOURCE_MISC_TEXTURECUBE	Indica que una textura 2D es una textura de mapa de cubo.	0x4

arraySize

Tipo: UINT

Número de elementos de la matriz.

Para una textura 2D que también es una textura de mapa de cubo, este número representa el número de cubos. Este número es el mismo que el número del miembro NumCubes de D3D10_TEXCUBE_ARRAY_SRV1 o D3D11_TEXCUBE_ARRAY_SRV). En este caso, el archivo DDS contiene texturas arraySize*6 2D. Para obtener más información sobre este caso, consulte la descripción de miscFlag .

Para una textura 3D, debe establecer este número en 1.

miscFlags2

Tipo: UINT

Contiene metadatos adicionales (anteriormente se reservaban). Los 3 bits inferiores indican el modo alfa del recurso asociado. Los 29 bits superiores están reservados y normalmente son 0.

Tipo	Descripción	Valor
DDS_ALPHA_MODE_UNKNOWN	El contenido del canal alfa es desconocido. Este es el valor de los archivos heredados, que normalmente se supone que es alfa "recto".	0x0
DDS_ALPHA_MODE_STRAIGHT	Se supone que cualquier contenido del canal alfa usa alfa recto.	0x1
DDS_ALPHA_MODE_PREMULTIPLIED	Cualquier contenido de canal alfa usa alfamultiplicado previamente. Los únicos formatos de archivo heredados que indican que esta información son "DX2" y "DX4".	0x2
DDS_ALPHA_MODE_OPAQUE	Todo el contenido del canal alfa se establece en totalmente opaco.	0x3
DDS_ALPHA_MODE_CUSTOM	Cualquier contenido de canal alfa se usa como un canal 4 y no está pensado para representar la transparencia (recta o premultiplicada).	0x4

Nota

Las bibliotecas de utilidades D3DX 10 y D3DX 11 heredadas no podrán cargar . DDS con miscFlags2 no es igual a cero.

Comentarios

Use esta estructura junto con un DDS_HEADER para almacenar una matriz de recursos en un archivo DDS. Para obtener más información, consulta matrices de texturas.

Este encabezado está presente si el miembro dwFourCC de la estructura DDS_PIXELFORMAT está establecido en "DX10".

Requisitos

Requisito	Value
Encabezado	Dds.h

Consulte también

Referencia de DDS