AbstractMesh

Class used to store all common mesh properties

Hierarchy

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Find examples in Playground

Properties

absolutePosition

Find examples in Playground
absolutePosition: Vector3

Returns the current mesh absolute position. Returns a Vector3.

actionManager

Find examples in Playground
actionManager: Nullable<ActionManager>

Gets or sets the current action manager

see

http://doc.babylonjs.com/how_to/how_to_use_actions

alphaIndex

Find examples in Playground
alphaIndex: number

Gets or sets the alpha index used to sort transparent meshes

see

http://doc.babylonjs.com/resources/transparency_and_how_meshes_are_rendered#alpha-index

alwaysSelectAsActiveMesh

Find examples in Playground
alwaysSelectAsActiveMesh: boolean

True if the mesh must be rendered in any case (this will shortcut the frustum clipping phase)

animationPropertiesOverride

Find examples in Playground
animationPropertiesOverride: Nullable<AnimationPropertiesOverride>

Gets or sets the animation properties override

animations

Find examples in Playground
animations: Animation[]

Gets a list of Animations associated with the node

applyFog

Find examples in Playground
applyFog: boolean

Gets or sets a boolean indicating that this mesh will allow fog to be rendered on it (true by default)

behaviors

Find examples in Playground
behaviors: Behavior<Node>[]

Gets the list of attached behaviors

see

http://doc.babylonjs.com/features/behaviour

billboardMode

Find examples in Playground
billboardMode: number

Set the billboard mode. Default is 0.

Value Type Description
0 BILLBOARDMODE_NONE
1 BILLBOARDMODE_X
2 BILLBOARDMODE_Y
4 BILLBOARDMODE_Z
7 BILLBOARDMODE_ALL

checkCollisions

Find examples in Playground
checkCollisions: boolean

Gets or sets a boolean indicating that this mesh can be used in the collision engine

see

http://doc.babylonjs.com/babylon101/cameras,_mesh_collisions_and_gravity

collider

Find examples in Playground
collider: Collider

Gets Collider object used to compute collisions (not physics)

see

http://doc.babylonjs.com/babylon101/cameras,_mesh_collisions_and_gravity

collisionGroup

Find examples in Playground
collisionGroup: number

Gets or sets the current collision group mask (-1 by default). A collision between A and B will happen if A.collisionGroup & b.collisionMask !== 0

collisionMask

Find examples in Playground
collisionMask: number

Gets or sets a collision mask used to mask collisions (default is -1). A collision between A and B will happen if A.collisionGroup & b.collisionMask !== 0

computeBonesUsingShaders

Find examples in Playground
computeBonesUsingShaders: boolean

Gets or sets a boolean indicating that bone animations must be computed by the CPU (false by default)

cullingStrategy

Find examples in Playground
cullingStrategy: number

Gets ot sets the culling strategy to use to find visible meshes

definedFacingForward

Find examples in Playground
definedFacingForward: boolean

Gets or sets the orientation for POV movement & rotation

doNotSerialize

Find examples in Playground
doNotSerialize: boolean

Gets or sets a boolean used to define if the node must be serialized

edgesColor

Find examples in Playground
edgesColor: Color4

Defines edge color used when edgesRenderer is enabled

see

https://www.babylonjs-playground.com/#10OJSG#13

edgesRenderer

Find examples in Playground
edgesRenderer: Nullable<EdgesRenderer>

Gets the edgesRenderer associated with the mesh

edgesWidth

Find examples in Playground
edgesWidth: number

Defines edge width used when edgesRenderer is enabled

see

https://www.babylonjs-playground.com/#10OJSG#13

ellipsoid

Find examples in Playground
ellipsoid: Vector3

Gets or sets the ellipsoid used to impersonate this mesh when using collision engine (default is (0.5, 1, 0.5))

see

http://doc.babylonjs.com/babylon101/cameras,_mesh_collisions_and_gravity

ellipsoidOffset

Find examples in Playground
ellipsoidOffset: Vector3

Gets or sets the ellipsoid offset used to impersonate this mesh when using collision engine (default is (0, 0, 0))

see

http://doc.babylonjs.com/babylon101/cameras,_mesh_collisions_and_gravity

enablePointerMoveEvents

Find examples in Playground
enablePointerMoveEvents: boolean

Gets or sets a boolean indicating that pointer move events must be supported on this mesh (false by default)

facetDepthSortFrom

Find examples in Playground
facetDepthSortFrom: Vector3

The location (Vector3) where the facet depth sort must be computed from. By default, the active camera position. Used only when facet depth sort is enabled

see

http://doc.babylonjs.com/how_to/how_to_use_facetdata#facet-depth-sort

facetNb

Find examples in Playground
facetNb: number

forward

Find examples in Playground
forward: Vector3

The forward direction of that transform in world space.

hasVertexAlpha

Find examples in Playground
hasVertexAlpha: boolean

Gets or sets a boolean indicating that this mesh contains vertex color data with alpha values

id

Find examples in Playground
id: string

Gets or sets the id of the node

ignoreNonUniformScaling

Find examples in Playground
ignoreNonUniformScaling: boolean

Gets or sets a boolean indicating that non uniform scaling (when at least one component is different from others) should be ignored. By default the system will update normals to compensate

infiniteDistance

Find examples in Playground
infiniteDistance: boolean

Sets the distance of the object to max, often used by skybox

isBlocked

Find examples in Playground
isBlocked: boolean

Returns true if the mesh is blocked. Implemented by child classes

isBlocker

Find examples in Playground
isBlocker: boolean

Gets or sets a boolean indicating if the mesh must be considered as a ray blocker for lens flares (false by default)

see

http://doc.babylonjs.com/how_to/how_to_use_lens_flares

isFacetDataEnabled

Find examples in Playground
isFacetDataEnabled: boolean

gets a boolean indicating if facetData is enabled

see

http://doc.babylonjs.com/how_to/how_to_use_facetdata#what-is-a-mesh-facet

isOccluded

Find examples in Playground
isOccluded: boolean

Gets or sets whether the mesh is occluded or not, it is used also to set the intial state of the mesh to be occluded or not

see

http://doc.babylonjs.com/features/occlusionquery

isOcclusionQueryInProgress

Find examples in Playground
isOcclusionQueryInProgress: boolean

