Scene class / three Library / Dart Documentation

Scene class

@author mr.doob / http://mrdoob.com/

Ported to Dart from JS by: @author rob silverton / http://www.unwrong.com/

class Scene extends Object3D {
 Fog fog;
 Material overrideMaterial;
 //bool matrixAutoUpdate;
 List<Object3D> objects;
 List<Light> lights;
 List __objectsAdded;
 List __objectsRemoved;

 Scene() {
   // TODO: check how to call super constructor
   // super();

   fog = null;
   overrideMaterial = null;

   matrixAutoUpdate = false;

   objects = [];
   lights = [];

   __objectsAdded = [];
   __objectsRemoved = [];
 }

 void addObject( Object3D object ) {
   if ( object is Light ) {
     if ( lights.indexOf( object ) == - 1 ) {
       lights.add( object );
     }
   } else if ( !( object is Camera || object is Bone ) ) {
     if ( objects.indexOf( object ) == - 1 ) {
       objects.add( object );
       __objectsAdded.add( object );

       // check if previously removed
       int i = __objectsRemoved.indexOf( object );

       if ( i != -1 ) {
         __objectsRemoved.removeAt(i);
       }
     }
   }

   for ( int c = 0; c < object.children.length; c ++ ) {
     addObject( object.children[ c ] );
   }
 }

 void removeObject( Object3D object ) {
   //TODO: "instanceof" replaced by "is"?
   if ( object is Light ) {
     int i = lights.indexOf( object );

     if ( i != -1 ) {
       lights.removeAt(i);
     }
   } else if ( !( object is Camera ) ) {
     int i = objects.indexOf( object );

     if( i != -1 ) {
       objects.removeAt(i);
       __objectsRemoved.add( object );

       // check if previously added
       var ai = __objectsAdded.indexOf( object );

       if ( ai != -1 ) {
         __objectsAdded.removeAt(ai);
       }
     }
   }

   for ( int c = 0; c < object.children.length; c ++ ) {
     removeObject( object.children[ c ] );
   }
 }
}

Extends

Object3D > Scene

Constructors

new Scene() #

Creates a new Object instance.

Object instances have no meaningful state, and are only useful through their identity. An Object instance is equal to itself only.

docs inherited from Object

Scene() {
 // TODO: check how to call super constructor
 // super();

 fog = null;
 overrideMaterial = null;

 matrixAutoUpdate = false;

 objects = [];
 lights = [];

 __objectsAdded = [];
 __objectsRemoved = [];
}

Properties

num boundRadius #

inherited from Object3D

num boundRadius

num boundRadiusScale #

inherited from Object3D

num boundRadius, boundRadiusScale

bool castShadow #

inherited from Object3D

bool visible = false, castShadow = false

List children #

inherited from Object3D

List children

var customDepthMaterial #

inherited from Object3D

var customDepthMaterial

bool doubleSided #

inherited from Object3D

bool _dynamic, doubleSided

String eulerOrder #

inherited from Object3D

String eulerOrder

bool flipSided #

inherited from Object3D

bool _dynamic, doubleSided, flipSided

Fog fog #

Fog fog

bool frustumCulled #

inherited from Object3D

bool visible = false, castShadow = false, receiveShadow = false, frustumCulled = false

int id #

inherited from Object3D

int id

bool isDynamic #

inherited from Object3D

bool get isDynamic => _dynamic;

set isDynamic(bool flag) => _dynamic = flag;

List<Light> lights #

List<Light> lights

Matrix4 matrix #

inherited from Object3D

Matrix4 matrix

bool matrixAutoUpdate #

inherited from Object3D

bool matrixAutoUpdate = false

Matrix4 matrixRotationWorld #

inherited from Object3D

Matrix4 matrix, matrixWorld, matrixRotationWorld

Matrix4 matrixWorld #

inherited from Object3D

Matrix4 matrix, matrixWorld

bool matrixWorldNeedsUpdate #

inherited from Object3D

bool matrixAutoUpdate = false, matrixWorldNeedsUpdate = false

String name #

inherited from Object3D

String name

List<Object3D> objects #

List<Object3D> objects

Material overrideMaterial #

Material overrideMaterial

Object3D parent #

inherited from Object3D

Object3D parent

Vector3 position #

inherited from Object3D

Vector3 up, position

Map properties #

inherited from Object3D

Map properties

var quaternion #

inherited from Object3D

var quaternion

bool receiveShadow #

inherited from Object3D

bool visible = false, castShadow = false, receiveShadow = false

int renderDepth #

inherited from Object3D

int renderDepth

Vector3 rotation #

inherited from Object3D

Vector3 up, position, rotation

bool rotationAutoUpdate #

inherited from Object3D

bool _dynamic, doubleSided, flipSided, rotationAutoUpdate

Vector3 scale #

inherited from Object3D

Vector3 up, position, rotation, scale

