Guide de programmation pour DDS

Direct3D implémente le format de fichier DDS pour stocker des textures non compressées ou compressées (DXTn). Le format de fichier implémente plusieurs types légèrement différents conçus pour stocker différents types de données et prend en charge des textures à couche unique, des textures avec des mipmaps, des mappages de cube, des cartes de volume et des tableaux de textures (dans Direct3D 10/11). Cette section décrit la disposition d’un fichier DDS.

Pour obtenir de l’aide sur la création d’une texture dans Direct3D 11, consultez How to : Create a Texture. Pour obtenir de l’aide dans Direct3D 9, consultez prise en charge des textures dans D3DX (Direct3D 9).

• disposition des fichiers DDS
• variantes DDS
• utilisation de tableaux de textures dans Direct3D 10/11
• formats de ressources de fichiers DDS courants et le contenu d’en-tête associé
• rubriques connexes

Disposition du fichier DDS

Un fichier DDS est un fichier binaire qui contient les informations suivantes :

• DWORD (nombre magique) contenant la valeur de code de quatre caractères « DDS » (0x20534444).

• Description des données dans le fichier.

  Les données sont décrites avec une description d’en-tête à l’aide de DDS_HEADER; le format de pixel est défini à l’aide de DDS_PIXELFORMAT. Notez que les structures DDS_HEADER et DDS_PIXELFORMAT remplacent les structures DDSURFACEDESC2 déconseillées, DDSCAPS2 et DDPIXELFORMAT DirectDraw 7. DDS_HEADER est l’équivalent binaire de DDSURFACEDESC2 et de DDSCAPS2. DDS_PIXELFORMAT est l’équivalent binaire de DDPIXELFORMAT.

  DWORD               dwMagic;
  DDS_HEADER          header;
  
  

  Si le DDS_PIXELFORMAT dwFlags est défini sur DDPF_FOURCC et dwFourCC est défini sur « DX10 », une structure de DDS_HEADER_DXT10 supplémentaire sera présente pour prendre en charge les tableaux de textures ou les formats DXGI qui ne peuvent pas être exprimés en tant que format de pixel RVB, tels que les formats à virgule flottante, les formats sRGB, etc. Lorsque la structure DDS_HEADER_DXT10 est présente la description complète des données ressemble à ceci.

  DWORD               dwMagic;
  DDS_HEADER          header;
  DDS_HEADER_DXT10    header10;
  

• Pointeur vers un tableau d’octets qui contient les données de surface principale.

  BYTE bdata[]
  

• Pointeur vers un tableau d’octets qui contient les surfaces restantes telles que ; niveaux mipmap, visages dans une carte de cube, profondeurs dans une texture de volume. Suivez ces liens pour plus d’informations sur la disposition de fichier DDS pour un de texture, une carte de cube ou une texture de volume .

  BYTE bdata2[]
  

Pour une prise en charge matérielle étendue, nous vous recommandons d’utiliser les DXGI_FORMAT_R8G8B8A8_UNORM, DXGI_FORMAT_R8G8B8A8_UNORM_SRGB, DXGI_FORMAT_R8G8B8A8_SNORM, DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_R16G16_SNORM, DXGI_FORMAT_R8G8_SNORM, DXGI_FORMAT_R8_UNORM, DXGI_FORMAT_BC1_UNORM, DXGI_FORMAT_BC1_UNORM_SRGB, DXGI_FORMAT_BC2_UNORM, DXGI_FORMAT_BC2_UNORM_SRGB, DXGI_FORMAT_BC3_UNORMou DXGI_FORMAT_BC3_UNORM_SRGB format.

Pour plus d’informations sur les formats de texture compressés, consultez compression de bloc de texture dans direct3D 11 et compression de bloc (Direct3D 10).

La bibliothèque D3DX (par exemple, D3DX11.lib) et d’autres bibliothèques similaires ne fournissent pas de manière incorrecte ou incohérente la valeur de pitch dans le dwPitchOrLinearSize membre de la structure DDS_HEADER. Par conséquent, lorsque vous lisez et écrivez dans des fichiers DDS, nous vous recommandons de calculer le pitch de l’une des manières suivantes pour les formats indiqués :