Flag to check the progress status of the query

see

http://doc.babylonjs.com/features/occlusionquery

isPickable

Find examples in Playground
isPickable: boolean

Gets or sets a boolean indicating if the mesh can be picked (by scene.pick for instance or through actions). Default is true

isVisible

Find examples in Playground
isVisible: boolean

Gets or sets a boolean indicating if the mesh is visible (renderable). Default is true

isWorldMatrixFrozen

Find examples in Playground
isWorldMatrixFrozen: boolean

True if the World matrix has been frozen.

layerMask

Find examples in Playground
layerMask: number

Gets or sets the current layer mask (default is 0x0FFFFFFF)

see

http://doc.babylonjs.com/how_to/layermasks_and_multi-cam_textures

material

Find examples in Playground
material: Nullable<Material>

Gets or sets current material

metadata

Find examples in Playground
metadata: any

Gets or sets an object used to store user defined information for the node

mustDepthSortFacets

Find examples in Playground
mustDepthSortFacets: boolean

Gets or sets a boolean indicating that the facets must be depth sorted on next call to updateFacetData(). Works only for updatable meshes. Doesn't work with multi-materials

see

http://doc.babylonjs.com/how_to/how_to_use_facetdata#facet-depth-sort

name

Find examples in Playground
name: string

Gets or sets the name of the node

nonUniformScaling

Find examples in Playground
nonUniformScaling: boolean

True if the scaling property of this object is non uniform eg. (1,2,1)

numBoneInfluencers

Find examples in Playground
numBoneInfluencers: number

Gets or sets the number of allowed bone influences per vertex (4 by default)

occlusionQueryAlgorithmType

Find examples in Playground
occlusionQueryAlgorithmType: number

This property determines the type of occlusion query algorithm to run in WebGl, you can use:

  • AbstractMesh.OCCLUSION_ALGORITHM_TYPE_ACCURATE which is mapped to GL_ANY_SAMPLES_PASSED.
  • AbstractMesh.OCCLUSION_ALGORITHM_TYPE_CONSERVATIVE (Default Value) which is mapped to GL_ANY_SAMPLES_PASSED_CONSERVATIVE which is a false positive algorithm that is faster than GL_ANY_SAMPLES_PASSED but less accurate.
see

http://doc.babylonjs.com/features/occlusionquery

occlusionRetryCount

Find examples in Playground
occlusionRetryCount: number

This number indicates the number of allowed retries before stop the occlusion query, this is useful if the occlusion query is taking long time before to the query result is retireved, the query result indicates if the object is visible within the scene or not and based on that Babylon.Js engine decideds to show or hide the object. The default value is -1 which means don't break the query and wait till the result

see

http://doc.babylonjs.com/features/occlusionquery

occlusionType

Find examples in Playground
occlusionType: number

This property is responsible for starting the occlusion query within the Mesh or not, this property is also used to determine what should happen when the occlusionRetryCount is reached. It has supports 3 values:

  • OCCLUSION_TYPE_NONE (Default Value): this option means no occlusion query whith the Mesh.
  • OCCLUSION_TYPE_OPTIMISTIC: this option is means use occlusion query and if occlusionRetryCount is reached and the query is broken show the mesh.
  • OCCLUSION_TYPE_STRICT: this option is means use occlusion query and if occlusionRetryCount is reached and the query is broken restore the last state of the mesh occlusion if the mesh was visible then show the mesh if was hidden then hide don't show.
see

http://doc.babylonjs.com/features/occlusionquery

onAfterWorldMatrixUpdateObservable

Find examples in Playground
onAfterWorldMatrixUpdateObservable: Observable<TransformNode>

An event triggered after the world matrix is updated

onCollide

Find examples in Playground
onCollide: function

Set a function to call when this mesh collides with another one

Type declaration

    • (): void
    • Returns void

onCollideObservable

Find examples in Playground
onCollideObservable: Observable<AbstractMesh>

An event triggered when this mesh collides with another one

onCollisionPositionChange

Find examples in Playground
onCollisionPositionChange: function

Set a function to call when the collision's position changes

Type declaration

    • (): void
    • Returns void

onCollisionPositionChangeObservable

Find examples in Playground
onCollisionPositionChangeObservable: Observable<Vector3>

An event triggered when the collision's position changes

onDispose

Find examples in Playground
onDispose: function

Sets a callback that will be raised when the node will be disposed

Type declaration

    • (): void
    • Returns void

onDisposeObservable

Find examples in Playground
onDisposeObservable: Observable<Node>

An event triggered when the mesh is disposed

onMaterialChangedObservable

Find examples in Playground
onMaterialChangedObservable: Observable<AbstractMesh>

An event triggered when material is changed

onReady

Find examples in Playground
onReady: function

Callback raised when the node is ready to be used

Type declaration

    • (node: Node): void
    • Parameters

      Returns void

onRebuildObservable

Find examples in Playground
onRebuildObservable: Observable<AbstractMesh>

An event triggered when the mesh is rebuilt.

outlineColor

Find examples in Playground
outlineColor: Color3

Defines color to use when rendering outline

outlineWidth

Find examples in Playground
outlineWidth: number

Define width to use when rendering outline

overlayAlpha

Find examples in Playground
overlayAlpha: number

Defines alpha to use when rendering overlay

overlayColor

Find examples in Playground
overlayColor: Color3

Defines color to use when rendering overlay

parent

Find examples in Playground
parent: Nullable<Node>

Gets or sets the parent of the node

partitioningBBoxRatio

Find examples in Playground
partitioningBBoxRatio: number

The ratio (float) to apply to the bouding box size to set to the partioning space. Ex : 1.01 (default) the partioning space is 1% bigger than the bounding box

see

http://doc.babylonjs.com/how_to/how_to_use_facetdata#tweaking-the-partitioning

partitioningSubdivisions

Find examples in Playground
partitioningSubdivisions: number

Gets or set the number (integer) of subdivisions per axis in the partioning space

see

http://doc.babylonjs.com/how_to/how_to_use_facetdata#tweaking-the-partitioning

physicsImpostor

Find examples in Playground
physicsImpostor: Nullable<PhysicsImpostor>

Gets or sets impostor used for physic simulation

see

http://doc.babylonjs.com/features/physics_engine

