Creates an instance of ngx htmlmesh.
an instance of BufferGeometry. Default is a new BufferGeometry.
A single or an array of Material. Default is a new MeshBasicMaterial
The constructor takes no arguments.
Creates eventDispatcher object. It needs to be call with '.call' to add the functionality to an object.
The default setting for .matrixAutoUpdate for newly created Object3Ds.
The default .up direction for objects, also used as the default position for DirectionalLight, HemisphereLight and Spotlight (which creates lights shining from the top down). Set to ( 0, 1, 0 ) by default.
Array with object's animation clips.
Whether the object gets rendered into shadow map. Default is false.
Array with object's children. See Group for info on manually grouping objects.
Custom depth material to be used when rendering to the depth map. Can only be used in context of meshes. When shadow-casting with a DirectionalLight or SpotLight, if you are modifying vertex positions in the vertex shader you must specify a customDepthMaterial for proper shadows. Default is undefined.
Same as .customDepthMaterial, but used with PointLight. Default is undefined.
When this is set, it checks every frame if the object is in the frustum of the camera before rendering the object. If set to false
the object gets rendered every frame even if it is not in the frustum of the camera. Default is true
.
An instance of BufferGeometry (or derived classes), defining the object's structure.
Unique number for this object instance.
Used to check whether this or derived classes are Object3Ds. Default is true. You should not change this, as it is used internally for optimisation.
An instance of material derived from the Material base class or an array of materials, defining the object's appearance. Default is a MeshBasicMaterial.
The local transform matrix.
When this is set, it calculates the matrix of position, (rotation or quaternion) and scale every frame and also recalculates the matrixWorld property. Default is Object3D.DefaultMatrixAutoUpdate (true).
The global transform of the object. If the Object3D has no parent, then it's identical to the local transform .matrix.
When this is set, it calculates the matrixWorld in that frame and resets this property to false. Default is false.
This is passed to the shader and used to calculate the position of the object.
A dictionary of morphTargets based on the morphTarget.name property. Undefined by default, but rebuilt updateMorphTargets.
An array of weights typically from 0-1 that specify how much of the morph is applied. Undefined by default, but reset to a blank array by updateMorphTargets.
Optional name of the object (doesn't need to be unique). Default is an empty string.
This is passed to the shader and used to calculate lighting for the object. It is the transpose of the inverse of the upper left 3x3 sub-matrix of this object's modelViewMatrix. The reason for this special matrix is that simply using the modelViewMatrix could result in a non-unit length of normals (on scaling) or in a non-perpendicular direction (on non-uniform scaling). On the other hand the translation part of the modelViewMatrix is not relevant for the calculation of normals. Thus a Matrix3 is sufficient.
Object's parent in the scene graph. An object can have at most one parent.
A Vector3 representing the object's local position. Default is (0, 0, 0).
Object's local rotation as a Quaternion.
Whether the material receives shadows. Default is false.
This value allows the default rendering order of scene graph objects to be overridden although opaque and transparent objects remain sorted independently. When this property is set for an instance of Group, all descendants objects will be sorted and rendered together. Sorting is from lowest to highest renderOrder. Default value is 0.
Object's local rotation (see Euler angles), in radians.
The object's local scale. Default is Vector3( 1, 1, 1 ).
This is used by the .lookAt method, for example, to determine the orientation of the result. Default is Object3D.DefaultUp - that is, ( 0, 1, 0 ).
An object that can be used to store custom data about the Object3D. It should not hold references to functions as these will not be cloned.
UUID of this object instance. This gets automatically assigned, so this shouldn't be edited.
Object gets rendered if true. Default is true.
The default setting for .matrixAutoUpdate for newly created Object3Ds.
The default .up direction for objects, also used as the default position for DirectionalLight, HemisphereLight and Spotlight (which creates lights shining from the top down). Set to ( 0, 1, 0 ) by default.
Array with object's animation clips.
Whether the object gets rendered into shadow map. Default is false.
Array with object's children. See Group for info on manually grouping objects.
Custom depth material to be used when rendering to the depth map. Can only be used in context of meshes. When shadow-casting with a DirectionalLight or SpotLight, if you are modifying vertex positions in the vertex shader you must specify a customDepthMaterial for proper shadows. Default is undefined.
Same as .customDepthMaterial, but used with PointLight. Default is undefined.
When this is set, it checks every frame if the object is in the frustum of the camera before rendering the object. If set to false
the object gets rendered every frame even if it is not in the frustum of the camera. Default is true
.
An instance of BufferGeometry (or derived classes), defining the object's structure.
Unique number for this object instance.
Used to check whether this or derived classes are Object3Ds. Default is true. You should not change this, as it is used internally for optimisation.
An instance of material derived from the Material base class or an array of materials, defining the object's appearance. Default is a MeshBasicMaterial.
The local transform matrix.
When this is set, it calculates the matrix of position, (rotation or quaternion) and scale every frame and also recalculates the matrixWorld property. Default is Object3D.DefaultMatrixAutoUpdate (true).
The global transform of the object. If the Object3D has no parent, then it's identical to the local transform .matrix.
When this is set, it calculates the matrixWorld in that frame and resets this property to false. Default is false.
This is passed to the shader and used to calculate the position of the object.
A dictionary of morphTargets based on the morphTarget.name property. Undefined by default, but rebuilt updateMorphTargets.
An array of weights typically from 0-1 that specify how much of the morph is applied. Undefined by default, but reset to a blank array by updateMorphTargets.
Optional name of the object (doesn't need to be unique). Default is an empty string.
This is passed to the shader and used to calculate lighting for the object. It is the transpose of the inverse of the upper left 3x3 sub-matrix of this object's modelViewMatrix. The reason for this special matrix is that simply using the modelViewMatrix could result in a non-unit length of normals (on scaling) or in a non-perpendicular direction (on non-uniform scaling). On the other hand the translation part of the modelViewMatrix is not relevant for the calculation of normals. Thus a Matrix3 is sufficient.
Object's parent in the scene graph. An object can have at most one parent.
A Vector3 representing the object's local position. Default is (0, 0, 0).
Object's local rotation as a Quaternion.
Whether the material receives shadows. Default is false.
This value allows the default rendering order of scene graph objects to be overridden although opaque and transparent objects remain sorted independently. When this property is set for an instance of Group, all descendants objects will be sorted and rendered together. Sorting is from lowest to highest renderOrder. Default value is 0.
Object's local rotation (see Euler angles), in radians.
The object's local scale. Default is Vector3( 1, 1, 1 ).
This is used by the .lookAt method, for example, to determine the orientation of the result. Default is Object3D.DefaultUp - that is, ( 0, 1, 0 ).
An object that can be used to store custom data about the Object3D. It should not hold references to functions as these will not be cloned.
UUID of this object instance. This gets automatically assigned, so this shouldn't be edited.
Object gets rendered if true. Default is true.
Adds object as child of this object. An arbitrary number of objects may be added. Any current parent on an object passed in here will be removed, since an object can have at most one parent. See Group for info on manually grouping objects.
Adds a listener to an event type.
The type of event to listen to.
The that gets called when the event is fired.
Applies the rotation represented by the quaternion to the object.
Adds object as a child of this, while maintaining the object's world transform. Note: This method does not support scene graphs having non-uniformly-scaled nodes(s).
Removes all child objects.
if true, descendants of the object are also cloned. Default is true.
Returns a clone of this object and optionally all descendants.
Copy the given object into this object. Note: event listeners and user-defined callbacks (.onAfterRender and .onBeforeRender) are not copied.
if true, descendants of the object are also copied. Default is true.
Fire an event type.
Note that ids are assigned in chronological order: 1, 2, 3, ..., incrementing by one for each new object.
Unique number of the object instance Searches through an object and its children, starting with the object itself, and returns the first with a matching id.
Searches through an object and its children, starting with the object itself, and returns the first with a matching name. Note that for most objects the name is an empty string by default. You will have to set it manually to make use of this method.
String to match to the children's Object3D.name property.
The result will be copied into this Quaternion.
Returns a quaternion representing the rotation of the object in world space.
Checks if listener is added to an event type.
The type of event to listen to.
The that gets called when the event is fired.
Optionally, the .x, .y and .z components of the world space position. Rotates the object to face a point in world space. This method does not support objects having non-uniformly-scaled parent(s).
A vector representing a position in world space.
An optional callback that is executed immediately after a 3D object is rendered. This function is called with the following parameters: renderer, scene, camera, geometry, material, group. Please notice that this callback is only executed for renderable 3D objects. Meaning 3D objects which define their visual appearance with geometries and materials like instances of Mesh, Line, Points or Sprite. Instances of Object3D, Group or Bone are not renderable and thus this callback is not executed for such objects.
An optional callback that is executed immediately before a 3D object is rendered. This function is called with the following parameters: renderer, scene, camera, geometry, material, group. Please notice that this callback is only executed for renderable 3D objects. Meaning 3D objects which define their visual appearance with geometries and materials like instances of Mesh, Line, Points or Sprite. Instances of Object3D, Group or Bone are not renderable and thus this callback is not executed for such objects.
Get intersections between a casted ray and this mesh. Raycaster.intersectObject will call this method, but the results are not ordered.
Removes object as child of this object. An arbitrary number of objects may be removed.
Removes a listener from an event type.
The type of the listener that gets removed.
The listener that gets removed.
Removes this object from its current parent.
Rotate an object along an axis in object space. The axis is assumed to be normalized.
Rotate an object along an axis in world space. The axis is assumed to be normalized. Method Assumes no rotated parent.
Rotates the object around x axis in local space.
The angle to rotate in radians.
Rotates the object around y axis in local space.
The angle to rotate in radians.
Rotates the object around z axis in local space.
The angle to rotate in radians.
Calls setFromAxisAngle( axis, angle ) on the .quaternion.
Calls setRotationFromEuler( euler) on the .quaternion.
Calls setFromRotationMatrix( m) on the .quaternion. Note that this assumes that the upper 3x3 of m is a pure rotation matrix (i.e, unscaled).
Copy the given quaternion into .quaternion.
normalized Quaternion
Translate an object by distance along an axis in object space. The axis is assumed to be normalized.
Translates object along x axis in object space by distance units.
Distance.
Translates object along y axis in object space by distance units.
Distance.
Translates object along z axis in object space by distance units.
Distance.
Like traverse, but the callback will only be executed for visible objects. Descendants of invisible objects are not traversed. Note: Modifying the scene graph inside the callback is discouraged.
A function with as first argument an object3D object.
Updates the local transform.
Updates the global transform of the object and its descendants.
Updates the morphTargets to have no influence on the object. Resets the morphTargetInfluences and morphTargetDictionary properties.
Updates the global transform of the object.
recursively updates global transform of ancestors.
recursively updates global transform of descendants.
Adds a listener to an event type.
The type of event to listen to.
The that gets called when the event is fired.
Applies the rotation represented by the quaternion to the object.
Fire an event type.
Note that ids are assigned in chronological order: 1, 2, 3, ..., incrementing by one for each new object.
Unique number of the object instance Searches through an object and its children, starting with the object itself, and returns the first with a matching id.
Searches through an object and its children, starting with the object itself, and returns the first with a matching name. Note that for most objects the name is an empty string by default. You will have to set it manually to make use of this method.
String to match to the children's Object3D.name property.
The result will be copied into this Quaternion.
Returns a quaternion representing the rotation of the object in world space.
Checks if listener is added to an event type.
The type of event to listen to.
The that gets called when the event is fired.
Optionally, the .x, .y and .z components of the world space position. Rotates the object to face a point in world space. This method does not support objects having non-uniformly-scaled parent(s).
A vector representing a position in world space.
An optional callback that is executed immediately after a 3D object is rendered. This function is called with the following parameters: renderer, scene, camera, geometry, material, group. Please notice that this callback is only executed for renderable 3D objects. Meaning 3D objects which define their visual appearance with geometries and materials like instances of Mesh, Line, Points or Sprite. Instances of Object3D, Group or Bone are not renderable and thus this callback is not executed for such objects.
An optional callback that is executed immediately before a 3D object is rendered. This function is called with the following parameters: renderer, scene, camera, geometry, material, group. Please notice that this callback is only executed for renderable 3D objects. Meaning 3D objects which define their visual appearance with geometries and materials like instances of Mesh, Line, Points or Sprite. Instances of Object3D, Group or Bone are not renderable and thus this callback is not executed for such objects.
Get intersections between a casted ray and this mesh. Raycaster.intersectObject will call this method, but the results are not ordered.
Removes a listener from an event type.
The type of the listener that gets removed.
The listener that gets removed.
Calls setFromAxisAngle( axis, angle ) on the .quaternion.
Calls setRotationFromEuler( euler) on the .quaternion.
Calls setFromRotationMatrix( m) on the .quaternion. Note that this assumes that the upper 3x3 of m is a pure rotation matrix (i.e, unscaled).
Copy the given quaternion into .quaternion.
normalized Quaternion
Like traverse, but the callback will only be executed for visible objects. Descendants of invisible objects are not traversed. Note: Modifying the scene graph inside the callback is discouraged.
A function with as first argument an object3D object.
Updates the local transform.
Updates the global transform of the object and its descendants.
Updates the morphTargets to have no influence on the object. Resets the morphTargetInfluences and morphTargetDictionary properties.
Updates the global transform of the object.
recursively updates global transform of ancestors.
recursively updates global transform of descendants.
Generated using TypeDoc
HTMLMesh mesh
See the ngx3js docs page for details. See the ngx mesh page for a live demo.