差分

このページの2つのバージョン間の差分を表示します。

--- ddsformat [2015/05/26 12:56] – [フォーマット判定コードの例] oga
+++ ddsformat [2015/05/26 16:45] (現在) – [DDS のヘッダ構造] oga
@@ 行 62: / 行 62: @@
     unsigned int    ArraySize;      // Texture Array を格納する場合に必要
     unsigned int    MiscFlag2;      // 0
+};
+enum {
+    DDS10_DIMENSION_1D = 2,
+    DDS10_DIMENSION_2D = 3,
+    DDS10_DIMENSION_3D = 4,
 };
 </code>
@@ 行 95: / 行 100: @@
 ==== dwPitchOrLinearSize ====
-dwFlags に DDSD_PITCH または DDSD_LINEARSIZE が含まれている場合に有効になります。
+dwFlags に DDSD_PITCH または DDSD_LINEARSIZE が含まれている場合に有効になります。あまり重要なフィールドではありません。
-あまり重要なフィールドではありません。
-無くてもおそらく問題ありませんが、一部ツールでは参照している可能性があります。
-| DDSD_LINEARSIZE  | 最初の face の最初の miplevel 0 の画像の byte 数。圧縮テクスチャの場合こちら。  |
-| DDSD_PITCH       | 最初の miplevel 0 の画像の横 1列の byte 数。(dwWidth * dwRGBBitCount) >> 3 相当。非圧縮で BitMask を使った画像の場合はこちらが入る。    |
+| DDSD_LINEARSIZE  | 最初の face の最初の miplevel 0 の画像の byte 数。  |
+| DDSD_PITCH       | 最初の miplevel 0 の画像の横 1列の byte 数。圧縮テクスチャの場合、block 単位の 1列分の byte サイズ。    |
+圧縮テクスチャの場合は pitch には 1列分の block サイズが入ります。
+例えば 256x256 の DXT1 なら、横は 256/4 = 64 block となります。
+DXT は 1block = 64bit なので pitch = 64block x 64bit / 8bit = 512byte です。
+同様に 250x250 のような半端なサイズのテクスチャも、block 単位に切り上げて計算する必要があります。
+( ( 250 + 3) >> 2) block x 64bit / 8bit = 504byte
+ただし、圧縮テクスチャの場合も結局 MipmapLevel 毎に同様の block 単位のアライメントサイズの再計算を行う必要があるので、実際の実装ではこのフィールドの値が必要になることがありません。
 ==== dwMipMapCount ====
@@ 行 111: / 行 121: @@
 ただし dwFlags DDSD_MIPMAPCOUNT を正しく判定していないツールやライブラリが存在する可能性があるため、安全のために常に 1 以上の有効な値を入れて置くことをおすすめします。
-また読み出す場合あ、DDSD_MIPMAPCOUNT が立っていたとしてもこのフィールドが 0 である可能性を考慮した方が良いでしょう。
+また読み出す場合、DDSD_MIPMAPCOUNT が立っていたとしてもこのフィールドが 0 である可能性を考慮した方が良いでしょう。
 <code cpp>
@@ 行 297: / 行 307: @@
 ReadFile( file, memory, file_size, &read_size, NULL );
 ～
+assert( file_size >= sizeof(T_DDSHEADER) );
 const T_DDSHEADER*      header= reinterpret_cast<const T_DDSHEADER*>( memory );
@@ 行 309: / 行 321: @@
 unsigned int  height= max( header->dwWidth, 1 );
 unsigned int  depth= (header->dwFlags & DDSD_DEPTH) ? max( header->dwDepth, 1 ) : 1;
-unsigned int  mip_map_count= (header->dwFlags & DDSD_MIPMAPCOUNT) ? max( header->dwMipMapCount, 1 ) : 1 ;
+unsigned int  mip_map_count= (header->dwFlags & DDSD_MIPMAPCOUNT) ? max( header->dwMipMapCount, 1 ) : 1;
 unsigned int  array_count= 1;
 unsigned int  face_count= 1;
@@ 行 354: / 行 366: @@
 }
 </code>
+==== ヘッダ設定コードの例 ====
+<code cpp>
+T_DDSHEADER         header;
+T_DDSHEADER_DX10    header10;
+memset( &header, 0, sizeof(T_DDSHEADER) );
+memset( &header10, 0, sizeof(T_DDSHEADER_DX10) );
+bool  isdx10= false;
+header.dwMagic= 0x20534444;
+header.dwSize= 124;
+header.dwFlags= DDSD_WIDTH|DDSD_HEIGHT|DDSD_CAPS|DDSD_PIXELFORMAT;
+header.dwWidth= width;
+header.dwHeight= height;
+header.dwDepth= 1;
+header.dwMipMapCount= 1;
+header10.ArraySize= 1;
+header10.Dimension= DDS10_DIIMENSION_2D;
+if( 非圧縮時 ){
+    header.dwFlags|= DDSD_PITCH;
+    header.dwPitchOrLinearSize= (width * bit_count) >> 3;
+}else{
+    header.dwFlags|= DDSD_LINEARSIZE;
+    header.dwPitchOrLinearSize= (block_width * block_height * block_bit_count) >> 3;
+}
+if( mipmap_count > 1 ){
+    header.dwFlags|= DDSD_MIPMAPCOUNT;
+    header.dwCaps|= DDSCAPS_COMPLEX|DDSCAPS_MIPMAP;
+    header.dwMipMapCount= mipmap_count;
+}
+if( face_count > 1 ){
+    header.dwCaps|= DDSCAPS_COMPLEX;
+    header.dwCaps2|= DDSCAPS2_CUBEMAP
+            |DDSCAPS2_CUBEMAP_POSITIVEX
+            |DDSCAPS2_CUBEMAP_NEGATIVEX
+            |DDSCAPS2_CUBEMAP_POSITIVEY
+            |DDSCAPS2_CUBEMAP_NEGATIVEY
+            |DDSCAPS2_CUBEMAP_POSITIVEZ
+            |DDSCAPS2_CUBEMAP_NEGATIVEZ;
+}
+if( depth > 1 ){
+    header.dwCaps|= DDSCAPS_COMPLEX;
+    header.dwCaps2|= DDSCAPS2_VOLUME;
+    header.dwDepth= depth;
+    header10.Dimension= DDS10_DIMENSION_3D;
+}
+if( array_count > 1 ){
+    header10.ArraySize= array_count;
+    isdx10= true; // Array なら DX10 ヘッダが必須
+}
+header.dwPfSize= 32;
+if( !isdx10 &&  BitMask 表現可能  ){
+    header.dwPfFlags|= DDPF_RGB|DDPF_ALPHAPIXELS;
+    header.dwRGBBitCount= bit_count;
+    header.dwRBitMask= ..
+    header.dwGBitMask= ..
+    header.dwBBitMask= ..
+    header.dwRGBAlphaBitMask= ..
+}else if( !isdx10 &&  FourCC 表現が可能  ){
+    header.dwPfFlags|= DDPF_FOURCC;
+    header.dwFourCC= ..
+}else{
+    isdx10= true;
+    header.dwPfFlags|= DDPF_FOURCC;
+    header.dwFourCC= 0x30315844;    // 'DX10'
+    // DXGI_FORMAT に変換
+    header10.Format= dxgi_format;
+}
+Write( &header, sizeof(T_DDSHEADER) );
+if( isdx10 ){
+    Write( &header10, sizeof(T_DDSHEADER_DX10) );
+}
+</code>