position

Find examples in Playground
position: Vector3

Gets or set the node position (default is (0.0, 0.0, 0.0))

receiveShadows

Find examples in Playground
receiveShadows: boolean

Gets or sets a boolean indicating that this mesh can receive realtime shadows

see

http://doc.babylonjs.com/babylon101/shadows

renderOutline

Find examples in Playground
renderOutline: boolean

Gets or sets a boolean indicating if the outline must be rendered as well

see

https://www.babylonjs-playground.com/#10WJ5S#3

renderOverlay

Find examples in Playground
renderOverlay: boolean

Gets or sets a boolean indicating if the overlay must be rendered as well

see

https://www.babylonjs-playground.com/#10WJ5S#2

renderingGroupId

Find examples in Playground
renderingGroupId: number

Specifies the rendering group id for this mesh (0 by default)

see

http://doc.babylonjs.com/resources/transparency_and_how_meshes_are_rendered#rendering-groups

reservedDataStore

Find examples in Playground
reservedDataStore: any

For internal use only. Please do not use.

right

Find examples in Playground
right: Vector3

The right direction of that transform in world space.

rotation

Find examples in Playground
rotation: Vector3

Gets or sets the rotation property : a Vector3 defining the rotation value in radians around each local axis X, Y, Z (default is (0.0, 0.0, 0.0)). If rotation quaternion is set, this Vector3 will be ignored and copy from the quaternion

rotationQuaternion

Find examples in Playground
rotationQuaternion: Nullable<Quaternion>

Gets or sets the rotation Quaternion property : this a Quaternion object defining the node rotation by using a unit quaternion (null by default). If set, only the rotationQuaternion is then used to compute the node rotation (ie. node.rotation will be ignored)

scaling

Find examples in Playground
scaling: Vector3

Gets or sets a Vector3 depicting the mesh scaling along each local axis X, Y, Z. Default is (1.0, 1.0, 1.0)

scalingDeterminant

Find examples in Playground
scalingDeterminant: number

Multiplication factor on scale x/y/z when computing the world matrix. Eg. for a 1x1x1 cube setting this to 2 will make it a 2x2x2 cube

showBoundingBox

Find examples in Playground
showBoundingBox: boolean

Gets or sets a boolean indicating if the bounding box must be rendered as well (false by default)

showSubMeshesBoundingBox

Find examples in Playground
showSubMeshesBoundingBox: boolean

Gets or sets a boolean indicating that bounding boxes of subMeshes must be rendered as well (false by default)

skeleton

Find examples in Playground
skeleton: Nullable<Skeleton>

Gets or sets a skeleton to apply skining transformations

see

http://doc.babylonjs.com/how_to/how_to_use_bones_and_skeletons

state

Find examples in Playground
state: string

Gets or sets a string used to store user defined state for the node

subMeshes

Find examples in Playground
subMeshes: SubMesh[]

Gets or sets the list of subMeshes

see

http://doc.babylonjs.com/how_to/multi_materials

uniqueId

Find examples in Playground
uniqueId: number

Gets or sets the unique id of the node

up

Find examples in Playground

The up direction of that transform in world space.

useBones

Find examples in Playground
useBones: boolean

Gets a boolean indicating if this mesh has skinning data and an attached skeleton

useOctreeForCollisions

Find examples in Playground
useOctreeForCollisions: boolean

Gets or sets a boolean indicating that internal octree (if available) can be used to boost submeshes collision (true by default)

useOctreeForPicking

Find examples in Playground
useOctreeForPicking: boolean

Gets or sets a boolean indicating that internal octree (if available) can be used to boost submeshes picking (true by default)

useOctreeForRenderingSelection

Find examples in Playground
useOctreeForRenderingSelection: boolean

Gets or sets a boolean indicating that internal octree (if available) can be used to boost submeshes selection (true by default)

useVertexColors

Find examples in Playground
useVertexColors: boolean

Gets or sets a boolean indicating that this mesh needs to use vertex color data to render (if this kind of vertex data is available in the geometry)

visibility

Find examples in Playground
visibility: number

Gets or sets mesh visibility between 0 and 1 (default is 1)

worldMatrixFromCache

Find examples in Playground
worldMatrixFromCache: Matrix

Returns directly the latest state of the mesh World matrix. A Matrix is returned.

Static BILLBOARDMODE_ALL

Find examples in Playground
BILLBOARDMODE_ALL: number

Billboard on all axes

Static BILLBOARDMODE_NONE

Find examples in Playground
BILLBOARDMODE_NONE: number

No billboard

Static BILLBOARDMODE_X

Find examples in Playground
BILLBOARDMODE_X: number

Billboard on X axis

Static BILLBOARDMODE_Y

Find examples in Playground
BILLBOARDMODE_Y: number

Billboard on Y axis

Static BILLBOARDMODE_Z

Find examples in Playground
BILLBOARDMODE_Z: number

Billboard on Z axis

Static CULLINGSTRATEGY_BOUNDINGSPHERE_ONLY

Find examples in Playground
CULLINGSTRATEGY_BOUNDINGSPHERE_ONLY: number

Culling strategy with bounding sphere only and then frustum culling

Static CULLINGSTRATEGY_STANDARD

Find examples in Playground
CULLINGSTRATEGY_STANDARD: number

Default culling strategy with bounding box and bounding sphere and then frustum culling

Static OCCLUSION_ALGORITHM_TYPE_ACCURATE

Find examples in Playground
OCCLUSION_ALGORITHM_TYPE_ACCURATE: number

Use an accurante occlusion algorithm

Static OCCLUSION_ALGORITHM_TYPE_CONSERVATIVE

Find examples in Playground
OCCLUSION_ALGORITHM_TYPE_CONSERVATIVE: number

Use a conservative occlusion algorithm

Static OCCLUSION_TYPE_NONE

Find examples in Playground
OCCLUSION_TYPE_NONE: number

No occlusion

Static OCCLUSION_TYPE_OPTIMISTIC

Find examples in Playground
OCCLUSION_TYPE_OPTIMISTIC: number

Occlusion set to optimisitic

Static OCCLUSION_TYPE_STRICT

Find examples in Playground
OCCLUSION_TYPE_STRICT: number

Occlusion set to strict

Methods

addBehavior

Find examples in Playground

