Guia de programação para DDS

O Direct3D implementa o formato de arquivo DDS para armazenar texturas DXTn (descompactadas ou compactadas). O formato de arquivo implementa vários tipos ligeiramente diferentes projetados para armazenar diferentes tipos de dados e dá suporte a texturas de camada única, texturas com mipmaps, mapas de cubo, mapas de volume e matrizes de textura (no Direct3D 10/11). Esta seção descreve o layout de um arquivo DDS.

Para obter ajuda para criar uma textura no Direct3D 11, consulte How to: Create a Texture. Para obter ajuda no Direct3D 9, consulte Suporte à textura noD3DX (Direct3D 9).

• de layout de arquivo DDS
• variantes DDS
• usando matrizes de textura no Direct3D 11/10
• formatos comuns de recurso de arquivo DDS e conteúdo de cabeçalho associado
• tópicos relacionados

Layout do arquivo DDS

Um arquivo DDS é um arquivo binário que contém as seguintes informações:

• Um DWORD (número mágico) que contém o valor de código de quatro caracteres 'DDS' (0x20534444).

• Uma descrição dos dados no arquivo.

  Os dados são descritos com uma descrição de cabeçalho usando DDS_HEADER; o formato de pixel é definido usando DDS_PIXELFORMAT. Observe que as estruturas DDS_HEADER e DDS_PIXELFORMAT substituem as estruturas DDSURFACEDESC2, DDSCAPS2 e DDPIXELFORMAT DirectDraw 7 preteridas. DDS_HEADER é o equivalente binário de DDSURFACEDESC2 e DDSCAPS2. DDS_PIXELFORMAT é o equivalente binário de DDPIXELFORMAT.

  DWORD               dwMagic;
  DDS_HEADER          header;
  
  

  Se o DDS_PIXELFORMAT dwFlags estiver definido como DDPF_FOURCC e dwFourCC estiver definido como "DX10" uma estrutura de DDS_HEADER_DXT10 adicional estará presente para acomodar matrizes de textura ou formatos DXGI que não podem ser expressos como um formato de pixel RGB, como formatos de ponto flutuante, formatos sRGB etc. Quando a estrutura de DDS_HEADER_DXT10 estiver presente, toda a descrição de dados será semelhante a esta.

  DWORD               dwMagic;
  DDS_HEADER          header;
  DDS_HEADER_DXT10    header10;
  

• Um ponteiro para uma matriz de bytes que contém os dados principais da superfície.

  BYTE bdata[]
  

• Um ponteiro para uma matriz de bytes que contém as superfícies restantes, como; níveis de mipmap, faces em um mapa de cubo, profundidades em uma textura de volume. Siga estes links para obter mais informações sobre o layout do arquivo DDS para: de textura, um mapa de cubo ou uma textura de volume .

  BYTE bdata2[]
  

Para obter amplo suporte a hardware, recomendamos que você use o 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 formato DXGI_FORMAT_BC3_UNORM_SRGB.

Para obter mais informações sobre formatos de textura compactada, consulte Compactação de blocos de textura no Direct3D 11 e compactação de bloco (Direct3D 10).

A biblioteca D3DX (por exemplo, D3DX11.lib) e outras bibliotecas semelhantes fornecem de forma injustificada ou inconsistente o valor de pitch no dwPitchOrLinearSize membro da estrutura DDS_HEADER. Portanto, ao ler e gravar em arquivos DDS, recomendamos que você compute o pitch de uma das seguintes maneiras para os formatos indicados:

• Para formatos compactados em bloco, compute o pitch como:

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

  O tamanho do bloco é de 8 bytes para formatos DXT1, BC1 e BC4 e 16 bytes para outros formatos compactados em bloco.

• Para R8G8_B8G8, G8R8_G8B8, formatos herdados repletos de UYVY e herdados repletos de YUY2, compute o pitch como:

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

• Para outros formatos, compute o pitch como:

  ( largura * bits por pixel + 7 ) / 8

  Você divide por 8 para alinhamento de bytes.

Variantes do DDS

Há muitas ferramentas que criam e consomem arquivos DDS, mas podem variar nos detalhes do que precisam no cabeçalho. Os gravadores devem preencher os cabeçalhos da maneira mais completa possível, e os leitores devem verificar os valores mínimos para obter a compatibilidade máxima. Para validar um arquivo DDS, um leitor deve garantir que o arquivo tenha pelo menos 128 bytes de comprimento para acomodar o valor mágico e o cabeçalho básico, o valor mágico é 0x20534444 ("DDS"), o tamanho do DDS_HEADER é 124 e o DDS_PIXELFORMAT no tamanho do cabeçalho é 32. Se o DDS_PIXELFORMAT dwFlags estiver definido como DDPF_FOURCC e um dwFourCC estiver definido como "DX10", o tamanho total do arquivo precisará ser de pelo menos 148 bytes.

Há algumas variantes comuns em uso em que o formato de pixel é definido como um código DDPF_FOURCC em que dwFourCC é definido como um valor de enumeração D3DFORMAT ou DXGI_FORMAT. Não há como saber se um valor de enumeração é um D3DFORMAT ou um DXGI_FORMAT, portanto, é altamente recomendável que a extensão "DX10" e o cabeçalho DDS_HEADER_DXT10 sejam usados para armazenar o dxgiFormat quando o DDS_PIXELFORMAT básico não puder expressar o formato.

O DDS_PIXELFORMAT padrão deve ser preferencial para a compatibilidade máxima para armazenar dados não compactados RGB e dados DXT1-5, pois nem todas as ferramentas DDS dão suporte à extensão DX10.

Usando matrizes de textura no Direct3D 10/11

As novas estruturas DDS (DDS_HEADER e DDS_HEADER_DXT10) no Direct3D 10/11 estendem o formato de arquivo DDS para dar suporte a uma matriz de texturas, que é um novo tipo de recurso no Direct3D 10/11. Aqui está um código de exemplo que mostra como acessar os diferentes níveis de mipmap em uma matriz de texturas, usando os novos cabeçalhos.

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++)
   {
     ...
   }
}       

Formatos comuns de recurso de arquivo DDS e conteúdo de cabeçalho associado

* = Um leitor DDS robusto deve ser capaz de lidar com esses códigos de formato herdados. No entanto, esse leitor de DDS deve preferir usar a extensão de cabeçalho "DX10" ao gravar esses códigos de formato para evitar ambiguidade.

** = Devido a alguns problemas de longa data em implementações comuns de leitores e gravadores de DDS, a maneira mais robusta de escrever dados de tipo 10:10:10:2 é usar a extensão de cabeçalho "DX10" com o código DXGI_FORMAT "24" (ou seja, o valor DXGI_FORMAT_R10G10B10A2_UNORM). D3DFMT_A2R10G10B10 dados devem ser convertidos em dados de tipo 10:10:10:2 antes de serem gravados como um arquivo DDS de formato DXGI_FORMAT_R10G10B10A2_UNORM.

Tópicos relacionados

DDS