EXRLoader.js 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482
  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 === '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 };