addChild

Find examples in Playground
  • Adds the passed mesh as a child to the current mesh

    Parameters

    Returns AbstractMesh

    the current mesh

addRotation

Find examples in Playground
  • Adds a rotation step to the mesh current rotation. x, y, z are Euler angles expressed in radians. This methods updates the current mesh rotation, either mesh.rotation, either mesh.rotationQuaternion if it's set. This means this rotation is made in the mesh local space only. It's useful to set a custom rotation order different from the BJS standard one YXZ. Example : this rotates the mesh first around its local X axis, then around its local Z axis, finally around its local Y axis.

    mesh.addRotation(x1, 0, 0).addRotation(0, 0, z2).addRotation(0, 0, y3);

    Note that addRotation() accumulates the passed rotation values to the current ones and computes the .rotation or .rotationQuaternion updated values. Under the hood, only quaternions are used. So it's a little faster is you use .rotationQuaternion because it doesn't need to translate them back to Euler angles.

    Parameters

    • x: number

      Rotation to add

    • y: number

      Rotation to add

    • z: number

      Rotation to add

    Returns TransformNode

    the TransformNode.

alignWithNormal

Find examples in Playground
  • Align the mesh with a normal

    Parameters

    • normal: Vector3

      defines the normal to use

    • Optional upDirection: Vector3

      can be used to redefined the up vector to use (will use the (0, 1, 0) by default)

    Returns AbstractMesh

    the current mesh

applyImpulse

Find examples in Playground

attachToBone

Find examples in Playground
  • Attach the current TransformNode to another TransformNode associated with a bone

    Parameters

    • bone: Bone

      Bone affecting the TransformNode

    • affectedTransformNode: TransformNode

      TransformNode associated with the bone

    Returns TransformNode

    this object

beginAnimation

Find examples in Playground
  • beginAnimation(name: string, loop?: boolean, speedRatio?: number, onAnimationEnd?: function): Nullable<Animatable>
  • Will start the animation sequence

    Parameters

    • name: string

      defines the range frames for animation sequence

    • Optional loop: boolean

      defines if the animation should loop (false by default)

    • Optional speedRatio: number

      defines the speed factor in which to run the animation (1 by default)

    • Optional onAnimationEnd: function

      defines a function to be executed when the animation ended (undefined by default)

        • (): void
        • Returns void

    Returns Nullable<Animatable>

    the object created for this animation. If range does not exist, it will return null

calcMovePOV

Find examples in Playground
  • calcMovePOV(amountRight: number, amountUp: number, amountForward: number): Vector3
  • Calculate relative position change from the point of view of behind the front of the mesh. This is performed taking into account the meshes current rotation, so you do not have to care. Supports definition of mesh facing forward or backward

    Parameters

    • amountRight: number

      defines the distance on the right axis

    • amountUp: number

      defines the distance on the up axis

    • amountForward: number

      defines the distance on the forward axis

    Returns Vector3

    the new displacement vector

calcRotatePOV

Find examples in Playground
  • calcRotatePOV(flipBack: number, twirlClockwise: number, tiltRight: number): Vector3
  • Calculate relative rotation change from the point of view of behind the front of the mesh. Supports definition of mesh facing forward or backward.

    Parameters

    • flipBack: number

      defines the flip

    • twirlClockwise: number

      defines the twirl

    • tiltRight: number

      defines the tilt

    Returns Vector3

    the new rotation vector

clone

Find examples in Playground
  • Clones the current mesh

    Parameters

    • name: string

      defines the mesh name

    • newParent: Node

      defines the new mesh parent

    • Optional doNotCloneChildren: boolean

      defines a boolean indicating that children must not be cloned (false by default)

    Returns Nullable<AbstractMesh>

    the new mesh

computeWorldMatrix

Find examples in Playground
  • computeWorldMatrix(force?: boolean): Matrix

createAnimationRange

Find examples in Playground
  • createAnimationRange(name: string, from: number, to: number): void
  • Creates an animation range for this node

    Parameters

    • name: string

      defines the name of the range

    • from: number

      defines the starting key

    • to: number

      defines the end key

    Returns void

createNormals

Find examples in Playground
  • Creates new normals data for the mesh

    Parameters

    • updatable: boolean

      defines if the normal vertex buffer must be flagged as updatable

    Returns AbstractMesh

    the current mesh

createOrUpdateSubmeshesOctree

Find examples in Playground
  • createOrUpdateSubmeshesOctree(maxCapacity?: number, maxDepth?: number): Octree<SubMesh>

deleteAnimationRange

Find examples in Playground
  • deleteAnimationRange(name: string, deleteFrames?: boolean): void
  • Delete a specific animation range

    Parameters

    • name: string

      defines the name of the range to delete

    • Optional deleteFrames: boolean

      defines if animation frames from the range must be deleted as well

    Returns void

detachFromBone

Find examples in Playground

disableEdgesRendering

Find examples in Playground
  • Disables the mesh edge rendering mode

    Returns AbstractMesh

    the currentAbstractMesh

disableFacetData

Find examples in Playground

dispose

Find examples in Playground
  • dispose(doNotRecurse?: boolean, disposeMaterialAndTextures?: boolean): void
  • Releases resources associated with this abstract mesh.

    Parameters

    • Optional doNotRecurse: boolean

      Set to true to not recurse into each children (recurse into each children by default)

    • Optional disposeMaterialAndTextures: boolean

      Set to true to also dispose referenced materials and textures (false by default)

    Returns void

enableEdgesRendering

Find examples in Playground
  • enableEdgesRendering(epsilon?: number, checkVerticesInsteadOfIndices?: boolean): AbstractMesh
  • Enables the edge rendering mode on the mesh. This mode makes the mesh edges visible

    see

    https://www.babylonjs-playground.com/#19O9TU#0

    Parameters

    • Optional epsilon: number

      defines the maximal distance between two angles to detect a face

    • Optional checkVerticesInsteadOfIndices: boolean

      indicates that we should check vertex list directly instead of faces

    Returns AbstractMesh

    the currentAbstractMesh

freezeWorldMatrix

Find examples in Playground

getAbsolutePivotPoint

Find examples in Playground

getAbsolutePivotPointToRef

Find examples in Playground

getAbsolutePosition

Find examples in Playground

