Przewodnik programowania dla usługi DDS

Direct3D implementuje format pliku DDS do przechowywania nieskompresowanych lub skompresowanych tekstur (DXTn). Format pliku implementuje kilka nieco różnych typów przeznaczonych do przechowywania różnych typów danych i obsługuje tekstury pojedynczej warstwy, tekstury z mapami mip, mapami modułów, mapami woluminów i tablicami tekstur (w trybie Direct3D 10/11). W tej sekcji opisano układ pliku DDS.

Aby uzyskać pomoc dotyczącą tworzenia tekstury w wersji Direct3D 11, zobacz Instrukcje: tworzenie tekstury. Aby uzyskać pomoc w programie Direct3D 9, zobacz obsługa tekstur w D3DX (Direct3D 9).

• układu plików DDS
• warianty DDS
• używanie tablic tekstur w Direct3D 10/11
• typowe formaty zasobów plików DDS i skojarzona zawartość nagłówka
• Tematy pokrewne

Układ pliku DDS

Plik DDS jest plikiem binarnym zawierającym następujące informacje:

• DWORD (liczba magiczna) zawierająca czteroznaczną wartość kodu "DDS" (0x20534444).

• Opis danych w pliku.

  Dane są opisane za pomocą opisu nagłówka przy użyciu DDS_HEADER; format pikseli jest definiowany przy użyciu DDS_PIXELFORMAT. Należy pamiętać, że struktury DDS_HEADER i DDS_PIXELFORMAT zastępują przestarzałe struktury DDSURFACEDESC2, DDSCAPS2 i DDPIXELFORMAT DirectDraw 7. DDS_HEADER jest binarnym odpowiednikiem DDSURFACEDESC2 i DDSCAPS2. DDS_PIXELFORMAT jest binarnym odpowiednikiem formatu DDPIXELFORMAT.

  DWORD               dwMagic;
  DDS_HEADER          header;
  
  

  Jeśli DDS_PIXELFORMAT dwFlags jest ustawiona na DDPF_FOURCC i dwFourCC jest ustawiona na "DX10" dodatkowa struktura DDS_HEADER_DXT10 będzie obecna, aby pomieścić tablice tekstur lub formaty DXGI, których nie można wyrazić jako format pikseli RGB, takich jak formaty zmiennoprzecinkowe, formaty SRGB itp. Gdy struktura DDS_HEADER_DXT10 jest obecna, cały opis danych będzie wyglądać następująco.

  DWORD               dwMagic;
  DDS_HEADER          header;
  DDS_HEADER_DXT10    header10;
  

• Wskaźnik do tablicy bajtów, która zawiera dane główne powierzchni.

  BYTE bdata[]
  

• Wskaźnik do tablicy bajtów, która zawiera pozostałe powierzchnie, takie jak; poziomy mipmap, twarze na mapie modułu, głębokości w teksturze woluminu. Skorzystaj z poniższych linków, aby uzyskać więcej informacji na temat układu pliku DDS dla tekstury , mapy modułu lub tekstury woluminu .

  BYTE bdata2[]
  

W przypadku szerokiej obsługi sprzętu zalecamy użycie 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, format 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_UNORMlub DXGI_FORMAT_BC3_UNORM_SRGB.

Aby uzyskać więcej informacji na temat skompresowanych formatów tekstur, zobacz Texture Block Compression in Direct3D 11 and Block Compression (Direct3D 10).

Biblioteka D3DX (na przykład D3DX11.lib) i inne podobne biblioteki niewiarygodnie lub konsekwentnie zapewniają wartość skoku w dwPitchOrLinearSize składowej struktury DDS_HEADER. W związku z tym podczas odczytywania i zapisywania w plikach DDS zalecamy obliczenie skoku w jeden z następujących sposobów dla wskazanych formatów:

• W przypadku formatów skompresowanych blokowo oblicz rzut w następujący sposób:

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

  Rozmiar bloku to 8 bajtów dla formatów DXT1, BC1 i BC4 oraz 16 bajtów dla innych formatów skompresowanych blokowo.

• W przypadku R8G8_B8G8, G8R8_G8B8, starszych formatów UYVY i starszych formatów YUY2, oblicz boisko jako:

  ((szerokość+1) >> 1) * 4

• W przypadku innych formatów oblicz rzut w następujący sposób:

  ( szerokość * bity na piksel + 7 ) / 8

  Dzielisz przez 8 dla wyrównania bajtów.

Warianty DDS

Istnieje wiele narzędzi, które tworzą i używają plików DDS, ale mogą się różnić w szczegółach tego, czego potrzebują w nagłówku. Autorzy powinni wypełnić nagłówki tak w pełni, jak to możliwe, a czytelnicy powinni sprawdzić minimalne wartości pod kątem maksymalnej zgodności. Aby zweryfikować plik DDS, czytelnik powinien upewnić się, że plik ma długość co najmniej 128 bajtów, aby pomieścić wartość magiczną i nagłówek podstawowy, wartość magiczna jest 0x20534444 ("DDS"), rozmiar DDS_HEADER wynosi 124, a DDS_PIXELFORMAT w rozmiarze nagłówka to 32. Jeśli DDS_PIXELFORMAT dwFlags jest ustawiona na DDPF_FOURCC, a dwFourCC ma wartość "DX10", łączny rozmiar pliku musi wynosić co najmniej 148 bajtów.

Istnieją pewne typowe warianty, w których format pikseli jest ustawiony na kod DDPF_FOURCC, w którym plik dwFourCC jest ustawiony na wartość D3DFORMAT lub DXGI_FORMAT wartość wyliczenia. Nie ma możliwości określania, czy wartość wyliczenia jest wartością D3DFORMAT lub DXGI_FORMAT, dlatego zdecydowanie zaleca się, aby rozszerzenie "DX10" i nagłówek DDS_HEADER_DXT10 był używany do przechowywania formatu dxgiFormat, gdy podstawowy DDS_PIXELFORMAT nie może wyrazić formatu.

Standardowe DDS_PIXELFORMAT powinny być preferowane w celu zapewnienia maksymalnej zgodności do przechowywania danych nieskompresowanych RGB i danych DXT1-5, ponieważ nie wszystkie narzędzia DDS obsługują rozszerzenie DX10.

Używanie tablic tekstur w trybie Direct3D 10/11

Nowe struktury DDS (DDS_HEADER i DDS_HEADER_DXT10) w trybie Direct3D 10/11 rozszerzają format pliku DDS w celu obsługi tablicy tekstur, która jest nowym typem zasobu w trybie Direct3D 10/11. Oto przykładowy kod, który pokazuje, jak uzyskać dostęp do różnych poziomów mipmap w tablicy tekstur przy użyciu nowych nagłówków.

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

Typowe formaty zasobów plików DDS i skojarzona zawartość nagłówka

* = niezawodny czytnik DDS musi mieć możliwość obsługi tych starszych kodów formatu. Jednak taki czytnik DDS powinien preferować użycie rozszerzenia nagłówka "DX10", gdy zapisuje te kody formatu, aby uniknąć niejednoznaczności.

** = Ze względu na niektóre długotrwałe problemy w typowych implementacjach czytników i pisarzy DDS, najbardziej niezawodnym sposobem na zapisanie danych 10:10:10:2 jest użycie rozszerzenia nagłówka "DX10" z kodem DXGI_FORMAT "24" (czyli wartością DXGI_FORMAT_R10G10B10A2_UNORM). D3DFMT_A2R10G10B10 dane powinny zostać przekonwertowane na dane o formacie 10:10:10:2, zanim zostaną zapisane jako plik DDS w formacie DXGI_FORMAT_R10G10B10A2_UNORM.

Tematy pokrewne

DDS