• Pour les formats compressés par bloc, calculez l’emplacement comme suit :

  max( 1, ((width+3)/4) ) * taille de bloc

  La taille de bloc est de 8 octets pour les formats DXT1, BC1 et BC4 et 16 octets pour les autres formats compressés par bloc.

• Pour R8G8_B8G8, G8R8_G8B8, les formats UYVY-packed hérités et yuY2 hérités, calculez l’emplacement comme suit :

  ((width+1) >> 1) * 4

• Pour d’autres formats, calculez l’emplacement comme suit :

  ( width * bits par pixel + 7 ) / 8

  Vous divisez par 8 pour l’alignement d’octets.

Variantes DDS

Il existe de nombreux outils qui créent et consomment des fichiers DDS, mais ils peuvent varier dans les détails de ce dont ils ont besoin dans l’en-tête. Les enregistreurs doivent remplir les en-têtes autant que possible, et les lecteurs doivent vérifier les valeurs minimales pour une compatibilité maximale. Pour valider un fichier DDS, un lecteur doit s’assurer que le fichier est d’au moins 128 octets de long pour prendre en charge la valeur magique et l’en-tête de base, la valeur magique est 0x20534444 (« DDS »), la taille du DDS_HEADER est 124 et la DDS_PIXELFORMAT dans la taille d’en-tête est 32. Si le DDS_PIXELFORMAT dwFlags est défini sur DDPF_FOURCC et qu’un dwFourCC est défini sur « DX10 », la taille totale du fichier doit être d’au moins 148 octets.

Certaines variantes courantes sont utilisées lorsque le format de pixel est défini sur un code DDPF_FOURCC où dwFourCC est défini sur une valeur d’énumération D3DFORMAT ou DXGI_FORMAT. Il n’existe aucun moyen de savoir si une valeur d’énumération est un D3DFORMAT ou un DXGI_FORMAT. Il est donc vivement recommandé que l’extension « DX10 » et DDS_HEADER_DXT10 en-tête soit utilisé à la place pour stocker le dxgiFormat lorsque le DDS_PIXELFORMAT de base ne peut pas exprimer le format.

L’DDS_PIXELFORMAT standard doit être préférable pour une compatibilité maximale pour stocker les données RVB non compressées et les données DXT1-5, car tous les outils DDS ne prennent pas en charge l’extension DX10.

Utilisation de tableaux de textures dans Direct3D 10/11

Les nouvelles structures DDS (DDS_HEADER et DDS_HEADER_DXT10) dans Direct3D 10/11 étendent le format de fichier DDS pour prendre en charge un tableau de textures, qui est un nouveau type de ressource dans Direct3D 10/11. Voici un exemple de code qui montre comment accéder aux différents niveaux mipmap dans un tableau de textures, à l’aide des nouveaux en-têtes.

DWORD               dwMagic;
DDS_HEADER          header;
DDS_HEADER_DXT10    header10;
   
for (int iArrayElement = 0; iArrayElement < header10.arraySize; iArrayElement++)
{
   for (int iMipLevel = 0; iMipLevel < header.dwMipMapCount; iMipLevel++)
   {
     ...
   }
}       

Formats de ressources de fichiers DDS courants et contenu d’en-tête associé

* = Un lecteur DDS robuste doit être en mesure de gérer ces codes de format hérités. Toutefois, un tel lecteur DDS doit préférer utiliser l’extension d’en-tête « DX10 » lorsqu’il écrit ces codes de format pour éviter toute ambiguïté.

** = En raison de problèmes de longue date dans les implémentations courantes des lecteurs et des enregistreurs DDS, la méthode la plus robuste pour écrire des données de type 10:10:10:2 consiste à utiliser l’extension d’en-tête « DX10 » avec le code DXGI_FORMAT « 24 » (autrement dit, la valeur DXGI_FORMAT_R10G10B10A2_UNORM). D3DFMT_A2R10G10B10 données doivent être converties en données de type 10:10:2 avant d’être écrites en tant que fichier DDS au format DXGI_FORMAT_R10G10B10A2_UNORM.

Rubriques connexes

DDS