getAnimationByName

Find examples in Playground
  • Get an animation by name

    Parameters

    • name: string

      defines the name of the animation to look for

    Returns Nullable<Animation>

    null if not found else the requested animation

getAnimationRange

Find examples in Playground
  • Get an animation range by name

    Parameters

    • name: string

      defines the name of the animation range to look for

    Returns Nullable<AnimationRange>

    null if not found else the requested animation range

getBehaviorByName

Find examples in Playground

getBoundingInfo

Find examples in Playground
  • Returns the mesh BoundingInfo object or creates a new one and returns if it was undefined

    Returns BoundingInfo

    a BoundingInfo

getChildMeshes

Find examples in Playground
  • getChildMeshes(directDescendantsOnly?: boolean, predicate?: function): AbstractMesh[]
  • Get all child-meshes of this node

    Parameters

    • Optional directDescendantsOnly: boolean

      defines if true only direct descendants of 'this' will be considered, if false direct and also indirect (children of children, an so on in a recursive manner) descendants of 'this' will be considered

    • Optional predicate: function

      defines an optional predicate that will be called on every evaluated child, the predicate must return true for a given child to be part of the result, otherwise it will be ignored

        • (node: Node): boolean
        • Parameters

          Returns boolean

    Returns AbstractMesh[]

    an array of AbstractMesh

getChildTransformNodes

Find examples in Playground
  • getChildTransformNodes(directDescendantsOnly?: boolean, predicate?: function): TransformNode[]
  • Get all child-transformNodes of this node

    Parameters

    • Optional directDescendantsOnly: boolean

      defines if true only direct descendants of 'this' will be considered, if false direct and also indirect (children of children, an so on in a recursive manner) descendants of 'this' will be considered

    • Optional predicate: function

      defines an optional predicate that will be called on every evaluated child, the predicate must return true for a given child to be part of the result, otherwise it will be ignored

        • (node: Node): boolean
        • Parameters

          Returns boolean

    Returns TransformNode[]

    an array of TransformNode

getChildren

Find examples in Playground
  • getChildren(predicate?: function, directDescendantsOnly?: boolean): Node[]
  • Get all direct children of this node

    Parameters

    • Optional predicate: function

      defines an optional predicate that will be called on every evaluated child, the predicate must return true for a given child to be part of the result, otherwise it will be ignored

        • (node: Node): boolean
        • Parameters

          Returns boolean

    • Optional directDescendantsOnly: boolean

      defines if true only direct descendants of 'this' will be considered, if false direct and also indirect (children of children, an so on in a recursive manner) descendants of 'this' will be considered (Default: true)

    Returns Node[]

    an array of Node

getClassName

Find examples in Playground
  • getClassName(): string

getClosestFacetAtCoordinates

Find examples in Playground
  • getClosestFacetAtCoordinates(x: number, y: number, z: number, projected?: Vector3, checkFace?: boolean, facing?: boolean): Nullable<number>
  • Returns the closest mesh facet index at (x,y,z) World coordinates, null if not found

    see

    http://doc.babylonjs.com/how_to/how_to_use_facetdata

    Parameters

    • x: number

      defines x coordinate

    • y: number

      defines y coordinate

    • z: number

      defines z coordinate

    • Optional projected: Vector3

      sets as the (x,y,z) world projection on the facet

    • Optional checkFace: boolean

      if true (default false), only the facet "facing" to (x,y,z) or only the ones "turning their backs", according to the parameter "facing" are returned

    • Optional facing: boolean

      if facing and checkFace are true, only the facet "facing" to (x, y, z) are returned : positive dot (x, y, z) * facet position. If facing si false and checkFace is true, only the facet "turning their backs" to (x, y, z) are returned : negative dot (x, y, z) * facet position

    Returns Nullable<number>

    the face index if found (or null instead)

getClosestFacetAtLocalCoordinates

Find examples in Playground
  • getClosestFacetAtLocalCoordinates(x: number, y: number, z: number, projected?: Vector3, checkFace?: boolean, facing?: boolean): Nullable<number>
  • Returns the closest mesh facet index at (x,y,z) local coordinates, null if not found

    see

    http://doc.babylonjs.com/how_to/how_to_use_facetdata

    Parameters

    • x: number

      defines x coordinate

    • y: number

      defines y coordinate

    • z: number

      defines z coordinate

    • Optional projected: Vector3

      sets as the (x,y,z) local projection on the facet

    • Optional checkFace: boolean

      if true (default false), only the facet "facing" to (x,y,z) or only the ones "turning their backs", according to the parameter "facing" are returned

    • Optional facing: boolean

      if facing and checkFace are true, only the facet "facing" to (x, y, z) are returned : positive dot (x, y, z) * facet position. If facing si false and checkFace is true, only the facet "turning their backs" to (x, y, z) are returned : negative dot (x, y, z) * facet position

    Returns Nullable<number>

    the face index if found (or null instead)

getDescendants

Find examples in Playground
  • getDescendants(directDescendantsOnly?: boolean, predicate?: function): Node[]
  • Will return all nodes that have this node as ascendant

    Parameters

    • Optional directDescendantsOnly: boolean

      defines if true only direct descendants of 'this' will be considered, if false direct and also indirect (children of children, an so on in a recursive manner) descendants of 'this' will be considered

    • Optional predicate: function

      defines an optional predicate that will be called on every evaluated child, the predicate must return true for a given child to be part of the result, otherwise it will be ignored

        • (node: Node): boolean
        • Parameters

          Returns boolean

    Returns Node[]

    all children nodes of all types

getDirection

Find examples in Playground
  • Returns a new Vector3 that is the localAxis, expressed in the mesh local space, rotated like the mesh. This Vector3 is expressed in the World space.

    Parameters

    • localAxis: Vector3

      axis to rotate

    Returns Vector3

    a new Vector3 that is the localAxis, expressed in the mesh local space, rotated like the mesh.

getDirectionToRef

Find examples in Playground
  • Sets the Vector3 "result" as the rotated Vector3 "localAxis" in the same rotation than the mesh. localAxis is expressed in the mesh local space. result is computed in the Wordl space from the mesh World matrix.

    Parameters

    • localAxis: Vector3

      axis to rotate

    • result: Vector3

      the resulting transformnode

    Returns TransformNode

    this TransformNode.

