DDS 的程式設計指南

  • 發行項

Direct3D 會實作 DDS 檔案格式，以儲存未壓縮或壓縮的 (DXTn) 紋理。 檔案格式會實作數種稍微不同的類型，其設計目的是儲存不同類型的資料，並支援單一圖層紋理、具有 Mipmap、Cube 貼圖、磁片區貼圖和紋理陣列 (Direct3D 10/11) 。 本節描述 DDS 檔案的配置。

如需在 Direct3D 11 中建立紋理的說明，請參閱 如何：建立紋理。 如需 Direct3D 9 的說明，請參閱 D3DX 中的紋理支援 (Direct3D 9) 。

DDS 檔案配置

DDS 檔案是包含下列資訊的二進位檔案：

  • 包含四個字元的代碼值 'DDS ' (0x20534444) 的 DWORD (魔術數字)。

  • 檔案中的資料描述。

    資料會使用 DDS_HEADER來描述標頭描述;像素格式是使用 DDS_PIXELFORMAT來定義。 請注意， DDS_HEADER 和 DDS_PIXELFORMAT 結構會取代已被取代的 DDSURFACEDESC2、DDSCAPS2 和 DDPIXELFORMAT DirectDraw 7 結構。 DDS_HEADER 是 DDSURFACEDESC2 和 DDSCAPS2 的二進位對等專案。 DDS_PIXELFORMAT 是 DDPIXELFORMAT 的二進位對等專案。

    DWORD               dwMagic;
DDS_HEADER          header;

    如果DDS_PIXELFORMAT dwFlags 設定為 DDPF_FOURCC，而 dwFourCC 設定為 「DX10」，則會出現額外的 DDS_HEADER_DXT10 結構，以容納無法以 RGB 像素格式表示的紋理陣列或 DXGI 格式，例如浮點格式、sRGB 格式等。當 DDS_HEADER_DXT10 結構出現時，整個資料描述看起來會像這樣。

    DWORD               dwMagic;
DDS_HEADER          header;
DDS_HEADER_DXT10    header10;

  • 包含主要表面資料的位元組陣列指標。

    BYTE bdata[]

  • 包含其餘的表面 (如 Mipmap 層級、立方體貼圖中的面及容積紋理中的深度) 的位元組陣列指標。 請點選下列連結，以了解下列的 DDS 檔案配置相關資訊：紋理、立方體貼圖或容積紋理。

    BYTE bdata2[]

如需廣泛的硬體支援，建議您使用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或DXGI_FORMAT_BC3_UNORM_SRGB格式。

如需壓縮紋理格式的詳細資訊，請參閱 Direct3D 11 中的紋理區塊壓縮 和 區塊壓縮 (Direct3D 10) 。

D3DX 程式庫 (例如，D3DX11.lib) 和其他類似的程式庫無法正確或不一致地提供DDS_HEADER結構的dwPitchOrLinearSize成員中的間距值。 因此，當您讀取和寫入 DDS 檔案時，建議您以下列其中一種方式計算指示格式的音調：

  • 針對區塊壓縮格式，將音調計算為：

    max ( 1， ( (width+3) /4) ) * 區塊大小

    區塊大小是 DXT1、BC1 和 BC4 格式的 8 個位元組，而其他區塊壓縮格式則為 16 個位元組。

  • 針對R8G8_B8G8，G8R8_G8B8、舊版 UYVY 套件和舊版 YUY2 套件格式，將音調計算為：

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

  • 針對其他格式，將音調計算為：

    (寬度 * 每圖元位 + 7 ) / 8

    您會將位元組對齊除以 8。

注意

您計算的音調值不一定等於執行時間所提供的音調，這在某些情況下會對齊 DWORD，在其他情況下會對齊位元組。 因此，建議您一次複製掃描行，而不是嘗試在一個複本中複製整個映射。

DDS Variants

