_Structure d’en-tête DDS
Décrit un en-tête de fichier DDS.
Syntaxe
typedef struct {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHeight;
DWORD dwWidth;
DWORD dwPitchOrLinearSize;
DWORD dwDepth;
DWORD dwMipMapCount;
DWORD dwReserved1[11];
DDS_PIXELFORMAT ddspf;
DWORD dwCaps;
DWORD dwCaps2;
DWORD dwCaps3;
DWORD dwCaps4;
DWORD dwReserved2;
} DDS_HEADER;
Membres
-
dwSize nul
-
Type : DWORD
-
Taille de la structure. Ce membre doit avoir la valeur 124.
-
dwFlags
-
Type : DWORD
-
Indicateurs indiquant les membres qui contiennent des données valides.
Indicateur Description Valeur DDSD _ Cap Obligatoire dans chaque fichier. DDS. 0x1 hauteur de DDSD _ Obligatoire dans chaque fichier. DDS. 0x2 largeur de DDSD _ Obligatoire dans chaque fichier. DDS. 0x4 DDSD _ Obligatoire lorsque le pas à pas est fourni pour une texture non compressée. 0x8 DDSD _ PIXELFORMAT Obligatoire dans chaque fichier. DDS. 0x1000 DDSD _ MIPMAPCOUNT Obligatoire dans une texture mipmapped. 0x20000 DDSD _ LINEARSIZE Obligatoire lorsque le pas à pas est fourni pour une texture compressée. 0x80000 DDSD _ profondeur) Obligatoire dans une texture de profondeur. 0x800000 Notes
Lorsque vous écrivez des fichiers. DDS, vous devez définir les _ indicateurs DDSD Cap et DDSD _ PIXELFORMAT, et pour les textures mipmapped, vous devez également définir l' _ indicateur DDSD MIPMAPCOUNT. Toutefois, lorsque vous lisez un fichier. DDS, vous ne devez pas vous appuyer sur les _ indicateurs DDSD Cap, DDSD _ PIXELFORMAT et DDSD _ MIPMAPCOUNT définis, car certains enregistreurs d’un tel fichier peuvent ne pas définir ces indicateurs.
L' _ indicateur de _ texture d’indicateurs d’en-tête DDS _ , qui est défini dans DDS. h, est une combinaison au niveau du bit or de la DDSD _ Cap, de DDSD _ Height, de DDSD _ Width et DDSD _ PIXELFORMAT Flags.
L' _ indicateur MIPMAP des indicateurs d’en-tête DDS _ _ , qui est défini dans DDS. h, est égal à l' _ indicateur DDSD MIPMAPCOUNT.
L' _ _ indicateur de volume Flags de l’en-tête DDS _ , qui est défini dans DDS. h, est égal à l' _ indicateur de profondeur DDSD.
L' _ _ indicateur de tangage des indicateurs d’en-tête DDS _ , qui est défini dans DDS. h, est égal à l’indicateur de pas DDSD _ .
L' _ indicateur LINEARSIZE de l’en-tête DDS _ _ , défini dans DDS. h, est égal à l' _ indicateur DDSD LINEARSIZE.
-
dwHeight
-
Type : DWORD
-
Hauteur de la surface (en pixels).
-
dwWidth
-
Type : DWORD
-
Largeur de la surface (en pixels).
-
dwPitchOrLinearSize
-
Type : DWORD
-
La hauteur ou le nombre d’octets par ligne d’analyse dans une texture non compressée ; nombre total d’octets dans la texture de niveau supérieur pour une texture compressée. Pour plus d’informations sur la façon de calculer le pas, consultez la section relative au format de fichier DDS dans le Guide de programmation pour DDS.
-
dwDepth
-
Type : DWORD
-
Profondeur d’une texture de volume (en pixels), sinon inutilisée.
-
dwMipMapCount
-
Type : DWORD
-
Nombre de niveaux de mipmap, sinon non utilisé.
-
dwReserved1 [ 11]
-
Type : DWORD
-
Inutilisé.
-
ddspf
-
Type : DDS _ PIXELFORMAT
-
Le format de pixel (voir DDS _ PIXELFORMAT).
-
dwCaps
-
Type : DWORD
-
Spécifie la complexité des surfaces stockées.
Indicateur Description Valeur DDSCAPS _ complexe Facultatif doit être utilisé sur tout fichier qui contient plusieurs surfaces (un mipmap, une carte d’environnement cubique ou une texture de volume mipmapped). 0x8 _MIPMAP DDSCAPS Facultatif doit être utilisé pour un mipmap. 0x400000 _texture DDSCAPS Obligatoire 0x1000 Notes
Lorsque vous écrivez des fichiers. DDS, vous devez définir l' _ indicateur de texture DDSCAPS et, pour plusieurs surfaces, vous devez également définir l' _ indicateur complexe DDSCAPS. Toutefois, lorsque vous lisez un fichier. DDS, vous ne devez pas vous appuyer sur la _ texture DDSCAPS et les _ indicateurs complexes DDSCAPS sont définis, car certains enregistreurs d’un tel fichier peuvent ne pas définir ces indicateurs.
L' _ _ _ indicateur mipmap des indicateurs de surface DDS, qui est défini dans DDS. h, est une combinaison de bits or des _ indicateurs mipmap DDSCAPS et DDSCAPS _ .
L' _ _ _ indicateur de texture indicateurs de surface DDS, qui est défini dans DDS. h, est égal à l' _ indicateur de texture DDSCAPS.
L' _ indicateur carte cubique des indicateurs de surface DDS _ _ , défini dans DDS. h, est égal à l' _ indicateur complexe DDSCAPS.
-
dwCaps2
-
Type : DWORD
-
Détails supplémentaires sur les surfaces stockées.
Indicateur Description Valeur DDSCAPS2 _ carte cubique Requis pour un mappage de cube. 0x200 DDSCAPS2 _ carte cubique _ POSITIVEX Obligatoire lorsque ces surfaces sont stockées dans un mappage de cube. 0x400 DDSCAPS2 _ carte cubique _ NEGATIVEX Obligatoire lorsque ces surfaces sont stockées dans un mappage de cube. 0x800 DDSCAPS2 _ carte cubique _ positif Obligatoire lorsque ces surfaces sont stockées dans un mappage de cube. 0x1000 DDSCAPS2 _ carte cubique _ négatif Obligatoire lorsque ces surfaces sont stockées dans un mappage de cube. 0x2000 DDSCAPS2 _ carte cubique _ POSITIVEZ Obligatoire lorsque ces surfaces sont stockées dans un mappage de cube. 0x4000 DDSCAPS2 _ carte cubique _ NEGATIVEZ Obligatoire lorsque ces surfaces sont stockées dans un mappage de cube. 0x8000 _Volume DDSCAPS2 Requis pour une texture de volume. 0x200000 L' _ indicateur DDS carte cubique _ POSITIVEX, qui est défini dans DDS. h, est une combinaison or au niveau du bit des _ indicateurs DDSCAPS2 carte cubique _ et _ DDSCAPS2 carte cubique POSITIVEX.
L' _ indicateur DDS carte cubique _ NEGATIVEX, qui est défini dans DDS. h, est une combinaison or au niveau du bit des _ indicateurs DDSCAPS2 carte cubique _ et _ DDSCAPS2 carte cubique NEGATIVEX.
L' _ _ indicateur de positif DDS carte cubique, qui est défini dans DDS. h, est une combinaison au niveau du bit or des _ indicateurs positifs DDSCAPS2 carte cubique et DDSCAPS2 _ carte cubique _ .
L' _ _ indicateur de négatif DDS carte cubique, qui est défini dans DDS. h, est une combinaison au niveau du bit ou de la DDSCAPS2 _ carte cubique et DDSCAPS2 _ carte cubique les _ indicateurs négatifs.
L' _ indicateur DDS carte cubique _ POSITIVEZ, qui est défini dans DDS. h, est une combinaison or au niveau du bit des _ indicateurs DDSCAPS2 carte cubique _ et _ DDSCAPS2 carte cubique POSITIVEZ.
L' _ indicateur DDS carte cubique _ NEGATIVEZ, qui est défini dans DDS. h, est une combinaison or au niveau du bit des _ indicateurs DDSCAPS2 carte cubique _ et _ DDSCAPS2 carte cubique NEGATIVEZ.
L' _ indicateur DDS carte cubique _ ALLFACES, qui est défini dans DDS. h, est une combinaison or au niveau du bit des _ carte cubique DDS _ POSITIVEX, DDS _ carte cubique _ NEGATIVEX, DDS _ carte cubique _ positive, DDS _ carte cubique _ Negative, DDS _ carte cubique _ POSITIVEZ et DDSCAPS2 _ _ carte cubique NEGATIVEZ.
L' _ _ indicateur de volume des indicateurs DDS, défini dans DDS. h, est égal à l' _ indicateur de volume DDSCAPS2.
Notes
Bien que Direct3D 9 prenne en charge les mappages de cubes partiels, Direct3D 10, 10,1 et 11 nécessitent que vous définissiez les six visages de mappage de cube (autrement dit, vous devez définir DDS _ carte cubique _ ALLFACES).
-
dwCaps3
-
Type : DWORD
-
Inutilisé.
-
dwCaps4
-
Type : DWORD
-
Inutilisé.
-
dwReserved2
-
Type : DWORD
-
Inutilisé.
Remarques
Incluez les indicateurs dans dwFlags pour les membres de la structure qui contiennent des données valides.
Utilisez cette structure en association avec un _ en-tête DDS _ DXT10 pour stocker un tableau de ressources dans un fichier DDS. Pour plus d’informations, consultez tableaux de texture.
DDS _ L’en-tête est identique à la structure DDSURFACEDESC2 de DirectDraw sans les dépendances DirectDraw.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|