getDistanceToCamera

Find examples in Playground

getEngine

Find examples in Playground

getFacetDataParameters

Find examples in Playground
  • getFacetDataParameters(): any

getFacetLocalNormals

Find examples in Playground
  • getFacetLocalNormals(): Vector3[]

getFacetLocalPartitioning

Find examples in Playground
  • getFacetLocalPartitioning(): number[][]

getFacetLocalPositions

Find examples in Playground
  • getFacetLocalPositions(): Vector3[]

getFacetNormal

Find examples in Playground
  • getFacetNormal(i: number): Vector3

getFacetNormalToRef

Find examples in Playground
  • getFacetNormalToRef(i: number, ref: Vector3): this

getFacetPosition

Find examples in Playground
  • getFacetPosition(i: number): Vector3

getFacetPositionToRef

Find examples in Playground

getFacetsAtLocalCoordinates

Find examples in Playground
  • getFacetsAtLocalCoordinates(x: number, y: number, z: number): Nullable<number[]>
  • Returns the facets (in an array) in the same partitioning block than the one the passed coordinates are located (expressed in the mesh local system)

    see

    http://doc.babylonjs.com/how_to/how_to_use_facetdata

    Parameters

    • x: number

      defines x coordinate

    • y: number

      defines y coordinate

    • z: number

      defines z coordinate

    Returns Nullable<number[]>

    the array of facet indexes

getHierarchyBoundingVectors

Find examples in Playground
  • getHierarchyBoundingVectors(includeDescendants?: boolean, predicate?: Nullable<function>): object
  • Return the minimum and maximum world vectors of the entire hierarchy under current mesh

    Parameters

    • Optional includeDescendants: boolean

      Include bounding info from descendants as well (true by default)

    • Optional predicate: Nullable<function>

      defines a callback function that can be customize to filter what meshes should be included in the list used to compute the bounding vectors

    Returns object

    the new bounding vectors

getIndices

Find examples in Playground

getLOD

Find examples in Playground
  • Returns the mesh itself by default. Implemented by child classes

    Parameters

    • camera: Camera

      defines the camera to use to pick the right LOD level

    Returns Nullable<AbstractMesh>

    the currentAbstractMesh

getPhysicsImpostor

Find examples in Playground

getPivotMatrix

Find examples in Playground

getPivotPoint

Find examples in Playground

getPivotPointToRef

Find examples in Playground

getPoseMatrix

Find examples in Playground

getPositionExpressedInLocalSpace

Find examples in Playground
  • getPositionExpressedInLocalSpace(): Vector3

getPositionInCameraSpace

Find examples in Playground

getScene

Find examples in Playground

getTotalIndices

Find examples in Playground
  • getTotalIndices(): number
  • Returns a positive integer : the total number of indices in this mesh geometry.

    Returns number

    the numner of indices or zero if the mesh has no geometry.

getTotalVertices

Find examples in Playground
  • getTotalVertices(): number
  • Returns 0 by default. Implemented by child classes

    Returns number

    an integer

getVerticesData

Find examples in Playground
  • Returns the array of the requested vertex data kind. Implemented by child classes

    Parameters

    • kind: string

      defines the vertex data kind to use

    Returns Nullable<FloatArray>

    null

getWorldMatrix

Find examples in Playground

intersects

Find examples in Playground

intersectsMesh

Find examples in Playground
  • True if the mesh intersects another mesh or a SolidParticle object

    Parameters

    • mesh: AbstractMesh | SolidParticle

      defines a target mesh or SolidParticle to test

    • Optional precise: boolean

      Unless the parameter precise is set to true the intersection is computed according to Axis Aligned Bounding Boxes (AABB), else according to OBB (Oriented BBoxes)

    • Optional includeDescendants: boolean

      Can be set to true to test if the mesh defined in parameters intersects with the current mesh or any child meshes

    Returns boolean

    true if there is an intersection

intersectsPoint

Find examples in Playground
  • intersectsPoint(point: Vector3): boolean
  • Returns true if the passed point (Vector3) is inside the mesh bounding box

    Parameters

    • point: Vector3

      defines the point to test

    Returns boolean

    true if there is an intersection

isCompletelyInFrustum

Find examples in Playground
  • isCompletelyInFrustum(frustumPlanes: Plane[]): boolean
  • Returns true if the mesh is completely in the frustum defined be the passed array of planes. A mesh is completely in the frustum if its bounding box it completely inside the frustum.

    Parameters

    • frustumPlanes: Plane[]

      defines the frustum to test

    Returns boolean

    true if the mesh is completely in the frustum planes

isDescendantOf

Find examples in Playground
  • isDescendantOf(ancestor: Node): boolean
  • Is this node a descendant of the given node? The function will iterate up the hierarchy until the ancestor was found or no more parents defined

    Parameters

    • ancestor: Node

      defines the parent node to inspect

    Returns boolean

    a boolean indicating if this node is a descendant of the given node

isDisposed

Find examples in Playground
  • isDisposed(): boolean
  • Gets a boolean indicating if the node has been disposed

    Returns boolean

    true if the node was disposed

isEnabled

Find examples in Playground
  • isEnabled(checkAncestors?: boolean): boolean
  • Is this node enabled? If the node has a parent, all ancestors will be checked and false will be returned if any are false (not enabled), otherwise will return true

    Parameters

    • Optional checkAncestors: boolean

      indicates if this method should check the ancestors. The default is to check the ancestors. If set to false, the method will return the value of this node without checking ancestors

    Returns boolean

    whether this node (and its parent) is enabled

isInFrustum

Find examples in Playground
  • isInFrustum(frustumPlanes: Plane[]): boolean
  • Returns true if the mesh is within the frustum defined by the passed array of planes. A mesh is in the frustum if its bounding box intersects the frustum

    Parameters

    • frustumPlanes: Plane[]

      defines the frustum to test

    Returns boolean

    true if the mesh is in the frustum planes

isReady

Find examples in Playground
  • isReady(completeCheck?: boolean): boolean
  • Is this node ready to be used/rendered

    Parameters

    • Optional completeCheck: boolean

      defines if a complete check (including materials and lights) has to be done (false by default)

    Returns boolean

    true if the node is ready

isVerticesDataPresent

