/** * @author mrdoob / http://mrdoob.com/ * @author mikael emtinger / http://gomo.se/ * @author alteredq / http://alteredqualia.com/ * @author WestLangley / http://github.com/WestLangley */ THREE.Object3D = function () { this.id = THREE.Object3DIdCount ++; this.name = ''; 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.userData = {}; }; THREE.Object3D.prototype = { constructor: THREE.Object3D, applyMatrix: function () { var m1 = new THREE.Matrix4(); return function ( matrix ) { this.matrix.multiplyMatrices( matrix, this.matrix ); this.position.getPositionFromMatrix( this.matrix ); this.scale.getScaleFromMatrix( this.matrix ); m1.copyRotation( this.matrix ); if ( this.useQuaternion === true ) { this.quaternion.setFromRotationMatrix( m1 ); } else { this.rotation.setEulerFromRotationMatrix( m1, this.eulerOrder ); } } }(), rotateOnAxis: function() { // rotate object on axis in object space // axis is assumed to be normalized var q1 = new THREE.Quaternion(); var q2 = new THREE.Quaternion(); return function ( axis, angle ) { q1.setFromAxisAngle( axis, angle ); if ( this.useQuaternion === true ) { this.quaternion.multiply( q1 ); } else { q2.setFromEuler( this.rotation, this.eulerOrder ); q2.multiply( q1 ); this.rotation.setEulerFromQuaternion( q2, this.eulerOrder ); } return this; } }(), translateOnAxis: function () { // translate object by distance along axis in object space // axis is assumed to be normalized var v1 = new THREE.Vector3(); return function ( axis, distance ) { v1.copy( axis ); if ( this.useQuaternion === true ) { v1.applyQuaternion( this.quaternion ); } else { v1.applyEuler( this.rotation, this.eulerOrder ); } this.position.add( v1.multiplyScalar( distance ) ); return this; } }(), translate: function ( distance, axis ) { console.warn( 'DEPRECATED: Object3D\'s .translate() has been removed. Use .translateOnAxis( axis, distance ) instead. Note args have been changed.' ); return this.translateOnAxis( axis, distance ); }, translateX: function () { var v1 = new THREE.Vector3( 1, 0, 0 ); return function ( distance ) { return this.translateOnAxis( v1, distance ); }; }(), translateY: function () { var v1 = new THREE.Vector3( 0, 1, 0 ); return function ( distance ) { return this.translateOnAxis( v1, distance ); }; }(), translateZ: function () { var v1 = new THREE.Vector3( 0, 0, 1 ); return function ( distance ) { return this.translateOnAxis( v1, distance ); }; }(), localToWorld: function ( vector ) { return vector.applyMatrix4( this.matrixWorld ); }, worldToLocal: function () { var m1 = new THREE.Matrix4(); return function ( vector ) { return vector.applyMatrix4( m1.getInverse( this.matrixWorld ) ); }; }(), lookAt: function () { // This routine does not support objects with rotated and/or translated parent(s) var m1 = new THREE.Matrix4(); return function ( vector ) { m1.lookAt( vector, this.position, this.up ); if ( this.useQuaternion === true ) { this.quaternion.setFromRotationMatrix( m1 ); } else { this.rotation.setEulerFromRotationMatrix( m1, this.eulerOrder ); } }; }(), 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.multiplyMatrices( 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.defaultEulerOrder = 'XYZ', THREE.Object3DIdCount = 0;