Camera class / three Library / Dart Documentation

Camera class

@author mr.doob / http://mrdoob.com/ @author mikael emtinger / http://gomo.se

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

class Camera extends Object3D {
 Matrix4 matrixWorldInverse;
 Matrix4 projectionMatrix;
 Matrix4 projectionMatrixInverse;

 double near;
 double far;

 Camera(this.near, this.far)
   : matrixWorldInverse = new Matrix4.identity(),
     projectionMatrix = new Matrix4.identity(),
     projectionMatrixInverse = new Matrix4.identity(),
     super();

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

   makeLookAt(matrix, position, vector, up);

   if ( rotationAutoUpdate ) {
     rotation = calcEulerFromRotationMatrix( matrix, eulerOrder );
   }
 }
}

Extends

Object3D > Camera

Subclasses

OrthographicCamera, PerspectiveCamera

Constructors

new Camera(double near, double far) #

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

Camera(this.near, this.far)
 : matrixWorldInverse = new Matrix4.identity(),
   projectionMatrix = new Matrix4.identity(),
   projectionMatrixInverse = new Matrix4.identity(),
   super();

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

double far #

double far

bool flipSided #

inherited from Object3D

bool _dynamic, doubleSided, flipSided

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;

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

Matrix4 matrixWorldInverse #

Matrix4 matrixWorldInverse

bool matrixWorldNeedsUpdate #

inherited from Object3D

bool matrixAutoUpdate = false, matrixWorldNeedsUpdate = false

String name #

inherited from Object3D

String name

double near #

double near

Object3D parent #

inherited from Object3D

Object3D parent

Vector3 position #

inherited from Object3D

Vector3 up, position

Matrix4 projectionMatrix #

Matrix4 projectionMatrix

Matrix4 projectionMatrixInverse #

Matrix4 projectionMatrixInverse

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 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) #

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

 makeLookAt(matrix, position, vector, up);

 if ( rotationAutoUpdate ) {
   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 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 );
}

Camera class

Extends

Subclasses

Constructors

Code new Camera(double near, double far) #

Properties

Code num boundRadius #

Code num boundRadiusScale #

Code bool castShadow #

Code List children #

Code var customDepthMaterial #

Code bool doubleSided #

Code String eulerOrder #

Code double far #

Code bool flipSided #

Code bool frustumCulled #

Code int id #

Code bool isDynamic #

Code Matrix4 matrix #

Code bool matrixAutoUpdate #

Code Matrix4 matrixRotationWorld #

Code Matrix4 matrixWorld #

Code Matrix4 matrixWorldInverse #

Code bool matrixWorldNeedsUpdate #

Code String name #

Code double near #

Code Object3D parent #

Code Vector3 position #

Code Matrix4 projectionMatrix #

Code Matrix4 projectionMatrixInverse #

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 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 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 Camera(double near, double far) #

num boundRadius #

num boundRadiusScale #

bool castShadow #

List children #

var customDepthMaterial #

bool doubleSided #

String eulerOrder #

double far #

bool flipSided #

bool frustumCulled #

int id #

bool isDynamic #

Matrix4 matrix #

bool matrixAutoUpdate #

Matrix4 matrixRotationWorld #

Matrix4 matrixWorld #

Matrix4 matrixWorldInverse #

bool matrixWorldNeedsUpdate #

String name #

double near #

Object3D parent #

Vector3 position #

Matrix4 projectionMatrix #

Matrix4 projectionMatrixInverse #

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 applyMatrix(Matrix4 matrix) #

dynamic clone() #

Object3D getChildByName(String name, bool doRecurse) #

dynamic localToWorld(Vector3 vector) #

void lookAt(Vector3 vector) #

void remove(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) #