OBJLoader2.js 45 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411
  1. /**
  2. * @author Kai Salmen / https://kaisalmen.de
  3. * Development repository: https://github.com/kaisalmen/WWOBJLoader
  4. */
  5. 'use strict';
  6. if ( THREE.OBJLoader2 === undefined ) { THREE.OBJLoader2 = {} }
  7. if ( THREE.LoaderSupport === undefined ) console.error( '"THREE.LoaderSupport" is not available. "THREE.OBJLoader2" requires it. Please include "LoaderSupport.js" in your HTML.' );
  8. /**
  9. * Use this class to load OBJ data from files or to parse OBJ data from an arraybuffer
  10. * @class
  11. *
  12. * @param {THREE.DefaultLoadingManager} [manager] The loadingManager for the loader to use. Default is {@link THREE.DefaultLoadingManager}
  13. */
  14. THREE.OBJLoader2 = (function () {
  15. var OBJLOADER2_VERSION = '2.4.1';
  16. var Validator = THREE.LoaderSupport.Validator;
  17. function OBJLoader2( manager ) {
  18. console.info( 'Using THREE.OBJLoader2 version: ' + OBJLOADER2_VERSION );
  19. this.manager = Validator.verifyInput( manager, THREE.DefaultLoadingManager );
  20. this.logging = {
  21. enabled: true,
  22. debug: false
  23. };
  24. this.modelName = '';
  25. this.instanceNo = 0;
  26. this.path = '';
  27. this.useIndices = false;
  28. this.disregardNormals = false;
  29. this.materialPerSmoothingGroup = false;
  30. this.useOAsMesh = false;
  31. this.loaderRootNode = new THREE.Group();
  32. this.meshBuilder = new THREE.LoaderSupport.MeshBuilder();
  33. this.callbacks = new THREE.LoaderSupport.Callbacks();
  34. this.workerSupport = new THREE.LoaderSupport.WorkerSupport();
  35. this.terminateWorkerOnLoad = true;
  36. }
  37. /**
  38. * Enable or disable logging in general (except warn and error), plus enable or disable debug logging.
  39. * @memberOf THREE.OBJLoader2
  40. *
  41. * @param {boolean} enabled True or false.
  42. * @param {boolean} debug True or false.
  43. */
  44. OBJLoader2.prototype.setLogging = function ( enabled, debug ) {
  45. this.logging.enabled = enabled === true;
  46. this.logging.debug = debug === true;
  47. this.meshBuilder.setLogging( this.logging.enabled, this.logging.debug );
  48. };
  49. /**
  50. * Set the name of the model.
  51. * @memberOf THREE.OBJLoader2
  52. *
  53. * @param {string} modelName
  54. */
  55. OBJLoader2.prototype.setModelName = function ( modelName ) {
  56. this.modelName = Validator.verifyInput( modelName, this.modelName );
  57. };
  58. /**
  59. * The URL of the base path.
  60. * @memberOf THREE.OBJLoader2
  61. *
  62. * @param {string} path URL
  63. */
  64. OBJLoader2.prototype.setPath = function ( path ) {
  65. this.path = Validator.verifyInput( path, this.path );
  66. };
  67. /**
  68. * Set the node where the loaded objects will be attached directly.
  69. * @memberOf THREE.OBJLoader2
  70. *
  71. * @param {THREE.Object3D} streamMeshesTo Object already attached to scenegraph where new meshes will be attached to
  72. */
  73. OBJLoader2.prototype.setStreamMeshesTo = function ( streamMeshesTo ) {
  74. this.loaderRootNode = Validator.verifyInput( streamMeshesTo, this.loaderRootNode );
  75. };
  76. /**
  77. * Set materials loaded by MTLLoader or any other supplier of an Array of {@link THREE.Material}.
  78. * @memberOf THREE.OBJLoader2
  79. *
  80. * @param {THREE.Material[]} materials Array of {@link THREE.Material}
  81. */
  82. OBJLoader2.prototype.setMaterials = function ( materials ) {
  83. this.meshBuilder.setMaterials( materials );
  84. };
  85. /**
  86. * Instructs loaders to create indexed {@link THREE.BufferGeometry}.
  87. * @memberOf THREE.OBJLoader2
  88. *
  89. * @param {boolean} useIndices=false
  90. */
  91. OBJLoader2.prototype.setUseIndices = function ( useIndices ) {
  92. this.useIndices = useIndices === true;
  93. };
  94. /**
  95. * Tells whether normals should be completely disregarded and regenerated.
  96. * @memberOf THREE.OBJLoader2
  97. *
  98. * @param {boolean} disregardNormals=false
  99. */
  100. OBJLoader2.prototype.setDisregardNormals = function ( disregardNormals ) {
  101. this.disregardNormals = disregardNormals === true;
  102. };
  103. /**
  104. * Tells whether a material shall be created per smoothing group.
  105. * @memberOf THREE.OBJLoader2
  106. *
  107. * @param {boolean} materialPerSmoothingGroup=false
  108. */
  109. OBJLoader2.prototype.setMaterialPerSmoothingGroup = function ( materialPerSmoothingGroup ) {
  110. this.materialPerSmoothingGroup = materialPerSmoothingGroup === true;
  111. };
  112. /**
  113. * Usually 'o' is meta-information and does not result in creation of new meshes, but mesh creation on occurrence of "o" can be enforced.
  114. * @memberOf THREE.OBJLoader2
  115. *
  116. * @param {boolean} useOAsMesh=false
  117. */
  118. OBJLoader2.prototype.setUseOAsMesh = function ( useOAsMesh ) {
  119. this.useOAsMesh = useOAsMesh === true;
  120. };
  121. OBJLoader2.prototype._setCallbacks = function ( callbacks ) {
  122. if ( Validator.isValid( callbacks.onProgress ) ) this.callbacks.setCallbackOnProgress( callbacks.onProgress );
  123. if ( Validator.isValid( callbacks.onMeshAlter ) ) this.callbacks.setCallbackOnMeshAlter( callbacks.onMeshAlter );
  124. if ( Validator.isValid( callbacks.onLoad ) ) this.callbacks.setCallbackOnLoad( callbacks.onLoad );
  125. if ( Validator.isValid( callbacks.onLoadMaterials ) ) this.callbacks.setCallbackOnLoadMaterials( callbacks.onLoadMaterials );
  126. this.meshBuilder._setCallbacks( this.callbacks );
  127. };
  128. /**
  129. * Announce feedback which is give to the registered callbacks.
  130. * @memberOf THREE.OBJLoader2
  131. * @private
  132. *
  133. * @param {string} type The type of event
  134. * @param {string} text Textual description of the event
  135. * @param {number} numericalValue Numerical value describing the progress
  136. */
  137. OBJLoader2.prototype.onProgress = function ( type, text, numericalValue ) {
  138. var content = Validator.isValid( text ) ? text: '';
  139. var event = {
  140. detail: {
  141. type: type,
  142. modelName: this.modelName,
  143. instanceNo: this.instanceNo,
  144. text: content,
  145. numericalValue: numericalValue
  146. }
  147. };
  148. if ( Validator.isValid( this.callbacks.onProgress ) ) this.callbacks.onProgress( event );
  149. if ( this.logging.enabled && this.logging.debug ) console.debug( content );
  150. };
  151. OBJLoader2.prototype._onError = function ( event ) {
  152. var output = 'Error occurred while downloading!';
  153. if ( event.currentTarget && event.currentTarget.statusText !== null ) {
  154. output += '\nurl: ' + event.currentTarget.responseURL + '\nstatus: ' + event.currentTarget.statusText;
  155. }
  156. this.onProgress( 'error', output, -1 );
  157. throw output;
  158. };
  159. /**
  160. * Use this convenient method to load a file at the given URL. By default the fileLoader uses an ArrayBuffer.
  161. * @memberOf THREE.OBJLoader2
  162. *
  163. * @param {string} url A string containing the path/URL of the file to be loaded.
  164. * @param {callback} onLoad A function to be called after loading is successfully completed. The function receives loaded Object3D as an argument.
  165. * @param {callback} [onProgress] A function to be called while the loading is in progress. The argument will be the XMLHttpRequest instance, which contains total and Integer bytes.
  166. * @param {callback} [onError] A function to be called if an error occurs during loading. The function receives the error as an argument.
  167. * @param {callback} [onMeshAlter] A function to be called after a new mesh raw data becomes available for alteration.
  168. * @param {boolean} [useAsync] If true, uses async loading with worker, if false loads data synchronously.
  169. */
  170. OBJLoader2.prototype.load = function ( url, onLoad, onProgress, onError, onMeshAlter, useAsync ) {
  171. var resource = new THREE.LoaderSupport.ResourceDescriptor( url, 'OBJ' );
  172. this._loadObj( resource, onLoad, onProgress, onError, onMeshAlter, useAsync );
  173. };
  174. OBJLoader2.prototype._loadObj = function ( resource, onLoad, onProgress, onError, onMeshAlter, useAsync ) {
  175. if ( ! Validator.isValid( onError ) ) onError = this._onError;
  176. // fast-fail
  177. if ( ! Validator.isValid( resource ) ) onError( 'An invalid ResourceDescriptor was provided. Unable to continue!' );
  178. var scope = this;
  179. var fileLoaderOnLoad = function ( content ) {
  180. resource.content = content;
  181. if ( useAsync ) {
  182. scope.parseAsync( content, onLoad );
  183. } else {
  184. var callbacks = new THREE.LoaderSupport.Callbacks();
  185. callbacks.setCallbackOnMeshAlter( onMeshAlter );
  186. scope._setCallbacks( callbacks );
  187. onLoad(
  188. {
  189. detail: {
  190. loaderRootNode: scope.parse( content ),
  191. modelName: scope.modelName,
  192. instanceNo: scope.instanceNo
  193. }
  194. }
  195. );
  196. }
  197. };
  198. // fast-fail
  199. if ( ! Validator.isValid( resource.url ) || Validator.isValid( resource.content ) ) {
  200. fileLoaderOnLoad( Validator.isValid( resource.content ) ? resource.content : null );
  201. } else {
  202. if ( ! Validator.isValid( onProgress ) ) {
  203. var numericalValueRef = 0;
  204. var numericalValue = 0;
  205. onProgress = function ( event ) {
  206. if ( ! event.lengthComputable ) return;
  207. numericalValue = event.loaded / event.total;
  208. if ( numericalValue > numericalValueRef ) {
  209. numericalValueRef = numericalValue;
  210. var output = 'Download of "' + resource.url + '": ' + ( numericalValue * 100 ).toFixed( 2 ) + '%';
  211. scope.onProgress( 'progressLoad', output, numericalValue );
  212. }
  213. };
  214. }
  215. var fileLoader = new THREE.FileLoader( this.manager );
  216. fileLoader.setPath( this.path );
  217. fileLoader.setResponseType( 'arraybuffer' );
  218. fileLoader.load( resource.url, fileLoaderOnLoad, onProgress, onError );
  219. }
  220. };
  221. /**
  222. * Run the loader according the provided instructions.
  223. * @memberOf THREE.OBJLoader2
  224. *
  225. * @param {THREE.LoaderSupport.PrepData} prepData All parameters and resources required for execution
  226. * @param {THREE.LoaderSupport.WorkerSupport} [workerSupportExternal] Use pre-existing WorkerSupport
  227. */
  228. OBJLoader2.prototype.run = function ( prepData, workerSupportExternal ) {
  229. this._applyPrepData( prepData );
  230. var available = prepData.checkResourceDescriptorFiles( prepData.resources,
  231. [
  232. { ext: "obj", type: "ArrayBuffer", ignore: false },
  233. { ext: "mtl", type: "String", ignore: false },
  234. { ext: "zip", type: "String", ignore: true }
  235. ]
  236. );
  237. if ( Validator.isValid( workerSupportExternal ) ) {
  238. this.terminateWorkerOnLoad = false;
  239. this.workerSupport = workerSupportExternal;
  240. this.logging.enabled = this.workerSupport.logging.enabled;
  241. this.logging.debug = this.workerSupport.logging.debug;
  242. }
  243. var scope = this;
  244. var onMaterialsLoaded = function ( materials ) {
  245. if ( materials !== null ) scope.meshBuilder.setMaterials( materials );
  246. scope._loadObj( available.obj, scope.callbacks.onLoad, null, null, scope.callbacks.onMeshAlter, prepData.useAsync );
  247. };
  248. this._loadMtl( available.mtl, onMaterialsLoaded, prepData.crossOrigin, prepData.materialOptions );
  249. };
  250. OBJLoader2.prototype._applyPrepData = function ( prepData ) {
  251. if ( Validator.isValid( prepData ) ) {
  252. this.setLogging( prepData.logging.enabled, prepData.logging.debug );
  253. this.setModelName( prepData.modelName );
  254. this.setStreamMeshesTo( prepData.streamMeshesTo );
  255. this.meshBuilder.setMaterials( prepData.materials );
  256. this.setUseIndices( prepData.useIndices );
  257. this.setDisregardNormals( prepData.disregardNormals );
  258. this.setMaterialPerSmoothingGroup( prepData.materialPerSmoothingGroup );
  259. this.setUseOAsMesh( prepData.useOAsMesh );
  260. this._setCallbacks( prepData.getCallbacks() );
  261. }
  262. };
  263. /**
  264. * Parses OBJ data synchronously from arraybuffer or string.
  265. * @memberOf THREE.OBJLoader2
  266. *
  267. * @param {arraybuffer|string} content OBJ data as Uint8Array or String
  268. */
  269. OBJLoader2.prototype.parse = function ( content ) {
  270. // fast-fail in case of illegal data
  271. if ( ! Validator.isValid( content ) ) {
  272. console.warn( 'Provided content is not a valid ArrayBuffer or String.' );
  273. return this.loaderRootNode;
  274. }
  275. if ( this.logging.enabled ) console.time( 'OBJLoader2 parse: ' + this.modelName );
  276. this.meshBuilder.init();
  277. var parser = new Parser();
  278. parser.setLogging( this.logging.enabled, this.logging.debug );
  279. parser.setMaterialPerSmoothingGroup( this.materialPerSmoothingGroup );
  280. parser.setUseOAsMesh( this.useOAsMesh );
  281. parser.setUseIndices( this.useIndices );
  282. parser.setDisregardNormals( this.disregardNormals );
  283. // sync code works directly on the material references
  284. parser.setMaterials( this.meshBuilder.getMaterials() );
  285. var scope = this;
  286. var onMeshLoaded = function ( payload ) {
  287. var meshes = scope.meshBuilder.processPayload( payload );
  288. var mesh;
  289. for ( var i in meshes ) {
  290. mesh = meshes[ i ];
  291. scope.loaderRootNode.add( mesh );
  292. }
  293. };
  294. parser.setCallbackMeshBuilder( onMeshLoaded );
  295. var onProgressScoped = function ( text, numericalValue ) {
  296. scope.onProgress( 'progressParse', text, numericalValue );
  297. };
  298. parser.setCallbackProgress( onProgressScoped );
  299. if ( content instanceof ArrayBuffer || content instanceof Uint8Array ) {
  300. if ( this.logging.enabled ) console.info( 'Parsing arrayBuffer...' );
  301. parser.parse( content );
  302. } else if ( typeof( content ) === 'string' || content instanceof String ) {
  303. if ( this.logging.enabled ) console.info( 'Parsing text...' );
  304. parser.parseText( content );
  305. } else {
  306. throw 'Provided content was neither of type String nor Uint8Array! Aborting...';
  307. }
  308. if ( this.logging.enabled ) console.timeEnd( 'OBJLoader2 parse: ' + this.modelName );
  309. return this.loaderRootNode;
  310. };
  311. /**
  312. * Parses OBJ content asynchronously from arraybuffer.
  313. * @memberOf THREE.OBJLoader2
  314. *
  315. * @param {arraybuffer} content OBJ data as Uint8Array
  316. * @param {callback} onLoad Called after worker successfully completed loading
  317. */
  318. OBJLoader2.prototype.parseAsync = function ( content, onLoad ) {
  319. var scope = this;
  320. var measureTime = false;
  321. var scopedOnLoad = function () {
  322. onLoad(
  323. {
  324. detail: {
  325. loaderRootNode: scope.loaderRootNode,
  326. modelName: scope.modelName,
  327. instanceNo: scope.instanceNo
  328. }
  329. }
  330. );
  331. if ( measureTime && scope.logging.enabled ) console.timeEnd( 'OBJLoader2 parseAsync: ' + scope.modelName );
  332. };
  333. // fast-fail in case of illegal data
  334. if ( ! Validator.isValid( content ) ) {
  335. console.warn( 'Provided content is not a valid ArrayBuffer.' );
  336. scopedOnLoad()
  337. } else {
  338. measureTime = true;
  339. }
  340. if ( measureTime && this.logging.enabled ) console.time( 'OBJLoader2 parseAsync: ' + this.modelName );
  341. this.meshBuilder.init();
  342. var scopedOnMeshLoaded = function ( payload ) {
  343. var meshes = scope.meshBuilder.processPayload( payload );
  344. var mesh;
  345. for ( var i in meshes ) {
  346. mesh = meshes[ i ];
  347. scope.loaderRootNode.add( mesh );
  348. }
  349. };
  350. var buildCode = function ( funcBuildObject, funcBuildSingleton ) {
  351. var workerCode = '';
  352. workerCode += '/**\n';
  353. workerCode += ' * This code was constructed by OBJLoader2 buildCode.\n';
  354. workerCode += ' */\n\n';
  355. workerCode += 'THREE = { LoaderSupport: {} };\n\n';
  356. workerCode += funcBuildObject( 'THREE.LoaderSupport.Validator', Validator );
  357. workerCode += funcBuildSingleton( 'Parser', Parser );
  358. return workerCode;
  359. };
  360. this.workerSupport.validate( buildCode, 'Parser' );
  361. this.workerSupport.setCallbacks( scopedOnMeshLoaded, scopedOnLoad );
  362. if ( scope.terminateWorkerOnLoad ) this.workerSupport.setTerminateRequested( true );
  363. var materialNames = {};
  364. var materials = this.meshBuilder.getMaterials();
  365. for ( var materialName in materials ) {
  366. materialNames[ materialName ] = materialName;
  367. }
  368. this.workerSupport.run(
  369. {
  370. params: {
  371. useAsync: true,
  372. materialPerSmoothingGroup: this.materialPerSmoothingGroup,
  373. useOAsMesh: this.useOAsMesh,
  374. useIndices: this.useIndices,
  375. disregardNormals: this.disregardNormals
  376. },
  377. logging: {
  378. enabled: this.logging.enabled,
  379. debug: this.logging.debug
  380. },
  381. materials: {
  382. // in async case only material names are supplied to parser
  383. materials: materialNames
  384. },
  385. data: {
  386. input: content,
  387. options: null
  388. }
  389. }
  390. );
  391. };
  392. /**
  393. * Parse OBJ data either from ArrayBuffer or string
  394. * @class
  395. */
  396. var Parser = (function () {
  397. function Parser() {
  398. this.callbackProgress = null;
  399. this.callbackMeshBuilder = null;
  400. this.contentRef = null;
  401. this.legacyMode = false;
  402. this.materials = {};
  403. this.useAsync = false;
  404. this.materialPerSmoothingGroup = false;
  405. this.useOAsMesh = false;
  406. this.useIndices = false;
  407. this.disregardNormals = false;
  408. this.vertices = [];
  409. this.colors = [];
  410. this.normals = [];
  411. this.uvs = [];
  412. this.rawMesh = {
  413. objectName: '',
  414. groupName: '',
  415. activeMtlName: '',
  416. mtllibName: '',
  417. // reset with new mesh
  418. faceType: -1,
  419. subGroups: [],
  420. subGroupInUse: null,
  421. smoothingGroup: {
  422. splitMaterials: false,
  423. normalized: -1,
  424. real: -1
  425. },
  426. counts: {
  427. doubleIndicesCount: 0,
  428. faceCount: 0,
  429. mtlCount: 0,
  430. smoothingGroupCount: 0
  431. }
  432. };
  433. this.inputObjectCount = 1;
  434. this.outputObjectCount = 1;
  435. this.globalCounts = {
  436. vertices: 0,
  437. faces: 0,
  438. doubleIndicesCount: 0,
  439. lineByte: 0,
  440. currentByte: 0,
  441. totalBytes: 0
  442. };
  443. this.logging = {
  444. enabled: true,
  445. debug: false
  446. };
  447. }
  448. Parser.prototype.resetRawMesh = function () {
  449. // faces are stored according combined index of group, material and smoothingGroup (0 or not)
  450. this.rawMesh.subGroups = [];
  451. this.rawMesh.subGroupInUse = null;
  452. this.rawMesh.smoothingGroup.normalized = -1;
  453. this.rawMesh.smoothingGroup.real = -1;
  454. // this default index is required as it is possible to define faces without 'g' or 'usemtl'
  455. this.pushSmoothingGroup( 1 );
  456. this.rawMesh.counts.doubleIndicesCount = 0;
  457. this.rawMesh.counts.faceCount = 0;
  458. this.rawMesh.counts.mtlCount = 0;
  459. this.rawMesh.counts.smoothingGroupCount = 0;
  460. };
  461. Parser.prototype.setUseAsync = function ( useAsync ) {
  462. this.useAsync = useAsync;
  463. };
  464. Parser.prototype.setMaterialPerSmoothingGroup = function ( materialPerSmoothingGroup ) {
  465. this.materialPerSmoothingGroup = materialPerSmoothingGroup;
  466. };
  467. Parser.prototype.setUseOAsMesh = function ( useOAsMesh ) {
  468. this.useOAsMesh = useOAsMesh;
  469. };
  470. Parser.prototype.setUseIndices = function ( useIndices ) {
  471. this.useIndices = useIndices;
  472. };
  473. Parser.prototype.setDisregardNormals = function ( disregardNormals ) {
  474. this.disregardNormals = disregardNormals;
  475. };
  476. Parser.prototype.setMaterials = function ( materials ) {
  477. this.materials = THREE.LoaderSupport.Validator.verifyInput( materials, this.materials );
  478. this.materials = THREE.LoaderSupport.Validator.verifyInput( this.materials, {} );
  479. };
  480. Parser.prototype.setCallbackMeshBuilder = function ( callbackMeshBuilder ) {
  481. if ( ! THREE.LoaderSupport.Validator.isValid( callbackMeshBuilder ) ) throw 'Unable to run as no "MeshBuilder" callback is set.';
  482. this.callbackMeshBuilder = callbackMeshBuilder;
  483. };
  484. Parser.prototype.setCallbackProgress = function ( callbackProgress ) {
  485. this.callbackProgress = callbackProgress;
  486. };
  487. Parser.prototype.setLogging = function ( enabled, debug ) {
  488. this.logging.enabled = enabled === true;
  489. this.logging.debug = debug === true;
  490. };
  491. Parser.prototype.configure = function () {
  492. this.pushSmoothingGroup( 1 );
  493. if ( this.logging.enabled ) {
  494. var matKeys = Object.keys( this.materials );
  495. var matNames = ( matKeys.length > 0 ) ? '\n\tmaterialNames:\n\t\t- ' + matKeys.join( '\n\t\t- ' ) : '\n\tmaterialNames: None';
  496. var printedConfig = 'OBJLoader2.Parser configuration:'
  497. + matNames
  498. + '\n\tuseAsync: ' + this.useAsync
  499. + '\n\tmaterialPerSmoothingGroup: ' + this.materialPerSmoothingGroup
  500. + '\n\tuseOAsMesh: ' + this.useOAsMesh
  501. + '\n\tuseIndices: ' + this.useIndices
  502. + '\n\tdisregardNormals: ' + this.disregardNormals
  503. + '\n\tcallbackMeshBuilderName: ' + this.callbackMeshBuilder.name
  504. + '\n\tcallbackProgressName: ' + this.callbackProgress.name;
  505. console.info( printedConfig );
  506. }
  507. };
  508. /**
  509. * Parse the provided arraybuffer
  510. * @memberOf Parser
  511. *
  512. * @param {Uint8Array} arrayBuffer OBJ data as Uint8Array
  513. */
  514. Parser.prototype.parse = function ( arrayBuffer ) {
  515. if ( this.logging.enabled ) console.time( 'OBJLoader2.Parser.parse' );
  516. this.configure();
  517. var arrayBufferView = new Uint8Array( arrayBuffer );
  518. this.contentRef = arrayBufferView;
  519. var length = arrayBufferView.byteLength;
  520. this.globalCounts.totalBytes = length;
  521. var buffer = new Array( 128 );
  522. for ( var code, word = '', bufferPointer = 0, slashesCount = 0, i = 0; i < length; i++ ) {
  523. code = arrayBufferView[ i ];
  524. switch ( code ) {
  525. // space
  526. case 32:
  527. if ( word.length > 0 ) buffer[ bufferPointer++ ] = word;
  528. word = '';
  529. break;
  530. // slash
  531. case 47:
  532. if ( word.length > 0 ) buffer[ bufferPointer++ ] = word;
  533. slashesCount++;
  534. word = '';
  535. break;
  536. // LF
  537. case 10:
  538. if ( word.length > 0 ) buffer[ bufferPointer++ ] = word;
  539. word = '';
  540. this.globalCounts.lineByte = this.globalCounts.currentByte;
  541. this.globalCounts.currentByte = i;
  542. this.processLine( buffer, bufferPointer, slashesCount );
  543. bufferPointer = 0;
  544. slashesCount = 0;
  545. break;
  546. // CR
  547. case 13:
  548. break;
  549. default:
  550. word += String.fromCharCode( code );
  551. break;
  552. }
  553. }
  554. this.finalizeParsing();
  555. if ( this.logging.enabled ) console.timeEnd( 'OBJLoader2.Parser.parse' );
  556. };
  557. /**
  558. * Parse the provided text
  559. * @memberOf Parser
  560. *
  561. * @param {string} text OBJ data as string
  562. */
  563. Parser.prototype.parseText = function ( text ) {
  564. if ( this.logging.enabled ) console.time( 'OBJLoader2.Parser.parseText' );
  565. this.configure();
  566. this.legacyMode = true;
  567. this.contentRef = text;
  568. var length = text.length;
  569. this.globalCounts.totalBytes = length;
  570. var buffer = new Array( 128 );
  571. for ( var char, word = '', bufferPointer = 0, slashesCount = 0, i = 0; i < length; i++ ) {
  572. char = text[ i ];
  573. switch ( char ) {
  574. case ' ':
  575. if ( word.length > 0 ) buffer[ bufferPointer++ ] = word;
  576. word = '';
  577. break;
  578. case '/':
  579. if ( word.length > 0 ) buffer[ bufferPointer++ ] = word;
  580. slashesCount++;
  581. word = '';
  582. break;
  583. case '\n':
  584. if ( word.length > 0 ) buffer[ bufferPointer++ ] = word;
  585. word = '';
  586. this.globalCounts.lineByte = this.globalCounts.currentByte;
  587. this.globalCounts.currentByte = i;
  588. this.processLine( buffer, bufferPointer, slashesCount );
  589. bufferPointer = 0;
  590. slashesCount = 0;
  591. break;
  592. case '\r':
  593. break;
  594. default:
  595. word += char;
  596. }
  597. }
  598. this.finalizeParsing();
  599. if ( this.logging.enabled ) console.timeEnd( 'OBJLoader2.Parser.parseText' );
  600. };
  601. Parser.prototype.processLine = function ( buffer, bufferPointer, slashesCount ) {
  602. if ( bufferPointer < 1 ) return;
  603. var reconstructString = function ( content, legacyMode, start, stop ) {
  604. var line = '';
  605. if ( stop > start ) {
  606. var i;
  607. if ( legacyMode ) {
  608. for ( i = start; i < stop; i++ ) line += content[ i ];
  609. } else {
  610. for ( i = start; i < stop; i++ ) line += String.fromCharCode( content[ i ] );
  611. }
  612. line = line.trim();
  613. }
  614. return line;
  615. };
  616. var bufferLength, length, i, lineDesignation;
  617. lineDesignation = buffer [ 0 ];
  618. switch ( lineDesignation ) {
  619. case 'v':
  620. this.vertices.push( parseFloat( buffer[ 1 ] ) );
  621. this.vertices.push( parseFloat( buffer[ 2 ] ) );
  622. this.vertices.push( parseFloat( buffer[ 3 ] ) );
  623. if ( bufferPointer > 4 ) {
  624. this.colors.push( parseFloat( buffer[ 4 ] ) );
  625. this.colors.push( parseFloat( buffer[ 5 ] ) );
  626. this.colors.push( parseFloat( buffer[ 6 ] ) );
  627. }
  628. break;
  629. case 'vt':
  630. this.uvs.push( parseFloat( buffer[ 1 ] ) );
  631. this.uvs.push( parseFloat( buffer[ 2 ] ) );
  632. break;
  633. case 'vn':
  634. this.normals.push( parseFloat( buffer[ 1 ] ) );
  635. this.normals.push( parseFloat( buffer[ 2 ] ) );
  636. this.normals.push( parseFloat( buffer[ 3 ] ) );
  637. break;
  638. case 'f':
  639. bufferLength = bufferPointer - 1;
  640. // "f vertex ..."
  641. if ( slashesCount === 0 ) {
  642. this.checkFaceType( 0 );
  643. for ( i = 2, length = bufferLength; i < length; i ++ ) {
  644. this.buildFace( buffer[ 1 ] );
  645. this.buildFace( buffer[ i ] );
  646. this.buildFace( buffer[ i + 1 ] );
  647. }
  648. // "f vertex/uv ..."
  649. } else if ( bufferLength === slashesCount * 2 ) {
  650. this.checkFaceType( 1 );
  651. for ( i = 3, length = bufferLength - 2; i < length; i += 2 ) {
  652. this.buildFace( buffer[ 1 ], buffer[ 2 ] );
  653. this.buildFace( buffer[ i ], buffer[ i + 1 ] );
  654. this.buildFace( buffer[ i + 2 ], buffer[ i + 3 ] );
  655. }
  656. // "f vertex/uv/normal ..."
  657. } else if ( bufferLength * 2 === slashesCount * 3 ) {
  658. this.checkFaceType( 2 );
  659. for ( i = 4, length = bufferLength - 3; i < length; i += 3 ) {
  660. this.buildFace( buffer[ 1 ], buffer[ 2 ], buffer[ 3 ] );
  661. this.buildFace( buffer[ i ], buffer[ i + 1 ], buffer[ i + 2 ] );
  662. this.buildFace( buffer[ i + 3 ], buffer[ i + 4 ], buffer[ i + 5 ] );
  663. }
  664. // "f vertex//normal ..."
  665. } else {
  666. this.checkFaceType( 3 );
  667. for ( i = 3, length = bufferLength - 2; i < length; i += 2 ) {
  668. this.buildFace( buffer[ 1 ], undefined, buffer[ 2 ] );
  669. this.buildFace( buffer[ i ], undefined, buffer[ i + 1 ] );
  670. this.buildFace( buffer[ i + 2 ], undefined, buffer[ i + 3 ] );
  671. }
  672. }
  673. break;
  674. case 'l':
  675. case 'p':
  676. bufferLength = bufferPointer - 1;
  677. if ( bufferLength === slashesCount * 2 ) {
  678. this.checkFaceType( 4 );
  679. for ( i = 1, length = bufferLength + 1; i < length; i += 2 ) this.buildFace( buffer[ i ], buffer[ i + 1 ] );
  680. } else {
  681. this.checkFaceType( ( lineDesignation === 'l' ) ? 5 : 6 );
  682. for ( i = 1, length = bufferLength + 1; i < length; i ++ ) this.buildFace( buffer[ i ] );
  683. }
  684. break;
  685. case 's':
  686. this.pushSmoothingGroup( buffer[ 1 ] );
  687. break;
  688. case 'g':
  689. // 'g' leads to creation of mesh if valid data (faces declaration was done before), otherwise only groupName gets set
  690. this.processCompletedMesh();
  691. this.rawMesh.groupName = reconstructString( this.contentRef, this.legacyMode, this.globalCounts.lineByte + 2, this.globalCounts.currentByte );
  692. break;
  693. case 'o':
  694. // 'o' is meta-information and usually does not result in creation of new meshes, but can be enforced with "useOAsMesh"
  695. if ( this.useOAsMesh ) this.processCompletedMesh();
  696. this.rawMesh.objectName = reconstructString( this.contentRef, this.legacyMode, this.globalCounts.lineByte + 2, this.globalCounts.currentByte );
  697. break;
  698. case 'mtllib':
  699. this.rawMesh.mtllibName = reconstructString( this.contentRef, this.legacyMode, this.globalCounts.lineByte + 7, this.globalCounts.currentByte );
  700. break;
  701. case 'usemtl':
  702. var mtlName = reconstructString( this.contentRef, this.legacyMode, this.globalCounts.lineByte + 7, this.globalCounts.currentByte );
  703. if ( mtlName !== '' && this.rawMesh.activeMtlName !== mtlName ) {
  704. this.rawMesh.activeMtlName = mtlName;
  705. this.rawMesh.counts.mtlCount++;
  706. this.checkSubGroup();
  707. }
  708. break;
  709. default:
  710. break;
  711. }
  712. };
  713. Parser.prototype.pushSmoothingGroup = function ( smoothingGroup ) {
  714. var smoothingGroupInt = parseInt( smoothingGroup );
  715. if ( isNaN( smoothingGroupInt ) ) {
  716. smoothingGroupInt = smoothingGroup === "off" ? 0 : 1;
  717. }
  718. var smoothCheck = this.rawMesh.smoothingGroup.normalized;
  719. this.rawMesh.smoothingGroup.normalized = this.rawMesh.smoothingGroup.splitMaterials ? smoothingGroupInt : ( smoothingGroupInt === 0 ) ? 0 : 1;
  720. this.rawMesh.smoothingGroup.real = smoothingGroupInt;
  721. if ( smoothCheck !== smoothingGroupInt ) {
  722. this.rawMesh.counts.smoothingGroupCount++;
  723. this.checkSubGroup();
  724. }
  725. };
  726. /**
  727. * Expanded faceTypes include all four face types, both line types and the point type
  728. * faceType = 0: "f vertex ..."
  729. * faceType = 1: "f vertex/uv ..."
  730. * faceType = 2: "f vertex/uv/normal ..."
  731. * faceType = 3: "f vertex//normal ..."
  732. * faceType = 4: "l vertex/uv ..." or "l vertex ..."
  733. * faceType = 5: "l vertex ..."
  734. * faceType = 6: "p vertex ..."
  735. */
  736. Parser.prototype.checkFaceType = function ( faceType ) {
  737. if ( this.rawMesh.faceType !== faceType ) {
  738. this.processCompletedMesh();
  739. this.rawMesh.faceType = faceType;
  740. this.checkSubGroup();
  741. }
  742. };
  743. Parser.prototype.checkSubGroup = function () {
  744. var index = this.rawMesh.activeMtlName + '|' + this.rawMesh.smoothingGroup.normalized;
  745. this.rawMesh.subGroupInUse = this.rawMesh.subGroups[ index ];
  746. if ( ! THREE.LoaderSupport.Validator.isValid( this.rawMesh.subGroupInUse ) ) {
  747. this.rawMesh.subGroupInUse = {
  748. index: index,
  749. objectName: this.rawMesh.objectName,
  750. groupName: this.rawMesh.groupName,
  751. materialName: this.rawMesh.activeMtlName,
  752. smoothingGroup: this.rawMesh.smoothingGroup.normalized,
  753. vertices: [],
  754. indexMappingsCount: 0,
  755. indexMappings: [],
  756. indices: [],
  757. colors: [],
  758. uvs: [],
  759. normals: []
  760. };
  761. this.rawMesh.subGroups[ index ] = this.rawMesh.subGroupInUse;
  762. }
  763. };
  764. Parser.prototype.buildFace = function ( faceIndexV, faceIndexU, faceIndexN ) {
  765. if ( this.disregardNormals ) faceIndexN = undefined;
  766. var scope = this;
  767. var updateSubGroupInUse = function () {
  768. var faceIndexVi = parseInt( faceIndexV );
  769. var indexPointerV = 3 * ( faceIndexVi > 0 ? faceIndexVi - 1 : faceIndexVi + scope.vertices.length / 3 );
  770. var vertices = scope.rawMesh.subGroupInUse.vertices;
  771. vertices.push( scope.vertices[ indexPointerV++ ] );
  772. vertices.push( scope.vertices[ indexPointerV++ ] );
  773. vertices.push( scope.vertices[ indexPointerV ] );
  774. var indexPointerC = scope.colors.length > 0 ? indexPointerV + 1 : null;
  775. if ( indexPointerC !== null ) {
  776. var colors = scope.rawMesh.subGroupInUse.colors;
  777. colors.push( scope.colors[ indexPointerC++ ] );
  778. colors.push( scope.colors[ indexPointerC++ ] );
  779. colors.push( scope.colors[ indexPointerC ] );
  780. }
  781. if ( faceIndexU ) {
  782. var faceIndexUi = parseInt( faceIndexU );
  783. var indexPointerU = 2 * ( faceIndexUi > 0 ? faceIndexUi - 1 : faceIndexUi + scope.uvs.length / 2 );
  784. var uvs = scope.rawMesh.subGroupInUse.uvs;
  785. uvs.push( scope.uvs[ indexPointerU++ ] );
  786. uvs.push( scope.uvs[ indexPointerU ] );
  787. }
  788. if ( faceIndexN ) {
  789. var faceIndexNi = parseInt( faceIndexN );
  790. var indexPointerN = 3 * ( faceIndexNi > 0 ? faceIndexNi - 1 : faceIndexNi + scope.normals.length / 3 );
  791. var normals = scope.rawMesh.subGroupInUse.normals;
  792. normals.push( scope.normals[ indexPointerN++ ] );
  793. normals.push( scope.normals[ indexPointerN++ ] );
  794. normals.push( scope.normals[ indexPointerN ] );
  795. }
  796. };
  797. if ( this.useIndices ) {
  798. var mappingName = faceIndexV + ( faceIndexU ? '_' + faceIndexU : '_n' ) + ( faceIndexN ? '_' + faceIndexN : '_n' );
  799. var indicesPointer = this.rawMesh.subGroupInUse.indexMappings[ mappingName ];
  800. if ( THREE.LoaderSupport.Validator.isValid( indicesPointer ) ) {
  801. this.rawMesh.counts.doubleIndicesCount++;
  802. } else {
  803. indicesPointer = this.rawMesh.subGroupInUse.vertices.length / 3;
  804. updateSubGroupInUse();
  805. this.rawMesh.subGroupInUse.indexMappings[ mappingName ] = indicesPointer;
  806. this.rawMesh.subGroupInUse.indexMappingsCount++;
  807. }
  808. this.rawMesh.subGroupInUse.indices.push( indicesPointer );
  809. } else {
  810. updateSubGroupInUse();
  811. }
  812. this.rawMesh.counts.faceCount++;
  813. };
  814. Parser.prototype.createRawMeshReport = function ( inputObjectCount ) {
  815. return 'Input Object number: ' + inputObjectCount +
  816. '\n\tObject name: ' + this.rawMesh.objectName +
  817. '\n\tGroup name: ' + this.rawMesh.groupName +
  818. '\n\tMtllib name: ' + this.rawMesh.mtllibName +
  819. '\n\tVertex count: ' + this.vertices.length / 3 +
  820. '\n\tNormal count: ' + this.normals.length / 3 +
  821. '\n\tUV count: ' + this.uvs.length / 2 +
  822. '\n\tSmoothingGroup count: ' + this.rawMesh.counts.smoothingGroupCount +
  823. '\n\tMaterial count: ' + this.rawMesh.counts.mtlCount +
  824. '\n\tReal MeshOutputGroup count: ' + this.rawMesh.subGroups.length;
  825. };
  826. /**
  827. * Clear any empty subGroup and calculate absolute vertex, normal and uv counts
  828. */
  829. Parser.prototype.finalizeRawMesh = function () {
  830. var meshOutputGroupTemp = [];
  831. var meshOutputGroup;
  832. var absoluteVertexCount = 0;
  833. var absoluteIndexMappingsCount = 0;
  834. var absoluteIndexCount = 0;
  835. var absoluteColorCount = 0;
  836. var absoluteNormalCount = 0;
  837. var absoluteUvCount = 0;
  838. var indices;
  839. for ( var name in this.rawMesh.subGroups ) {
  840. meshOutputGroup = this.rawMesh.subGroups[ name ];
  841. if ( meshOutputGroup.vertices.length > 0 ) {
  842. indices = meshOutputGroup.indices;
  843. if ( indices.length > 0 && absoluteIndexMappingsCount > 0 ) {
  844. for ( var i in indices ) indices[ i ] = indices[ i ] + absoluteIndexMappingsCount;
  845. }
  846. meshOutputGroupTemp.push( meshOutputGroup );
  847. absoluteVertexCount += meshOutputGroup.vertices.length;
  848. absoluteIndexMappingsCount += meshOutputGroup.indexMappingsCount;
  849. absoluteIndexCount += meshOutputGroup.indices.length;
  850. absoluteColorCount += meshOutputGroup.colors.length;
  851. absoluteUvCount += meshOutputGroup.uvs.length;
  852. absoluteNormalCount += meshOutputGroup.normals.length;
  853. }
  854. }
  855. // do not continue if no result
  856. var result = null;
  857. if ( meshOutputGroupTemp.length > 0 ) {
  858. result = {
  859. name: this.rawMesh.groupName !== '' ? this.rawMesh.groupName : this.rawMesh.objectName,
  860. subGroups: meshOutputGroupTemp,
  861. absoluteVertexCount: absoluteVertexCount,
  862. absoluteIndexCount: absoluteIndexCount,
  863. absoluteColorCount: absoluteColorCount,
  864. absoluteNormalCount: absoluteNormalCount,
  865. absoluteUvCount: absoluteUvCount,
  866. faceCount: this.rawMesh.counts.faceCount,
  867. doubleIndicesCount: this.rawMesh.counts.doubleIndicesCount
  868. };
  869. }
  870. return result;
  871. };
  872. Parser.prototype.processCompletedMesh = function () {
  873. var result = this.finalizeRawMesh();
  874. if ( THREE.LoaderSupport.Validator.isValid( result ) ) {
  875. if ( this.colors.length > 0 && this.colors.length !== this.vertices.length ) {
  876. throw 'Vertex Colors were detected, but vertex count and color count do not match!';
  877. }
  878. if ( this.logging.enabled && this.logging.debug ) console.debug( this.createRawMeshReport( this.inputObjectCount ) );
  879. this.inputObjectCount++;
  880. this.buildMesh( result );
  881. var progressBytesPercent = this.globalCounts.currentByte / this.globalCounts.totalBytes;
  882. this.callbackProgress( 'Completed [o: ' + this.rawMesh.objectName + ' g:' + this.rawMesh.groupName + '] Total progress: ' + ( progressBytesPercent * 100 ).toFixed( 2 ) + '%', progressBytesPercent );
  883. this.resetRawMesh();
  884. return true;
  885. } else {
  886. return false;
  887. }
  888. };
  889. /**
  890. * SubGroups are transformed to too intermediate format that is forwarded to the MeshBuilder.
  891. * It is ensured that SubGroups only contain objects with vertices (no need to check).
  892. *
  893. * @param result
  894. */
  895. Parser.prototype.buildMesh = function ( result ) {
  896. var meshOutputGroups = result.subGroups;
  897. var vertexFA = new Float32Array( result.absoluteVertexCount );
  898. this.globalCounts.vertices += result.absoluteVertexCount / 3;
  899. this.globalCounts.faces += result.faceCount;
  900. this.globalCounts.doubleIndicesCount += result.doubleIndicesCount;
  901. var indexUA = ( result.absoluteIndexCount > 0 ) ? new Uint32Array( result.absoluteIndexCount ) : null;
  902. var colorFA = ( result.absoluteColorCount > 0 ) ? new Float32Array( result.absoluteColorCount ) : null;
  903. var normalFA = ( result.absoluteNormalCount > 0 ) ? new Float32Array( result.absoluteNormalCount ) : null;
  904. var uvFA = ( result.absoluteUvCount > 0 ) ? new Float32Array( result.absoluteUvCount ) : null;
  905. var haveVertexColors = THREE.LoaderSupport.Validator.isValid( colorFA );
  906. var meshOutputGroup;
  907. var materialNames = [];
  908. var createMultiMaterial = ( meshOutputGroups.length > 1 );
  909. var materialIndex = 0;
  910. var materialIndexMapping = [];
  911. var selectedMaterialIndex;
  912. var materialGroup;
  913. var materialGroups = [];
  914. var vertexFAOffset = 0;
  915. var indexUAOffset = 0;
  916. var colorFAOffset = 0;
  917. var normalFAOffset = 0;
  918. var uvFAOffset = 0;
  919. var materialGroupOffset = 0;
  920. var materialGroupLength = 0;
  921. var materialOrg, material, materialName, materialNameOrg;
  922. // only one specific face type
  923. for ( var oodIndex in meshOutputGroups ) {
  924. if ( ! meshOutputGroups.hasOwnProperty( oodIndex ) ) continue;
  925. meshOutputGroup = meshOutputGroups[ oodIndex ];
  926. materialNameOrg = meshOutputGroup.materialName;
  927. if ( this.rawMesh.faceType < 4 ) {
  928. materialName = materialNameOrg + ( haveVertexColors ? '_vertexColor' : '' ) + ( meshOutputGroup.smoothingGroup === 0 ? '_flat' : '' );
  929. } else {
  930. materialName = this.rawMesh.faceType === 6 ? 'defaultPointMaterial' : 'defaultLineMaterial';
  931. }
  932. materialOrg = this.materials[ materialNameOrg ];
  933. material = this.materials[ materialName ];
  934. // both original and derived names do not lead to an existing material => need to use a default material
  935. if ( ! THREE.LoaderSupport.Validator.isValid( materialOrg ) && ! THREE.LoaderSupport.Validator.isValid( material ) ) {
  936. var defaultMaterialName = haveVertexColors ? 'defaultVertexColorMaterial' : 'defaultMaterial';
  937. materialOrg = this.materials[ defaultMaterialName ];
  938. if ( this.logging.enabled ) console.warn( 'object_group "' + meshOutputGroup.objectName + '_' +
  939. meshOutputGroup.groupName + '" was defined with unresolvable material "' +
  940. materialNameOrg + '"! Assigning "' + defaultMaterialName + '".' );
  941. materialNameOrg = defaultMaterialName;
  942. // if names are identical then there is no need for later manipulation
  943. if ( materialNameOrg === materialName ) {
  944. material = materialOrg;
  945. materialName = defaultMaterialName;
  946. }
  947. }
  948. if ( ! THREE.LoaderSupport.Validator.isValid( material ) ) {
  949. var materialCloneInstructions = {
  950. materialNameOrg: materialNameOrg,
  951. materialName: materialName,
  952. materialProperties: {
  953. vertexColors: haveVertexColors ? 2 : 0,
  954. flatShading: meshOutputGroup.smoothingGroup === 0
  955. }
  956. };
  957. var payload = {
  958. cmd: 'materialData',
  959. materials: {
  960. materialCloneInstructions: materialCloneInstructions
  961. }
  962. };
  963. this.callbackMeshBuilder( payload );
  964. // fake entry for async; sync Parser always works on material references (Builder update directly visible here)
  965. if ( this.useAsync ) this.materials[ materialName ] = materialCloneInstructions;
  966. }
  967. if ( createMultiMaterial ) {
  968. // re-use material if already used before. Reduces materials array size and eliminates duplicates
  969. selectedMaterialIndex = materialIndexMapping[ materialName ];
  970. if ( ! selectedMaterialIndex ) {
  971. selectedMaterialIndex = materialIndex;
  972. materialIndexMapping[ materialName ] = materialIndex;
  973. materialNames.push( materialName );
  974. materialIndex++;
  975. }
  976. materialGroupLength = this.useIndices ? meshOutputGroup.indices.length : meshOutputGroup.vertices.length / 3;
  977. materialGroup = {
  978. start: materialGroupOffset,
  979. count: materialGroupLength,
  980. index: selectedMaterialIndex
  981. };
  982. materialGroups.push( materialGroup );
  983. materialGroupOffset += materialGroupLength;
  984. } else {
  985. materialNames.push( materialName );
  986. }
  987. vertexFA.set( meshOutputGroup.vertices, vertexFAOffset );
  988. vertexFAOffset += meshOutputGroup.vertices.length;
  989. if ( indexUA ) {
  990. indexUA.set( meshOutputGroup.indices, indexUAOffset );
  991. indexUAOffset += meshOutputGroup.indices.length;
  992. }
  993. if ( colorFA ) {
  994. colorFA.set( meshOutputGroup.colors, colorFAOffset );
  995. colorFAOffset += meshOutputGroup.colors.length;
  996. }
  997. if ( normalFA ) {
  998. normalFA.set( meshOutputGroup.normals, normalFAOffset );
  999. normalFAOffset += meshOutputGroup.normals.length;
  1000. }
  1001. if ( uvFA ) {
  1002. uvFA.set( meshOutputGroup.uvs, uvFAOffset );
  1003. uvFAOffset += meshOutputGroup.uvs.length;
  1004. }
  1005. if ( this.logging.enabled && this.logging.debug ) {
  1006. var materialIndexLine = THREE.LoaderSupport.Validator.isValid( selectedMaterialIndex ) ? '\n\t\tmaterialIndex: ' + selectedMaterialIndex : '';
  1007. var createdReport = '\tOutput Object no.: ' + this.outputObjectCount +
  1008. '\n\t\tgroupName: ' + meshOutputGroup.groupName +
  1009. '\n\t\tIndex: ' + meshOutputGroup.index +
  1010. '\n\t\tfaceType: ' + this.rawMesh.faceType +
  1011. '\n\t\tmaterialName: ' + meshOutputGroup.materialName +
  1012. '\n\t\tsmoothingGroup: ' + meshOutputGroup.smoothingGroup +
  1013. materialIndexLine +
  1014. '\n\t\tobjectName: ' + meshOutputGroup.objectName +
  1015. '\n\t\t#vertices: ' + meshOutputGroup.vertices.length / 3 +
  1016. '\n\t\t#indices: ' + meshOutputGroup.indices.length +
  1017. '\n\t\t#colors: ' + meshOutputGroup.colors.length / 3 +
  1018. '\n\t\t#uvs: ' + meshOutputGroup.uvs.length / 2 +
  1019. '\n\t\t#normals: ' + meshOutputGroup.normals.length / 3;
  1020. console.debug( createdReport );
  1021. }
  1022. }
  1023. this.outputObjectCount++;
  1024. this.callbackMeshBuilder(
  1025. {
  1026. cmd: 'meshData',
  1027. progress: {
  1028. numericalValue: this.globalCounts.currentByte / this.globalCounts.totalBytes
  1029. },
  1030. params: {
  1031. meshName: result.name
  1032. },
  1033. materials: {
  1034. multiMaterial: createMultiMaterial,
  1035. materialNames: materialNames,
  1036. materialGroups: materialGroups
  1037. },
  1038. buffers: {
  1039. vertices: vertexFA,
  1040. indices: indexUA,
  1041. colors: colorFA,
  1042. normals: normalFA,
  1043. uvs: uvFA
  1044. },
  1045. // 0: mesh, 1: line, 2: point
  1046. geometryType: this.rawMesh.faceType < 4 ? 0 : ( this.rawMesh.faceType === 6 ) ? 2 : 1
  1047. },
  1048. [ vertexFA.buffer ],
  1049. THREE.LoaderSupport.Validator.isValid( indexUA ) ? [ indexUA.buffer ] : null,
  1050. THREE.LoaderSupport.Validator.isValid( colorFA ) ? [ colorFA.buffer ] : null,
  1051. THREE.LoaderSupport.Validator.isValid( normalFA ) ? [ normalFA.buffer ] : null,
  1052. THREE.LoaderSupport.Validator.isValid( uvFA ) ? [ uvFA.buffer ] : null
  1053. );
  1054. };
  1055. Parser.prototype.finalizeParsing = function () {
  1056. if ( this.logging.enabled ) console.info( 'Global output object count: ' + this.outputObjectCount );
  1057. if ( this.processCompletedMesh() && this.logging.enabled ) {
  1058. var parserFinalReport = 'Overall counts: ' +
  1059. '\n\tVertices: ' + this.globalCounts.vertices +
  1060. '\n\tFaces: ' + this.globalCounts.faces +
  1061. '\n\tMultiple definitions: ' + this.globalCounts.doubleIndicesCount;
  1062. console.info( parserFinalReport );
  1063. }
  1064. };
  1065. return Parser;
  1066. })();
  1067. /**
  1068. * Utility method for loading an mtl file according resource description. Provide url or content.
  1069. * @memberOf THREE.OBJLoader2
  1070. *
  1071. * @param {string} url URL to the file
  1072. * @param {Object} content The file content as arraybuffer or text
  1073. * @param {function} callbackOnLoad Callback to be called after successful load
  1074. * @param {string} [crossOrigin] CORS value
  1075. * @param {Object} [materialOptions] Set material loading options for MTLLoader
  1076. */
  1077. OBJLoader2.prototype.loadMtl = function ( url, content, callbackOnLoad, crossOrigin, materialOptions ) {
  1078. var resource = new THREE.LoaderSupport.ResourceDescriptor( url, 'MTL' );
  1079. resource.setContent( content );
  1080. this._loadMtl( resource, callbackOnLoad, crossOrigin, materialOptions );
  1081. };
  1082. OBJLoader2.prototype._loadMtl = function ( resource, callbackOnLoad, crossOrigin, materialOptions ) {
  1083. if ( THREE.MTLLoader === undefined ) console.error( '"THREE.MTLLoader" is not available. "THREE.OBJLoader2" requires it for loading MTL files.' );
  1084. if ( Validator.isValid( resource ) && this.logging.enabled ) console.time( 'Loading MTL: ' + resource.name );
  1085. var materials = [];
  1086. var scope = this;
  1087. var processMaterials = function ( materialCreator ) {
  1088. var materialCreatorMaterials = [];
  1089. if ( Validator.isValid( materialCreator ) ) {
  1090. materialCreator.preload();
  1091. materialCreatorMaterials = materialCreator.materials;
  1092. for ( var materialName in materialCreatorMaterials ) {
  1093. if ( materialCreatorMaterials.hasOwnProperty( materialName ) ) {
  1094. materials[ materialName ] = materialCreatorMaterials[ materialName ];
  1095. }
  1096. }
  1097. }
  1098. if ( Validator.isValid( resource ) && scope.logging.enabled ) console.timeEnd( 'Loading MTL: ' + resource.name );
  1099. callbackOnLoad( materials, materialCreator );
  1100. };
  1101. // fast-fail
  1102. if ( ! Validator.isValid( resource ) || ( ! Validator.isValid( resource.content ) && ! Validator.isValid( resource.url ) ) ) {
  1103. processMaterials();
  1104. } else {
  1105. var mtlLoader = new THREE.MTLLoader( this.manager );
  1106. crossOrigin = Validator.verifyInput( crossOrigin, 'anonymous' );
  1107. mtlLoader.setCrossOrigin( crossOrigin );
  1108. mtlLoader.setPath( resource.path );
  1109. if ( Validator.isValid( materialOptions ) ) mtlLoader.setMaterialOptions( materialOptions );
  1110. var parseTextWithMtlLoader = function ( content ) {
  1111. var contentAsText = content;
  1112. if ( typeof( content ) !== 'string' && ! ( content instanceof String ) ) {
  1113. if ( content.length > 0 || content.byteLength > 0 ) {
  1114. contentAsText = THREE.LoaderUtils.decodeText( content );
  1115. } else {
  1116. throw 'Unable to parse mtl as it it seems to be neither a String, an Array or an ArrayBuffer!';
  1117. }
  1118. }
  1119. processMaterials( mtlLoader.parse( contentAsText ) );
  1120. };
  1121. if ( Validator.isValid( resource.content ) ) {
  1122. parseTextWithMtlLoader( resource.content );
  1123. } else if ( Validator.isValid( resource.url ) ) {
  1124. var fileLoader = new THREE.FileLoader( this.manager );
  1125. fileLoader.load( resource.url, parseTextWithMtlLoader, this._onProgress, this._onError );
  1126. }
  1127. }
  1128. };
  1129. return OBJLoader2;
  1130. })();