有許多工具可建立及取用 DDS 檔案，但可能會因標頭中需要的詳細資料而有所不同。 寫入器應該盡可能完整地填入標頭，而讀取器應該檢查最小值以取得最大的相容性。 若要驗證 DDS 檔案，讀取器應該確保檔案長度至少為 128 位元組，以容納 magic 值和基本標頭，magic 值為 0x20534444 (「DDS 」) ，DDS_HEADER大小為 124，標頭大小的DDS_PIXELFORMAT為 32。 如果DDS_PIXELFORMAT dwFlags 設定為 DDPF_FOURCC，而 dwFourCC 設定為 「DX10」，則總檔案大小至少必須是 148 個位元組。

有一些常見的變體，其中像素格式設定為DDPF_FOURCC程式碼，其中 dwFourCC 設定為 D3DFORMAT 或DXGI_FORMAT列舉值。 無法判斷列舉值是否為 D3DFORMAT 或DXGI_FORMAT，因此強烈建議使用 「DX10」 延伸模組和DDS_HEADER_DXT10標頭來儲存基本DDS_PIXELFORMAT無法表示格式時的 dxgiFormat。

建議使用標準DDS_PIXELFORMAT，以達到最大相容性來儲存 RGB 未壓縮的資料和 DXT1-5 資料，因為並非所有 DDS 工具都支援 DX10 擴充功能。

在 Direct3D 10/11 中使用紋理陣列

Direct3D 10/11 中的新 DDS 結構 (DDS_HEADER 和 DDS_HEADER_DXT10) 延伸 DDS 檔案格式以支援紋理陣列，這是 Direct3D 10/11 中的新資源類型。 以下是一些範例程式碼，示範如何使用新的標頭，存取紋理陣列中的不同 Mipmap 層級。

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

常見的 DDS 檔資源格式和相關聯的標頭內容

資源格式 dwFlags dwRGBBitCount dwRBitMask dwGBitMask dwBBitMask dwABitMask
DXGI_FORMAT_R8G8B8A8_UNORM
D3DFMT_A8B8G8R8
 DDS_RGBA 32 0xff 0xff00 0xff0000 0xff000000
DXGI_FORMAT_R16G16_UNORM
D3DFMT_G16R16
 DDS_RGBA 32 0xffff 0xffff0000
**
DXGI_FORMAT_R10G10B10A2_UNORM
D3DFMT_A2B10G10R10
 DDS_RGBA 32 0x3ff 0xffc00 0x3ff00000
DXGI_FORMAT_R16G16_UNORM
D3DFMT_G16R16
 DDS_RGB 32 0xffff 0xffff0000
DXGI_FORMAT_B5G5R5A1_UNORM
D3DFMT_A1R5G5B5
 DDS_RGBA 16 0x7c00 0x3e0 0x1f 0x8000
DXGI_FORMAT_B5G6R5_UNORM
D3FMT_R5G6B5
 DDS_RGB 16 0xf800 0x7e0 0x1f
DXGI_A8_UNORM
D3DFMT_A8
 DDS_ALPHA 8 0xff
D3DFMT_A8R8G8B8
 DDS_RGBA 32 0xff0000 0xff00 0xff 0xff000000
D3DFMT_X8R8G8B8
 DDS_RGB 32 0xff0000 0xff00 0xff
D3DFMT_X8B8G8R8
 DDS_RGB 32 0xff 0xff00 0xff0000
**
D3DFMT_A2R10G10B10
 DDS_RGBA 32 0x3ff00000 0xffc00 0x3ff 0xc0000000
D3DFMT_R8G8B8
 DDS_RGB 24 0xff0000 0xff00 0xff
D3DFMT_X1R5G5B5
 DDS_RGB 16 0x7c00 0x3e0 0x1f
D3DFMT_A4R4G4B4
 DDS_RGBA 16 0xf00 0xf0 0xf 0xf000
D3DFMT_X4R4G4B4
 DDS_RGB 16 0xf00 0xf0 0xf