Find examples in Playground
  • isVerticesDataPresent(kind: string): boolean
  • Gets a boolean indicating if specific vertex data is present

    Parameters

    • kind: string

      defines the vertex data kind to use

    Returns boolean

    true is data kind is present

locallyTranslate

Find examples in Playground

lookAt

Find examples in Playground
  • Orients a mesh towards a target point. Mesh must be drawn facing user.

    Parameters

    • targetPoint: Vector3

      the position (must be in same space as current mesh) to look at

    • Optional yawCor: number

      optional yaw (y-axis) correction in radians

    • Optional pitchCor: number

      optional pitch (x-axis) correction in radians

    • Optional rollCor: number

      optional roll (z-axis) correction in radians

    • Optional space: Space

      the choosen space of the target

    Returns TransformNode

    the TransformNode.

markAsDirty

Find examples in Playground
  • Flag the transform node as dirty (Forcing it to update everything)

    Parameters

    • property: string

      if set to "rotation" the objects rotationQuaternion will be set to null

    Returns TransformNode

    this transform node

movePOV

Find examples in Playground
  • movePOV(amountRight: number, amountUp: number, amountForward: number): AbstractMesh
  • Perform relative position change from the point of view of behind the front of the mesh. This is performed taking into account the meshes current rotation, so you do not have to care. Supports definition of mesh facing forward or backward

    Parameters

    • amountRight: number

      defines the distance on the right axis

    • amountUp: number

      defines the distance on the up axis

    • amountForward: number

      defines the distance on the forward axis

    Returns AbstractMesh

    the current mesh

moveWithCollisions

Find examples in Playground

normalizeToUnitCube

Find examples in Playground
  • normalizeToUnitCube(includeDescendants?: boolean): AbstractMesh
  • Uniformly scales the mesh to fit inside of a unit cube (1 X 1 X 1 units)

    Parameters

    • Optional includeDescendants: boolean

      Use the hierarchy's bounding box instead of the mesh's bounding box

    Returns AbstractMesh

    the current mesh

refreshBoundingInfo

Find examples in Playground
  • refreshBoundingInfo(applySkeleton?: boolean): AbstractMesh
  • This method recomputes and sets a new BoundingInfo to the mesh unless it is locked. This means the mesh underlying bounding box and sphere are recomputed.

    Parameters

    • Optional applySkeleton: boolean

      defines whether to apply the skeleton before computing the bounding info

    Returns AbstractMesh

    the current mesh

registerAfterWorldMatrixUpdate

Find examples in Playground

releaseSubMeshes

Find examples in Playground
  • Disposes all the submeshes of the current meshnp

    Returns AbstractMesh

    the current mesh

removeBehavior

Find examples in Playground

removeChild

Find examples in Playground
  • Removes the passed mesh from the current mesh children list

    Parameters

    Returns AbstractMesh

    the current mesh

rotate

Find examples in Playground
  • Rotates the mesh around the axis vector for the passed angle (amount) expressed in radians, in the given space. space (default LOCAL) can be either BABYLON.Space.LOCAL, either BABYLON.Space.WORLD. Note that the property rotationQuaternion is then automatically updated and the property rotation is set to (0,0,0) and no longer used. The passed axis is also normalized.

    Parameters

    • axis: Vector3

      the axis to rotate around

    • amount: number

      the amount to rotate in radians

    • Optional space: Space

      Space to rotate in (Default: local)

    Returns TransformNode

    the TransformNode.

rotateAround

Find examples in Playground

rotatePOV

Find examples in Playground
  • rotatePOV(flipBack: number, twirlClockwise: number, tiltRight: number): AbstractMesh
  • Perform relative rotation change from the point of view of behind the front of the mesh. Supports definition of mesh facing forward or backward

    Parameters

    • flipBack: number

      defines the flip

    • twirlClockwise: number

      defines the twirl

    • tiltRight: number

      defines the tilt

    Returns AbstractMesh

    the current mesh

serialize

Find examples in Playground
  • serialize(currentSerializationObject?: any): any
  • Serializes the objects information.

    Parameters

    • Optional currentSerializationObject: any

      defines the object to serialize in

    Returns any

    the serialized object

serializeAnimationRanges

Find examples in Playground
  • serializeAnimationRanges(): any

setAbsolutePosition

Find examples in Playground

setBoundingInfo

Find examples in Playground
  • Overwrite the current bounding info

    Parameters

    Returns AbstractMesh

    the current mesh

setDirection

Find examples in Playground
  • setDirection(localAxis: Vector3, yawCor?: number, pitchCor?: number, rollCor?: number): TransformNode
  • Sets this transform node rotation to the given local axis.

    Parameters

    • localAxis: Vector3

      the axis in local space

    • Optional yawCor: number

      optional yaw (y-axis) correction in radians

    • Optional pitchCor: number

      optional pitch (x-axis) correction in radians

    • Optional rollCor: number

      optional roll (z-axis) correction in radians

    Returns TransformNode

    this TransformNode

setEnabled

Find examples in Playground
  • setEnabled(value: boolean): void
  • Set the enabled state of this node

    Parameters

    • value: boolean

      defines the new enabled state

    Returns void

setIndices

Find examples in Playground
  • Sets the mesh indices, If the mesh has no geometry, a new Geometry object is created and set to the mesh.

    Parameters

    • indices: IndicesArray

      Expects an array populated with integers or a typed array (Int32Array, Uint32Array, Uint16Array)

    • totalVertices: Nullable<number>

      Defines the total number of vertices

    Returns AbstractMesh

    the current mesh

setParent

Find examples in Playground
  • Defines the passed node as the parent of the current node. The node will remain exactly where it is and its position / rotation will be updated accordingly

    Parameters

    Returns TransformNode

    this TransformNode.

setPhysicsLinkWith

Find examples in Playground

setPivotMatrix

Find examples in Playground
  • Sets a new pivot matrix to the current node

    Parameters

    • matrix: DeepImmutable<Matrix>

      defines the new pivot matrix to use

    • Optional postMultiplyPivotMatrix: boolean

      defines if the pivot matrix must be cancelled in the world matrix. When this parameter is set to true (default), the inverse of the pivot matrix is also applied at the end to cancel the transformation effect

    Returns TransformNode

    the current TransformNode

