DDSLoader.js 5.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272
  1. /*
  2. * @author mrdoob / http://mrdoob.com/
  3. */
  4. THREE.DDSLoader = function ( manager ) {
  5. THREE.CompressedTextureLoader.call( this, manager );
  6. this._parser = THREE.DDSLoader.parse;
  7. };
  8. THREE.DDSLoader.prototype = Object.create( THREE.CompressedTextureLoader.prototype );
  9. THREE.DDSLoader.prototype.constructor = THREE.DDSLoader;
  10. THREE.DDSLoader.parse = function ( buffer, loadMipmaps ) {
  11. var dds = { mipmaps: [], width: 0, height: 0, format: null, mipmapCount: 1 };
  12. // Adapted from @toji's DDS utils
  13. // https://github.com/toji/webgl-texture-utils/blob/master/texture-util/dds.js
  14. // All values and structures referenced from:
  15. // http://msdn.microsoft.com/en-us/library/bb943991.aspx/
  16. var DDS_MAGIC = 0x20534444;
  17. var DDSD_CAPS = 0x1,
  18. DDSD_HEIGHT = 0x2,
  19. DDSD_WIDTH = 0x4,
  20. DDSD_PITCH = 0x8,
  21. DDSD_PIXELFORMAT = 0x1000,
  22. DDSD_MIPMAPCOUNT = 0x20000,
  23. DDSD_LINEARSIZE = 0x80000,
  24. DDSD_DEPTH = 0x800000;
  25. var DDSCAPS_COMPLEX = 0x8,
  26. DDSCAPS_MIPMAP = 0x400000,
  27. DDSCAPS_TEXTURE = 0x1000;
  28. var DDSCAPS2_CUBEMAP = 0x200,
  29. DDSCAPS2_CUBEMAP_POSITIVEX = 0x400,
  30. DDSCAPS2_CUBEMAP_NEGATIVEX = 0x800,
  31. DDSCAPS2_CUBEMAP_POSITIVEY = 0x1000,
  32. DDSCAPS2_CUBEMAP_NEGATIVEY = 0x2000,
  33. DDSCAPS2_CUBEMAP_POSITIVEZ = 0x4000,
  34. DDSCAPS2_CUBEMAP_NEGATIVEZ = 0x8000,
  35. DDSCAPS2_VOLUME = 0x200000;
  36. var DDPF_ALPHAPIXELS = 0x1,
  37. DDPF_ALPHA = 0x2,
  38. DDPF_FOURCC = 0x4,
  39. DDPF_RGB = 0x40,
  40. DDPF_YUV = 0x200,
  41. DDPF_LUMINANCE = 0x20000;
  42. function fourCCToInt32( value ) {
  43. return value.charCodeAt( 0 ) +
  44. ( value.charCodeAt( 1 ) << 8 ) +
  45. ( value.charCodeAt( 2 ) << 16 ) +
  46. ( value.charCodeAt( 3 ) << 24 );
  47. }
  48. function int32ToFourCC( value ) {
  49. return String.fromCharCode(
  50. value & 0xff,
  51. ( value >> 8 ) & 0xff,
  52. ( value >> 16 ) & 0xff,
  53. ( value >> 24 ) & 0xff
  54. );
  55. }
  56. function loadARGBMip( buffer, dataOffset, width, height ) {
  57. var dataLength = width * height * 4;
  58. var srcBuffer = new Uint8Array( buffer, dataOffset, dataLength );
  59. var byteArray = new Uint8Array( dataLength );
  60. var dst = 0;
  61. var src = 0;
  62. for ( var y = 0; y < height; y ++ ) {
  63. for ( var x = 0; x < width; x ++ ) {
  64. var b = srcBuffer[ src ]; src ++;
  65. var g = srcBuffer[ src ]; src ++;
  66. var r = srcBuffer[ src ]; src ++;
  67. var a = srcBuffer[ src ]; src ++;
  68. byteArray[ dst ] = r; dst ++; //r
  69. byteArray[ dst ] = g; dst ++; //g
  70. byteArray[ dst ] = b; dst ++; //b
  71. byteArray[ dst ] = a; dst ++; //a
  72. }
  73. }
  74. return byteArray;
  75. }
  76. var FOURCC_DXT1 = fourCCToInt32( "DXT1" );
  77. var FOURCC_DXT3 = fourCCToInt32( "DXT3" );
  78. var FOURCC_DXT5 = fourCCToInt32( "DXT5" );
  79. var FOURCC_ETC1 = fourCCToInt32( "ETC1" );
  80. var headerLengthInt = 31; // The header length in 32 bit ints
  81. // Offsets into the header array
  82. var off_magic = 0;
  83. var off_size = 1;
  84. var off_flags = 2;
  85. var off_height = 3;
  86. var off_width = 4;
  87. var off_mipmapCount = 7;
  88. var off_pfFlags = 20;
  89. var off_pfFourCC = 21;
  90. var off_RGBBitCount = 22;
  91. var off_RBitMask = 23;
  92. var off_GBitMask = 24;
  93. var off_BBitMask = 25;
  94. var off_ABitMask = 26;
  95. var off_caps = 27;
  96. var off_caps2 = 28;
  97. var off_caps3 = 29;
  98. var off_caps4 = 30;
  99. // Parse header
  100. var header = new Int32Array( buffer, 0, headerLengthInt );
  101. if ( header[ off_magic ] !== DDS_MAGIC ) {
  102. console.error( 'THREE.DDSLoader.parse: Invalid magic number in DDS header.' );
  103. return dds;
  104. }
  105. if ( ! header[ off_pfFlags ] & DDPF_FOURCC ) {
  106. console.error( 'THREE.DDSLoader.parse: Unsupported format, must contain a FourCC code.' );
  107. return dds;
  108. }
  109. var blockBytes;
  110. var fourCC = header[ off_pfFourCC ];
  111. var isRGBAUncompressed = false;
  112. switch ( fourCC ) {
  113. case FOURCC_DXT1:
  114. blockBytes = 8;
  115. dds.format = THREE.RGB_S3TC_DXT1_Format;
  116. break;
  117. case FOURCC_DXT3:
  118. blockBytes = 16;
  119. dds.format = THREE.RGBA_S3TC_DXT3_Format;
  120. break;
  121. case FOURCC_DXT5:
  122. blockBytes = 16;
  123. dds.format = THREE.RGBA_S3TC_DXT5_Format;
  124. break;
  125. case FOURCC_ETC1:
  126. blockBytes = 8;
  127. dds.format = THREE.RGB_ETC1_Format;
  128. break;
  129. default:
  130. if ( header[ off_RGBBitCount ] === 32
  131. && header[ off_RBitMask ] & 0xff0000
  132. && header[ off_GBitMask ] & 0xff00
  133. && header[ off_BBitMask ] & 0xff
  134. && header[ off_ABitMask ] & 0xff000000 ) {
  135. isRGBAUncompressed = true;
  136. blockBytes = 64;
  137. dds.format = THREE.RGBAFormat;
  138. } else {
  139. console.error( 'THREE.DDSLoader.parse: Unsupported FourCC code ', int32ToFourCC( fourCC ) );
  140. return dds;
  141. }
  142. }
  143. dds.mipmapCount = 1;
  144. if ( header[ off_flags ] & DDSD_MIPMAPCOUNT && loadMipmaps !== false ) {
  145. dds.mipmapCount = Math.max( 1, header[ off_mipmapCount ] );
  146. }
  147. var caps2 = header[ off_caps2 ];
  148. dds.isCubemap = caps2 & DDSCAPS2_CUBEMAP ? true : false;
  149. if ( dds.isCubemap && (
  150. ! ( caps2 & DDSCAPS2_CUBEMAP_POSITIVEX ) ||
  151. ! ( caps2 & DDSCAPS2_CUBEMAP_NEGATIVEX ) ||
  152. ! ( caps2 & DDSCAPS2_CUBEMAP_POSITIVEY ) ||
  153. ! ( caps2 & DDSCAPS2_CUBEMAP_NEGATIVEY ) ||
  154. ! ( caps2 & DDSCAPS2_CUBEMAP_POSITIVEZ ) ||
  155. ! ( caps2 & DDSCAPS2_CUBEMAP_NEGATIVEZ )
  156. ) ) {
  157. console.error( 'THREE.DDSLoader.parse: Incomplete cubemap faces' );
  158. return dds;
  159. }
  160. dds.width = header[ off_width ];
  161. dds.height = header[ off_height ];
  162. var dataOffset = header[ off_size ] + 4;
  163. // Extract mipmaps buffers
  164. var faces = dds.isCubemap ? 6 : 1;
  165. for ( var face = 0; face < faces; face ++ ) {
  166. var width = dds.width;
  167. var height = dds.height;
  168. for ( var i = 0; i < dds.mipmapCount; i ++ ) {
  169. if ( isRGBAUncompressed ) {
  170. var byteArray = loadARGBMip( buffer, dataOffset, width, height );
  171. var dataLength = byteArray.length;
  172. } else {
  173. var dataLength = Math.max( 4, width ) / 4 * Math.max( 4, height ) / 4 * blockBytes;
  174. var byteArray = new Uint8Array( buffer, dataOffset, dataLength );
  175. }
  176. var mipmap = { "data": byteArray, "width": width, "height": height };
  177. dds.mipmaps.push( mipmap );
  178. dataOffset += dataLength;
  179. width = Math.max( width >> 1, 1 );
  180. height = Math.max( height >> 1, 1 );
  181. }
  182. }
  183. return dds;
  184. };