/** * @author mrdoob / http://mrdoob.com/ * @author mikael emtinger / http://gomo.se/ * @author alteredq / http://alteredqualia.com/ */ THREE.Object3D = function () { this.id = THREE.Object3DIdCount ++; this.name = ''; this.properties = {}; this.parent = undefined; this.children = []; this.up = new THREE.Vector3( 0, 1, 0 ); this.position = new THREE.Vector3(); this.rotation = new THREE.Vector3(); this.eulerOrder = THREE.Object3D.defaultEulerOrder; this.scale = new THREE.Vector3( 1, 1, 1 ); this.renderDepth = null; this.rotationAutoUpdate = true; this.matrix = new THREE.Matrix4(); this.matrixWorld = new THREE.Matrix4(); this.matrixRotationWorld = new THREE.Matrix4(); this.matrixAutoUpdate = true; this.matrixWorldNeedsUpdate = true; this.quaternion = new THREE.Quaternion(); this.useQuaternion = false; this.visible = true; this.castShadow = false; this.receiveShadow = false; this.frustumCulled = true; this._vector = new THREE.Vector3(); }; THREE.Object3D.prototype = { constructor: THREE.Object3D, applyMatrix: function ( matrix ) { this.matrix.multiply( matrix, this.matrix ); this.scale.getScaleFromMatrix( this.matrix ); var mat = new THREE.Matrix4().extractRotation( this.matrix ); this.rotation.setEulerFromRotationMatrix( mat, this.eulerOrder ); this.position.getPositionFromMatrix( this.matrix ); }, translate: function ( distance, axis ) { this.matrix.rotateAxis( axis ); this.position.addSelf( axis.multiplyScalar( distance ) ); }, translateX: function ( distance ) { this.translate( distance, this._vector.set( 1, 0, 0 ) ); }, translateY: function ( distance ) { this.translate( distance, this._vector.set( 0, 1, 0 ) ); }, translateZ: function ( distance ) { this.translate( distance, this._vector.set( 0, 0, 1 ) ); }, localToWorld: function ( vector ) { return vector.multiplyMatrix4( this.matrixWorld ); }, worldToLocal: function ( vector ) { return vector.multiplyMatrix4( THREE.Object3D.__m1.getInverse( this.matrixWorld ) ); }, lookAt: function ( vector ) { // TODO: Add hierarchy support. this.matrix.lookAt( vector, this.position, this.up ); if ( this.rotationAutoUpdate ) { if ( this.useQuaternion === false ) { this.rotation.setEulerFromRotationMatrix( this.matrix, this.eulerOrder ); } else { this.quaternion.copy( this.matrix.decompose()[ 1 ] ); } } }, add: function ( object ) { if ( object === this ) { console.warn( 'THREE.Object3D.add: An object can\'t be added as a child of itself.' ); return; } if ( object instanceof THREE.Object3D ) { if ( object.parent !== undefined ) { object.parent.remove( object ); } object.parent = this; this.children.push( object ); // add to scene var scene = this; while ( scene.parent !== undefined ) { scene = scene.parent; } if ( scene !== undefined && scene instanceof THREE.Scene ) { scene.__addObject( object ); } } }, remove: function ( object ) { var index = this.children.indexOf( object ); if ( index !== - 1 ) { object.parent = undefined; this.children.splice( index, 1 ); // remove from scene var scene = this; while ( scene.parent !== undefined ) { scene = scene.parent; } if ( scene !== undefined && scene instanceof THREE.Scene ) { scene.__removeObject( object ); } } }, traverse: function ( callback ) { callback( this ); for ( var i = 0, l = this.children.length; i < l; i ++ ) { this.children[ i ].traverse( callback ); } }, getChildByName: function ( name, recursive ) { for ( var i = 0, l = this.children.length; i < l; i ++ ) { var child = this.children[ i ]; if ( child.name === name ) { return child; } if ( recursive === true ) { child = child.getChildByName( name, recursive ); if ( child !== undefined ) { return child; } } } return undefined; }, getDescendants: function ( array ) { if ( array === undefined ) array = []; Array.prototype.push.apply( array, this.children ); for ( var i = 0, l = this.children.length; i < l; i ++ ) { this.children[ i ].getDescendants( array ); } return array; }, updateMatrix: function () { this.matrix.setPosition( this.position ); if ( this.useQuaternion === false ) { this.matrix.setRotationFromEuler( this.rotation, this.eulerOrder ); } else { this.matrix.setRotationFromQuaternion( this.quaternion ); } if ( this.scale.x !== 1 || this.scale.y !== 1 || this.scale.z !== 1 ) { this.matrix.scale( this.scale ); } this.matrixWorldNeedsUpdate = true; }, updateMatrixWorld: function ( force ) { if ( this.matrixAutoUpdate === true ) this.updateMatrix(); if ( this.matrixWorldNeedsUpdate === true || force === true ) { if ( this.parent === undefined ) { this.matrixWorld.copy( this.matrix ); } else { this.matrixWorld.multiply( this.parent.matrixWorld, this.matrix ); } this.matrixWorldNeedsUpdate = false; force = true; } // update children for ( var i = 0, l = this.children.length; i < l; i ++ ) { this.children[ i ].updateMatrixWorld( force ); } }, clone: function ( object ) { if ( object === undefined ) object = new THREE.Object3D(); object.name = this.name; object.up.copy( this.up ); object.position.copy( this.position ); if ( object.rotation instanceof THREE.Vector3 ) object.rotation.copy( this.rotation ); // because of Sprite madness object.eulerOrder = this.eulerOrder; object.scale.copy( this.scale ); object.renderDepth = this.renderDepth; object.rotationAutoUpdate = this.rotationAutoUpdate; object.matrix.copy( this.matrix ); object.matrixWorld.copy( this.matrixWorld ); object.matrixRotationWorld.copy( this.matrixRotationWorld ); object.matrixAutoUpdate = this.matrixAutoUpdate; object.matrixWorldNeedsUpdate = this.matrixWorldNeedsUpdate; object.quaternion.copy( this.quaternion ); object.useQuaternion = this.useQuaternion; object.visible = this.visible; object.castShadow = this.castShadow; object.receiveShadow = this.receiveShadow; object.frustumCulled = this.frustumCulled; for ( var i = 0; i < this.children.length; i ++ ) { var child = this.children[ i ]; object.add( child.clone() ); } return object; } }; THREE.Object3D.__m1 = new THREE.Matrix4(); THREE.Object3D.defaultEulerOrder = 'XYZ', THREE.Object3DIdCount = 0;