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
| Condition requise | Valeur |
|---|---|
| En-tête |
|