D3DFMT_A8R3G3B2
 DDS_RGBA 16 0xe0 0x1c 0x3 0xff00
D3DFMT_A8L8
 DDS_LUMINANCE 16 0xff 0xff00
D3DFMT_L16
 DDS_LUMINANCE 16 0xffff
D3DFMT_L8
 DDS_LUMINANCE 8 0xff
D3DFMT_A4L4
 DDS_LUMINANCE 8 0xf 0xf0
資源格式 dwFlags dwFourCC
DXGI_FORMAT_BC1_UNORM
D3DFMT_DXT1
 DDS_FOURCC 「DXT1」
DXGI_FORMAT_BC2_UNORM
D3DFMT_DXT3
 DDS_FOURCC 「DXT3」
DXGI_FORMAT_BC3_UNORM
D3DFMT_DXT5
 DDS_FOURCC 「DXT5」
*
DXGI_FORMAT_BC4_UNORM
 DDS_FOURCC 「BC4U」
*
DXGI_FORMAT_BC4_SNORM
 DDS_FOURCC 「BC4S」
*
DXGI_FORMAT_BC5_UNORM
 DDS_FOURCC 「ATI2」
*
DXGI_FORMAT_BC5_SNORM
 DDS_FOURCC 「BC5S」
DXGI_FORMAT_R8G8_B8G8_UNORM
D3DFMT_R8G8_B8G8
 DDS_FOURCC 「RGBG」
DXGI_FORMAT_G8R8_G8B8_UNORM
D3DFMT_G8R8_G8B8
 DDS_FOURCC 「GRGB」
*
DXGI_FORMAT_R16G16B16A16_UNORM
D3DFMT_A16B16G16R16
 DDS_FOURCC 36
*
DXGI_FORMAT_R16G16B16A16_SNORM
D3DFMT_Q16W16V16U16
 DDS_FOURCC 110
*
DXGI_FORMAT_R16_FLOAT
D3DFMT_R16F
 DDS_FOURCC 111
*
DXGI_FORMAT_R16G16_FLOAT
D3DFMT_G16R16F
 DDS_FOURCC 112
*
DXGI_FORMAT_R16G16B16A16_FLOAT
D3DFMT_A16B16G16R16F
 DDS_FOURCC 113
*
DXGI_FORMAT_R32_FLOAT
D3DFMT_R32F
 DDS_FOURCC 114
*
DXGI_FORMAT_R32G32_FLOAT
D3DFMT_G32R32F
 DDS_FOURCC 115
*
DXGI_FORMAT_R32G32B32A32_FLOAT
D3DFMT_A32B32G32R32F
 DDS_FOURCC 116
D3DFMT_DXT2
 DDS_FOURCC 「DXT2」
D3DFMT_DXT4
 DDS_FOURCC 「DXT4」
D3DFMT_UYVY
 DDS_FOURCC 「UYVY」
D3DFMT_YUY2
 DDS_FOURCC 「YUY2」
D3DFMT_CxV8U8
 DDS_FOURCC 117
任何 DXGI 格式 DDS_FOURCC 「DX10」

* = 強固的 DDS 讀取器必須能夠處理這些舊版格式代碼。 不過，這類 DDS 讀取器應該偏好在撰寫這些格式代碼時使用 「DX10」 標頭延伸，以避免模棱兩可。

** = 由於 DDS 讀取器和寫入器常見實作中的一些長期問題，所以寫出 10：10：10：2 類型資料的最強固方式是使用 「DX10」 標頭延伸模組搭配 DXGI_FORMAT 程式碼 「24」 (，也就是DXGI_FORMAT_R10G10B10A2_UNORM值) 。 D3DFMT_A2R10G10B10資料應該先轉換成 10：10：10：2 類型資料，再寫出成DXGI_FORMAT_R10G10B10A2_UNORM格式 DDS 檔案。

Dds