three.js/src/animation/PropertyBinding.js

/**
 *
 * A track bound to a real value in the scene graph.
 * 
 * @author Ben Houston / http://clara.io/
 * @author David Sarno / http://lighthaus.us/
 */

THREE.PropertyBinding = function ( rootNode, trackName ) {

	this.rootNode = rootNode;
	this.trackName = trackName;

	var parseResults = THREE.PropertyBinding.parseTrackName( trackName );

	this.directoryName = parseResults.directoryName || null;
	this.nodeName = parseResults.nodeName;
	this.material = parseResults.material;
	this.materialIndex = parseResults.materialIndex;
	this.propertyName = parseResults.propertyName || null;
	this.propertyIndex = parseResults.propertyIndex || -1;

	this.node = THREE.PropertyBinding.findNode( rootNode, this.nodeName );

};

THREE.PropertyBinding.prototype = {

	constructor: THREE.PropertyBinding,

	set: function( value ) {

		 console.log( "PropertyBinding.set( " + value + ")" );

		 var targetObject = this.node;

 		// ensure there is a value node
		if( ! targetObject ) {
			console.log( "  trying to update node for track: " + this.trackName + " but it wasn't found." );
			return;
		}

		if( this.material ) {
			targetObject = targetObject.material;
			if( this.materialIndex !== undefined && this.materialIndex !== null && this.materialIndex >= 0 ) {
				if( targetObject.materials ) {
					targetObject = targetObject.materials[ this.materialIndex ];
				}
				else {
					console.log( "  trying to submaterial via index, but no materials exist:", targetObject );				
				}
			}
		}

 		// ensure there is a value property on the node
		var nodeProperty = targetObject[ this.propertyName ];
		if( ! nodeProperty ) {
			console.log( "  trying to update property for track: " + this.nodeName + '.' + this.propertyName + " but it wasn't found.", targetObject );				
			return;
		}

		// access a sub element of the property array (only primitives are supported right now)
		if( ( this.propertyIndex.length && this.propertyIndex.length > 0 ) || this.propertyIndex >= 0 ) {
			console.log( '  update property array ' + this.propertyName + '[' + this.propertyIndex + '] via assignment.' );				
			nodeProperty[ this.propertyIndex ] = value;
		}
		// must use copy for Object3D.Euler/Quaternion		
		else if( nodeProperty.copy ) {
			console.log( '  update property ' + this.name + '.' + this.propertyName + ' via a set() function.' );				
			nodeProperty.copy( value );
		}
		// otherwise just set the property directly on the node (do not use nodeProperty as it may not be a reference object)
		else {
			console.log( '  update property ' + this.name + '.' + this.propertyName + ' via assignment.' );				
			targetObject[ this.propertyName ] = value;	
		}

		// trigger node dirty			
		if( targetObject.needsUpdate !== undefined ) { // material
			console.log( '  triggering material as dirty' );
			this.node.needsUpdate = true;
		}			
		if( targetObject.matrixWorldNeedsUpdate !== undefined ) { // node transform
			console.log( '  triggering node as dirty' );
			targetObject.matrixWorldNeedsUpdate = true;
		}

	},

	get: function() {

		throw new Error( "TODO" );

	}

};


THREE.PropertyBinding.parseTrackName = function( trackName ) {

	// matches strings in the form of:
	//    nodeName.property
	//    nodeName.property[accessor]
	//    nodeName.material.property[accessor]
	//    uuid.property[accessor]
	//    uuid.material.property[accessor]
	//    parentName/nodeName.property
	//    parentName/parentName/nodeName.property[index]
	// created and tested via https://regex101.com/#javascript

	var re = /^(([\w]+\/)*)([\w-]+)?(\.material(\[([\w]+)\])?)?(\.([\w]+)(\[([\w]+)\])?)?$/; 
	var matches = re.exec(trackName);

	if( ! matches ) {
		throw new Error( "cannot parse trackName at all: " + trackName );
	}

    if (matches.index === re.lastIndex) {
        re.lastIndex++;
    }

	var results = {
		directoryName: matches[0],
		nodeName: matches[3], 	// allowed to be null, specified root node.
		material: ( matches[4] && matches[4].length > 0 ),
		materialIndex: matches[6],
		propertyName: matches[8],
		propertyIndex: matches[10]	// allowed to be null, specifies that the whole property is set.
	};

	console.log( "PropertyBinding.parseTrackName", trackName, results, matches );

	if( results.propertyName === null || results.propertyName.length === 0 ) {
		throw new Error( "can not parse propertyName from trackName: " + trackName );
	}

	return results;

};

// TODO: Cache this at some point
THREE.PropertyBinding.findNode = function( root, nodeName ) {

	console.log( 'AnimationUtils.findNode( ' + root.name + ', nodeName: ' + nodeName + ')');
	
	if( ! nodeName || nodeName === "" || nodeName === "root" || nodeName === "." || nodeName === -1 || nodeName === root.name || nodeName === root.uuid ) {

		console.log( '  root.' );
		return root;

	}

	// (2) search into skeleton bones.
	if( root.skeleton ) {

		var searchSkeleton = function( skeleton ) {

			for( var i = 0; i < skeleton.bones.length; i ++ ) {

				var bone = skeleton.bones[i];

				if( bone.name === nodeName ) {

					return bone;

				}
			}

			return null;

		};

		var bone = searchSkeleton( root.skeleton );

		if( bone ) {

			console.log( '  bone: ' + bone.name + '.' );
			return bone;

		}
	}

	// (3) search into node subtree.
	if( root.children ) {

		var searchNodeSubtree = function( children ) {

			for( var i = 0; i < children.length; i ++ ) {

				var childNode = children[i];

				if( childNode.name === nodeName || childNode.uuid === nodeName ) {

					return childNode;

				}

				var result = searchNodeSubtree( childNode.children );

				if( result ) return result;

			}

			return null;	

		};

		var subTreeNode = searchNodeSubtree( root.children );

		if( subTreeNode ) {

			console.log( '  node: ' + subTreeNode.name + '.' );
			return subTreeNode;

		}

	}

	console.log( "   <null>.  No node found for name: " + nodeName );

	return null;
}