EXRLoader.js 31 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483
  1. /**
  2. * @author Richard M. / https://github.com/richardmonette
  3. * @author ScieCode / http://github.com/sciecode
  4. *
  5. * OpenEXR loader which, currently, supports uncompressed, ZIP(S), RLE and PIZ wavelet compression.
  6. * Supports reading 16 and 32 bit data format, except for PIZ compression which only reads 16-bit data.
  7. *
  8. * Referred to the original Industrial Light & Magic OpenEXR implementation and the TinyEXR / Syoyo Fujita
  9. * implementation, so I have preserved their copyright notices.
  10. */
  11. import {
  12. DataTextureLoader,
  13. FloatType,
  14. HalfFloatType,
  15. LinearEncoding,
  16. LinearFilter,
  17. RGBAFormat,
  18. RGBFormat
  19. } from "../../../build/three.module.js";
  20. import { Zlib } from "../libs/inflate.module.min.js";
  21. // /*
  22. // Copyright (c) 2014 - 2017, Syoyo Fujita
  23. // All rights reserved.
  24. // Redistribution and use in source and binary forms, with or without
  25. // modification, are permitted provided that the following conditions are met:
  26. // * Redistributions of source code must retain the above copyright
  27. // notice, this list of conditions and the following disclaimer.
  28. // * Redistributions in binary form must reproduce the above copyright
  29. // notice, this list of conditions and the following disclaimer in the
  30. // documentation and/or other materials provided with the distribution.
  31. // * Neither the name of the Syoyo Fujita nor the
  32. // names of its contributors may be used to endorse or promote products
  33. // derived from this software without specific prior written permission.
  34. // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
  35. // ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  36. // WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  37. // DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
  38. // DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  39. // (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  40. // LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  41. // ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  42. // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  43. // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  44. // */
  45. // // TinyEXR contains some OpenEXR code, which is licensed under ------------
  46. // ///////////////////////////////////////////////////////////////////////////
  47. // //
  48. // // Copyright (c) 2002, Industrial Light & Magic, a division of Lucas
  49. // // Digital Ltd. LLC
  50. // //
  51. // // All rights reserved.
  52. // //
  53. // // Redistribution and use in source and binary forms, with or without
  54. // // modification, are permitted provided that the following conditions are
  55. // // met:
  56. // // * Redistributions of source code must retain the above copyright
  57. // // notice, this list of conditions and the following disclaimer.
  58. // // * Redistributions in binary form must reproduce the above
  59. // // copyright notice, this list of conditions and the following disclaimer
  60. // // in the documentation and/or other materials provided with the
  61. // // distribution.
  62. // // * Neither the name of Industrial Light & Magic nor the names of
  63. // // its contributors may be used to endorse or promote products derived
  64. // // from this software without specific prior written permission.
  65. // //
  66. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  67. // // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  68. // // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  69. // // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  70. // // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  71. // // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  72. // // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  73. // // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  74. // // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  75. // // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  76. // // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  77. // //
  78. // ///////////////////////////////////////////////////////////////////////////
  79. // // End of OpenEXR license -------------------------------------------------
  80. var EXRLoader = function ( manager ) {
  81. DataTextureLoader.call( this, manager );
  82. this.type = FloatType;
  83. };
  84. EXRLoader.prototype = Object.assign( Object.create( DataTextureLoader.prototype ), {
  85. constructor: EXRLoader,
  86. parse: function ( buffer ) {
  87. const USHORT_RANGE = ( 1 << 16 );
  88. const BITMAP_SIZE = ( USHORT_RANGE >> 3 );
  89. const HUF_ENCBITS = 16; // literal (value) bit length
  90. const HUF_DECBITS = 14; // decoding bit size (>= 8)
  91. const HUF_ENCSIZE = ( 1 << HUF_ENCBITS ) + 1; // encoding table size
  92. const HUF_DECSIZE = 1 << HUF_DECBITS; // decoding table size
  93. const HUF_DECMASK = HUF_DECSIZE - 1;
  94. const SHORT_ZEROCODE_RUN = 59;
  95. const LONG_ZEROCODE_RUN = 63;
  96. const SHORTEST_LONG_RUN = 2 + LONG_ZEROCODE_RUN - SHORT_ZEROCODE_RUN;
  97. const BYTES_PER_HALF = 2;
  98. const ULONG_SIZE = 8;
  99. const FLOAT32_SIZE = 4;
  100. const INT32_SIZE = 4;
  101. const INT16_SIZE = 2;
  102. const INT8_SIZE = 1;
  103. function reverseLutFromBitmap( bitmap, lut ) {
  104. var k = 0;
  105. for ( var i = 0; i < USHORT_RANGE; ++ i ) {
  106. if ( ( i == 0 ) || ( bitmap[ i >> 3 ] & ( 1 << ( i & 7 ) ) ) ) {
  107. lut[ k ++ ] = i;
  108. }
  109. }
  110. var n = k - 1;
  111. while ( k < USHORT_RANGE ) lut[ k ++ ] = 0;
  112. return n;
  113. }
  114. function hufClearDecTable( hdec ) {
  115. for ( var i = 0; i < HUF_DECSIZE; i ++ ) {
  116. hdec[ i ] = {};
  117. hdec[ i ].len = 0;
  118. hdec[ i ].lit = 0;
  119. hdec[ i ].p = null;
  120. }
  121. }
  122. const getBitsReturn = { l: 0, c: 0, lc: 0 };
  123. function getBits( nBits, c, lc, uInt8Array, inOffset ) {
  124. while ( lc < nBits ) {
  125. c = ( c << 8 ) | parseUint8Array( uInt8Array, inOffset );
  126. lc += 8;
  127. }
  128. lc -= nBits;
  129. getBitsReturn.l = ( c >> lc ) & ( ( 1 << nBits ) - 1 );
  130. getBitsReturn.c = c;
  131. getBitsReturn.lc = lc;
  132. }
  133. const hufTableBuffer = new Array( 59 );
  134. function hufCanonicalCodeTable( hcode ) {
  135. for ( var i = 0; i <= 58; ++ i ) hufTableBuffer[ i ] = 0;
  136. for ( var i = 0; i < HUF_ENCSIZE; ++ i ) hufTableBuffer[ hcode[ i ] ] += 1;
  137. var c = 0;
  138. for ( var i = 58; i > 0; -- i ) {
  139. var nc = ( ( c + hufTableBuffer[ i ] ) >> 1 );
  140. hufTableBuffer[ i ] = c;
  141. c = nc;
  142. }
  143. for ( var i = 0; i < HUF_ENCSIZE; ++ i ) {
  144. var l = hcode[ i ];
  145. if ( l > 0 ) hcode[ i ] = l | ( hufTableBuffer[ l ] ++ << 6 );
  146. }
  147. }
  148. function hufUnpackEncTable( uInt8Array, inDataView, inOffset, ni, im, iM, hcode ) {
  149. var p = inOffset;
  150. var c = 0;
  151. var lc = 0;
  152. for ( ; im <= iM; im ++ ) {
  153. if ( p.value - inOffset.value > ni ) return false;
  154. getBits( 6, c, lc, uInt8Array, p );
  155. var l = getBitsReturn.l;
  156. c = getBitsReturn.c;
  157. lc = getBitsReturn.lc;
  158. hcode[ im ] = l;
  159. if ( l == LONG_ZEROCODE_RUN ) {
  160. if ( p.value - inOffset.value > ni ) {
  161. throw 'Something wrong with hufUnpackEncTable';
  162. }
  163. getBits( 8, c, lc, uInt8Array, p );
  164. var zerun = getBitsReturn.l + SHORTEST_LONG_RUN;
  165. c = getBitsReturn.c;
  166. lc = getBitsReturn.lc;
  167. if ( im + zerun > iM + 1 ) {
  168. throw 'Something wrong with hufUnpackEncTable';
  169. }
  170. while ( zerun -- ) hcode[ im ++ ] = 0;
  171. im --;
  172. } else if ( l >= SHORT_ZEROCODE_RUN ) {
  173. var zerun = l - SHORT_ZEROCODE_RUN + 2;
  174. if ( im + zerun > iM + 1 ) {
  175. throw 'Something wrong with hufUnpackEncTable';
  176. }
  177. while ( zerun -- ) hcode[ im ++ ] = 0;
  178. im --;
  179. }
  180. }
  181. hufCanonicalCodeTable( hcode );
  182. }
  183. function hufLength( code ) {
  184. return code & 63;
  185. }
  186. function hufCode( code ) {
  187. return code >> 6;
  188. }
  189. function hufBuildDecTable( hcode, im, iM, hdecod ) {
  190. for ( ; im <= iM; im ++ ) {
  191. var c = hufCode( hcode[ im ] );
  192. var l = hufLength( hcode[ im ] );
  193. if ( c >> l ) {
  194. throw 'Invalid table entry';
  195. }
  196. if ( l > HUF_DECBITS ) {
  197. var pl = hdecod[ ( c >> ( l - HUF_DECBITS ) ) ];
  198. if ( pl.len ) {
  199. throw 'Invalid table entry';
  200. }
  201. pl.lit ++;
  202. if ( pl.p ) {
  203. var p = pl.p;
  204. pl.p = new Array( pl.lit );
  205. for ( var i = 0; i < pl.lit - 1; ++ i ) {
  206. pl.p[ i ] = p[ i ];
  207. }
  208. } else {
  209. pl.p = new Array( 1 );
  210. }
  211. pl.p[ pl.lit - 1 ] = im;
  212. } else if ( l ) {
  213. var plOffset = 0;
  214. for ( var i = 1 << ( HUF_DECBITS - l ); i > 0; i -- ) {
  215. var pl = hdecod[ ( c << ( HUF_DECBITS - l ) ) + plOffset ];
  216. if ( pl.len || pl.p ) {
  217. throw 'Invalid table entry';
  218. }
  219. pl.len = l;
  220. pl.lit = im;
  221. plOffset ++;
  222. }
  223. }
  224. }
  225. return true;
  226. }
  227. const getCharReturn = { c: 0, lc: 0 };
  228. function getChar( c, lc, uInt8Array, inOffset ) {
  229. c = ( c << 8 ) | parseUint8Array( uInt8Array, inOffset );
  230. lc += 8;
  231. getCharReturn.c = c;
  232. getCharReturn.lc = lc;
  233. }
  234. const getCodeReturn = { c: 0, lc: 0 };
  235. function getCode( po, rlc, c, lc, uInt8Array, inDataView, inOffset, outBuffer, outBufferOffset, outBufferEndOffset ) {
  236. if ( po == rlc ) {
  237. if ( lc < 8 ) {
  238. getChar( c, lc, uInt8Array, inOffset );
  239. c = getCharReturn.c;
  240. lc = getCharReturn.lc;
  241. }
  242. lc -= 8;
  243. var cs = ( c >> lc );
  244. var cs = new Uint8Array( [ cs ] )[ 0 ];
  245. if ( outBufferOffset.value + cs > outBufferEndOffset ) {
  246. return false;
  247. }
  248. var s = outBuffer[ outBufferOffset.value - 1 ];
  249. while ( cs -- > 0 ) {
  250. outBuffer[ outBufferOffset.value ++ ] = s;
  251. }
  252. } else if ( outBufferOffset.value < outBufferEndOffset ) {
  253. outBuffer[ outBufferOffset.value ++ ] = po;
  254. } else {
  255. return false;
  256. }
  257. getCodeReturn.c = c;
  258. getCodeReturn.lc = lc;
  259. }
  260. function UInt16( value ) {
  261. return ( value & 0xFFFF );
  262. }
  263. function Int16( value ) {
  264. var ref = UInt16( value );
  265. return ( ref > 0x7FFF ) ? ref - 0x10000 : ref;
  266. }
  267. const wdec14Return = { a: 0, b: 0 };
  268. function wdec14( l, h ) {
  269. var ls = Int16( l );
  270. var hs = Int16( h );
  271. var hi = hs;
  272. var ai = ls + ( hi & 1 ) + ( hi >> 1 );
  273. var as = ai;
  274. var bs = ai - hi;
  275. wdec14Return.a = as;
  276. wdec14Return.b = bs;
  277. }
  278. function wav2Decode( j, buffer, nx, ox, ny, oy ) {
  279. var n = ( nx > ny ) ? ny : nx;
  280. var p = 1;
  281. var p2;
  282. while ( p <= n ) p <<= 1;
  283. p >>= 1;
  284. p2 = p;
  285. p >>= 1;
  286. while ( p >= 1 ) {
  287. var py = 0;
  288. var ey = py + oy * ( ny - p2 );
  289. var oy1 = oy * p;
  290. var oy2 = oy * p2;
  291. var ox1 = ox * p;
  292. var ox2 = ox * p2;
  293. var i00, i01, i10, i11;
  294. for ( ; py <= ey; py += oy2 ) {
  295. var px = py;
  296. var ex = py + ox * ( nx - p2 );
  297. for ( ; px <= ex; px += ox2 ) {
  298. var p01 = px + ox1;
  299. var p10 = px + oy1;
  300. var p11 = p10 + ox1;
  301. wdec14( buffer[ px + j ], buffer[ p10 + j ] );
  302. i00 = wdec14Return.a;
  303. i10 = wdec14Return.b;
  304. wdec14( buffer[ p01 + j ], buffer[ p11 + j ] );
  305. i01 = wdec14Return.a;
  306. i11 = wdec14Return.b;
  307. wdec14( i00, i01 );
  308. buffer[ px + j ] = wdec14Return.a;
  309. buffer[ p01 + j ] = wdec14Return.b;
  310. wdec14( i10, i11 );
  311. buffer[ p10 + j ] = wdec14Return.a;
  312. buffer[ p11 + j ] = wdec14Return.b;
  313. }
  314. if ( nx & p ) {
  315. var p10 = px + oy1;
  316. wdec14( buffer[ px + j ], buffer[ p10 + j ] );
  317. i00 = wdec14Return.a;
  318. buffer[ p10 + j ] = wdec14Return.b;
  319. buffer[ px + j ] = i00;
  320. }
  321. }
  322. if ( ny & p ) {
  323. var px = py;
  324. var ex = py + ox * ( nx - p2 );
  325. for ( ; px <= ex; px += ox2 ) {
  326. var p01 = px + ox1;
  327. wdec14( buffer[ px + j ], buffer[ p01 + j ] );
  328. i00 = wdec14Return.a;
  329. buffer[ p01 + j ] = wdec14Return.b;
  330. buffer[ px + j ] = i00;
  331. }
  332. }
  333. p2 = p;
  334. p >>= 1;
  335. }
  336. return py;
  337. }
  338. function hufDecode( encodingTable, decodingTable, uInt8Array, inDataView, inOffset, ni, rlc, no, outBuffer, outOffset ) {
  339. var c = 0;
  340. var lc = 0;
  341. var outBufferEndOffset = no;
  342. var inOffsetEnd = Math.trunc( inOffset.value + ( ni + 7 ) / 8 );
  343. while ( inOffset.value < inOffsetEnd ) {
  344. getChar( c, lc, uInt8Array, inOffset );
  345. c = getCharReturn.c;
  346. lc = getCharReturn.lc;
  347. while ( lc >= HUF_DECBITS ) {
  348. var index = ( c >> ( lc - HUF_DECBITS ) ) & HUF_DECMASK;
  349. var pl = decodingTable[ index ];
  350. if ( pl.len ) {
  351. lc -= pl.len;
  352. getCode( pl.lit, rlc, c, lc, uInt8Array, inDataView, inOffset, outBuffer, outOffset, outBufferEndOffset );
  353. c = getCodeReturn.c;
  354. lc = getCodeReturn.lc;
  355. } else {
  356. if ( ! pl.p ) {
  357. throw 'hufDecode issues';
  358. }
  359. var j;
  360. for ( j = 0; j < pl.lit; j ++ ) {
  361. var l = hufLength( encodingTable[ pl.p[ j ] ] );
  362. while ( lc < l && inOffset.value < inOffsetEnd ) {
  363. getChar( c, lc, uInt8Array, inOffset );
  364. c = getCharReturn.c;
  365. lc = getCharReturn.lc;
  366. }
  367. if ( lc >= l ) {
  368. if ( hufCode( encodingTable[ pl.p[ j ] ] ) == ( ( c >> ( lc - l ) ) & ( ( 1 << l ) - 1 ) ) ) {
  369. lc -= l;
  370. getCode( pl.p[ j ], rlc, c, lc, uInt8Array, inDataView, inOffset, outBuffer, outOffset, outBufferEndOffset );
  371. c = getCodeReturn.c;
  372. lc = getCodeReturn.lc;
  373. break;
  374. }
  375. }
  376. }
  377. if ( j == pl.lit ) {
  378. throw 'hufDecode issues';
  379. }
  380. }
  381. }
  382. }
  383. var i = ( 8 - ni ) & 7;
  384. c >>= i;
  385. lc -= i;
  386. while ( lc > 0 ) {
  387. var pl = decodingTable[ ( c << ( HUF_DECBITS - lc ) ) & HUF_DECMASK ];
  388. if ( pl.len ) {
  389. lc -= pl.len;
  390. getCode( pl.lit, rlc, c, lc, uInt8Array, inDataView, inOffset, outBuffer, outOffset, outBufferEndOffset );
  391. c = getCodeReturn.c;
  392. lc = getCodeReturn.lc;
  393. } else {
  394. throw 'hufDecode issues';
  395. }
  396. }
  397. return true;
  398. }
  399. function hufUncompress( uInt8Array, inDataView, inOffset, nCompressed, outBuffer, outOffset, nRaw ) {
  400. var initialInOffset = inOffset.value;
  401. var im = parseUint32( inDataView, inOffset );
  402. var iM = parseUint32( inDataView, inOffset );
  403. inOffset.value += 4;
  404. var nBits = parseUint32( inDataView, inOffset );
  405. inOffset.value += 4;
  406. if ( im < 0 || im >= HUF_ENCSIZE || iM < 0 || iM >= HUF_ENCSIZE ) {
  407. throw 'Something wrong with HUF_ENCSIZE';
  408. }
  409. var freq = new Array( HUF_ENCSIZE );
  410. var hdec = new Array( HUF_DECSIZE );
  411. hufClearDecTable( hdec );
  412. var ni = nCompressed - ( inOffset.value - initialInOffset );
  413. hufUnpackEncTable( uInt8Array, inDataView, inOffset, ni, im, iM, freq );
  414. if ( nBits > 8 * ( nCompressed - ( inOffset.value - initialInOffset ) ) ) {
  415. throw 'Something wrong with hufUncompress';
  416. }
  417. hufBuildDecTable( freq, im, iM, hdec );
  418. hufDecode( freq, hdec, uInt8Array, inDataView, inOffset, nBits, iM, nRaw, outBuffer, outOffset );
  419. }
  420. function applyLut( lut, data, nData ) {
  421. for ( var i = 0; i < nData; ++ i ) {
  422. data[ i ] = lut[ data[ i ] ];
  423. }
  424. }
  425. function predictor( source ) {
  426. for ( var t = 1; t < source.length; t ++ ) {
  427. var d = source[ t - 1 ] + source[ t ] - 128;
  428. source[ t ] = d;
  429. }
  430. }
  431. function interleaveScalar( source, out ) {
  432. var t1 = 0;
  433. var t2 = Math.floor( ( source.length + 1 ) / 2 );
  434. var s = 0;
  435. var stop = source.length - 1;
  436. while ( true ) {
  437. if ( s > stop ) break;
  438. out[ s ++ ] = source[ t1 ++ ];
  439. if ( s > stop ) break;
  440. out[ s ++ ] = source[ t2 ++ ];
  441. }
  442. }
  443. function decodeRunLength( source ) {
  444. var size = source.byteLength;
  445. var out = new Array();
  446. var p = 0;
  447. var reader = new DataView( source );
  448. while ( size > 0 ) {
  449. var l = reader.getInt8( p ++ );
  450. if ( l < 0 ) {
  451. var count = - l;
  452. size -= count + 1;
  453. for ( var i = 0; i < count; i ++ ) {
  454. out.push( reader.getUint8( p ++ ) );
  455. }
  456. } else {
  457. var count = l;
  458. size -= 2;
  459. var value = reader.getUint8( p ++ );
  460. for ( var i = 0; i < count + 1; i ++ ) {
  461. out.push( value );
  462. }
  463. }
  464. }
  465. return out;
  466. }
  467. function uncompressRaw( info ) {
  468. return new DataView( info.array.buffer, info.offset.value, info.size );
  469. }
  470. function uncompressRLE( info ) {
  471. var compressed = info.viewer.buffer.slice( info.offset.value, info.offset.value + info.size );
  472. var rawBuffer = new Uint8Array( decodeRunLength( compressed ) );
  473. var tmpBuffer = new Uint8Array( rawBuffer.length );
  474. predictor( rawBuffer ); // revert predictor
  475. interleaveScalar( rawBuffer, tmpBuffer ); // interleave pixels
  476. return new DataView( tmpBuffer.buffer );
  477. }
  478. function uncompressZIP( info ) {
  479. var compressed = info.array.slice( info.offset.value, info.offset.value + info.size );
  480. if ( typeof Zlib === 'undefined' ) {
  481. console.error( 'THREE.EXRLoader: External library Inflate.min.js required, obtain or import from https://github.com/imaya/zlib.js' );
  482. }
  483. var inflate = new Zlib.Inflate( compressed, { resize: true, verify: true } ); // eslint-disable-line no-undef
  484. var rawBuffer = new Uint8Array( inflate.decompress().buffer );
  485. var tmpBuffer = new Uint8Array( rawBuffer.length );
  486. predictor( rawBuffer ); // revert predictor
  487. interleaveScalar( rawBuffer, tmpBuffer ); // interleave pixels
  488. return new DataView( tmpBuffer.buffer );
  489. }
  490. function uncompressPIZ( info ) {
  491. var inDataView = info.viewer;
  492. var inOffset = { value: info.offset.value };
  493. var tmpBufSize = info.width * scanlineBlockSize * ( EXRHeader.channels.length * BYTES_PER_HALF );
  494. var outBuffer = new Uint16Array( tmpBufSize );
  495. var outOffset = { value: 0 };
  496. var bitmap = new Uint8Array( BITMAP_SIZE );
  497. var minNonZero = parseUint16( inDataView, inOffset );
  498. var maxNonZero = parseUint16( inDataView, inOffset );
  499. if ( maxNonZero >= BITMAP_SIZE ) {
  500. throw 'Something is wrong with PIZ_COMPRESSION BITMAP_SIZE';
  501. }
  502. if ( minNonZero <= maxNonZero ) {
  503. for ( var i = 0; i < maxNonZero - minNonZero + 1; i ++ ) {
  504. bitmap[ i + minNonZero ] = parseUint8( inDataView, inOffset );
  505. }
  506. }
  507. var lut = new Uint16Array( USHORT_RANGE );
  508. reverseLutFromBitmap( bitmap, lut );
  509. var length = parseUint32( inDataView, inOffset );
  510. hufUncompress( info.array, inDataView, inOffset, length, outBuffer, outOffset, tmpBufSize );
  511. var pizChannelData = new Array( info.channels );
  512. var outBufferEnd = 0;
  513. for ( var i = 0; i < info.channels; i ++ ) {
  514. pizChannelData[ i ] = {};
  515. pizChannelData[ i ][ 'start' ] = outBufferEnd;
  516. pizChannelData[ i ][ 'end' ] = pizChannelData[ i ][ 'start' ];
  517. pizChannelData[ i ][ 'nx' ] = info.width;
  518. pizChannelData[ i ][ 'ny' ] = info.lines;
  519. pizChannelData[ i ][ 'size' ] = 1;
  520. outBufferEnd += pizChannelData[ i ].nx * pizChannelData[ i ].ny * pizChannelData[ i ].size;
  521. }
  522. var fooOffset = 0;
  523. for ( var i = 0; i < info.channels; i ++ ) {
  524. for ( var j = 0; j < pizChannelData[ i ].size; ++ j ) {
  525. fooOffset += wav2Decode(
  526. j + fooOffset,
  527. outBuffer,
  528. pizChannelData[ i ].nx,
  529. pizChannelData[ i ].size,
  530. pizChannelData[ i ].ny,
  531. pizChannelData[ i ].nx * pizChannelData[ i ].size
  532. );
  533. }
  534. }
  535. applyLut( lut, outBuffer, outBufferEnd );
  536. var tmpBuffer = new Uint8Array( outBuffer.buffer.byteLength );
  537. var tmpOffset = 0;
  538. var n = info.width * 2;
  539. for ( var y = 0; y < info.lines; y ++ ) {
  540. for ( var c = 0; c < info.channels; c ++ ) {
  541. var cd = pizChannelData[ c ];
  542. var cp = new Uint8Array( outBuffer.buffer, cd.end * 2 + y * n, n );
  543. tmpBuffer.set( cp, tmpOffset );
  544. tmpOffset += n;
  545. }
  546. }
  547. return new DataView( tmpBuffer.buffer );
  548. }
  549. function parseNullTerminatedString( buffer, offset ) {
  550. var uintBuffer = new Uint8Array( buffer );
  551. var endOffset = 0;
  552. while ( uintBuffer[ offset.value + endOffset ] != 0 ) {
  553. endOffset += 1;
  554. }
  555. var stringValue = new TextDecoder().decode(
  556. uintBuffer.slice( offset.value, offset.value + endOffset )
  557. );
  558. offset.value = offset.value + endOffset + 1;
  559. return stringValue;
  560. }
  561. function parseFixedLengthString( buffer, offset, size ) {
  562. var stringValue = new TextDecoder().decode(
  563. new Uint8Array( buffer ).slice( offset.value, offset.value + size )
  564. );
  565. offset.value = offset.value + size;
  566. return stringValue;
  567. }
  568. function parseUlong( dataView, offset ) {
  569. var uLong = dataView.getUint32( 0, true );
  570. offset.value = offset.value + ULONG_SIZE;
  571. return uLong;
  572. }
  573. function parseUint32( dataView, offset ) {
  574. var Uint32 = dataView.getUint32( offset.value, true );
  575. offset.value = offset.value + INT32_SIZE;
  576. return Uint32;
  577. }
  578. function parseUint8Array( uInt8Array, offset ) {
  579. var Uint8 = uInt8Array[ offset.value ];
  580. offset.value = offset.value + INT8_SIZE;
  581. return Uint8;
  582. }
  583. function parseUint8( dataView, offset ) {
  584. var Uint8 = dataView.getUint8( offset.value );
  585. offset.value = offset.value + INT8_SIZE;
  586. return Uint8;
  587. }
  588. function parseFloat32( dataView, offset ) {
  589. var float = dataView.getFloat32( offset.value, true );
  590. offset.value += FLOAT32_SIZE;
  591. return float;
  592. }
  593. // https://stackoverflow.com/questions/5678432/decompressing-half-precision-floats-in-javascript
  594. function decodeFloat16( binary ) {
  595. var exponent = ( binary & 0x7C00 ) >> 10,
  596. fraction = binary & 0x03FF;
  597. return ( binary >> 15 ? - 1 : 1 ) * (
  598. exponent ?
  599. (
  600. exponent === 0x1F ?
  601. fraction ? NaN : Infinity :
  602. Math.pow( 2, exponent - 15 ) * ( 1 + fraction / 0x400 )
  603. ) :
  604. 6.103515625e-5 * ( fraction / 0x400 )
  605. );
  606. }
  607. function parseUint16( dataView, offset ) {
  608. var Uint16 = dataView.getUint16( offset.value, true );
  609. offset.value += INT16_SIZE;
  610. return Uint16;
  611. }
  612. function parseFloat16( buffer, offset ) {
  613. return decodeFloat16( parseUint16( buffer, offset ) );
  614. }
  615. function parseChlist( dataView, buffer, offset, size ) {
  616. var startOffset = offset.value;
  617. var channels = [];
  618. while ( offset.value < ( startOffset + size - 1 ) ) {
  619. var name = parseNullTerminatedString( buffer, offset );
  620. var pixelType = parseUint32( dataView, offset ); // TODO: Cast this to UINT, HALF or FLOAT
  621. var pLinear = parseUint8( dataView, offset );
  622. offset.value += 3; // reserved, three chars
  623. var xSampling = parseUint32( dataView, offset );
  624. var ySampling = parseUint32( dataView, offset );
  625. channels.push( {
  626. name: name,
  627. pixelType: pixelType,
  628. pLinear: pLinear,
  629. xSampling: xSampling,
  630. ySampling: ySampling
  631. } );
  632. }
  633. offset.value += 1;
  634. return channels;
  635. }
  636. function parseChromaticities( dataView, offset ) {
  637. var redX = parseFloat32( dataView, offset );
  638. var redY = parseFloat32( dataView, offset );
  639. var greenX = parseFloat32( dataView, offset );
  640. var greenY = parseFloat32( dataView, offset );
  641. var blueX = parseFloat32( dataView, offset );
  642. var blueY = parseFloat32( dataView, offset );
  643. var whiteX = parseFloat32( dataView, offset );
  644. var whiteY = parseFloat32( dataView, offset );
  645. return { redX: redX, redY: redY, greenX: greenX, greenY: greenY, blueX: blueX, blueY: blueY, whiteX: whiteX, whiteY: whiteY };
  646. }
  647. function parseCompression( dataView, offset ) {
  648. var compressionCodes = [
  649. 'NO_COMPRESSION',
  650. 'RLE_COMPRESSION',
  651. 'ZIPS_COMPRESSION',
  652. 'ZIP_COMPRESSION',
  653. 'PIZ_COMPRESSION',
  654. 'PXR24_COMPRESSION',
  655. 'B44_COMPRESSION',
  656. 'B44A_COMPRESSION',
  657. 'DWAA_COMPRESSION',
  658. 'DWAB_COMPRESSION'
  659. ];
  660. var compression = parseUint8( dataView, offset );
  661. return compressionCodes[ compression ];
  662. }
  663. function parseBox2i( dataView, offset ) {
  664. var xMin = parseUint32( dataView, offset );
  665. var yMin = parseUint32( dataView, offset );
  666. var xMax = parseUint32( dataView, offset );
  667. var yMax = parseUint32( dataView, offset );
  668. return { xMin: xMin, yMin: yMin, xMax: xMax, yMax: yMax };
  669. }
  670. function parseLineOrder( dataView, offset ) {
  671. var lineOrders = [
  672. 'INCREASING_Y'
  673. ];
  674. var lineOrder = parseUint8( dataView, offset );
  675. return lineOrders[ lineOrder ];
  676. }
  677. function parseV2f( dataView, offset ) {
  678. var x = parseFloat32( dataView, offset );
  679. var y = parseFloat32( dataView, offset );
  680. return [ x, y ];
  681. }
  682. function parseValue( dataView, buffer, offset, type, size ) {
  683. if ( type === 'string' || type === 'stringvector' || type === 'iccProfile' ) {
  684. return parseFixedLengthString( buffer, offset, size );
  685. } else if ( type === 'chlist' ) {
  686. return parseChlist( dataView, buffer, offset, size );
  687. } else if ( type === 'chromaticities' ) {
  688. return parseChromaticities( dataView, offset );
  689. } else if ( type === 'compression' ) {
  690. return parseCompression( dataView, offset );
  691. } else if ( type === 'box2i' ) {
  692. return parseBox2i( dataView, offset );
  693. } else if ( type === 'lineOrder' ) {
  694. return parseLineOrder( dataView, offset );
  695. } else if ( type === 'float' ) {
  696. return parseFloat32( dataView, offset );
  697. } else if ( type === 'v2f' ) {
  698. return parseV2f( dataView, offset );
  699. } else if ( type === 'int' ) {
  700. return parseUint32( dataView, offset );
  701. } else {
  702. throw 'Cannot parse value for unsupported type: ' + type;
  703. }
  704. }
  705. var bufferDataView = new DataView( buffer );
  706. var uInt8Array = new Uint8Array( buffer );
  707. var EXRHeader = {};
  708. bufferDataView.getUint32( 0, true ); // magic
  709. bufferDataView.getUint8( 4, true ); // versionByteZero
  710. bufferDataView.getUint8( 5, true ); // fullMask
  711. // start of header
  712. var offset = { value: 8 }; // start at 8, after magic stuff
  713. var keepReading = true;
  714. while ( keepReading ) {
  715. var attributeName = parseNullTerminatedString( buffer, offset );
  716. if ( attributeName == 0 ) {
  717. keepReading = false;
  718. } else {
  719. var attributeType = parseNullTerminatedString( buffer, offset );
  720. var attributeSize = parseUint32( bufferDataView, offset );
  721. var attributeValue = parseValue( bufferDataView, buffer, offset, attributeType, attributeSize );
  722. EXRHeader[ attributeName ] = attributeValue;
  723. }
  724. }
  725. // offsets
  726. var dataWindowHeight = EXRHeader.dataWindow.yMax + 1;
  727. var uncompress;
  728. var scanlineBlockSize;
  729. switch ( EXRHeader.compression ) {
  730. case 'NO_COMPRESSION':
  731. scanlineBlockSize = 1;
  732. uncompress = uncompressRaw;
  733. break;
  734. case 'RLE_COMPRESSION':
  735. scanlineBlockSize = 1;
  736. uncompress = uncompressRLE;
  737. break;
  738. case 'ZIPS_COMPRESSION':
  739. scanlineBlockSize = 1;
  740. uncompress = uncompressZIP;
  741. break;
  742. case 'ZIP_COMPRESSION':
  743. scanlineBlockSize = 16;
  744. uncompress = uncompressZIP;
  745. break;
  746. case 'PIZ_COMPRESSION':
  747. scanlineBlockSize = 32;
  748. uncompress = uncompressPIZ;
  749. break;
  750. default:
  751. throw 'EXRLoader.parse: ' + EXRHeader.compression + ' is unsupported';
  752. }
  753. var size_t;
  754. var getValue;
  755. // mixed pixelType not supported
  756. var pixelType = EXRHeader.channels[ 0 ].pixelType;
  757. if ( pixelType === 1 ) { // half
  758. switch ( this.type ) {
  759. case FloatType:
  760. getValue = parseFloat16;
  761. size_t = INT16_SIZE;
  762. break;
  763. case HalfFloatType:
  764. getValue = parseUint16;
  765. size_t = INT16_SIZE;
  766. break;
  767. }
  768. } else if ( pixelType === 2 ) { // float
  769. switch ( this.type ) {
  770. case FloatType:
  771. getValue = parseFloat32;
  772. size_t = FLOAT32_SIZE;
  773. break;
  774. case HalfFloatType:
  775. throw 'EXRLoader.parse: unsupported HalfFloatType texture for FloatType image file.';
  776. }
  777. } else {
  778. throw 'EXRLoader.parse: unsupported pixelType ' + pixelType + ' for ' + EXRHeader.compression + '.';
  779. }
  780. var numBlocks = dataWindowHeight / scanlineBlockSize;
  781. for ( var i = 0; i < numBlocks; i ++ ) {
  782. parseUlong( bufferDataView, offset ); // scanlineOffset
  783. }
  784. // we should be passed the scanline offset table, start reading pixel data
  785. var width = EXRHeader.dataWindow.xMax - EXRHeader.dataWindow.xMin + 1;
  786. var height = EXRHeader.dataWindow.yMax - EXRHeader.dataWindow.yMin + 1;
  787. // Firefox only supports RGBA (half) float textures
  788. // var numChannels = EXRHeader.channels.length;
  789. var numChannels = 4;
  790. var size = width * height * numChannels;
  791. // Fill initially with 1s for the alpha value if the texture is not RGBA, RGB values will be overwritten
  792. switch ( this.type ) {
  793. case FloatType:
  794. var byteArray = new Float32Array( size );
  795. if ( EXRHeader.channels.length < numChannels ) {
  796. byteArray.fill( 1, 0, size );
  797. }
  798. break;
  799. case HalfFloatType:
  800. var byteArray = new Uint16Array( size );
  801. if ( EXRHeader.channels.length < numChannels ) {
  802. byteArray.fill( 0x3C00, 0, size ); // Uint16Array holds half float data, 0x3C00 is 1
  803. }
  804. break;
  805. default:
  806. console.error( 'THREE.EXRLoader: unsupported type: ', this.type );
  807. break;
  808. }
  809. var channelOffsets = {
  810. R: 0,
  811. G: 1,
  812. B: 2,
  813. A: 3
  814. };
  815. var compressionInfo = {
  816. array: uInt8Array,
  817. viewer: bufferDataView,
  818. offset: offset,
  819. channels: EXRHeader.channels.length,
  820. width: width,
  821. lines: scanlineBlockSize,
  822. size: 0
  823. };
  824. if ( EXRHeader.compression === 'NO_COMPRESSION' ||
  825. EXRHeader.compression === 'ZIP_COMPRESSION' ||
  826. EXRHeader.compression === 'ZIPS_COMPRESSION' ||
  827. EXRHeader.compression === 'RLE_COMPRESSION' ||
  828. EXRHeader.compression === 'PIZ_COMPRESSION' ) {
  829. var size;
  830. var viewer;
  831. var tmpOffset = { value: 0 };
  832. for ( var scanlineBlockIdx = 0; scanlineBlockIdx < height / scanlineBlockSize; scanlineBlockIdx ++ ) {
  833. parseUint32( bufferDataView, offset ); // line_no
  834. size = parseUint32( bufferDataView, offset ); // data_len
  835. compressionInfo.offset = offset;
  836. compressionInfo.size = size;
  837. viewer = uncompress( compressionInfo );
  838. offset.value += size;
  839. for ( var line_y = 0; line_y < scanlineBlockSize; line_y ++ ) {
  840. var true_y = line_y + ( scanlineBlockIdx * scanlineBlockSize );
  841. if ( true_y >= height ) break;
  842. for ( var channelID = 0; channelID < EXRHeader.channels.length; channelID ++ ) {
  843. var cOff = channelOffsets[ EXRHeader.channels[ channelID ].name ];
  844. for ( var x = 0; x < width; x ++ ) {
  845. var idx = ( line_y * ( EXRHeader.channels.length * width ) ) + ( channelID * width ) + x;
  846. tmpOffset.value = idx * size_t;
  847. var val = getValue( viewer, tmpOffset );
  848. byteArray[ ( ( ( height - 1 - true_y ) * ( width * numChannels ) ) + ( x * numChannels ) ) + cOff ] = val;
  849. }
  850. }
  851. }
  852. }
  853. }
  854. return {
  855. header: EXRHeader,
  856. width: width,
  857. height: height,
  858. data: byteArray,
  859. format: numChannels === 4 ? RGBAFormat : RGBFormat,
  860. type: this.type
  861. };
  862. },
  863. setDataType: function ( value ) {
  864. this.type = value;
  865. return this;
  866. },
  867. load: function ( url, onLoad, onProgress, onError ) {
  868. function onLoadCallback( texture, texData ) {
  869. switch ( texture.type ) {
  870. case FloatType:
  871. texture.encoding = LinearEncoding;
  872. texture.minFilter = LinearFilter;
  873. texture.magFilter = LinearFilter;
  874. texture.generateMipmaps = false;
  875. texture.flipY = false;
  876. break;
  877. case HalfFloatType:
  878. texture.encoding = LinearEncoding;
  879. texture.minFilter = LinearFilter;
  880. texture.magFilter = LinearFilter;
  881. texture.generateMipmaps = false;
  882. texture.flipY = false;
  883. break;
  884. }
  885. if ( onLoad ) onLoad( texture, texData );
  886. }
  887. return DataTextureLoader.prototype.load.call( this, url, onLoadCallback, onProgress, onError );
  888. }
  889. } );
  890. export { EXRLoader };