Vector3 up #

inherited from Object3D

Vector3 up

bool useQuaternion #

inherited from Object3D

bool useQuaternion

bool visible #

inherited from Object3D

bool visible = false

Operators

dynamic operator [](String key) #

inherited from Object3D

operator [] (String key) => _data[key];

dynamic operator []=(String key, value) #

inherited from Object3D

operator []= (String key, value) => _data[key] = value;

Methods

void add(Object3D object) #

inherited from Object3D

void add( Object3D object ) {
 if ( object == this ) {
   print( 'THREE.Object3D.add: An object can\'t be added as a child of itself.' );
   return;
 }


 if ( object.parent != null ) {
   object.parent.remove( object );
 }

 object.parent = this;
 children.add( object );

 // add to scene
 Object3D scene = this;

 while ( scene.parent != null ) {
   scene = scene.parent;
 }

 if ( scene is Scene ) {
   scene.addObject( object );
 }

}

void addObject(Object3D object) #

void addObject( Object3D object ) {
 if ( object is Light ) {
   if ( lights.indexOf( object ) == - 1 ) {
     lights.add( object );
   }
 } else if ( !( object is Camera || object is Bone ) ) {
   if ( objects.indexOf( object ) == - 1 ) {
     objects.add( object );
     __objectsAdded.add( object );

     // check if previously removed
     int i = __objectsRemoved.indexOf( object );

     if ( i != -1 ) {
       __objectsRemoved.removeAt(i);
     }
   }
 }

 for ( int c = 0; c < object.children.length; c ++ ) {
   addObject( object.children[ c ] );
 }
}

void applyMatrix(Matrix4 matrix) #

inherited from Object3D

void applyMatrix ( Matrix4 matrix ) {
 this.matrix = matrix * this.matrix;

 this.scale = getScaleFromMatrix( this.matrix );

 Matrix4 mat = extractRotation(new Matrix4.identity(), this.matrix );
 this.rotation = calcEulerFromRotationMatrix( mat, this.eulerOrder );

 this.position = this.matrix.getTranslation();
}

dynamic clone() #

inherited from Object3D

clone() {

 // TODO

}

Object3D getChildByName(String name, bool doRecurse) #

inherited from Object3D

Object3D getChildByName( String name, bool doRecurse ) {
 int c;
 int cl = children.length;
 Object3D child, recurseResult;

 children.forEach((child){

   if ( child.name == name ) {
     return child;
   }

   if ( doRecurse ) {
     recurseResult = child.getChildByName( name, doRecurse );

     if ( recurseResult != null ) {
       return recurseResult;
     }
   }
 });

 return null;
}

dynamic localToWorld(Vector3 vector) #

inherited from Object3D

localToWorld(Vector3 vector) => vector.applyProjection(matrixWorld);

void lookAt(Vector3 vector) #

inherited from Object3D

void lookAt( Vector3 vector ) {
 // TODO: Add hierarchy support.

 makeLookAt( matrix, vector, position, up );

 if ( rotationAutoUpdate ) {
   if(useQuaternion)
     quaternion.setFromRotationMatrix(matrix);
   else
     rotation = calcEulerFromRotationMatrix( matrix, eulerOrder );
 }
}

void remove(Object3D object) #

inherited from Object3D

void remove( Object3D object ) {

 int index = children.indexOf( object );

 if ( index != - 1 ){

   object.parent = null;
   children.removeAt(index);

   // remove from scene
   Object3D scene = this;

   while ( scene.parent != null ) {
     scene = scene.parent;
   }

   if (scene is Scene ) {
     scene.removeObject( object );
   }
 }
}

void removeObject(Object3D object) #

void removeObject( Object3D object ) {
 //TODO: "instanceof" replaced by "is"?
 if ( object is Light ) {
   int i = lights.indexOf( object );

   if ( i != -1 ) {
     lights.removeAt(i);
   }
 } else if ( !( object is Camera ) ) {
   int i = objects.indexOf( object );

   if( i != -1 ) {
     objects.removeAt(i);
     __objectsRemoved.add( object );

     // check if previously added
     var ai = __objectsAdded.indexOf( object );

     if ( ai != -1 ) {
       __objectsAdded.removeAt(ai);
     }
   }
 }

 for ( int c = 0; c < object.children.length; c ++ ) {
   removeObject( object.children[ c ] );
 }
}

void translate(num distance, Vector3 axis) #

inherited from Object3D

void translate( num distance, Vector3 axis ) {
 matrix.rotate3( axis );
 axis.normalize();
 position.add( axis.scale( distance ) );
}

void translateX(num distance) #

inherited from Object3D

void translateX( num distance ) => translate( distance, _vector.setValues( 1.0, 0.0, 0.0 ) );

void translateY(num distance) #

inherited from Object3D

void translateY( num distance ) => translate( distance, _vector.setValues( 0.0, 1.0, 0.0 ) );

