Mesh class / three Library / Dart Documentation

Mesh class

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

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

class Mesh extends Object3D {
 Geometry geometry;
 Material material;

 num morphTargetBase = 0;
 List morphTargetForcedOrder;
 List morphTargetInfluences;
 Map _morphTargetDictionary;

 Mesh( this.geometry, [this.material] ) : super() {

   if (material == null) {
     material = new MeshBasicMaterial( color: new Math.Random().nextInt(0xffffff), wireframe: true );
   }
   if ( geometry != null ) {
     // calc bound radius
     if( geometry.boundingSphere == null ) {
       geometry.computeBoundingSphere();
     }

     boundRadius = geometry.boundingSphere.radius;


     // setup morph targets
     if( geometry.morphTargets.length != 0 ) {
       morphTargetBase = -1;
       morphTargetForcedOrder = [];
       morphTargetInfluences = [];
       _morphTargetDictionary = {};

       for( int m = 0; m < geometry.morphTargets.length; m ++ ) {
         morphTargetInfluences.add( 0.0 );
         _morphTargetDictionary[ geometry.morphTargets[ m ].name ] = m;
       }
     }
   }
 }

 /*
  * Get Morph Target Index by Name
  */
 num getMorphTargetIndexByName( name ) {
   if ( _morphTargetDictionary[ name ] != null ) {
     return _morphTargetDictionary[ name ];
   }

   print( "THREE.Mesh.getMorphTargetIndexByName: morph target $name does not exist. Returning 0." );
   return 0;
 }
}

Extends

Object3D > Mesh

Subclasses

MorphAnimMesh, SkinnedMesh

Constructors

new Mesh(Geometry geometry, [Material material]) #

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

Mesh( this.geometry, [this.material] ) : super() {

 if (material == null) {
   material = new MeshBasicMaterial( color: new Math.Random().nextInt(0xffffff), wireframe: true );
 }
 if ( geometry != null ) {
   // calc bound radius
   if( geometry.boundingSphere == null ) {
     geometry.computeBoundingSphere();
   }

   boundRadius = geometry.boundingSphere.radius;


   // setup morph targets
   if( geometry.morphTargets.length != 0 ) {
     morphTargetBase = -1;
     morphTargetForcedOrder = [];
     morphTargetInfluences = [];
     _morphTargetDictionary = {};

     for( int m = 0; m < geometry.morphTargets.length; m ++ ) {
       morphTargetInfluences.add( 0.0 );
       _morphTargetDictionary[ geometry.morphTargets[ m ].name ] = m;
     }
   }
 }
}

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

bool frustumCulled #

inherited from Object3D

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

Geometry geometry #

Geometry geometry

int id #

inherited from Object3D

int id

bool isDynamic #

inherited from Object3D

bool get isDynamic => _dynamic;

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

Material material #

Material material

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

num morphTargetBase #

num morphTargetBase = 0

List morphTargetForcedOrder #

List morphTargetForcedOrder

List morphTargetInfluences #

List morphTargetInfluences

String name #

inherited from Object3D

String name

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 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;
}

num getMorphTargetIndexByName(name) #

num getMorphTargetIndexByName( name ) {
 if ( _morphTargetDictionary[ name ] != null ) {
   return _morphTargetDictionary[ name ];
 }

 print( "THREE.Mesh.getMorphTargetIndexByName: morph target $name does not exist. Returning 0." );
 return 0;
}

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 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 );
}

Mesh class

Extends

Subclasses

Constructors

Code new Mesh(Geometry geometry, [Material material]) #

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 bool frustumCulled #

Code Geometry geometry #

Code int id #

Code bool isDynamic #

Code Material material #

Code Matrix4 matrix #

Code bool matrixAutoUpdate #

Code Matrix4 matrixRotationWorld #

Code Matrix4 matrixWorld #

Code bool matrixWorldNeedsUpdate #

Code num morphTargetBase #

Code List morphTargetForcedOrder #

Code List morphTargetInfluences #

Code String name #

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

Code dynamic clone() #

Code Object3D getChildByName(String name, bool doRecurse) #

Code num getMorphTargetIndexByName(name) #

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 Mesh(Geometry geometry, [Material material]) #

num boundRadius #

num boundRadiusScale #

bool castShadow #

List children #

var customDepthMaterial #

bool doubleSided #

String eulerOrder #

bool flipSided #

bool frustumCulled #

Geometry geometry #

int id #

bool isDynamic #

Material material #

Matrix4 matrix #

bool matrixAutoUpdate #

Matrix4 matrixRotationWorld #

Matrix4 matrixWorld #

bool matrixWorldNeedsUpdate #

num morphTargetBase #

List morphTargetForcedOrder #

List morphTargetInfluences #

String name #

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

dynamic clone() #

Object3D getChildByName(String name, bool doRecurse) #

num getMorphTargetIndexByName(name) #

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