12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496 |
- /**
- * @author Kai Salmen / https://kaisalmen.de
- * Development repository: https://github.com/kaisalmen/WWOBJLoader
- */
- 'use strict';
- if ( THREE.LoaderSupport === undefined ) { THREE.LoaderSupport = {} }
- /**
- * Validation functions.
- * @class
- */
- THREE.LoaderSupport.Validator = {
- /**
- * If given input is null or undefined, false is returned otherwise true.
- *
- * @param input Can be anything
- * @returns {boolean}
- */
- isValid: function( input ) {
- return ( input !== null && input !== undefined );
- },
- /**
- * If given input is null or undefined, the defaultValue is returned otherwise the given input.
- *
- * @param input Can be anything
- * @param defaultValue Can be anything
- * @returns {*}
- */
- verifyInput: function( input, defaultValue ) {
- return ( input === null || input === undefined ) ? defaultValue : input;
- }
- };
- /**
- * Callbacks utilized by loaders and builders.
- * @class
- */
- THREE.LoaderSupport.Callbacks = (function () {
- var Validator = THREE.LoaderSupport.Validator;
- function Callbacks() {
- this.onProgress = null;
- this.onMeshAlter = null;
- this.onLoad = null;
- this.onLoadMaterials = null;
- }
- /**
- * Register callback function that is invoked by internal function "announceProgress" to print feedback.
- * @memberOf THREE.LoaderSupport.Callbacks
- *
- * @param {callback} callbackOnProgress Callback function for described functionality
- */
- Callbacks.prototype.setCallbackOnProgress = function ( callbackOnProgress ) {
- this.onProgress = Validator.verifyInput( callbackOnProgress, this.onProgress );
- };
- /**
- * Register callback function that is called every time a mesh was loaded.
- * Use {@link THREE.LoaderSupport.LoadedMeshUserOverride} for alteration instructions (geometry, material or disregard mesh).
- * @memberOf THREE.LoaderSupport.Callbacks
- *
- * @param {callback} callbackOnMeshAlter Callback function for described functionality
- */
- Callbacks.prototype.setCallbackOnMeshAlter = function ( callbackOnMeshAlter ) {
- this.onMeshAlter = Validator.verifyInput( callbackOnMeshAlter, this.onMeshAlter );
- };
- /**
- * Register callback function that is called once loading of the complete OBJ file is completed.
- * @memberOf THREE.LoaderSupport.Callbacks
- *
- * @param {callback} callbackOnLoad Callback function for described functionality
- */
- Callbacks.prototype.setCallbackOnLoad = function ( callbackOnLoad ) {
- this.onLoad = Validator.verifyInput( callbackOnLoad, this.onLoad );
- };
- /**
- * Register callback function that is called when materials have been loaded.
- * @memberOf THREE.LoaderSupport.Callbacks
- *
- * @param {callback} callbackOnLoadMaterials Callback function for described functionality
- */
- Callbacks.prototype.setCallbackOnLoadMaterials = function ( callbackOnLoadMaterials ) {
- this.onLoadMaterials = Validator.verifyInput( callbackOnLoadMaterials, this.onLoadMaterials );
- };
- return Callbacks;
- })();
- /**
- * Object to return by callback onMeshAlter. Used to disregard a certain mesh or to return one to many meshes.
- * @class
- *
- * @param {boolean} disregardMesh=false Tell implementation to completely disregard this mesh
- * @param {boolean} disregardMesh=false Tell implementation that mesh(es) have been altered or added
- */
- THREE.LoaderSupport.LoadedMeshUserOverride = (function () {
- function LoadedMeshUserOverride( disregardMesh, alteredMesh ) {
- this.disregardMesh = disregardMesh === true;
- this.alteredMesh = alteredMesh === true;
- this.meshes = [];
- }
- /**
- * Add a mesh created within callback.
- *
- * @memberOf THREE.OBJLoader2.LoadedMeshUserOverride
- *
- * @param {THREE.Mesh} mesh
- */
- LoadedMeshUserOverride.prototype.addMesh = function ( mesh ) {
- this.meshes.push( mesh );
- this.alteredMesh = true;
- };
- /**
- * Answers if mesh shall be disregarded completely.
- *
- * @returns {boolean}
- */
- LoadedMeshUserOverride.prototype.isDisregardMesh = function () {
- return this.disregardMesh;
- };
- /**
- * Answers if new mesh(es) were created.
- *
- * @returns {boolean}
- */
- LoadedMeshUserOverride.prototype.providesAlteredMeshes = function () {
- return this.alteredMesh;
- };
- return LoadedMeshUserOverride;
- })();
- /**
- * A resource description used by {@link THREE.LoaderSupport.PrepData} and others.
- * @class
- *
- * @param {string} url URL to the file
- * @param {string} extension The file extension (type)
- */
- THREE.LoaderSupport.ResourceDescriptor = (function () {
- var Validator = THREE.LoaderSupport.Validator;
- function ResourceDescriptor( url, extension ) {
- var urlParts = url.split( '/' );
- if ( urlParts.length < 2 ) {
- this.path = null;
- this.name = url;
- this.url = url;
- } else {
- this.path = Validator.verifyInput( urlParts.slice( 0, urlParts.length - 1).join( '/' ) + '/', null );
- this.name = Validator.verifyInput( urlParts[ urlParts.length - 1 ], null );
- this.url = url;
- }
- this.extension = Validator.verifyInput( extension, "default" );
- this.extension = this.extension.trim();
- this.content = null;
- }
- /**
- * Set the content of this resource
- * @memberOf THREE.LoaderSupport.ResourceDescriptor
- *
- * @param {Object} content The file content as arraybuffer or text
- */
- ResourceDescriptor.prototype.setContent = function ( content ) {
- this.content = Validator.verifyInput( content, null );
- };
- return ResourceDescriptor;
- })();
- /**
- * Configuration instructions to be used by run method.
- * @class
- */
- THREE.LoaderSupport.PrepData = (function () {
- var Validator = THREE.LoaderSupport.Validator;
- function PrepData( modelName ) {
- this.logging = {
- enabled: true,
- debug: false
- };
- this.modelName = Validator.verifyInput( modelName, '' );
- this.resources = [];
- this.callbacks = new THREE.LoaderSupport.Callbacks();
- }
- /**
- * Enable or disable logging in general (except warn and error), plus enable or disable debug logging.
- * @memberOf THREE.LoaderSupport.PrepData
- *
- * @param {boolean} enabled True or false.
- * @param {boolean} debug True or false.
- */
- PrepData.prototype.setLogging = function ( enabled, debug ) {
- this.logging.enabled = enabled === true;
- this.logging.debug = debug === true;
- };
- /**
- * Returns all callbacks as {@link THREE.LoaderSupport.Callbacks}
- * @memberOf THREE.LoaderSupport.PrepData
- *
- * @returns {THREE.LoaderSupport.Callbacks}
- */
- PrepData.prototype.getCallbacks = function () {
- return this.callbacks;
- };
- /**
- * Add a resource description.
- * @memberOf THREE.LoaderSupport.PrepData
- *
- * @param {THREE.LoaderSupport.ResourceDescriptor} Adds a {@link THREE.LoaderSupport.ResourceDescriptor}
- */
- PrepData.prototype.addResource = function ( resource ) {
- this.resources.push( resource );
- };
- /**
- * Clones this object and returns it afterwards. Callbacks and resources are not cloned deep (references!).
- * @memberOf THREE.LoaderSupport.PrepData
- *
- * @returns {@link THREE.LoaderSupport.PrepData}
- */
- PrepData.prototype.clone = function () {
- var clone = new THREE.LoaderSupport.PrepData( this.modelName );
- clone.logging.enabled = this.logging.enabled;
- clone.logging.debug = this.logging.debug;
- clone.resources = this.resources;
- clone.callbacks = this.callbacks;
- var property, value;
- for ( property in this ) {
- value = this[ property ];
- if ( ! clone.hasOwnProperty( property ) && typeof this[ property ] !== 'function' ) {
- clone[ property ] = value;
- }
- }
- return clone;
- };
- /**
- * Identify files or content of interest from an Array of {@link THREE.LoaderSupport.ResourceDescriptor}.
- * @memberOf THREE.LoaderSupport.PrepData
- *
- * @param {THREE.LoaderSupport.ResourceDescriptor[]} resources Array of {@link THREE.LoaderSupport.ResourceDescriptor}
- * @param Object fileDesc Object describing which resources are of interest (ext, type (string or UInt8Array) and ignore (boolean))
- * @returns {{}} Object with each "ext" and the corresponding {@link THREE.LoaderSupport.ResourceDescriptor}
- */
- PrepData.prototype.checkResourceDescriptorFiles = function ( resources, fileDesc ) {
- var resource, triple, i, found;
- var result = {};
- for ( var index in resources ) {
- resource = resources[ index ];
- found = false;
- if ( ! Validator.isValid( resource.name ) ) continue;
- if ( Validator.isValid( resource.content ) ) {
- for ( i = 0; i < fileDesc.length && !found; i++ ) {
- triple = fileDesc[ i ];
- if ( resource.extension.toLowerCase() === triple.ext.toLowerCase() ) {
- if ( triple.ignore ) {
- found = true;
- } else if ( triple.type === "ArrayBuffer" ) {
- // fast-fail on bad type
- if ( ! ( resource.content instanceof ArrayBuffer || resource.content instanceof Uint8Array ) ) throw 'Provided content is not of type ArrayBuffer! Aborting...';
- result[ triple.ext ] = resource;
- found = true;
- } else if ( triple.type === "String" ) {
- if ( ! ( typeof( resource.content ) === 'string' || resource.content instanceof String) ) throw 'Provided content is not of type String! Aborting...';
- result[ triple.ext ] = resource;
- found = true;
- }
- }
- }
- if ( !found ) throw 'Unidentified resource "' + resource.name + '": ' + resource.url;
- } else {
- // fast-fail on bad type
- if ( ! ( typeof( resource.name ) === 'string' || resource.name instanceof String ) ) throw 'Provided file is not properly defined! Aborting...';
- for ( i = 0; i < fileDesc.length && !found; i++ ) {
- triple = fileDesc[ i ];
- if ( resource.extension.toLowerCase() === triple.ext.toLowerCase() ) {
- if ( ! triple.ignore ) result[ triple.ext ] = resource;
- found = true;
- }
- }
- if ( !found ) throw 'Unidentified resource "' + resource.name + '": ' + resource.url;
- }
- }
- return result;
- };
- return PrepData;
- })();
- /**
- * Builds one or many THREE.Mesh from one raw set of Arraybuffers, materialGroup descriptions and further parameters.
- * Supports vertex, vertexColor, normal, uv and index buffers.
- * @class
- */
- THREE.LoaderSupport.MeshBuilder = (function () {
- var LOADER_MESH_BUILDER_VERSION = '1.2.0';
- var Validator = THREE.LoaderSupport.Validator;
- function MeshBuilder() {
- console.info( 'Using THREE.LoaderSupport.MeshBuilder version: ' + LOADER_MESH_BUILDER_VERSION );
- this.logging = {
- enabled: true,
- debug: false
- };
- this.callbacks = new THREE.LoaderSupport.Callbacks();
- this.materials = [];
- }
- /**
- * Enable or disable logging in general (except warn and error), plus enable or disable debug logging.
- * @memberOf THREE.LoaderSupport.MeshBuilder
- *
- * @param {boolean} enabled True or false.
- * @param {boolean} debug True or false.
- */
- MeshBuilder.prototype.setLogging = function ( enabled, debug ) {
- this.logging.enabled = enabled === true;
- this.logging.debug = debug === true;
- };
- /**
- * Initializes the MeshBuilder (currently only default material initialisation).
- * @memberOf THREE.LoaderSupport.MeshBuilder
- *
- */
- MeshBuilder.prototype.init = function () {
- var defaultMaterial = new THREE.MeshStandardMaterial( { color: 0xDCF1FF } );
- defaultMaterial.name = 'defaultMaterial';
- var defaultVertexColorMaterial = new THREE.MeshStandardMaterial( { color: 0xDCF1FF } );
- defaultVertexColorMaterial.name = 'defaultVertexColorMaterial';
- defaultVertexColorMaterial.vertexColors = THREE.VertexColors;
- var defaultLineMaterial = new THREE.LineBasicMaterial();
- defaultLineMaterial.name = 'defaultLineMaterial';
- var defaultPointMaterial = new THREE.PointsMaterial( { size: 1 } );
- defaultPointMaterial.name = 'defaultPointMaterial';
- var runtimeMaterials = {};
- runtimeMaterials[ defaultMaterial.name ] = defaultMaterial;
- runtimeMaterials[ defaultVertexColorMaterial.name ] = defaultVertexColorMaterial;
- runtimeMaterials[ defaultLineMaterial.name ] = defaultLineMaterial;
- runtimeMaterials[ defaultPointMaterial.name ] = defaultPointMaterial;
- this.updateMaterials(
- {
- cmd: 'materialData',
- materials: {
- materialCloneInstructions: null,
- serializedMaterials: null,
- runtimeMaterials: runtimeMaterials
- }
- }
- );
- };
- /**
- * Set materials loaded by any supplier of an Array of {@link THREE.Material}.
- * @memberOf THREE.LoaderSupport.MeshBuilder
- *
- * @param {THREE.Material[]} materials Array of {@link THREE.Material}
- */
- MeshBuilder.prototype.setMaterials = function ( materials ) {
- var payload = {
- cmd: 'materialData',
- materials: {
- materialCloneInstructions: null,
- serializedMaterials: null,
- runtimeMaterials: Validator.isValid( this.callbacks.onLoadMaterials ) ? this.callbacks.onLoadMaterials( materials ) : materials
- }
- };
- this.updateMaterials( payload );
- };
- MeshBuilder.prototype._setCallbacks = function ( callbacks ) {
- if ( Validator.isValid( callbacks.onProgress ) ) this.callbacks.setCallbackOnProgress( callbacks.onProgress );
- if ( Validator.isValid( callbacks.onMeshAlter ) ) this.callbacks.setCallbackOnMeshAlter( callbacks.onMeshAlter );
- if ( Validator.isValid( callbacks.onLoad ) ) this.callbacks.setCallbackOnLoad( callbacks.onLoad );
- if ( Validator.isValid( callbacks.onLoadMaterials ) ) this.callbacks.setCallbackOnLoadMaterials( callbacks.onLoadMaterials );
- };
- /**
- * Delegates processing of the payload (mesh building or material update) to the corresponding functions (BW-compatibility).
- * @memberOf THREE.LoaderSupport.MeshBuilder
- *
- * @param {Object} payload Raw Mesh or Material descriptions.
- * @returns {THREE.Mesh[]} mesh Array of {@link THREE.Mesh} or null in case of material update
- */
- MeshBuilder.prototype.processPayload = function ( payload ) {
- if ( payload.cmd === 'meshData' ) {
- return this.buildMeshes( payload );
- } else if ( payload.cmd === 'materialData' ) {
- this.updateMaterials( payload );
- return null;
- }
- };
- /**
- * Builds one or multiple meshes from the data described in the payload (buffers, params, material info).
- * @memberOf THREE.LoaderSupport.MeshBuilder
- *
- * @param {Object} meshPayload Raw mesh description (buffers, params, materials) used to build one to many meshes.
- * @returns {THREE.Mesh[]} mesh Array of {@link THREE.Mesh}
- */
- MeshBuilder.prototype.buildMeshes = function ( meshPayload ) {
- var meshName = meshPayload.params.meshName;
- var bufferGeometry = new THREE.BufferGeometry();
- bufferGeometry.addAttribute( 'position', new THREE.BufferAttribute( new Float32Array( meshPayload.buffers.vertices ), 3 ) );
- if ( Validator.isValid( meshPayload.buffers.indices ) ) {
- bufferGeometry.setIndex( new THREE.BufferAttribute( new Uint32Array( meshPayload.buffers.indices ), 1 ));
- }
- var haveVertexColors = Validator.isValid( meshPayload.buffers.colors );
- if ( haveVertexColors ) {
- bufferGeometry.addAttribute( 'color', new THREE.BufferAttribute( new Float32Array( meshPayload.buffers.colors ), 3 ) );
- }
- if ( Validator.isValid( meshPayload.buffers.normals ) ) {
- bufferGeometry.addAttribute( 'normal', new THREE.BufferAttribute( new Float32Array( meshPayload.buffers.normals ), 3 ) );
- } else {
- bufferGeometry.computeVertexNormals();
- }
- if ( Validator.isValid( meshPayload.buffers.uvs ) ) {
- bufferGeometry.addAttribute( 'uv', new THREE.BufferAttribute( new Float32Array( meshPayload.buffers.uvs ), 2 ) );
- }
- var material, materialName, key;
- var materialNames = meshPayload.materials.materialNames;
- var createMultiMaterial = meshPayload.materials.multiMaterial;
- var multiMaterials = [];
- for ( key in materialNames ) {
- materialName = materialNames[ key ];
- material = this.materials[ materialName ];
- if ( createMultiMaterial ) multiMaterials.push( material );
- }
- if ( createMultiMaterial ) {
- material = multiMaterials;
- var materialGroups = meshPayload.materials.materialGroups;
- var materialGroup;
- for ( key in materialGroups ) {
- materialGroup = materialGroups[ key ];
- bufferGeometry.addGroup( materialGroup.start, materialGroup.count, materialGroup.index );
- }
- }
- var meshes = [];
- var mesh;
- var callbackOnMeshAlter = this.callbacks.onMeshAlter;
- var callbackOnMeshAlterResult;
- var useOrgMesh = true;
- var geometryType = Validator.verifyInput( meshPayload.geometryType, 0 );
- if ( Validator.isValid( callbackOnMeshAlter ) ) {
- callbackOnMeshAlterResult = callbackOnMeshAlter(
- {
- detail: {
- meshName: meshName,
- bufferGeometry: bufferGeometry,
- material: material,
- geometryType: geometryType
- }
- }
- );
- if ( Validator.isValid( callbackOnMeshAlterResult ) ) {
- if ( ! callbackOnMeshAlterResult.isDisregardMesh() && callbackOnMeshAlterResult.providesAlteredMeshes() ) {
- for ( var i in callbackOnMeshAlterResult.meshes ) {
- meshes.push( callbackOnMeshAlterResult.meshes[ i ] );
- }
- }
- useOrgMesh = false;
- }
- }
- if ( useOrgMesh ) {
- if ( meshPayload.computeBoundingSphere ) bufferGeometry.computeBoundingSphere();
- if ( geometryType === 0 ) {
- mesh = new THREE.Mesh( bufferGeometry, material );
- } else if ( geometryType === 1) {
- mesh = new THREE.LineSegments( bufferGeometry, material );
- } else {
- mesh = new THREE.Points( bufferGeometry, material );
- }
- mesh.name = meshName;
- meshes.push( mesh );
- }
- var progressMessage;
- if ( Validator.isValid( meshes ) && meshes.length > 0 ) {
- var meshNames = [];
- for ( var i in meshes ) {
- mesh = meshes[ i ];
- meshNames[ i ] = mesh.name;
- }
- progressMessage = 'Adding mesh(es) (' + meshNames.length + ': ' + meshNames + ') from input mesh: ' + meshName;
- progressMessage += ' (' + ( meshPayload.progress.numericalValue * 100 ).toFixed( 2 ) + '%)';
- } else {
- progressMessage = 'Not adding mesh: ' + meshName;
- progressMessage += ' (' + ( meshPayload.progress.numericalValue * 100 ).toFixed( 2 ) + '%)';
- }
- var callbackOnProgress = this.callbacks.onProgress;
- if ( Validator.isValid( callbackOnProgress ) ) {
- var event = new CustomEvent( 'MeshBuilderEvent', {
- detail: {
- type: 'progress',
- modelName: meshPayload.params.meshName,
- text: progressMessage,
- numericalValue: meshPayload.progress.numericalValue
- }
- } );
- callbackOnProgress( event );
- }
- return meshes;
- };
- /**
- * Updates the materials with contained material objects (sync) or from alteration instructions (async).
- * @memberOf THREE.LoaderSupport.MeshBuilder
- *
- * @param {Object} materialPayload Material update instructions
- */
- MeshBuilder.prototype.updateMaterials = function ( materialPayload ) {
- var material, materialName;
- var materialCloneInstructions = materialPayload.materials.materialCloneInstructions;
- if ( Validator.isValid( materialCloneInstructions ) ) {
- var materialNameOrg = materialCloneInstructions.materialNameOrg;
- var materialOrg = this.materials[ materialNameOrg ];
- if ( Validator.isValid( materialNameOrg ) ) {
- material = materialOrg.clone();
- materialName = materialCloneInstructions.materialName;
- material.name = materialName;
- var materialProperties = materialCloneInstructions.materialProperties;
- for ( var key in materialProperties ) {
- if ( material.hasOwnProperty( key ) && materialProperties.hasOwnProperty( key ) ) material[ key ] = materialProperties[ key ];
- }
- this.materials[ materialName ] = material;
- } else {
- console.warn( 'Requested material "' + materialNameOrg + '" is not available!' );
- }
- }
- var materials = materialPayload.materials.serializedMaterials;
- if ( Validator.isValid( materials ) && Object.keys( materials ).length > 0 ) {
- var loader = new THREE.MaterialLoader();
- var materialJson;
- for ( materialName in materials ) {
- materialJson = materials[ materialName ];
- if ( Validator.isValid( materialJson ) ) {
- material = loader.parse( materialJson );
- if ( this.logging.enabled ) console.info( 'De-serialized material with name "' + materialName + '" will be added.' );
- this.materials[ materialName ] = material;
- }
- }
- }
- materials = materialPayload.materials.runtimeMaterials;
- if ( Validator.isValid( materials ) && Object.keys( materials ).length > 0 ) {
- for ( materialName in materials ) {
- material = materials[ materialName ];
- if ( this.logging.enabled ) console.info( 'Material with name "' + materialName + '" will be added.' );
- this.materials[ materialName ] = material;
- }
- }
- };
- /**
- * Returns the mapping object of material name and corresponding jsonified material.
- *
- * @returns {Object} Map of Materials in JSON representation
- */
- MeshBuilder.prototype.getMaterialsJSON = function () {
- var materialsJSON = {};
- var material;
- for ( var materialName in this.materials ) {
- material = this.materials[ materialName ];
- materialsJSON[ materialName ] = material.toJSON();
- }
- return materialsJSON;
- };
- /**
- * Returns the mapping object of material name and corresponding material.
- *
- * @returns {Object} Map of {@link THREE.Material}
- */
- MeshBuilder.prototype.getMaterials = function () {
- return this.materials;
- };
- return MeshBuilder;
- })();
- /**
- * Default implementation of the WorkerRunner responsible for creation and configuration of the parser within the worker.
- *
- * @class
- */
- THREE.LoaderSupport.WorkerRunnerRefImpl = (function () {
- function WorkerRunnerRefImpl() {
- var scope = this;
- var scopedRunner = function( event ) {
- scope.processMessage( event.data );
- };
- self.addEventListener( 'message', scopedRunner, false );
- }
- /**
- * Applies values from parameter object via set functions or via direct assignment.
- * @memberOf THREE.LoaderSupport.WorkerRunnerRefImpl
- *
- * @param {Object} parser The parser instance
- * @param {Object} params The parameter object
- */
- WorkerRunnerRefImpl.prototype.applyProperties = function ( parser, params ) {
- var property, funcName, values;
- for ( property in params ) {
- funcName = 'set' + property.substring( 0, 1 ).toLocaleUpperCase() + property.substring( 1 );
- values = params[ property ];
- if ( typeof parser[ funcName ] === 'function' ) {
- parser[ funcName ]( values );
- } else if ( parser.hasOwnProperty( property ) ) {
- parser[ property ] = values;
- }
- }
- };
- /**
- * Configures the Parser implementation according the supplied configuration object.
- * @memberOf THREE.LoaderSupport.WorkerRunnerRefImpl
- *
- * @param {Object} payload Raw mesh description (buffers, params, materials) used to build one to many meshes.
- */
- WorkerRunnerRefImpl.prototype.processMessage = function ( payload ) {
- if ( payload.cmd === 'run' ) {
- var callbacks = {
- callbackMeshBuilder: function ( payload ) {
- self.postMessage( payload );
- },
- callbackProgress: function ( text ) {
- if ( payload.logging.enabled && payload.logging.debug ) console.debug( 'WorkerRunner: progress: ' + text );
- }
- };
- // Parser is expected to be named as such
- var parser = new Parser();
- if ( typeof parser[ 'setLogging' ] === 'function' ) parser.setLogging( payload.logging.enabled, payload.logging.debug );
- this.applyProperties( parser, payload.params );
- this.applyProperties( parser, payload.materials );
- this.applyProperties( parser, callbacks );
- parser.workerScope = self;
- parser.parse( payload.data.input, payload.data.options );
- if ( payload.logging.enabled ) console.log( 'WorkerRunner: Run complete!' );
- callbacks.callbackMeshBuilder( {
- cmd: 'complete',
- msg: 'WorkerRunner completed run.'
- } );
- } else {
- console.error( 'WorkerRunner: Received unknown command: ' + payload.cmd );
- }
- };
- return WorkerRunnerRefImpl;
- })();
- /**
- * This class provides means to transform existing parser code into a web worker. It defines a simple communication protocol
- * which allows to configure the worker and receive raw mesh data during execution.
- * @class
- */
- THREE.LoaderSupport.WorkerSupport = (function () {
- var WORKER_SUPPORT_VERSION = '2.2.0';
- var Validator = THREE.LoaderSupport.Validator;
- var LoaderWorker = (function () {
- function LoaderWorker() {
- this._reset();
- }
- LoaderWorker.prototype._reset = function () {
- this.logging = {
- enabled: true,
- debug: false
- };
- this.worker = null;
- this.runnerImplName = null;
- this.callbacks = {
- meshBuilder: null,
- onLoad: null
- };
- this.terminateRequested = false;
- this.queuedMessage = null;
- this.started = false;
- this.forceCopy = false;
- };
- LoaderWorker.prototype.setLogging = function ( enabled, debug ) {
- this.logging.enabled = enabled === true;
- this.logging.debug = debug === true;
- };
- LoaderWorker.prototype.setForceCopy = function ( forceCopy ) {
- this.forceCopy = forceCopy === true;
- };
- LoaderWorker.prototype.initWorker = function ( code, runnerImplName ) {
- this.runnerImplName = runnerImplName;
- var blob = new Blob( [ code ], { type: 'application/javascript' } );
- this.worker = new Worker( window.URL.createObjectURL( blob ) );
- this.worker.onmessage = this._receiveWorkerMessage;
- // set referemce to this, then processing in worker scope within "_receiveWorkerMessage" can access members
- this.worker.runtimeRef = this;
- // process stored queuedMessage
- this._postMessage();
- };
- /**
- * Executed in worker scope
- */
- LoaderWorker.prototype._receiveWorkerMessage = function ( e ) {
- var payload = e.data;
- switch ( payload.cmd ) {
- case 'meshData':
- case 'materialData':
- case 'imageData':
- this.runtimeRef.callbacks.meshBuilder( payload );
- break;
- case 'complete':
- this.runtimeRef.queuedMessage = null;
- this.started = false;
- this.runtimeRef.callbacks.onLoad( payload.msg );
- if ( this.runtimeRef.terminateRequested ) {
- if ( this.runtimeRef.logging.enabled ) console.info( 'WorkerSupport [' + this.runtimeRef.runnerImplName + ']: Run is complete. Terminating application on request!' );
- this.runtimeRef._terminate();
- }
- break;
- case 'error':
- console.error( 'WorkerSupport [' + this.runtimeRef.runnerImplName + ']: Reported error: ' + payload.msg );
- this.runtimeRef.queuedMessage = null;
- this.started = false;
- this.runtimeRef.callbacks.onLoad( payload.msg );
- if ( this.runtimeRef.terminateRequested ) {
- if ( this.runtimeRef.logging.enabled ) console.info( 'WorkerSupport [' + this.runtimeRef.runnerImplName + ']: Run reported error. Terminating application on request!' );
- this.runtimeRef._terminate();
- }
- break;
- default:
- console.error( 'WorkerSupport [' + this.runtimeRef.runnerImplName + ']: Received unknown command: ' + payload.cmd );
- break;
- }
- };
- LoaderWorker.prototype.setCallbacks = function ( meshBuilder, onLoad ) {
- this.callbacks.meshBuilder = Validator.verifyInput( meshBuilder, this.callbacks.meshBuilder );
- this.callbacks.onLoad = Validator.verifyInput( onLoad, this.callbacks.onLoad );
- };
- LoaderWorker.prototype.run = function( payload ) {
- if ( Validator.isValid( this.queuedMessage ) ) {
- console.warn( 'Already processing message. Rejecting new run instruction' );
- return;
- } else {
- this.queuedMessage = payload;
- this.started = true;
- }
- if ( ! Validator.isValid( this.callbacks.meshBuilder ) ) throw 'Unable to run as no "MeshBuilder" callback is set.';
- if ( ! Validator.isValid( this.callbacks.onLoad ) ) throw 'Unable to run as no "onLoad" callback is set.';
- if ( payload.cmd !== 'run' ) payload.cmd = 'run';
- if ( Validator.isValid( payload.logging ) ) {
- payload.logging.enabled = payload.logging.enabled === true;
- payload.logging.debug = payload.logging.debug === true;
- } else {
- payload.logging = {
- enabled: true,
- debug: false
- }
- }
- this._postMessage();
- };
- LoaderWorker.prototype._postMessage = function () {
- if ( Validator.isValid( this.queuedMessage ) && Validator.isValid( this.worker ) ) {
- if ( this.queuedMessage.data.input instanceof ArrayBuffer ) {
- var content;
- if ( this.forceCopy ) {
- content = this.queuedMessage.data.input.slice( 0 );
- } else {
- content = this.queuedMessage.data.input;
- }
- this.worker.postMessage( this.queuedMessage, [ content ] );
- } else {
- this.worker.postMessage( this.queuedMessage );
- }
- }
- };
- LoaderWorker.prototype.setTerminateRequested = function ( terminateRequested ) {
- this.terminateRequested = terminateRequested === true;
- if ( this.terminateRequested && Validator.isValid( this.worker ) && ! Validator.isValid( this.queuedMessage ) && this.started ) {
- if ( this.logging.enabled ) console.info( 'Worker is terminated immediately as it is not running!' );
- this._terminate();
- }
- };
- LoaderWorker.prototype._terminate = function () {
- this.worker.terminate();
- this._reset();
- };
- return LoaderWorker;
- })();
- function WorkerSupport() {
- console.info( 'Using THREE.LoaderSupport.WorkerSupport version: ' + WORKER_SUPPORT_VERSION );
- this.logging = {
- enabled: true,
- debug: false
- };
- // check worker support first
- if ( window.Worker === undefined ) throw "This browser does not support web workers!";
- if ( window.Blob === undefined ) throw "This browser does not support Blob!";
- if ( typeof window.URL.createObjectURL !== 'function' ) throw "This browser does not support Object creation from URL!";
- this.loaderWorker = new LoaderWorker();
- }
- /**
- * Enable or disable logging in general (except warn and error), plus enable or disable debug logging.
- * @memberOf THREE.LoaderSupport.WorkerSupport
- *
- * @param {boolean} enabled True or false.
- * @param {boolean} debug True or false.
- */
- WorkerSupport.prototype.setLogging = function ( enabled, debug ) {
- this.logging.enabled = enabled === true;
- this.logging.debug = debug === true;
- this.loaderWorker.setLogging( this.logging.enabled, this.logging.debug );
- };
- /**
- * Forces all ArrayBuffers to be transferred to worker to be copied.
- * @memberOf THREE.LoaderSupport.WorkerSupport
- *
- * @param {boolean} forceWorkerDataCopy True or false.
- */
- WorkerSupport.prototype.setForceWorkerDataCopy = function ( forceWorkerDataCopy ) {
- this.loaderWorker.setForceCopy( forceWorkerDataCopy );
- };
- /**
- * Validate the status of worker code and the derived worker.
- * @memberOf THREE.LoaderSupport.WorkerSupport
- *
- * @param {Function} functionCodeBuilder Function that is invoked with funcBuildObject and funcBuildSingleton that allows stringification of objects and singletons.
- * @param {String} parserName Name of the Parser object
- * @param {String[]} libLocations URL of libraries that shall be added to worker code relative to libPath
- * @param {String} libPath Base path used for loading libraries
- * @param {THREE.LoaderSupport.WorkerRunnerRefImpl} runnerImpl The default worker parser wrapper implementation (communication and execution). An extended class could be passed here.
- */
- WorkerSupport.prototype.validate = function ( functionCodeBuilder, parserName, libLocations, libPath, runnerImpl ) {
- if ( Validator.isValid( this.loaderWorker.worker ) ) return;
- if ( this.logging.enabled ) {
- console.info( 'WorkerSupport: Building worker code...' );
- console.time( 'buildWebWorkerCode' );
- }
- if ( Validator.isValid( runnerImpl ) ) {
- if ( this.logging.enabled ) console.info( 'WorkerSupport: Using "' + runnerImpl.name + '" as Runner class for worker.' );
- } else {
- runnerImpl = THREE.LoaderSupport.WorkerRunnerRefImpl;
- if ( this.logging.enabled ) console.info( 'WorkerSupport: Using DEFAULT "THREE.LoaderSupport.WorkerRunnerRefImpl" as Runner class for worker.' );
- }
- var userWorkerCode = functionCodeBuilder( buildObject, buildSingleton );
- userWorkerCode += 'var Parser = '+ parserName + ';\n\n';
- userWorkerCode += buildSingleton( runnerImpl.name, runnerImpl );
- userWorkerCode += 'new ' + runnerImpl.name + '();\n\n';
- var scope = this;
- if ( Validator.isValid( libLocations ) && libLocations.length > 0 ) {
- var libsContent = '';
- var loadAllLibraries = function ( path, locations ) {
- if ( locations.length === 0 ) {
- scope.loaderWorker.initWorker( libsContent + userWorkerCode, runnerImpl.name );
- if ( scope.logging.enabled ) console.timeEnd( 'buildWebWorkerCode' );
- } else {
- var loadedLib = function ( contentAsString ) {
- libsContent += contentAsString;
- loadAllLibraries( path, locations );
- };
- var fileLoader = new THREE.FileLoader();
- fileLoader.setPath( path );
- fileLoader.setResponseType( 'text' );
- fileLoader.load( locations[ 0 ], loadedLib );
- locations.shift();
- }
- };
- loadAllLibraries( libPath, libLocations );
- } else {
- this.loaderWorker.initWorker( userWorkerCode, runnerImpl.name );
- if ( this.logging.enabled ) console.timeEnd( 'buildWebWorkerCode' );
- }
- };
- /**
- * Specify functions that should be build when new raw mesh data becomes available and when the parser is finished.
- * @memberOf THREE.LoaderSupport.WorkerSupport
- *
- * @param {Function} meshBuilder The mesh builder function. Default is {@link THREE.LoaderSupport.MeshBuilder}.
- * @param {Function} onLoad The function that is called when parsing is complete.
- */
- WorkerSupport.prototype.setCallbacks = function ( meshBuilder, onLoad ) {
- this.loaderWorker.setCallbacks( meshBuilder, onLoad );
- };
- /**
- * Runs the parser with the provided configuration.
- * @memberOf THREE.LoaderSupport.WorkerSupport
- *
- * @param {Object} payload Raw mesh description (buffers, params, materials) used to build one to many meshes.
- */
- WorkerSupport.prototype.run = function ( payload ) {
- this.loaderWorker.run( payload );
- };
- /**
- * Request termination of worker once parser is finished.
- * @memberOf THREE.LoaderSupport.WorkerSupport
- *
- * @param {boolean} terminateRequested True or false.
- */
- WorkerSupport.prototype.setTerminateRequested = function ( terminateRequested ) {
- this.loaderWorker.setTerminateRequested( terminateRequested );
- };
- var buildObject = function ( fullName, object ) {
- var objectString = fullName + ' = {\n';
- var part;
- for ( var name in object ) {
- part = object[ name ];
- if ( typeof( part ) === 'string' || part instanceof String ) {
- part = part.replace( '\n', '\\n' );
- part = part.replace( '\r', '\\r' );
- objectString += '\t' + name + ': "' + part + '",\n';
- } else if ( part instanceof Array ) {
- objectString += '\t' + name + ': [' + part + '],\n';
- } else if ( Number.isInteger( part ) ) {
- objectString += '\t' + name + ': ' + part + ',\n';
- } else if ( typeof part === 'function' ) {
- objectString += '\t' + name + ': ' + part + ',\n';
- }
- }
- objectString += '}\n\n';
- return objectString;
- };
- var buildSingleton = function ( fullName, object, internalName, basePrototypeName, ignoreFunctions ) {
- var objectString = '';
- var objectName = ( Validator.isValid( internalName ) ) ? internalName : object.name;
- var funcString, objectPart, constructorString;
- ignoreFunctions = Validator.verifyInput( ignoreFunctions, [] );
- for ( var name in object.prototype ) {
- objectPart = object.prototype[ name ];
- if ( name === 'constructor' ) {
- funcString = objectPart.toString();
- funcString = funcString.replace( 'function', '' );
- constructorString = '\tfunction ' + objectName + funcString + ';\n\n';
- } else if ( typeof objectPart === 'function' ) {
- if ( ignoreFunctions.indexOf( name ) < 0 ) {
- funcString = objectPart.toString();
- objectString += '\t' + objectName + '.prototype.' + name + ' = ' + funcString + ';\n\n';
- }
- }
- }
- objectString += '\treturn ' + objectName + ';\n';
- objectString += '})();\n\n';
- var inheritanceBlock = '';
- if ( Validator.isValid( basePrototypeName ) ) {
- inheritanceBlock += '\n';
- inheritanceBlock += objectName + '.prototype = Object.create( ' + basePrototypeName + '.prototype );\n';
- inheritanceBlock += objectName + '.constructor = ' + objectName + ';\n';
- inheritanceBlock += '\n';
- }
- if ( ! Validator.isValid( constructorString ) ) {
- constructorString = fullName + ' = (function () {\n\n';
- constructorString += inheritanceBlock + '\t' + object.prototype.constructor.toString() + '\n\n';
- objectString = constructorString + objectString;
- } else {
- objectString = fullName + ' = (function () {\n\n' + inheritanceBlock + constructorString + objectString;
- }
- return objectString;
- };
- return WorkerSupport;
- })();
- /**
- * Orchestrate loading of multiple OBJ files/data from an instruction queue with a configurable amount of workers (1-16).
- * Workflow:
- * prepareWorkers
- * enqueueForRun
- * processQueue
- * tearDown (to force stop)
- *
- * @class
- *
- * @param {string} classDef Class definition to be used for construction
- */
- THREE.LoaderSupport.WorkerDirector = (function () {
- var LOADER_WORKER_DIRECTOR_VERSION = '2.2.0';
- var Validator = THREE.LoaderSupport.Validator;
- var MAX_WEB_WORKER = 16;
- var MAX_QUEUE_SIZE = 8192;
- function WorkerDirector( classDef ) {
- console.info( 'Using THREE.LoaderSupport.WorkerDirector version: ' + LOADER_WORKER_DIRECTOR_VERSION );
- this.logging = {
- enabled: true,
- debug: false
- };
- this.maxQueueSize = MAX_QUEUE_SIZE ;
- this.maxWebWorkers = MAX_WEB_WORKER;
- this.crossOrigin = null;
- if ( ! Validator.isValid( classDef ) ) throw 'Provided invalid classDef: ' + classDef;
- this.workerDescription = {
- classDef: classDef,
- globalCallbacks: {},
- workerSupports: {},
- forceWorkerDataCopy: true
- };
- this.objectsCompleted = 0;
- this.instructionQueue = [];
- this.instructionQueuePointer = 0;
- this.callbackOnFinishedProcessing = null;
- }
- /**
- * Enable or disable logging in general (except warn and error), plus enable or disable debug logging.
- * @memberOf THREE.LoaderSupport.WorkerDirector
- *
- * @param {boolean} enabled True or false.
- * @param {boolean} debug True or false.
- */
- WorkerDirector.prototype.setLogging = function ( enabled, debug ) {
- this.logging.enabled = enabled === true;
- this.logging.debug = debug === true;
- };
- /**
- * Returns the maximum length of the instruction queue.
- * @memberOf THREE.LoaderSupport.WorkerDirector
- *
- * @returns {number}
- */
- WorkerDirector.prototype.getMaxQueueSize = function () {
- return this.maxQueueSize;
- };
- /**
- * Returns the maximum number of workers.
- * @memberOf THREE.LoaderSupport.WorkerDirector
- *
- * @returns {number}
- */
- WorkerDirector.prototype.getMaxWebWorkers = function () {
- return this.maxWebWorkers;
- };
- /**
- * Sets the CORS string to be used.
- * @memberOf THREE.LoaderSupport.WorkerDirector
- *
- * @param {string} crossOrigin CORS value
- */
- WorkerDirector.prototype.setCrossOrigin = function ( crossOrigin ) {
- this.crossOrigin = crossOrigin;
- };
- /**
- * Forces all ArrayBuffers to be transferred to worker to be copied.
- * @memberOf THREE.LoaderSupport.WorkerDirector
- *
- * @param {boolean} forceWorkerDataCopy True or false.
- */
- WorkerDirector.prototype.setForceWorkerDataCopy = function ( forceWorkerDataCopy ) {
- this.workerDescription.forceWorkerDataCopy = forceWorkerDataCopy === true;
- };
- /**
- * Create or destroy workers according limits. Set the name and register callbacks for dynamically created web workers.
- * @memberOf THREE.LoaderSupport.WorkerDirector
- *
- * @param {THREE.OBJLoader2.WWOBJLoader2.PrepDataCallbacks} globalCallbacks Register global callbacks used by all web workers
- * @param {number} maxQueueSize Set the maximum size of the instruction queue (1-1024)
- * @param {number} maxWebWorkers Set the maximum amount of workers (1-16)
- */
- WorkerDirector.prototype.prepareWorkers = function ( globalCallbacks, maxQueueSize, maxWebWorkers ) {
- if ( Validator.isValid( globalCallbacks ) ) this.workerDescription.globalCallbacks = globalCallbacks;
- this.maxQueueSize = Math.min( maxQueueSize, MAX_QUEUE_SIZE );
- this.maxWebWorkers = Math.min( maxWebWorkers, MAX_WEB_WORKER );
- this.maxWebWorkers = Math.min( this.maxWebWorkers, this.maxQueueSize );
- this.objectsCompleted = 0;
- this.instructionQueue = [];
- this.instructionQueuePointer = 0;
- for ( var instanceNo = 0; instanceNo < this.maxWebWorkers; instanceNo++ ) {
- var workerSupport = new THREE.LoaderSupport.WorkerSupport();
- workerSupport.setLogging( this.logging.enabled, this.logging.debug );
- workerSupport.setForceWorkerDataCopy( this.workerDescription.forceWorkerDataCopy );
- this.workerDescription.workerSupports[ instanceNo ] = {
- instanceNo: instanceNo,
- inUse: false,
- terminateRequested: false,
- workerSupport: workerSupport,
- loader: null
- };
- }
- };
- /**
- * Store run instructions in internal instructionQueue.
- * @memberOf THREE.LoaderSupport.WorkerDirector
- *
- * @param {THREE.LoaderSupport.PrepData} prepData
- */
- WorkerDirector.prototype.enqueueForRun = function ( prepData ) {
- if ( this.instructionQueue.length < this.maxQueueSize ) {
- this.instructionQueue.push( prepData );
- }
- };
- /**
- * Returns if any workers are running.
- *
- * @memberOf THREE.LoaderSupport.WorkerDirector
- * @returns {boolean}
- */
- WorkerDirector.prototype.isRunning = function () {
- var wsKeys = Object.keys( this.workerDescription.workerSupports );
- return ( ( this.instructionQueue.length > 0 && this.instructionQueuePointer < this.instructionQueue.length ) || wsKeys.length > 0 );
- };
- /**
- * Process the instructionQueue until it is depleted.
- * @memberOf THREE.LoaderSupport.WorkerDirector
- */
- WorkerDirector.prototype.processQueue = function () {
- var prepData, supportDesc;
- for ( var instanceNo in this.workerDescription.workerSupports ) {
- supportDesc = this.workerDescription.workerSupports[ instanceNo ];
- if ( ! supportDesc.inUse ) {
- if ( this.instructionQueuePointer < this.instructionQueue.length ) {
- prepData = this.instructionQueue[ this.instructionQueuePointer ];
- this._kickWorkerRun( prepData, supportDesc );
- this.instructionQueuePointer++;
- } else {
- this._deregister( supportDesc );
- }
- }
- }
- if ( ! this.isRunning() && this.callbackOnFinishedProcessing !== null ) {
- this.callbackOnFinishedProcessing();
- this.callbackOnFinishedProcessing = null;
- }
- };
- WorkerDirector.prototype._kickWorkerRun = function( prepData, supportDesc ) {
- supportDesc.inUse = true;
- supportDesc.workerSupport.setTerminateRequested( supportDesc.terminateRequested );
- if ( this.logging.enabled ) console.info( '\nAssigning next item from queue to worker (queue length: ' + this.instructionQueue.length + ')\n\n' );
- var scope = this;
- var prepDataCallbacks = prepData.getCallbacks();
- var globalCallbacks = this.workerDescription.globalCallbacks;
- var wrapperOnLoad = function ( event ) {
- if ( Validator.isValid( globalCallbacks.onLoad ) ) globalCallbacks.onLoad( event );
- if ( Validator.isValid( prepDataCallbacks.onLoad ) ) prepDataCallbacks.onLoad( event );
- scope.objectsCompleted++;
- supportDesc.inUse = false;
- scope.processQueue();
- };
- var wrapperOnProgress = function ( event ) {
- if ( Validator.isValid( globalCallbacks.onProgress ) ) globalCallbacks.onProgress( event );
- if ( Validator.isValid( prepDataCallbacks.onProgress ) ) prepDataCallbacks.onProgress( event );
- };
- var wrapperOnMeshAlter = function ( event ) {
- if ( Validator.isValid( globalCallbacks.onMeshAlter ) ) globalCallbacks.onMeshAlter( event );
- if ( Validator.isValid( prepDataCallbacks.onMeshAlter ) ) prepDataCallbacks.onMeshAlter( event );
- };
- supportDesc.loader = this._buildLoader( supportDesc.instanceNo );
- var updatedCallbacks = new THREE.LoaderSupport.Callbacks();
- updatedCallbacks.setCallbackOnLoad( wrapperOnLoad );
- updatedCallbacks.setCallbackOnProgress( wrapperOnProgress );
- updatedCallbacks.setCallbackOnMeshAlter( wrapperOnMeshAlter );
- prepData.callbacks = updatedCallbacks;
- supportDesc.loader.run( prepData, supportDesc.workerSupport );
- };
- WorkerDirector.prototype._buildLoader = function ( instanceNo ) {
- var classDef = this.workerDescription.classDef;
- var loader = Object.create( classDef.prototype );
- classDef.call( loader, THREE.DefaultLoadingManager );
- // verify that all required functions are implemented
- if ( ! loader.hasOwnProperty( 'instanceNo' ) ) throw classDef.name + ' has no property "instanceNo".';
- loader.instanceNo = instanceNo;
- if ( ! loader.hasOwnProperty( 'workerSupport' ) ) {
- throw classDef.name + ' has no property "workerSupport".';
- }
- if ( typeof loader.run !== 'function' ) throw classDef.name + ' has no function "run".';
- if ( ! loader.hasOwnProperty( 'callbacks' ) || ! Validator.isValid( loader.callbacks ) ) {
- console.warn( classDef.name + ' has an invalid property "callbacks". Will change to "THREE.LoaderSupport.Callbacks"' );
- loader.callbacks = new THREE.LoaderSupport.Callbacks();
- }
- return loader;
- };
- WorkerDirector.prototype._deregister = function ( supportDesc ) {
- if ( Validator.isValid( supportDesc ) ) {
- supportDesc.workerSupport.setTerminateRequested( true );
- if ( this.logging.enabled ) console.info( 'Requested termination of worker #' + supportDesc.instanceNo + '.' );
- var loaderCallbacks = supportDesc.loader.callbacks;
- if ( Validator.isValid( loaderCallbacks.onProgress ) ) loaderCallbacks.onProgress( { detail: { text: '' } } );
- delete this.workerDescription.workerSupports[ supportDesc.instanceNo ];
- }
- };
- /**
- * Terminate all workers.
- * @memberOf THREE.LoaderSupport.WorkerDirector
- *
- * @param {callback} callbackOnFinishedProcessing Function called once all workers finished processing.
- */
- WorkerDirector.prototype.tearDown = function ( callbackOnFinishedProcessing ) {
- if ( this.logging.enabled ) console.info( 'WorkerDirector received the deregister call. Terminating all workers!' );
- this.instructionQueuePointer = this.instructionQueue.length;
- this.callbackOnFinishedProcessing = Validator.verifyInput( callbackOnFinishedProcessing, null );
- for ( var name in this.workerDescription.workerSupports ) {
- this.workerDescription.workerSupports[ name ].terminateRequested = true;
- }
- };
- return WorkerDirector;
- })();
|