setPivotPoint

Find examples in Playground
  • Sets a new pivot point to the current node

    Parameters

    • point: Vector3

      defines the new pivot point to use

    • Optional space: Space

      defines if the point is in world or local space (local by default)

    Returns TransformNode

    the current TransformNode

setPositionWithLocalVector

Find examples in Playground

setPreTransformMatrix

Find examples in Playground

setVerticesData

Find examples in Playground
  • Sets the vertex data of the mesh geometry for the requested kind. If the mesh has no geometry, a new Geometry object is set to the mesh and then passed this vertex data. Note that a new underlying VertexBuffer object is created each call. If the kind is the PositionKind, the mesh BoundingInfo is renewed, so the bounding box and sphere, and the mesh World Matrix is recomputed.

    Parameters

    • kind: string

      defines vertex data kind:

      • BABYLON.VertexBuffer.PositionKind
      • BABYLON.VertexBuffer.UVKind
      • BABYLON.VertexBuffer.UV2Kind
      • BABYLON.VertexBuffer.UV3Kind
      • BABYLON.VertexBuffer.UV4Kind
      • BABYLON.VertexBuffer.UV5Kind
      • BABYLON.VertexBuffer.UV6Kind
      • BABYLON.VertexBuffer.ColorKind
      • BABYLON.VertexBuffer.MatricesIndicesKind
      • BABYLON.VertexBuffer.MatricesIndicesExtraKind
      • BABYLON.VertexBuffer.MatricesWeightsKind
      • BABYLON.VertexBuffer.MatricesWeightsExtraKind
    • data: FloatArray

      defines the data source

    • Optional updatable: boolean

      defines if the data must be flagged as updatable (or static)

    • Optional stride: number

      defines the vertex stride (size of an entire vertex). Can be null and in this case will be deduced from vertex data kind

    Returns AbstractMesh

    the current mesh

toString

Find examples in Playground
  • toString(fullDetails?: boolean): string
  • Gets a string representation of the current mesh

    Parameters

    • Optional fullDetails: boolean

      defines a boolean indicating if full details must be included

    Returns string

    a string representation of the current mesh

translate

Find examples in Playground
  • Translates the mesh along the axis vector for the passed distance in the given space. space (default LOCAL) can be either BABYLON.Space.LOCAL, either BABYLON.Space.WORLD.

    Parameters

    • axis: Vector3

      the axis to translate in

    • distance: number

      the distance to translate

    • Optional space: Space

      Space to rotate in (Default: local)

    Returns TransformNode

    the TransformNode.

unfreezeWorldMatrix

Find examples in Playground
  • unfreezeWorldMatrix(): this

unregisterAfterWorldMatrixUpdate

Find examples in Playground
  • unregisterAfterWorldMatrixUpdate(func: function): TransformNode

updateFacetData

Find examples in Playground
  • Updates the mesh facetData arrays and the internal partitioning when the mesh is morphed or updated. This method can be called within the render loop. You don't need to call this method by yourself in the render loop when you update/morph a mesh with the methods CreateXXX() as they automatically manage this computation

    see

    http://doc.babylonjs.com/how_to/how_to_use_facetdata

    Returns AbstractMesh

    the current mesh

updateIndices

Find examples in Playground
  • Updates the AbstractMesh indices array

    Parameters

    Returns AbstractMesh

    the current mesh

updatePoseMatrix

Find examples in Playground

updateVerticesData

Find examples in Playground
  • updateVerticesData(kind: string, data: FloatArray, updateExtends?: boolean, makeItUnique?: boolean): AbstractMesh
  • Updates the existing vertex data of the mesh geometry for the requested kind. If the mesh has no geometry, it is simply returned as it is.

    Parameters

    • kind: string

      defines vertex data kind:

      • BABYLON.VertexBuffer.PositionKind
      • BABYLON.VertexBuffer.UVKind
      • BABYLON.VertexBuffer.UV2Kind
      • BABYLON.VertexBuffer.UV3Kind
      • BABYLON.VertexBuffer.UV4Kind
      • BABYLON.VertexBuffer.UV5Kind
      • BABYLON.VertexBuffer.UV6Kind
      • BABYLON.VertexBuffer.ColorKind
      • BABYLON.VertexBuffer.MatricesIndicesKind
      • BABYLON.VertexBuffer.MatricesIndicesExtraKind
      • BABYLON.VertexBuffer.MatricesWeightsKind
      • BABYLON.VertexBuffer.MatricesWeightsExtraKind
    • data: FloatArray

      defines the data source

    • Optional updateExtends: boolean

      If kind is PositionKind and if updateExtends is true, the mesh BoundingInfo is renewed, so the bounding box and sphere, and the mesh World Matrix is recomputed

    • Optional makeItUnique: boolean

      If true, a new global geometry is created from this data and is set to the mesh

    Returns AbstractMesh

    the current mesh

Static AddNodeConstructor

Find examples in Playground
  • Add a new node constructor

    Parameters

    • type: string

      defines the type name of the node to construct

    • constructorFunc: NodeConstructor

      defines the constructor function

    Returns void

Static Construct

Find examples in Playground
  • Construct(type: string, name: string, scene: Scene, options?: any): Nullable<function>
  • Returns a node constructor based on type name

    Parameters

    • type: string

      defines the type name

    • name: string

      defines the new node name

    • scene: Scene

      defines the hosting scene

    • Optional options: any

      defines optional options to transmit to constructors

    Returns Nullable<function>

    the new constructor or null

Static Parse

Find examples in Playground
  • Returns a new TransformNode object parsed from the source provided.

    Parameters

    • parsedTransformNode: any

      is the source.

    • scene: Scene

      the scne the object belongs to

    • rootUrl: string

      is a string, it's the root URL to prefix the delayLoadingFile property with

    Returns TransformNode

    a new TransformNode object parsed from the source provided.

Static ParseAnimationRanges

Find examples in Playground
  • ParseAnimationRanges(node: Node, parsedNode: any, scene: Scene): void
  • Parse animation range data from a serialization object and store them into a given node

    Parameters

    • node: Node

      defines where to store the animation ranges

    • parsedNode: any

      defines the serialization object to read data from

    • scene: Scene

      defines the hosting scene

    Returns void

Generated using TypeDoc