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 les textures à couche unique, les textures avec mipmaps, les mappages de cube, les mappages de volumes et les 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 Guide pratique pour créer une texture. Pour obtenir de l’aide sur Direct3D 9, consultez Prise en charge des textures dans D3DX (Direct3D 9).

• Disposition du fichier DDS
• Variantes DDS
• Utilisation de tableaux de textures dans Direct3D 10/11
• Formats de ressources de fichier DDS courants et contenu d’en-tête associé
• Rubriques connexes

Disposition du fichier DDS

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

• Un DWORD (nombre magique) contenant la valeur codée des quatre caractères "DDS " (0x20534444).

• Une description des données du 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, DDSCAPS2 et DDPIXELFORMAT DirectDraw 7 dépréciées. DDS_HEADER est l’équivalent binaire de DDSURFACEDESC2 et 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 que dwFourCC est défini sur « DX10 », une structure de DDS_HEADER_DXT10 supplémentaire est présente pour prendre en charge les tableaux de textures ou les formats DXGI qui ne peuvent pas être exprimés sous la forme d’un format de pixel RVB tel que des formats à virgule flottante, des 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 principales données de surface.

  BYTE bdata[]
  

• Pointeur vers un tableau d’octets qui contient les surfaces restantes telles que niveaux de mipmap, faces dans un plan de cube, profondeurs dans une texture de volume. Suivez ces liens pour plus d’informations sur le schéma du fichier DDS pour une texture, un mappage 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_UNORM ou format DXGI_FORMAT_BC3_UNORM_SRGB.

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

La bibliothèque D3DX (par exemple, D3DX11.lib) et d’autres bibliothèques similaires fournissent de manière non ou incohérente la valeur pitch dans le membre dwPitchOrLinearSize 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 le pitch comme suit :

  max( 1, ((width+3)/4) ) * block-size

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

• Pour R8G8_B8G8, G8R8_G8B8, les formats uYVY hérités et les formats yuY2-pack hérités, calculez le pitch comme suit :

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

• Pour les autres formats, calculez le pitch comme suit :

  ( width * bits-per-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 rédacteurs doivent remplir les en-têtes aussi complètement que possible, et les lecteurs doivent case activée 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 pour tenir compte de la valeur magique et de l’en-tête de base, que la valeur magique est 0x20534444 (« DDS »), que la taille du DDS_HEADER est 124 et que 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.

Il existe quelques variantes courantes dans lesquelles 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 fortement recommandé d’utiliser l’extension « DX10 » et l’en-tête DDS_HEADER_DXT10 pour stocker le dxgiFormat lorsque le DDS_PIXELFORMAT de base ne peut pas exprimer le format.

Le DDS_PIXELFORMAT standard doit être préféré pour une compatibilité maximale afin de 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 fichier 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 certains 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:10:2 avant d’être écrites en tant que fichier DDS au format DXGI_FORMAT_R10G10B10A2_UNORM.

Rubriques connexes

DDS