void translateZ(num distance) #

inherited from Object3D

void translateZ( num distance ) => translate( distance, _vector.setValues( 0.0, 0.0, 1.0 ) );

void updateMatrix() #

inherited from Object3D

void updateMatrix() {

 if ( useQuaternion ) {
   setRotationFromQuaternion( matrix, quaternion );
 } else {
   setRotationFromEuler( matrix, rotation, eulerOrder );
 }

 matrix.setTranslation( position );

 if ( scale.x != 1.0 || scale.y != 1.0 || scale.z != 1.0 ) {
   matrix.scale( scale );
   boundRadiusScale = Math.max( scale.x, Math.max( scale.y, scale.z ) );
 }

 matrixWorldNeedsUpdate = true;
}

void updateMatrixWorld({bool force: false}) #

inherited from Object3D

void updateMatrixWorld( {bool force: false} ) {

if (matrixAutoUpdate) updateMatrix();

 // update matrixWorld
 if ( matrixWorldNeedsUpdate || force ) {
   if ( parent != null ) {
     matrixWorld = parent.matrixWorld * matrix;
   } else {
     matrixWorld = matrix.clone();
   }

   matrixWorldNeedsUpdate = false;

   force = true;
 }

 // update children
 children.forEach((c) => c.updateMatrixWorld( force: force ) );

}

dynamic worldToLocal(Vector3 vector) #

inherited from Object3D

worldToLocal(Vector3 vector) {
 Matrix4 m = this.matrixWorld.clone();
 m.invert();
 m.transform3( vector );
}

Scene class

Extends

Constructors

Code new Scene() #

Properties

Code num boundRadius #

Code num boundRadiusScale #

Code bool castShadow #

Code List children #

Code var customDepthMaterial #

Code bool doubleSided #

Code String eulerOrder #

Code bool flipSided #

Code Fog fog #

Code bool frustumCulled #

Code int id #

Code bool isDynamic #

Code List<Light> lights #

Code Matrix4 matrix #

Code bool matrixAutoUpdate #

Code Matrix4 matrixRotationWorld #

Code Matrix4 matrixWorld #

Code bool matrixWorldNeedsUpdate #

Code String name #

Code List<Object3D> objects #

Code Material overrideMaterial #

Code Object3D parent #

Code Vector3 position #

Code Map properties #

Code var quaternion #

Code bool receiveShadow #

Code int renderDepth #

Code Vector3 rotation #

Code bool rotationAutoUpdate #

Code Vector3 scale #

Code Vector3 up #

Code bool useQuaternion #

Code bool visible #

Operators

Code dynamic operator [](String key) #

Code dynamic operator []=(String key, value) #

Methods

Code void add(Object3D object) #

Code void addObject(Object3D object) #

Code void applyMatrix(Matrix4 matrix) #

Code dynamic clone() #

Code Object3D getChildByName(String name, bool doRecurse) #

Code dynamic localToWorld(Vector3 vector) #

Code void lookAt(Vector3 vector) #

Code void remove(Object3D object) #

Code void removeObject(Object3D object) #

Code void translate(num distance, Vector3 axis) #

Code void translateX(num distance) #

Code void translateY(num distance) #

Code void translateZ(num distance) #

Code void updateMatrix() #

Code void updateMatrixWorld({bool force: false}) #

Code dynamic worldToLocal(Vector3 vector) #

new Scene() #

num boundRadius #

num boundRadiusScale #

bool castShadow #

List children #

var customDepthMaterial #

bool doubleSided #

String eulerOrder #

bool flipSided #

Fog fog #

bool frustumCulled #

int id #

bool isDynamic #

List<Light> lights #

Matrix4 matrix #

bool matrixAutoUpdate #

Matrix4 matrixRotationWorld #

Matrix4 matrixWorld #

bool matrixWorldNeedsUpdate #

String name #

List<Object3D> objects #

Material overrideMaterial #

Object3D parent #

Vector3 position #

Map properties #

var quaternion #

bool receiveShadow #

int renderDepth #

Vector3 rotation #

bool rotationAutoUpdate #

Vector3 scale #

Vector3 up #

bool useQuaternion #

bool visible #

dynamic operator [](String key) #

dynamic operator []=(String key, value) #

void add(Object3D object) #

void addObject(Object3D object) #

void applyMatrix(Matrix4 matrix) #

dynamic clone() #

Object3D getChildByName(String name, bool doRecurse) #

dynamic localToWorld(Vector3 vector) #

void lookAt(Vector3 vector) #

void remove(Object3D object) #

void removeObject(Object3D object) #

void translate(num distance, Vector3 axis) #

void translateX(num distance) #

void translateY(num distance) #

void translateZ(num distance) #

void updateMatrix() #

void updateMatrixWorld({bool force: false}) #

dynamic worldToLocal(Vector3 vector) #