DDS ファイルとは?
DDS ファイルは、グラフィックスシステムで使われるテクスチャデータ用の DirectDraw Surface コンテナーです。ミップマップ、キューブマップ、ボリュームテクスチャ、GPU での直接利用に適した圧縮ピクセル形式を格納できます。
DDS ファイルの仕組み
DDS は、4 バイトのシグネチャと固定長ヘッダーに続けて GPU テクスチャデータを格納します。ヘッダーには、寸法、ピクセル形式、ミップマップ数、サーフェスの機能が記録されます。単一の 2D 画像だけでなく、ミップマップチェーン、キューブマップの各面、ボリュームテクスチャを表現でき、DirectX 10 のヘッダー拡張を使うとテクスチャ配列も表現できます。ピクセルデータは非圧縮、またはブロック圧縮(DXT1 から DXT5、後に BC1 から BC3 と改称、および BC4 から BC7)で格納され、グラフィックスハードウェアが直接デコードします。拡張を重ねて発展した形式のため、使用するヘッダーフィールドや形式コードはファイルによって異なり、ツールの対応状況もバリアントによって異なります。
要点
- DDS はマジック値
DDS(0x20534444)と、124 バイトのDDS_HEADERで始まります。そのため、読み取り側では少なくとも 128 バイトを必須とし、ヘッダーのdwSizeが 124 であることと、埋め込まれたDDS_PIXELFORMATのサイズが 32 であることを確認する必要があります。ピクセル形式でDDPF_FOURCCが設定され、FourCC がDX10の場合は、DDS_HEADER_DXT10が続き、最小サイズは 148 バイトになります。これらの最小サイズはヘッダーのみを対象とし、ピクセルデータは含みません。この拡張は、テクスチャ配列と、従来のピクセル形式構造体では表現できない DXGI 形式に必要です。Microsoft は、すべての DDS ツールがこの拡張に対応しているわけではないと説明しています。 - Direct3D でデバイスが受け付けるブロック圧縮形式は、コンテナーではなく機能レベルに依存します。Microsoft の記載では、BC1 から BC3(旧 DXT1 から DXT5)はすべての機能レベルで必須、BC4 と BC5 は Direct3D 10 以降、BC6H と BC7 は Direct3D 11 以降でのみ必須です。ツールとの互換性を最も広く確保するため、Microsoft は非圧縮 RGB と DXT1 から DXT5 のデータに従来のピクセル形式ヘッダーを推奨しています。
- ブロック圧縮されたミップレベルは、完全な 4×4 ブロック単位で保存されます。4×4 テクセルより小さいレベルも、完全なブロックになるようにパディングされます(BC1 と BC4 は 8 バイト、その他の BC 形式は 16 バイト)。そのため、レベルのサイズはピクセル単位ではなくブロック単位で計算する必要があります。Microsoft が示す行サイズの計算式は、整数除算で評価する
max(1, (width + 3) / 4) * block-sizeです。 - ヘッダーフィールドの信頼性は、書き込みソフトウェアによって異なります。Microsoft は、読み取り側で
DDSD_CAPS、DDSD_PIXELFORMAT、DDSD_MIPMAPCOUNT、DDSCAPS_TEXTURE、DDSCAPS_COMPLEXのフラグが設定されていることを前提にせず、dwPitchOrLinearSizeを信用するのではなく、ピッチを計算するよう推奨しています。アルファに関する情報は部分的にしか記述されません。DX10 ヘッダーにはアルファモードのフィールド(不明、ストレート、乗算済み、不透明、カスタム)があり、ファイルでは不明のままになっている場合もあります。レガシーファイルのうち、乗算済みアルファを示すのは FourCC がDXT2またはDXT4のものだけです。その他のレガシーファイルでは指定されず、通常はストレートアルファと見なされます。
DDS ファイルが重要になる場面
事前計算したミップマップや GPU ネイティブのテクスチャ圧縮がレンダリングパイプラインに役立つ場合は、DDS を使用してください。未対応のバリアントには変換または展開が必要なため、対象の API とハードウェアで形式の対応状況を確認してください。
DDS ファイル処理における Transloadit の活用
Transloadit の画像形式リファレンスは、/image/resize などの
ImageMagick ベースの画像 Robot を対象とし、DDS と、そのバリアントである
DXT1 および DXT5 を、読み取りと書き込みに対応する形式として掲載しています。
このリファレンスに記載されているのは、形式単位の読み取りと書き込みの対応状況のみです。デコードできる DDS ヘッダーのバリアントや BC 形式は明記されていません。また、ImageMagick が DDS の書き込みオプションとして記載しているのは、dxt1、dxt5、非圧縮です。そのため、DX10 ヘッダーや BC7 のテクスチャを利用する前に、代表的なファイルでテストしてください。
出典
- Microsoft Learn:DDS プログラミングガイド(ファイル構造、バリアント、ピッチ計算)
- Microsoft Learn:DDS_HEADER 構造体
- Microsoft Learn:DDS_HEADER_DXT10 構造体
- Microsoft Learn:Direct3D 11 のテクスチャブロック圧縮(形式と最小機能レベル)
- Microsoft Learn:ブロック圧縮(Direct3D 10)、仮想サイズと物理サイズ
- Microsoft Learn:圧縮テクスチャの使用(Direct3D 9)、DXT1 から DXT5 と乗算済みアルファ
- ImageMagick:画像形式、DDS の項目と dds: 定義
- Pillow ハンドブック:画像ファイル形式、DDS(バリアントごとの読み取りと書き込みの対応状況)