TDSLoader.js 25 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147
  1. /**
  2. * Autodesk 3DS three.js file loader, based on lib3ds.
  3. *
  4. * Loads geometry with uv and materials basic properties with texture support.
  5. *
  6. * @author @tentone
  7. * @author @timknip
  8. * @class TDSLoader
  9. * @constructor
  10. */
  11. import {
  12. AdditiveBlending,
  13. BufferGeometry,
  14. Color,
  15. DefaultLoadingManager,
  16. DoubleSide,
  17. FileLoader,
  18. Float32BufferAttribute,
  19. Group,
  20. LoaderUtils,
  21. Matrix4,
  22. Mesh,
  23. MeshPhongMaterial,
  24. TextureLoader
  25. } from "../../../build/three.module.js";
  26. var TDSLoader = function ( manager ) {
  27. this.manager = ( manager !== undefined ) ? manager : DefaultLoadingManager;
  28. this.debug = false;
  29. this.group = null;
  30. this.position = 0;
  31. this.materials = [];
  32. this.meshes = [];
  33. };
  34. TDSLoader.prototype = {
  35. constructor: TDSLoader,
  36. crossOrigin: 'anonymous',
  37. /**
  38. * Load 3ds file from url.
  39. *
  40. * @method load
  41. * @param {[type]} url URL for the file.
  42. * @param {Function} onLoad onLoad callback, receives group Object3D as argument.
  43. * @param {Function} onProgress onProgress callback.
  44. * @param {Function} onError onError callback.
  45. */
  46. load: function ( url, onLoad, onProgress, onError ) {
  47. var scope = this;
  48. var path = this.path !== undefined ? this.path : LoaderUtils.extractUrlBase( url );
  49. var loader = new FileLoader( this.manager );
  50. loader.setPath( this.path );
  51. loader.setResponseType( 'arraybuffer' );
  52. loader.load( url, function ( data ) {
  53. onLoad( scope.parse( data, path ) );
  54. }, onProgress, onError );
  55. },
  56. /**
  57. * Parse arraybuffer data and load 3ds file.
  58. *
  59. * @method parse
  60. * @param {ArrayBuffer} arraybuffer Arraybuffer data to be loaded.
  61. * @param {String} path Path for external resources.
  62. * @return {Group} Group loaded from 3ds file.
  63. */
  64. parse: function ( arraybuffer, path ) {
  65. this.group = new Group();
  66. this.position = 0;
  67. this.materials = [];
  68. this.meshes = [];
  69. this.readFile( arraybuffer, path );
  70. for ( var i = 0; i < this.meshes.length; i ++ ) {
  71. this.group.add( this.meshes[ i ] );
  72. }
  73. return this.group;
  74. },
  75. /**
  76. * Decode file content to read 3ds data.
  77. *
  78. * @method readFile
  79. * @param {ArrayBuffer} arraybuffer Arraybuffer data to be loaded.
  80. * @param {String} path Path for external resources.
  81. */
  82. readFile: function ( arraybuffer, path ) {
  83. var data = new DataView( arraybuffer );
  84. var chunk = this.readChunk( data );
  85. if ( chunk.id === MLIBMAGIC || chunk.id === CMAGIC || chunk.id === M3DMAGIC ) {
  86. var next = this.nextChunk( data, chunk );
  87. while ( next !== 0 ) {
  88. if ( next === M3D_VERSION ) {
  89. var version = this.readDWord( data );
  90. this.debugMessage( '3DS file version: ' + version );
  91. } else if ( next === MDATA ) {
  92. this.resetPosition( data );
  93. this.readMeshData( data, path );
  94. } else {
  95. this.debugMessage( 'Unknown main chunk: ' + next.toString( 16 ) );
  96. }
  97. next = this.nextChunk( data, chunk );
  98. }
  99. }
  100. this.debugMessage( 'Parsed ' + this.meshes.length + ' meshes' );
  101. },
  102. /**
  103. * Read mesh data chunk.
  104. *
  105. * @method readMeshData
  106. * @param {Dataview} data Dataview in use.
  107. * @param {String} path Path for external resources.
  108. */
  109. readMeshData: function ( data, path ) {
  110. var chunk = this.readChunk( data );
  111. var next = this.nextChunk( data, chunk );
  112. while ( next !== 0 ) {
  113. if ( next === MESH_VERSION ) {
  114. var version = + this.readDWord( data );
  115. this.debugMessage( 'Mesh Version: ' + version );
  116. } else if ( next === MASTER_SCALE ) {
  117. var scale = this.readFloat( data );
  118. this.debugMessage( 'Master scale: ' + scale );
  119. this.group.scale.set( scale, scale, scale );
  120. } else if ( next === NAMED_OBJECT ) {
  121. this.debugMessage( 'Named Object' );
  122. this.resetPosition( data );
  123. this.readNamedObject( data );
  124. } else if ( next === MAT_ENTRY ) {
  125. this.debugMessage( 'Material' );
  126. this.resetPosition( data );
  127. this.readMaterialEntry( data, path );
  128. } else {
  129. this.debugMessage( 'Unknown MDATA chunk: ' + next.toString( 16 ) );
  130. }
  131. next = this.nextChunk( data, chunk );
  132. }
  133. },
  134. /**
  135. * Read named object chunk.
  136. *
  137. * @method readNamedObject
  138. * @param {Dataview} data Dataview in use.
  139. */
  140. readNamedObject: function ( data ) {
  141. var chunk = this.readChunk( data );
  142. var name = this.readString( data, 64 );
  143. chunk.cur = this.position;
  144. var next = this.nextChunk( data, chunk );
  145. while ( next !== 0 ) {
  146. if ( next === N_TRI_OBJECT ) {
  147. this.resetPosition( data );
  148. var mesh = this.readMesh( data );
  149. mesh.name = name;
  150. this.meshes.push( mesh );
  151. } else {
  152. this.debugMessage( 'Unknown named object chunk: ' + next.toString( 16 ) );
  153. }
  154. next = this.nextChunk( data, chunk );
  155. }
  156. this.endChunk( chunk );
  157. },
  158. /**
  159. * Read material data chunk and add it to the material list.
  160. *
  161. * @method readMaterialEntry
  162. * @param {Dataview} data Dataview in use.
  163. * @param {String} path Path for external resources.
  164. */
  165. readMaterialEntry: function ( data, path ) {
  166. var chunk = this.readChunk( data );
  167. var next = this.nextChunk( data, chunk );
  168. var material = new MeshPhongMaterial();
  169. while ( next !== 0 ) {
  170. if ( next === MAT_NAME ) {
  171. material.name = this.readString( data, 64 );
  172. this.debugMessage( ' Name: ' + material.name );
  173. } else if ( next === MAT_WIRE ) {
  174. this.debugMessage( ' Wireframe' );
  175. material.wireframe = true;
  176. } else if ( next === MAT_WIRE_SIZE ) {
  177. var value = this.readByte( data );
  178. material.wireframeLinewidth = value;
  179. this.debugMessage( ' Wireframe Thickness: ' + value );
  180. } else if ( next === MAT_TWO_SIDE ) {
  181. material.side = DoubleSide;
  182. this.debugMessage( ' DoubleSided' );
  183. } else if ( next === MAT_ADDITIVE ) {
  184. this.debugMessage( ' Additive Blending' );
  185. material.blending = AdditiveBlending;
  186. } else if ( next === MAT_DIFFUSE ) {
  187. this.debugMessage( ' Diffuse Color' );
  188. material.color = this.readColor( data );
  189. } else if ( next === MAT_SPECULAR ) {
  190. this.debugMessage( ' Specular Color' );
  191. material.specular = this.readColor( data );
  192. } else if ( next === MAT_AMBIENT ) {
  193. this.debugMessage( ' Ambient color' );
  194. material.color = this.readColor( data );
  195. } else if ( next === MAT_SHININESS ) {
  196. var shininess = this.readWord( data );
  197. material.shininess = shininess;
  198. this.debugMessage( ' Shininess : ' + shininess );
  199. } else if ( next === MAT_TEXMAP ) {
  200. this.debugMessage( ' ColorMap' );
  201. this.resetPosition( data );
  202. material.map = this.readMap( data, path );
  203. } else if ( next === MAT_BUMPMAP ) {
  204. this.debugMessage( ' BumpMap' );
  205. this.resetPosition( data );
  206. material.bumpMap = this.readMap( data, path );
  207. } else if ( next === MAT_OPACMAP ) {
  208. this.debugMessage( ' OpacityMap' );
  209. this.resetPosition( data );
  210. material.alphaMap = this.readMap( data, path );
  211. } else if ( next === MAT_SPECMAP ) {
  212. this.debugMessage( ' SpecularMap' );
  213. this.resetPosition( data );
  214. material.specularMap = this.readMap( data, path );
  215. } else {
  216. this.debugMessage( ' Unknown material chunk: ' + next.toString( 16 ) );
  217. }
  218. next = this.nextChunk( data, chunk );
  219. }
  220. this.endChunk( chunk );
  221. this.materials[ material.name ] = material;
  222. },
  223. /**
  224. * Read mesh data chunk.
  225. *
  226. * @method readMesh
  227. * @param {Dataview} data Dataview in use.
  228. * @return {Mesh} The parsed mesh.
  229. */
  230. readMesh: function ( data ) {
  231. var chunk = this.readChunk( data );
  232. var next = this.nextChunk( data, chunk );
  233. var geometry = new BufferGeometry();
  234. var uvs = [];
  235. var material = new MeshPhongMaterial();
  236. var mesh = new Mesh( geometry, material );
  237. mesh.name = 'mesh';
  238. while ( next !== 0 ) {
  239. if ( next === POINT_ARRAY ) {
  240. var points = this.readWord( data );
  241. this.debugMessage( ' Vertex: ' + points );
  242. //BufferGeometry
  243. var vertices = [];
  244. for ( var i = 0; i < points; i ++ ) {
  245. vertices.push( this.readFloat( data ) );
  246. vertices.push( this.readFloat( data ) );
  247. vertices.push( this.readFloat( data ) );
  248. }
  249. geometry.addAttribute( 'position', new Float32BufferAttribute( vertices, 3 ) );
  250. } else if ( next === FACE_ARRAY ) {
  251. this.resetPosition( data );
  252. this.readFaceArray( data, mesh );
  253. } else if ( next === TEX_VERTS ) {
  254. var texels = this.readWord( data );
  255. this.debugMessage( ' UV: ' + texels );
  256. //BufferGeometry
  257. var uvs = [];
  258. for ( var i = 0; i < texels; i ++ ) {
  259. uvs.push( this.readFloat( data ) );
  260. uvs.push( this.readFloat( data ) );
  261. }
  262. geometry.addAttribute( 'uv', new Float32BufferAttribute( uvs, 2 ) );
  263. } else if ( next === MESH_MATRIX ) {
  264. this.debugMessage( ' Tranformation Matrix (TODO)' );
  265. var values = [];
  266. for ( var i = 0; i < 12; i ++ ) {
  267. values[ i ] = this.readFloat( data );
  268. }
  269. var matrix = new Matrix4();
  270. //X Line
  271. matrix.elements[ 0 ] = values[ 0 ];
  272. matrix.elements[ 1 ] = values[ 6 ];
  273. matrix.elements[ 2 ] = values[ 3 ];
  274. matrix.elements[ 3 ] = values[ 9 ];
  275. //Y Line
  276. matrix.elements[ 4 ] = values[ 2 ];
  277. matrix.elements[ 5 ] = values[ 8 ];
  278. matrix.elements[ 6 ] = values[ 5 ];
  279. matrix.elements[ 7 ] = values[ 11 ];
  280. //Z Line
  281. matrix.elements[ 8 ] = values[ 1 ];
  282. matrix.elements[ 9 ] = values[ 7 ];
  283. matrix.elements[ 10 ] = values[ 4 ];
  284. matrix.elements[ 11 ] = values[ 10 ];
  285. //W Line
  286. matrix.elements[ 12 ] = 0;
  287. matrix.elements[ 13 ] = 0;
  288. matrix.elements[ 14 ] = 0;
  289. matrix.elements[ 15 ] = 1;
  290. matrix.transpose();
  291. var inverse = new Matrix4();
  292. inverse.getInverse( matrix, true );
  293. geometry.applyMatrix( inverse );
  294. matrix.decompose( mesh.position, mesh.quaternion, mesh.scale );
  295. } else {
  296. this.debugMessage( ' Unknown mesh chunk: ' + next.toString( 16 ) );
  297. }
  298. next = this.nextChunk( data, chunk );
  299. }
  300. this.endChunk( chunk );
  301. geometry.computeVertexNormals();
  302. return mesh;
  303. },
  304. /**
  305. * Read face array data chunk.
  306. *
  307. * @method readFaceArray
  308. * @param {Dataview} data Dataview in use.
  309. * @param {Mesh} mesh Mesh to be filled with the data read.
  310. */
  311. readFaceArray: function ( data, mesh ) {
  312. var chunk = this.readChunk( data );
  313. var faces = this.readWord( data );
  314. this.debugMessage( ' Faces: ' + faces );
  315. var index = [];
  316. for ( var i = 0; i < faces; ++ i ) {
  317. index.push( this.readWord( data ), this.readWord( data ), this.readWord( data ) );
  318. this.readWord( data ); // visibility
  319. }
  320. mesh.geometry.setIndex( index );
  321. //The rest of the FACE_ARRAY chunk is subchunks
  322. while ( this.position < chunk.end ) {
  323. var chunk = this.readChunk( data );
  324. if ( chunk.id === MSH_MAT_GROUP ) {
  325. this.debugMessage( ' Material Group' );
  326. this.resetPosition( data );
  327. var group = this.readMaterialGroup( data );
  328. var material = this.materials[ group.name ];
  329. if ( material !== undefined ) {
  330. mesh.material = material;
  331. if ( material.name === '' ) {
  332. material.name = mesh.name;
  333. }
  334. }
  335. } else {
  336. this.debugMessage( ' Unknown face array chunk: ' + chunk.toString( 16 ) );
  337. }
  338. this.endChunk( chunk );
  339. }
  340. this.endChunk( chunk );
  341. },
  342. /**
  343. * Read texture map data chunk.
  344. *
  345. * @method readMap
  346. * @param {Dataview} data Dataview in use.
  347. * @param {String} path Path for external resources.
  348. * @return {Texture} Texture read from this data chunk.
  349. */
  350. readMap: function ( data, path ) {
  351. var chunk = this.readChunk( data );
  352. var next = this.nextChunk( data, chunk );
  353. var texture = {};
  354. var loader = new TextureLoader( this.manager );
  355. loader.setPath( this.resourcePath || path ).setCrossOrigin( this.crossOrigin );
  356. while ( next !== 0 ) {
  357. if ( next === MAT_MAPNAME ) {
  358. var name = this.readString( data, 128 );
  359. texture = loader.load( name );
  360. this.debugMessage( ' File: ' + path + name );
  361. } else if ( next === MAT_MAP_UOFFSET ) {
  362. texture.offset.x = this.readFloat( data );
  363. this.debugMessage( ' OffsetX: ' + texture.offset.x );
  364. } else if ( next === MAT_MAP_VOFFSET ) {
  365. texture.offset.y = this.readFloat( data );
  366. this.debugMessage( ' OffsetY: ' + texture.offset.y );
  367. } else if ( next === MAT_MAP_USCALE ) {
  368. texture.repeat.x = this.readFloat( data );
  369. this.debugMessage( ' RepeatX: ' + texture.repeat.x );
  370. } else if ( next === MAT_MAP_VSCALE ) {
  371. texture.repeat.y = this.readFloat( data );
  372. this.debugMessage( ' RepeatY: ' + texture.repeat.y );
  373. } else {
  374. this.debugMessage( ' Unknown map chunk: ' + next.toString( 16 ) );
  375. }
  376. next = this.nextChunk( data, chunk );
  377. }
  378. this.endChunk( chunk );
  379. return texture;
  380. },
  381. /**
  382. * Read material group data chunk.
  383. *
  384. * @method readMaterialGroup
  385. * @param {Dataview} data Dataview in use.
  386. * @return {Object} Object with name and index of the object.
  387. */
  388. readMaterialGroup: function ( data ) {
  389. this.readChunk( data );
  390. var name = this.readString( data, 64 );
  391. var numFaces = this.readWord( data );
  392. this.debugMessage( ' Name: ' + name );
  393. this.debugMessage( ' Faces: ' + numFaces );
  394. var index = [];
  395. for ( var i = 0; i < numFaces; ++ i ) {
  396. index.push( this.readWord( data ) );
  397. }
  398. return { name: name, index: index };
  399. },
  400. /**
  401. * Read a color value.
  402. *
  403. * @method readColor
  404. * @param {DataView} data Dataview.
  405. * @return {Color} Color value read..
  406. */
  407. readColor: function ( data ) {
  408. var chunk = this.readChunk( data );
  409. var color = new Color();
  410. if ( chunk.id === COLOR_24 || chunk.id === LIN_COLOR_24 ) {
  411. var r = this.readByte( data );
  412. var g = this.readByte( data );
  413. var b = this.readByte( data );
  414. color.setRGB( r / 255, g / 255, b / 255 );
  415. this.debugMessage( ' Color: ' + color.r + ', ' + color.g + ', ' + color.b );
  416. } else if ( chunk.id === COLOR_F || chunk.id === LIN_COLOR_F ) {
  417. var r = this.readFloat( data );
  418. var g = this.readFloat( data );
  419. var b = this.readFloat( data );
  420. color.setRGB( r, g, b );
  421. this.debugMessage( ' Color: ' + color.r + ', ' + color.g + ', ' + color.b );
  422. } else {
  423. this.debugMessage( ' Unknown color chunk: ' + chunk.toString( 16 ) );
  424. }
  425. this.endChunk( chunk );
  426. return color;
  427. },
  428. /**
  429. * Read next chunk of data.
  430. *
  431. * @method readChunk
  432. * @param {DataView} data Dataview.
  433. * @return {Object} Chunk of data read.
  434. */
  435. readChunk: function ( data ) {
  436. var chunk = {};
  437. chunk.cur = this.position;
  438. chunk.id = this.readWord( data );
  439. chunk.size = this.readDWord( data );
  440. chunk.end = chunk.cur + chunk.size;
  441. chunk.cur += 6;
  442. return chunk;
  443. },
  444. /**
  445. * Set position to the end of the current chunk of data.
  446. *
  447. * @method endChunk
  448. * @param {Object} chunk Data chunk.
  449. */
  450. endChunk: function ( chunk ) {
  451. this.position = chunk.end;
  452. },
  453. /**
  454. * Move to the next data chunk.
  455. *
  456. * @method nextChunk
  457. * @param {DataView} data Dataview.
  458. * @param {Object} chunk Data chunk.
  459. */
  460. nextChunk: function ( data, chunk ) {
  461. if ( chunk.cur >= chunk.end ) {
  462. return 0;
  463. }
  464. this.position = chunk.cur;
  465. try {
  466. var next = this.readChunk( data );
  467. chunk.cur += next.size;
  468. return next.id;
  469. } catch ( e ) {
  470. this.debugMessage( 'Unable to read chunk at ' + this.position );
  471. return 0;
  472. }
  473. },
  474. /**
  475. * Reset dataview position.
  476. *
  477. * @method resetPosition
  478. */
  479. resetPosition: function () {
  480. this.position -= 6;
  481. },
  482. /**
  483. * Read byte value.
  484. *
  485. * @method readByte
  486. * @param {DataView} data Dataview to read data from.
  487. * @return {Number} Data read from the dataview.
  488. */
  489. readByte: function ( data ) {
  490. var v = data.getUint8( this.position, true );
  491. this.position += 1;
  492. return v;
  493. },
  494. /**
  495. * Read 32 bit float value.
  496. *
  497. * @method readFloat
  498. * @param {DataView} data Dataview to read data from.
  499. * @return {Number} Data read from the dataview.
  500. */
  501. readFloat: function ( data ) {
  502. try {
  503. var v = data.getFloat32( this.position, true );
  504. this.position += 4;
  505. return v;
  506. } catch ( e ) {
  507. this.debugMessage( e + ' ' + this.position + ' ' + data.byteLength );
  508. }
  509. },
  510. /**
  511. * Read 32 bit signed integer value.
  512. *
  513. * @method readInt
  514. * @param {DataView} data Dataview to read data from.
  515. * @return {Number} Data read from the dataview.
  516. */
  517. readInt: function ( data ) {
  518. var v = data.getInt32( this.position, true );
  519. this.position += 4;
  520. return v;
  521. },
  522. /**
  523. * Read 16 bit signed integer value.
  524. *
  525. * @method readShort
  526. * @param {DataView} data Dataview to read data from.
  527. * @return {Number} Data read from the dataview.
  528. */
  529. readShort: function ( data ) {
  530. var v = data.getInt16( this.position, true );
  531. this.position += 2;
  532. return v;
  533. },
  534. /**
  535. * Read 64 bit unsigned integer value.
  536. *
  537. * @method readDWord
  538. * @param {DataView} data Dataview to read data from.
  539. * @return {Number} Data read from the dataview.
  540. */
  541. readDWord: function ( data ) {
  542. var v = data.getUint32( this.position, true );
  543. this.position += 4;
  544. return v;
  545. },
  546. /**
  547. * Read 32 bit unsigned integer value.
  548. *
  549. * @method readWord
  550. * @param {DataView} data Dataview to read data from.
  551. * @return {Number} Data read from the dataview.
  552. */
  553. readWord: function ( data ) {
  554. var v = data.getUint16( this.position, true );
  555. this.position += 2;
  556. return v;
  557. },
  558. /**
  559. * Read string value.
  560. *
  561. * @method readString
  562. * @param {DataView} data Dataview to read data from.
  563. * @param {Number} maxLength Max size of the string to be read.
  564. * @return {String} Data read from the dataview.
  565. */
  566. readString: function ( data, maxLength ) {
  567. var s = '';
  568. for ( var i = 0; i < maxLength; i ++ ) {
  569. var c = this.readByte( data );
  570. if ( ! c ) {
  571. break;
  572. }
  573. s += String.fromCharCode( c );
  574. }
  575. return s;
  576. },
  577. /**
  578. * Set path to adjust the path to the original 3ds file.
  579. *
  580. * @method setPath
  581. * @param {String} path Path to file.
  582. * @return Self for chaining.
  583. */
  584. setPath: function ( path ) {
  585. this.path = path;
  586. return this;
  587. },
  588. /**
  589. * Set resource path used to determine the path to attached resources like textures.
  590. *
  591. * @method setResourcePath
  592. * @param {String} resourcePath Path to resources.
  593. * @return Self for chaining.
  594. */
  595. setResourcePath: function ( resourcePath ) {
  596. this.resourcePath = resourcePath;
  597. return this;
  598. },
  599. /**
  600. * Set crossOrigin value to configure CORS settings
  601. * for the image loading process.
  602. *
  603. * @method setCrossOrigin
  604. * @param {String} crossOrigin crossOrigin string.
  605. * @return Self for chaining.
  606. */
  607. setCrossOrigin: function ( crossOrigin ) {
  608. this.crossOrigin = crossOrigin;
  609. return this;
  610. },
  611. /**
  612. * Print debug message to the console.
  613. *
  614. * Is controlled by a flag to show or hide debug messages.
  615. *
  616. * @method debugMessage
  617. * @param {Object} message Debug message to print to the console.
  618. */
  619. debugMessage: function ( message ) {
  620. if ( this.debug ) {
  621. console.log( message );
  622. }
  623. }
  624. };
  625. // var NULL_CHUNK = 0x0000;
  626. var M3DMAGIC = 0x4D4D;
  627. // var SMAGIC = 0x2D2D;
  628. // var LMAGIC = 0x2D3D;
  629. var MLIBMAGIC = 0x3DAA;
  630. // var MATMAGIC = 0x3DFF;
  631. var CMAGIC = 0xC23D;
  632. var M3D_VERSION = 0x0002;
  633. // var M3D_KFVERSION = 0x0005;
  634. var COLOR_F = 0x0010;
  635. var COLOR_24 = 0x0011;
  636. var LIN_COLOR_24 = 0x0012;
  637. var LIN_COLOR_F = 0x0013;
  638. // var INT_PERCENTAGE = 0x0030;
  639. // var FLOAT_PERCENTAGE = 0x0031;
  640. var MDATA = 0x3D3D;
  641. var MESH_VERSION = 0x3D3E;
  642. var MASTER_SCALE = 0x0100;
  643. // var LO_SHADOW_BIAS = 0x1400;
  644. // var HI_SHADOW_BIAS = 0x1410;
  645. // var SHADOW_MAP_SIZE = 0x1420;
  646. // var SHADOW_SAMPLES = 0x1430;
  647. // var SHADOW_RANGE = 0x1440;
  648. // var SHADOW_FILTER = 0x1450;
  649. // var RAY_BIAS = 0x1460;
  650. // var O_CONSTS = 0x1500;
  651. // var AMBIENT_LIGHT = 0x2100;
  652. // var BIT_MAP = 0x1100;
  653. // var SOLID_BGND = 0x1200;
  654. // var V_GRADIENT = 0x1300;
  655. // var USE_BIT_MAP = 0x1101;
  656. // var USE_SOLID_BGND = 0x1201;
  657. // var USE_V_GRADIENT = 0x1301;
  658. // var FOG = 0x2200;
  659. // var FOG_BGND = 0x2210;
  660. // var LAYER_FOG = 0x2302;
  661. // var DISTANCE_CUE = 0x2300;
  662. // var DCUE_BGND = 0x2310;
  663. // var USE_FOG = 0x2201;
  664. // var USE_LAYER_FOG = 0x2303;
  665. // var USE_DISTANCE_CUE = 0x2301;
  666. var MAT_ENTRY = 0xAFFF;
  667. var MAT_NAME = 0xA000;
  668. var MAT_AMBIENT = 0xA010;
  669. var MAT_DIFFUSE = 0xA020;
  670. var MAT_SPECULAR = 0xA030;
  671. var MAT_SHININESS = 0xA040;
  672. // var MAT_SHIN2PCT = 0xA041;
  673. // var MAT_TRANSPARENCY = 0xA050;
  674. // var MAT_XPFALL = 0xA052;
  675. // var MAT_USE_XPFALL = 0xA240;
  676. // var MAT_REFBLUR = 0xA053;
  677. // var MAT_SHADING = 0xA100;
  678. // var MAT_USE_REFBLUR = 0xA250;
  679. // var MAT_SELF_ILLUM = 0xA084;
  680. var MAT_TWO_SIDE = 0xA081;
  681. // var MAT_DECAL = 0xA082;
  682. var MAT_ADDITIVE = 0xA083;
  683. var MAT_WIRE = 0xA085;
  684. // var MAT_FACEMAP = 0xA088;
  685. // var MAT_TRANSFALLOFF_IN = 0xA08A;
  686. // var MAT_PHONGSOFT = 0xA08C;
  687. // var MAT_WIREABS = 0xA08E;
  688. var MAT_WIRE_SIZE = 0xA087;
  689. var MAT_TEXMAP = 0xA200;
  690. // var MAT_SXP_TEXT_DATA = 0xA320;
  691. // var MAT_TEXMASK = 0xA33E;
  692. // var MAT_SXP_TEXTMASK_DATA = 0xA32A;
  693. // var MAT_TEX2MAP = 0xA33A;
  694. // var MAT_SXP_TEXT2_DATA = 0xA321;
  695. // var MAT_TEX2MASK = 0xA340;
  696. // var MAT_SXP_TEXT2MASK_DATA = 0xA32C;
  697. var MAT_OPACMAP = 0xA210;
  698. // var MAT_SXP_OPAC_DATA = 0xA322;
  699. // var MAT_OPACMASK = 0xA342;
  700. // var MAT_SXP_OPACMASK_DATA = 0xA32E;
  701. var MAT_BUMPMAP = 0xA230;
  702. // var MAT_SXP_BUMP_DATA = 0xA324;
  703. // var MAT_BUMPMASK = 0xA344;
  704. // var MAT_SXP_BUMPMASK_DATA = 0xA330;
  705. var MAT_SPECMAP = 0xA204;
  706. // var MAT_SXP_SPEC_DATA = 0xA325;
  707. // var MAT_SPECMASK = 0xA348;
  708. // var MAT_SXP_SPECMASK_DATA = 0xA332;
  709. // var MAT_SHINMAP = 0xA33C;
  710. // var MAT_SXP_SHIN_DATA = 0xA326;
  711. // var MAT_SHINMASK = 0xA346;
  712. // var MAT_SXP_SHINMASK_DATA = 0xA334;
  713. // var MAT_SELFIMAP = 0xA33D;
  714. // var MAT_SXP_SELFI_DATA = 0xA328;
  715. // var MAT_SELFIMASK = 0xA34A;
  716. // var MAT_SXP_SELFIMASK_DATA = 0xA336;
  717. // var MAT_REFLMAP = 0xA220;
  718. // var MAT_REFLMASK = 0xA34C;
  719. // var MAT_SXP_REFLMASK_DATA = 0xA338;
  720. // var MAT_ACUBIC = 0xA310;
  721. var MAT_MAPNAME = 0xA300;
  722. // var MAT_MAP_TILING = 0xA351;
  723. // var MAT_MAP_TEXBLUR = 0xA353;
  724. var MAT_MAP_USCALE = 0xA354;
  725. var MAT_MAP_VSCALE = 0xA356;
  726. var MAT_MAP_UOFFSET = 0xA358;
  727. var MAT_MAP_VOFFSET = 0xA35A;
  728. // var MAT_MAP_ANG = 0xA35C;
  729. // var MAT_MAP_COL1 = 0xA360;
  730. // var MAT_MAP_COL2 = 0xA362;
  731. // var MAT_MAP_RCOL = 0xA364;
  732. // var MAT_MAP_GCOL = 0xA366;
  733. // var MAT_MAP_BCOL = 0xA368;
  734. var NAMED_OBJECT = 0x4000;
  735. // var N_DIRECT_LIGHT = 0x4600;
  736. // var DL_OFF = 0x4620;
  737. // var DL_OUTER_RANGE = 0x465A;
  738. // var DL_INNER_RANGE = 0x4659;
  739. // var DL_MULTIPLIER = 0x465B;
  740. // var DL_EXCLUDE = 0x4654;
  741. // var DL_ATTENUATE = 0x4625;
  742. // var DL_SPOTLIGHT = 0x4610;
  743. // var DL_SPOT_ROLL = 0x4656;
  744. // var DL_SHADOWED = 0x4630;
  745. // var DL_LOCAL_SHADOW2 = 0x4641;
  746. // var DL_SEE_CONE = 0x4650;
  747. // var DL_SPOT_RECTANGULAR = 0x4651;
  748. // var DL_SPOT_ASPECT = 0x4657;
  749. // var DL_SPOT_PROJECTOR = 0x4653;
  750. // var DL_SPOT_OVERSHOOT = 0x4652;
  751. // var DL_RAY_BIAS = 0x4658;
  752. // var DL_RAYSHAD = 0x4627;
  753. // var N_CAMERA = 0x4700;
  754. // var CAM_SEE_CONE = 0x4710;
  755. // var CAM_RANGES = 0x4720;
  756. // var OBJ_HIDDEN = 0x4010;
  757. // var OBJ_VIS_LOFTER = 0x4011;
  758. // var OBJ_DOESNT_CAST = 0x4012;
  759. // var OBJ_DONT_RECVSHADOW = 0x4017;
  760. // var OBJ_MATTE = 0x4013;
  761. // var OBJ_FAST = 0x4014;
  762. // var OBJ_PROCEDURAL = 0x4015;
  763. // var OBJ_FROZEN = 0x4016;
  764. var N_TRI_OBJECT = 0x4100;
  765. var POINT_ARRAY = 0x4110;
  766. // var POINT_FLAG_ARRAY = 0x4111;
  767. var FACE_ARRAY = 0x4120;
  768. var MSH_MAT_GROUP = 0x4130;
  769. // var SMOOTH_GROUP = 0x4150;
  770. // var MSH_BOXMAP = 0x4190;
  771. var TEX_VERTS = 0x4140;
  772. var MESH_MATRIX = 0x4160;
  773. // var MESH_COLOR = 0x4165;
  774. // var MESH_TEXTURE_INFO = 0x4170;
  775. // var KFDATA = 0xB000;
  776. // var KFHDR = 0xB00A;
  777. // var KFSEG = 0xB008;
  778. // var KFCURTIME = 0xB009;
  779. // var AMBIENT_NODE_TAG = 0xB001;
  780. // var OBJECT_NODE_TAG = 0xB002;
  781. // var CAMERA_NODE_TAG = 0xB003;
  782. // var TARGET_NODE_TAG = 0xB004;
  783. // var LIGHT_NODE_TAG = 0xB005;
  784. // var L_TARGET_NODE_TAG = 0xB006;
  785. // var SPOTLIGHT_NODE_TAG = 0xB007;
  786. // var NODE_ID = 0xB030;
  787. // var NODE_HDR = 0xB010;
  788. // var PIVOT = 0xB013;
  789. // var INSTANCE_NAME = 0xB011;
  790. // var MORPH_SMOOTH = 0xB015;
  791. // var BOUNDBOX = 0xB014;
  792. // var POS_TRACK_TAG = 0xB020;
  793. // var COL_TRACK_TAG = 0xB025;
  794. // var ROT_TRACK_TAG = 0xB021;
  795. // var SCL_TRACK_TAG = 0xB022;
  796. // var MORPH_TRACK_TAG = 0xB026;
  797. // var FOV_TRACK_TAG = 0xB023;
  798. // var ROLL_TRACK_TAG = 0xB024;
  799. // var HOT_TRACK_TAG = 0xB027;
  800. // var FALL_TRACK_TAG = 0xB028;
  801. // var HIDE_TRACK_TAG = 0xB029;
  802. // var POLY_2D = 0x5000;
  803. // var SHAPE_OK = 0x5010;
  804. // var SHAPE_NOT_OK = 0x5011;
  805. // var SHAPE_HOOK = 0x5020;
  806. // var PATH_3D = 0x6000;
  807. // var PATH_MATRIX = 0x6005;
  808. // var SHAPE_2D = 0x6010;
  809. // var M_SCALE = 0x6020;
  810. // var M_TWIST = 0x6030;
  811. // var M_TEETER = 0x6040;
  812. // var M_FIT = 0x6050;
  813. // var M_BEVEL = 0x6060;
  814. // var XZ_CURVE = 0x6070;
  815. // var YZ_CURVE = 0x6080;
  816. // var INTERPCT = 0x6090;
  817. // var DEFORM_LIMIT = 0x60A0;
  818. // var USE_CONTOUR = 0x6100;
  819. // var USE_TWEEN = 0x6110;
  820. // var USE_SCALE = 0x6120;
  821. // var USE_TWIST = 0x6130;
  822. // var USE_TEETER = 0x6140;
  823. // var USE_FIT = 0x6150;
  824. // var USE_BEVEL = 0x6160;
  825. // var DEFAULT_VIEW = 0x3000;
  826. // var VIEW_TOP = 0x3010;
  827. // var VIEW_BOTTOM = 0x3020;
  828. // var VIEW_LEFT = 0x3030;
  829. // var VIEW_RIGHT = 0x3040;
  830. // var VIEW_FRONT = 0x3050;
  831. // var VIEW_BACK = 0x3060;
  832. // var VIEW_USER = 0x3070;
  833. // var VIEW_CAMERA = 0x3080;
  834. // var VIEW_WINDOW = 0x3090;
  835. // var VIEWPORT_LAYOUT_OLD = 0x7000;
  836. // var VIEWPORT_DATA_OLD = 0x7010;
  837. // var VIEWPORT_LAYOUT = 0x7001;
  838. // var VIEWPORT_DATA = 0x7011;
  839. // var VIEWPORT_DATA_3 = 0x7012;
  840. // var VIEWPORT_SIZE = 0x7020;
  841. // var NETWORK_VIEW = 0x7030;
  842. export { TDSLoader };