structure DDS_HEADER_DXT10

Extension d’en-tête DDS pour gérer les tableaux de ressources, les formats de pixels DXGI qui ne sont pas mappés aux structures de format de pixels Microsoft DirectDraw héritées et les métadonnées supplémentaires.

Syntaxe

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

Membres

dxgiFormat

Type : DXGI_FORMAT

Format de pixels de surface (voir DXGI_FORMAT).

resourceDimension

Type : D3D10_RESOURCE_DIMENSION

Identifie le type de ressource. Les valeurs suivantes pour ce membre sont un sous-ensemble des valeurs de l’énumération D3D10_RESOURCE_DIMENSION ou D3D11_RESOURCE_DIMENSION :

Type	Description	Valeur
DDS_DIMENSION_TEXTURE1D (D3D10_RESOURCE_DIMENSION_TEXTURE1D)	La ressource est une texture 1D. Le membre dwWidth de DDS_HEADER spécifie la taille de la texture. En règle générale, vous définissez le membre dwHeight de DDS_HEADER sur 1 ; vous devez également définir l’indicateur DDSD_HEIGHT dans le membre dwFlags de DDS_HEADER.	2
DDS_DIMENSION_TEXTURE2D (D3D10_RESOURCE_DIMENSION_TEXTURE2D)	La ressource est une texture 2D avec une zone spécifiée par les membres dwWidth et dwHeight de DDS_HEADER. Vous pouvez également utiliser ce type pour identifier une texture de carte de cube. Pour plus d’informations sur l’identification d’une texture de carte de cube, consultez miscFlag et arraySize members.	3
DDS_DIMENSION_TEXTURE3D (D3D10_RESOURCE_DIMENSION_TEXTURE3D)	La ressource est une texture 3D avec un volume spécifié par les membres dwWidth, dwHeight et dwDepth de DDS_HEADER. Vous devez également définir l’indicateur DDSD_DEPTH dans le membre dwFlags de DDS_HEADER.	4

miscFlag

Type : UINT

Identifie d’autres options moins courantes pour les ressources. La valeur suivante pour ce membre est un sous-ensemble des valeurs de l’énumération D3D10_RESOURCE_MISC_FLAG ou D3D11_RESOURCE_MISC_FLAG :

Type	Description	Valeur
DDS_RESOURCE_MISC_TEXTURECUBE	Indique qu’une texture 2D est une texture de carte de cube.	0x4

arraySize

Type : UINT

Nombre d’éléments dans le tableau.

Pour une texture 2D qui est également une texture de carte de cube, ce nombre représente le nombre de cubes. Ce nombre est identique au nombre dans le membre NumCubes de D3D10_TEXCUBE_ARRAY_SRV1 ou D3D11_TEXCUBE_ARRAY_SRV). Dans ce cas, le fichier DDS contient des textures 2D arraySize*6. Pour plus d’informations sur ce cas, consultez la description de miscFlag .

Pour une texture 3D, vous devez définir ce nombre sur 1.

miscFlags2

Type : UINT

Contient des métadonnées supplémentaires (anciennement réservées). Les 3 bits inférieurs indiquent le mode alpha de la ressource associée. Les 29 bits supérieurs sont réservés et sont généralement 0.

Type	Description	Valeur
DDS_ALPHA_MODE_UNKNOWN	Le contenu du canal alpha est inconnu. Il s’agit de la valeur des fichiers hérités, qui est généralement supposée être « droite » alpha.	0x0
DDS_ALPHA_MODE_STRAIGHT	Tout contenu de canal alpha est présumé utiliser l’alpha droit.	0x1
DDS_ALPHA_MODE_PREMULTIPLIED	Tout contenu de canal alpha utilise l’alpha prémultiplié. Les seuls formats de fichiers hérités qui indiquent ces informations sont « DX2 » et « DX4 ».	0x2
DDS_ALPHA_MODE_OPAQUE	Tout contenu de canal alpha est entièrement opaque.	0x3
DDS_ALPHA_MODE_CUSTOM	Tout contenu de canal alpha est utilisé en tant que 4e canal et n’est pas destiné à représenter la transparence (droit ou prémultiplié).	0x4

Notes

Les bibliothèques d’utilitaires D3DX 10 et D3DX 11 héritées ne parviennent pas à charger . Fichier DDS avec miscFlags2 non égal à zéro.

Notes

Utilisez cette structure avec un DDS_HEADER pour stocker un tableau de ressources dans un fichier DDS. Pour plus d’informations, consultez Tableaux de textures.

Cet en-tête est présent si le membre dwFourCC de la structure DDS_PIXELFORMAT est défini sur « DX10 ».

Spécifications

Voir aussi

Référence pour DDS