Documentation / scene / Mesh
Class: Mesh
Defined in: libs/scene/src/scene/mesh.ts:60
Mesh node
Extends
MeshBase
Implements
Constructors
Constructor
new Mesh(
scene,primitive?,material?):Mesh
Defined in: libs/scene/src/scene/mesh.ts:105
Creates an instance of mesh node
Parameters
scene
The scene to which the mesh node belongs
primitive?
material?
Returns
Mesh
Overrides
MeshBase.constructor
Properties
[EventMapType]?
readonlyoptional[EventMapType]?:object&object
Defined in: libs/base/dist/index.d.ts:549
Type-only event map marker.
Type Declaration
primitive_changed
primitive_changed: [
Primitive]
material_changed
material_changed: [
MeshMaterial]
Type Declaration
dispose
dispose: []
Inherited from
MeshBase.[EventMapType]
objectColor
readonlyobjectColor:Vector4
Defined in: libs/scene/src/render/drawable_mixin.ts:13
Inherited from
MeshBase.objectColor
BBOXDRAW_INHERITED
readonlystaticBBOXDRAW_INHERITED:-1=-1
Defined in: libs/scene/src/scene/scene_node.ts:166
Bounding-box draw mode inherited from nearest graph ancestor.
Inherited from
MeshBase.BBOXDRAW_INHERITED
BBOXDRAW_DISABLED
readonlystaticBBOXDRAW_DISABLED:0=0
Defined in: libs/scene/src/scene/scene_node.ts:168
Disable bounding-box visualization.
Inherited from
MeshBase.BBOXDRAW_DISABLED
BBOXDRAW_LOCAL
readonlystaticBBOXDRAW_LOCAL:1=1
Defined in: libs/scene/src/scene/scene_node.ts:170
Draw local-space bounding box.
Inherited from
MeshBase.BBOXDRAW_LOCAL
BBOXDRAW_WORLD
readonlystaticBBOXDRAW_WORLD:2=2
Defined in: libs/scene/src/scene/scene_node.ts:172
Draw world-space bounding box.
Inherited from
MeshBase.BBOXDRAW_WORLD
Accessors
disposed
Get Signature
get disposed():
boolean
Defined in: libs/base/dist/index.d.ts:6065
Returns
boolean
Inherited from
MeshBase.disposed
useRenderBundle
Get Signature
get useRenderBundle():
boolean
Defined in: libs/scene/src/scene/mesh.ts:151
Returns
boolean
Set Signature
set useRenderBundle(
val):void
Defined in: libs/scene/src/scene/mesh.ts:154
Parameters
val
boolean
Returns
void
skeletonName
Get Signature
get skeletonName():
string
Defined in: libs/scene/src/scene/mesh.ts:157
Returns
string
Set Signature
set skeletonName(
name):void
Defined in: libs/scene/src/scene/mesh.ts:160
Parameters
name
string
Returns
void
skinBindingName
Get Signature
get skinBindingName():
string
Defined in: libs/scene/src/scene/mesh.ts:163
Returns
string
Set Signature
set skinBindingName(
name):void
Defined in: libs/scene/src/scene/mesh.ts:166
Parameters
name
string
Returns
void
castShadow
Get Signature
get castShadow():
boolean
Defined in: libs/scene/src/scene/mesh.ts:185
Wether the mesh node casts shadows
Returns
boolean
Set Signature
set castShadow(
b):void
Defined in: libs/scene/src/scene/mesh.ts:188
Parameters
b
boolean
Returns
void
primitive
Get Signature
get primitive():
Primitive
Defined in: libs/scene/src/scene/mesh.ts:192
Primitive of the mesh
Returns
Set Signature
set primitive(
prim):void
Defined in: libs/scene/src/scene/mesh.ts:195
Parameters
prim
Returns
void
material
Get Signature
get material():
MeshMaterial
Defined in: libs/scene/src/scene/mesh.ts:216
Material of the mesh
Returns
Set Signature
set material(
m):void
Defined in: libs/scene/src/scene/mesh.ts:219
Parameters
m
Returns
void
placeToOctree
Get Signature
get placeToOctree():
boolean
Defined in: libs/scene/src/scene/scene_node.ts:312
Whether the node should be inserted into the scene's spatial structure.
Remarks
Toggling this hints the scene to (re)place the node in octree/acceleration structures.
Returns
boolean
Set Signature
set placeToOctree(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:315
Parameters
val
boolean
Returns
void
Inherited from
MeshBase.placeToOctree
runtimeId
Get Signature
get runtimeId():
number
Defined in: libs/scene/src/scene/scene_node.ts:326
Node's runtime unique identifier
Returns
number
Inherited from
MeshBase.runtimeId
persistentId
Get Signature
get persistentId():
string
Defined in: libs/scene/src/scene/scene_node.ts:335
Node's persistent identifier.
Remarks
Changing this affects serialization and registry lookup; ensure uniqueness.
Returns
string
Set Signature
set persistentId(
id):void
Defined in: libs/scene/src/scene/scene_node.ts:338
Parameters
id
string
Returns
void
Inherited from
MeshBase.persistentId
prefabId
Get Signature
get prefabId():
string
Defined in: libs/scene/src/scene/scene_node.ts:347
If not empty, this node was loaded from a prefab
Remarks
Internal used for serialization
Returns
string
Set Signature
set prefabId(
id):void
Defined in: libs/scene/src/scene/scene_node.ts:350
Parameters
id
string
Returns
void
Inherited from
MeshBase.prefabId
jointTypeT
Get Signature
get jointTypeT():
"none"|"animated"|"static"
Defined in: libs/scene/src/scene/scene_node.ts:366
Translation type if this is a joint node of any skeleton
Remarks
Internal used for serialization
Returns
"none" | "animated" | "static"
Set Signature
set jointTypeT(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:369
Parameters
val
"none" | "animated" | "static"
Returns
void
Inherited from
MeshBase.jointTypeT
jointTypeS
Get Signature
get jointTypeS():
"none"|"animated"|"static"
Defined in: libs/scene/src/scene/scene_node.ts:378
Scale type if this is a joint node of any skeleton
Remarks
Internal used for serialization
Returns
"none" | "animated" | "static"
Set Signature
set jointTypeS(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:381
Parameters
val
"none" | "animated" | "static"
Returns
void
Inherited from
MeshBase.jointTypeS
jointTypeR
Get Signature
get jointTypeR():
"none"|"animated"|"static"
Defined in: libs/scene/src/scene/scene_node.ts:390
Rotation type if this is a joint node of any skeleton
Remarks
Internal used for serialization
Returns
"none" | "animated" | "static"
Set Signature
set jointTypeR(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:393
Parameters
val
"none" | "animated" | "static"
Returns
void
Inherited from
MeshBase.jointTypeR
metaData
Get Signature
get metaData():
Metadata
Defined in: libs/scene/src/scene/scene_node.ts:402
Arbitrary metadata associated with this node.
Remarks
Stored and transported with the node; format is application-defined.
Returns
Metadata
Set Signature
set metaData(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:405
Parameters
val
Metadata
Returns
void
Inherited from
MeshBase.metaData
script
Get Signature
get script():
string
Defined in: libs/scene/src/scene/scene_node.ts:414
Attached script filename or identifier (engine-specific).
Remarks
Integrates with the engine’s scripting system if available.
Returns
string
Set Signature
set script(
fileName):void
Defined in: libs/scene/src/scene/scene_node.ts:417
Parameters
fileName
string
Returns
void
Inherited from
MeshBase.script
scriptConfig
Get Signature
get scriptConfig():
object|unknown[]
Defined in: libs/scene/src/scene/scene_node.ts:430
Script component configuration payload used by editor/runtime script components.
Returns
object | unknown[]
Set Signature
set scriptConfig(
value):void
Defined in: libs/scene/src/scene/scene_node.ts:433
Parameters
value
object | unknown[]
Returns
void
Inherited from
MeshBase.scriptConfig
scripts
Get Signature
get scripts():
ScriptAttachment[]
Defined in: libs/scene/src/scene/scene_node.ts:447
All script attachments on this node.
Returns
Set Signature
set scripts(
value):void
Defined in: libs/scene/src/scene/scene_node.ts:450
Parameters
value
Returns
void
Inherited from
MeshBase.scripts
scriptConfigs
Get Signature
get scriptConfigs():
unknown[]
Defined in: libs/scene/src/scene/scene_node.ts:456
Script configs for all script attachments.
Returns
unknown[]
Set Signature
set scriptConfigs(
value):void
Defined in: libs/scene/src/scene/scene_node.ts:459
Parameters
value
unknown[]
Returns
void
Inherited from
MeshBase.scriptConfigs
name
Get Signature
get name():
string
Defined in: libs/scene/src/scene/scene_node.ts:474
Display name of the node (for UI/debugging).
Returns
string
Set Signature
set name(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:477
Parameters
val
string
Returns
void
Inherited from
MeshBase.name
scene
Get Signature
get scene():
Scene
Defined in: libs/scene/src/scene/scene_node.ts:481
The owning scene.
Returns
Inherited from
MeshBase.scene
attached
Get Signature
get attached():
boolean
Defined in: libs/scene/src/scene/scene_node.ts:487
Whether this node is currently attached under the scene's root.
Returns
boolean
Inherited from
MeshBase.attached
sealed
Get Signature
get sealed():
boolean
Defined in: libs/scene/src/scene/scene_node.ts:501
If true, the node is logically sealed; some operations (like cloning as child) may be restricted by engine policies.
Returns
boolean
Set Signature
set sealed(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:504
Parameters
val
boolean
Returns
void
Inherited from
MeshBase.sealed
animationSet
Get Signature
get animationSet():
AnimationSet
Defined in: libs/scene/src/scene/scene_node.ts:513
Lazily created animation set for this node.
Remarks
Accessing this schedules the node for update in the scene.
Returns
Inherited from
MeshBase.animationSet
sharedModel
Get Signature
get sharedModel():
SharedModel
Defined in: libs/scene/src/scene/scene_node.ts:523
Shared model reference for instancing/streaming systems.
Returns
Set Signature
set sharedModel(
model):void
Defined in: libs/scene/src/scene/scene_node.ts:526
Parameters
model
Returns
void
Inherited from
MeshBase.sharedModel
morphTargetGroups
Get Signature
get morphTargetGroups():
SceneMorphTargetGroup[]
Defined in: libs/scene/src/scene/scene_node.ts:530
Runtime morph target groups bound to this model instance.
Returns
Set Signature
set morphTargetGroups(
groups):void
Defined in: libs/scene/src/scene/scene_node.ts:533
Parameters
groups
Returns
void
Inherited from
MeshBase.morphTargetGroups
clipTestEnabled
Get Signature
get clipTestEnabled():
boolean
Defined in: libs/scene/src/scene/scene_node.ts:774
Clip mode
Returns
boolean
Set Signature
set clipTestEnabled(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:777
Parameters
val
boolean
Returns
void
Inherited from
MeshBase.clipTestEnabled
hidden
Get Signature
get hidden():
boolean
Defined in: libs/scene/src/scene/scene_node.ts:781
Computed value of show state
Returns
boolean
Inherited from
MeshBase.hidden
showState
Get Signature
get showState():
SceneNodeVisible
Defined in: libs/scene/src/scene/scene_node.ts:789
Show state
Returns
Set Signature
set showState(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:792
Parameters
val
Returns
void
Inherited from
MeshBase.showState
pickable
Get Signature
get pickable():
boolean
Defined in: libs/scene/src/scene/scene_node.ts:810
Whether this node is enabled for CPU picking
Returns
boolean
Set Signature
set pickable(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:813
Parameters
val
boolean
Returns
void
Inherited from
MeshBase.pickable
gpuPickable
Get Signature
get gpuPickable():
boolean
Defined in: libs/scene/src/scene/scene_node.ts:817
Whether this node is enabled for GPU picking
Returns
boolean
Set Signature
set gpuPickable(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:820
Parameters
val
boolean
Returns
void
Inherited from
MeshBase.gpuPickable
computedBoundingBoxDrawMode
Get Signature
get computedBoundingBoxDrawMode():
number
Defined in: libs/scene/src/scene/scene_node.ts:902
Computed value for bounding box draw mode
Returns
number
Inherited from
MeshBase.computedBoundingBoxDrawMode
boundingBoxDrawMode
Get Signature
get boundingBoxDrawMode():
number
Defined in: libs/scene/src/scene/scene_node.ts:913
Bounding box draw mode
Returns
number
Set Signature
set boundingBoxDrawMode(
mode):void
Defined in: libs/scene/src/scene/scene_node.ts:916
Parameters
mode
number
Returns
void
Inherited from
MeshBase.boundingBoxDrawMode
parent
Get Signature
get parent():
SceneNode
Defined in: libs/scene/src/scene/scene_node.ts:1204
Parent of the xform
Returns
Set Signature
set parent(
p):void
Defined in: libs/scene/src/scene/scene_node.ts:1207
Parameters
p
Returns
void
Inherited from
MeshBase.parent
children
Get Signature
get children():
SceneNode[]
Defined in: libs/scene/src/scene/scene_node.ts:1213
Children of this xform
Returns
Inherited from
MeshBase.children
position
Get Signature
get position():
Vector3
Defined in: libs/scene/src/scene/scene_node.ts:1219
Position of the xform relative to it's parent
Returns
Vector3
Set Signature
set position(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:1222
Parameters
val
Vector3
Returns
void
Inherited from
MeshBase.position
scale
Get Signature
get scale():
Vector3
Defined in: libs/scene/src/scene/scene_node.ts:1228
Scaling of the xform
Returns
Vector3
Set Signature
set scale(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:1231
Parameters
val
Vector3
Returns
void
Inherited from
MeshBase.scale
rotation
Get Signature
get rotation():
Quaternion
Defined in: libs/scene/src/scene/scene_node.ts:1237
Rotation of the xform
Returns
Quaternion
Set Signature
set rotation(
val):void
Defined in: libs/scene/src/scene/scene_node.ts:1240
Parameters
val
Quaternion
Returns
void
Inherited from
MeshBase.rotation
localMatrix
Get Signature
get localMatrix():
Immutable<Matrix4x4>
Defined in: libs/scene/src/scene/scene_node.ts:1346
Local transformation matrix of the xform
Returns
Immutable<Matrix4x4>
Set Signature
set localMatrix(
matrix):void
Defined in: libs/scene/src/scene/scene_node.ts:1353
Parameters
matrix
Immutable<Matrix4x4>
Returns
void
Inherited from
MeshBase.localMatrix
worldMatrix
Get Signature
get worldMatrix():
Immutable<Matrix4x4>
Defined in: libs/scene/src/scene/scene_node.ts:1357
World transformation matrix of the xform
Returns
Immutable<Matrix4x4>
Inherited from
MeshBase.worldMatrix
worldMatrixDet
Get Signature
get worldMatrixDet():
number
Defined in: libs/scene/src/scene/scene_node.ts:1362
The determinant of world matrix
Returns
number
Inherited from
MeshBase.worldMatrixDet
invWorldMatrix
Get Signature
get invWorldMatrix():
Immutable<Matrix4x4>
Defined in: libs/scene/src/scene/scene_node.ts:1367
Inverse of the world transformation matrix of the xform
Returns
Immutable<Matrix4x4>
Inherited from
MeshBase.invWorldMatrix
Methods
isPrototypeOf()
staticisPrototypeOf(v):boolean
Defined in: libs/base/dist/index.d.ts:80
Parameters
v
object
Returns
boolean
Inherited from
MeshBase.isPrototypeOf
on()
Call Signature
on<
K>(type,listener,context?):void
Defined in: libs/base/dist/index.d.ts:635
IEventTarget.on
Type Parameters
K
K extends "dispose" | "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged"
Parameters
type
K
listener
EventListener<object & object, K>
context?
unknown
Returns
void
Inherited from
MeshBase.on
Call Signature
on<
K>(type,listener,context?):void
Defined in: libs/base/dist/index.d.ts:594
IEventTarget.on
Type Parameters
K
K extends "dispose"
Parameters
type
K
listener
EventListener<{ dispose: []; }, K>
context?
unknown
Returns
void
Inherited from
MeshBase.on
Call Signature
on<
K>(type,listener,context?):void
Defined in: libs/base/dist/index.d.ts:556
Sets up a function that will be called whenever the specified event is delivered to the target
Type Parameters
K
K extends "dispose" | "primitive_changed" | "material_changed"
Parameters
type
K
The event type to listen for
listener
EventListener<object & object, K>
The callback function
context?
unknown
Context object of the listener function
Returns
void
Inherited from
MeshBase.on
once()
Call Signature
once<
K>(type,listener,context?):void
Defined in: libs/base/dist/index.d.ts:639
IEventTarget.once
Type Parameters
K
K extends "dispose" | "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged"
Parameters
type
K
listener
EventListener<object & object, K>
context?
unknown
Returns
void
Inherited from
MeshBase.once
Call Signature
once<
K>(type,listener,context?):void
Defined in: libs/base/dist/index.d.ts:598
IEventTarget.once
Type Parameters
K
K extends "dispose"
Parameters
type
K
listener
EventListener<{ dispose: []; }, K>
context?
unknown
Returns
void
Inherited from
MeshBase.once
Call Signature
once<
K>(type,listener,context?):void
Defined in: libs/base/dist/index.d.ts:563
Sets up a function that will be called only once when the specified event is delivered to the target
Type Parameters
K
K extends "dispose" | "primitive_changed" | "material_changed"
Parameters
type
K
The event type to listen for
listener
EventListener<object & object, K>
The callback function
context?
unknown
Context object of the listener function
Returns
void
Inherited from
MeshBase.once
off()
Call Signature
off<
K>(type,listener,context?):void
Defined in: libs/base/dist/index.d.ts:643
IEventTarget.off
Type Parameters
K
K extends "dispose" | "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged"
Parameters
type
K
listener
EventListener<object & object, K>
context?
unknown
Returns
void
Inherited from
MeshBase.off
Call Signature
off<
K>(type,listener?,context?):void
Defined in: libs/base/dist/index.d.ts:602
IEventTarget.off
Type Parameters
K
K extends "dispose"
Parameters
type
K
listener?
EventListener<{ dispose: []; }>
context?
unknown
Returns
void
Inherited from
MeshBase.off
Call Signature
off<
K>(type,listener?,context?):void
Defined in: libs/base/dist/index.d.ts:569
Removes an event listener function previously registered.
Type Parameters
K
K extends "dispose" | "primitive_changed" | "material_changed"
Parameters
type
K
The event type for which to remove an event listener
listener?
EventListener<object & object>
The callback function to be removed
context?
unknown
Returns
void
Inherited from
MeshBase.off
dispatchEvent()
Call Signature
dispatchEvent<
K>(type, ...args):void
Defined in: libs/base/dist/index.d.ts:647
IEventTarget.dispatchEvent
Type Parameters
K
K extends "dispose" | "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged"
Parameters
type
K
args
...object & object[K]
Returns
void
Inherited from
MeshBase.dispatchEvent
Call Signature
dispatchEvent<
K>(type, ...args):void
Defined in: libs/base/dist/index.d.ts:606
IEventTarget.dispatchEvent
Type Parameters
K
K extends "dispose"
Parameters
type
K
args
...object[K]
Returns
void
Inherited from
MeshBase.dispatchEvent
Call Signature
dispatchEvent<
K>(type, ...args):void
Defined in: libs/base/dist/index.d.ts:575
Synchronously invoke the affected event listeners with an event object
Type Parameters
K
K extends "dispose" | "primitive_changed" | "material_changed"
Parameters
type
K
args
...object & object[K]
Returns
void
false if the event was canceled, otherwise true
Inherited from
MeshBase.dispatchEvent
dispose()
dispose():
void
Defined in: libs/base/dist/index.d.ts:6066
Releases all GPU resources and detaches from the renderer.
Returns
void
Implementation of
Inherited from
MeshBase.dispose
getDrawableId()
getDrawableId():
number
Defined in: libs/scene/src/render/drawable_mixin.ts:14
Unique, stable identifier for the drawable, used in caches and picking.
Returns
number
Implementation of
Inherited from
MeshBase.getDrawableId
pushRenderQueueRef()
pushRenderQueueRef(
ref):void
Defined in: libs/scene/src/render/drawable_mixin.ts:15
Pushes a reference to the current render queue for cleanup or back-references.
Useful for batching or delayed state application.
Parameters
ref
Returns
void
Implementation of
BatchDrawable.pushRenderQueueRef
Inherited from
MeshBase.pushRenderQueueRef
applyInstanceOffsetAndStride()
applyInstanceOffsetAndStride(
renderQueue,stride,offset):void
Defined in: libs/scene/src/render/drawable_mixin.ts:16
Parameters
renderQueue
stride
number
offset
number
Returns
void
Implementation of
BatchDrawable.applyInstanceOffsetAndStride
Inherited from
MeshBase.applyInstanceOffsetAndStride
applyTransformUniforms()
applyTransformUniforms(
renderQueue):void
Defined in: libs/scene/src/render/drawable_mixin.ts:17
Applies transform-related uniforms to the active bind group or pipeline.
Parameters
renderQueue
The current render queue issuing this draw.
Returns
void
Implementation of
BatchDrawable.applyTransformUniforms
Inherited from
MeshBase.applyTransformUniforms
applyMaterialUniforms()
applyMaterialUniforms(
instanceInfo):void
Defined in: libs/scene/src/render/drawable_mixin.ts:18
Parameters
instanceInfo
Returns
void
Implementation of
BatchDrawable.applyMaterialUniforms
Inherited from
MeshBase.applyMaterialUniforms
applyMaterialUniformsAll()
applyMaterialUniformsAll():
void
Defined in: libs/scene/src/render/drawable_mixin.ts:19
Returns
void
Implementation of
BatchDrawable.applyMaterialUniformsAll
Inherited from
MeshBase.applyMaterialUniformsAll
getObjectColor()
getObjectColor():
Vector4
Defined in: libs/scene/src/render/drawable_mixin.ts:20
Returns the unique color used for GPU picking (object ID in color).
Returns
Vector4
Implementation of
Inherited from
MeshBase.getObjectColor
updateState()
updateState():
void
Defined in: libs/scene/src/render/drawable_mixin.ts:21
Updates internal state or GPU resources for this drawable, if needed.
Returns
void
Implementation of
Inherited from
MeshBase.updateState
bind()
bind(
ctx,renderQueue):void
Defined in: libs/scene/src/render/drawable_mixin.ts:22
Parameters
ctx
renderQueue
Returns
void
Inherited from
MeshBase.bind
getName()
getName():
string
Defined in: libs/scene/src/scene/graph_node.ts:36
Gets the name
Returns
string
Implementation of
Inherited from
MeshBase.getName
isGraphNode()
isGraphNode():
this is GraphNode
Defined in: libs/scene/src/scene/graph_node.ts:43
Type guard: true if this node is a graph node.
Returns
this is GraphNode
Inherited from
MeshBase.isGraphNode
getSortDistance()
getSortDistance(
camera):number
Defined in: libs/scene/src/scene/graph_node.ts:61
Computes the distance used for sorting (e.g., transparent draw order).
Parameters
camera
Camera from which to compute distance (usually camera -> object).
Returns
number
Implementation of
Inherited from
MeshBase.getSortDistance
getInstanceId()
getInstanceId(
_renderPass):string
Defined in: libs/scene/src/scene/mesh.ts:133
Returns the batch instance ID for the current render pass.
Parameters
_renderPass
Returns
string
Implementation of
BatchDrawable.getInstanceId
getInstanceUniforms()
getInstanceUniforms():
Float32Array<ArrayBuffer>
Defined in: libs/scene/src/scene/mesh.ts:139
Returns the packed instance-uniform buffer used for batching.
Returns
Float32Array<ArrayBuffer>
Implementation of
BatchDrawable.getInstanceUniforms
getPickTarget()
getPickTarget():
PickTarget
Defined in: libs/scene/src/scene/mesh.ts:145
Returns the pick target override to be reported when this object is picked.
If not set, a default target derived from the node/material may be used.
Returns
Implementation of
setPickTarget()
setPickTarget(
node,label?):void
Defined in: libs/scene/src/scene/mesh.ts:148
Parameters
node
label?
string
Returns
void
isMesh()
isMesh():
this is Mesh
Defined in: libs/scene/src/scene/mesh.ts:237
Type guard: true if this node is a mesh.
Returns
this is Mesh
Overrides
MeshBase.isMesh
setAnimatedBoundingBox()
setAnimatedBoundingBox(
bbox):void
Defined in: libs/scene/src/scene/mesh.ts:244
Sets the bounding box for animation
Parameters
bbox
The bounding box for animation
Returns
void
getAnimatedBoundingBox()
getAnimatedBoundingBox():
BoundingBox
Defined in: libs/scene/src/scene/mesh.ts:251
Gets the bounding box for animation
Returns
setMorphBoundingInfo()
setMorphBoundingInfo(
info):void
Defined in: libs/scene/src/scene/mesh.ts:258
Sets morph target bounding data used to update the animated bounding box when weights change.
Parameters
info
Morph target bounding data
Returns
void
getMorphBoundingInfo()
getMorphBoundingInfo():
MorphBoundingInfo
Defined in: libs/scene/src/scene/mesh.ts:270
Gets morph target bounding data.
Returns
setBoneMatrices()
setBoneMatrices(
matrices):void
Defined in: libs/scene/src/scene/mesh.ts:277
Sets the texture that contains the bone matrices for skeletal animation
Parameters
matrices
Texture2D<unknown>
The texture that contains the bone matrices
Returns
void
setMorphData()
setMorphData(
data):void
Defined in: libs/scene/src/scene/mesh.ts:288
Sets the texture that contains the morph target data
Parameters
data
The texture that contains the morph target data
Returns
void
setSkinnedBoundingInfo()
setSkinnedBoundingInfo(
info):void
Defined in: libs/scene/src/scene/mesh.ts:327
Sets the skinned bounding info
Parameters
info
The skinned bounding info
Returns
void
getMorphData()
getMorphData():
MorphData
Defined in: libs/scene/src/scene/mesh.ts:333
Returns the morph target data texture (if morphing is used).
Returns
Implementation of
setMorphInfo()
setMorphInfo(
info):void
Defined in: libs/scene/src/scene/mesh.ts:340
Sets the buffer that contains the morph target information
Parameters
info
The buffer that contains the morph target information
Returns
void
getMorphInfo()
getMorphInfo():
MorphInfo
Defined in: libs/scene/src/scene/mesh.ts:386
Returns the morph information buffer (weights, ranges, etc.).
Returns
Implementation of
getNumMorphTargets()
getNumMorphTargets():
number
Defined in: libs/scene/src/scene/mesh.ts:405
Get the number of morph targets
Returns
number
The number of morph targets
getMorphTargetName()
getMorphTargetName(
index):string
Defined in: libs/scene/src/scene/mesh.ts:414
Get the name of the morph target by index
Parameters
index
number
The index of the morph target
Returns
string
The name of the morph target, or null if not found
getMorphTargetIndexByName()
getMorphTargetIndexByName(
name):number
Defined in: libs/scene/src/scene/mesh.ts:426
Get the index of the morph target by name
Parameters
name
string
The name of the morph target
Returns
number
The index of the morph target, or -1 if not found
setMorphWeight()
setMorphWeight(
name,weight):void
Defined in: libs/scene/src/scene/mesh.ts:435
Update morph target weight
Parameters
name
string
The name of the morph target
weight
number
The weight of the morph target
Returns
void
setMorphWeightByIndex()
setMorphWeightByIndex(
index,weight):void
Defined in: libs/scene/src/scene/mesh.ts:447
Update morph target weight by index
Parameters
index
number
The index of the morph target
weight
number
The weight of the morph target
Returns
void
getMorphWeight()
getMorphWeight(
name):number
Defined in: libs/scene/src/scene/mesh.ts:465
Get morph target weight
Parameters
name
string
The name of the morph target
Returns
number
The weight of the morph target, or 0 if not found
updateMorphWeights()
updateMorphWeights(
weight):void
Defined in: libs/scene/src/scene/mesh.ts:477
Update morph target weights
Parameters
weight
number[]
The morph target weights. The length must not exceed the mesh's morph target count.
Returns
void
update()
update(
frameId,elapsedInSeconds,deltaInSeconds):void
Defined in: libs/scene/src/scene/mesh.ts:486
Update node state once per-frame
Parameters
frameId
number
Current frame id
elapsedInSeconds
number
Elapsed time from game start in seconds
deltaInSeconds
number
Elapsed time since previous frame in seconds
Returns
void
Overrides
MeshBase.update
isBatchable()
isBatchable():
this is BatchDrawable
Defined in: libs/scene/src/scene/mesh.ts:511
Returns true if the object supports instanced rendering.
When true, the object should also implement the BatchDrawable methods.
Returns
this is BatchDrawable
Implementation of
Overrides
MeshBase.isBatchable
getQueueType()
getQueueType():
number
Defined in: libs/scene/src/scene/mesh.ts:522
Returns the type/category of render queue this object belongs to.
Returns
number
Implementation of
isUnlit()
isUnlit():
boolean
Defined in: libs/scene/src/scene/mesh.ts:528
True if shading is unlit (does not depend on scene lighting).
Returns
boolean
Implementation of
needSceneColor()
needSceneColor():
boolean
Defined in: libs/scene/src/scene/mesh.ts:534
Whether the object requires access to the scene color buffer.
Returns
boolean
Implementation of
needSceneDepth()
needSceneDepth():
boolean
Defined in: libs/scene/src/scene/mesh.ts:540
Whether the object requires access to the scene depth (linear or non-linear).
Returns
boolean
Implementation of
draw()
draw(
ctx,renderQueue,hash?):void
Defined in: libs/scene/src/scene/mesh.ts:597
Issues draw commands for this object.
Parameters
ctx
Full draw context for the current pass.
renderQueue
The current render queue issuing this draw.
hash?
string
Optional hash key for render bundle or pipeline caching.
Returns
void
Implementation of
getMaterial()
getMaterial():
MeshMaterial
Defined in: libs/scene/src/scene/mesh.ts:628
Returns the bound material driving shading for this drawable.
Returns
Implementation of
getPrimitive()
getPrimitive():
Primitive
Defined in: libs/scene/src/scene/mesh.ts:634
Returns the geometry primitive to be drawn.
Returns
Implementation of
getBoneMatrices()
getBoneMatrices():
Texture2D<unknown>
Defined in: libs/scene/src/scene/mesh.ts:640
Returns the texture containing bone matrices for skinned meshes.
Returns
Texture2D<unknown>
Implementation of
Overrides
MeshBase.getBoneMatrices
getNode()
getNode():
Mesh
Defined in: libs/scene/src/scene/mesh.ts:646
Returns the owning scene node (transform and hierarchy).
Returns
Mesh
Implementation of
Overrides
MeshBase.getNode
onDispose()
protectedonDispose():void
Defined in: libs/scene/src/scene/mesh.ts:661
Disposes the mesh node
Returns
void
Overrides
MeshBase.onDispose
getPrefabNode()
getPrefabNode():
SceneNode
Defined in: libs/scene/src/scene/scene_node.ts:357
Get prefab node this node belongs to, or null if this node does not belongs to any prefab
Returns
prefab node this node belongs to
Inherited from
MeshBase.getPrefabNode
clone()
clone():
Promise<Mesh>
Defined in: libs/scene/src/scene/scene_node.ts:547
Clone this node.
Returns
Promise<Mesh>
New node instance
Remarks
If a shared model exists, it may create an instanced node. The clone is attached under the same parent; children are cloned based on method and recursive.
Inherited from
MeshBase.clone
hasChild()
hasChild(
child):boolean
Defined in: libs/scene/src/scene/scene_node.ts:577
Whether the given node is a direct child of this node.
Parameters
child
The node to be checked
Returns
boolean
true if the given node is a direct child of this node, false otherwise
Inherited from
MeshBase.hasChild
removeChildren()
removeChildren():
void
Defined in: libs/scene/src/scene/scene_node.ts:583
Remove all children from this node.
Returns
void
Inherited from
MeshBase.removeChildren
isParentOf()
isParentOf(
child):boolean
Defined in: libs/scene/src/scene/scene_node.ts:591
Whether this node is an ancestor (direct or indirect) of the given node.
Parameters
child
Returns
boolean
Inherited from
MeshBase.isParentOf
remove()
remove():
Mesh
Defined in: libs/scene/src/scene/scene_node.ts:602
Detach this node from its parent.
Returns
Mesh
this
Inherited from
MeshBase.remove
traverse()
traverse(
v):void
Defined in: libs/scene/src/scene/scene_node.ts:611
Depth-first traversal of this node's subtree (pre-order).
Parameters
v
Visitor invoked on each node.
Returns
void
Inherited from
MeshBase.traverse
iterate()
iterate(
callback):boolean
Defined in: libs/scene/src/scene/scene_node.ts:625
Iterate self and descendants in pre-order.
Warning: Do not remove children during this iteration. To allow removal, use iterateBottomToTop.
Parameters
callback
Called for each node; if returns true, iteration stops.
Returns
boolean
If returns true, the iteration will immediately stop.
Inherited from
MeshBase.iterate
iterateBottomToTop()
iterateBottomToTop(
callback):boolean
Defined in: libs/scene/src/scene/scene_node.ts:644
Iterate self and descendants in reverse post-order (bottom-to-top).
Child nodes can be safely removed during this iteration.
Parameters
callback
Called for each node; if returns true, iteration stops.
Returns
boolean
If returns true, the iteration will immediately stop.
Inherited from
MeshBase.iterateBottomToTop
isLight()
isLight():
this is BaseLight
Defined in: libs/scene/src/scene/scene_node.ts:661
Type guard: true if this node is a light.
Returns
this is BaseLight
Inherited from
MeshBase.isLight
isSprite()
isSprite():
this is Sprite
Defined in: libs/scene/src/scene/scene_node.ts:669
Type guard: true if this node is a sprite
Returns
this is Sprite
Inherited from
MeshBase.isSprite
isMSDFTextSprite()
isMSDFTextSprite():
this is MSDFTextSprite
Defined in: libs/scene/src/scene/scene_node.ts:673
Type guard: true if this node is a MSDF text sprite
Returns
this is MSDFTextSprite
Inherited from
MeshBase.isMSDFTextSprite
isMSDFText()
isMSDFText():
this is MSDFText
Defined in: libs/scene/src/scene/scene_node.ts:677
Type guard: true if this node is a MSDF text sprite
Returns
this is MSDFText
Inherited from
MeshBase.isMSDFText
isWater()
isWater():
this is Water
Defined in: libs/scene/src/scene/scene_node.ts:681
Type guard: true if this node is a water node.
Returns
this is Water
Inherited from
MeshBase.isWater
isParticleSystem()
isParticleSystem():
this is ParticleSystem
Defined in: libs/scene/src/scene/scene_node.ts:685
Type guard: true if this node is a particle system.
Returns
this is ParticleSystem
Inherited from
MeshBase.isParticleSystem
isBatchGroup()
isBatchGroup():
this is BatchGroup
Defined in: libs/scene/src/scene/scene_node.ts:689
Type guard: true if this node is a batch group.
Returns
this is BatchGroup
Inherited from
MeshBase.isBatchGroup
isClipmapTerrain()
isClipmapTerrain():
this is ClipmapTerrain
Defined in: libs/scene/src/scene/scene_node.ts:693
Type guard: true if this node is a clipmap terrain.
Returns
this is ClipmapTerrain
Inherited from
MeshBase.isClipmapTerrain
isCamera()
isCamera():
this is Camera
Defined in: libs/scene/src/scene/scene_node.ts:697
true if this is a camera node, false otherwise
Returns
this is Camera
Inherited from
MeshBase.isCamera
isPunctualLight()
isPunctualLight():
this is PunctualLight
Defined in: libs/scene/src/scene/scene_node.ts:701
true if this is a punctual light node, false otherwise
Returns
this is PunctualLight
Inherited from
MeshBase.isPunctualLight
getBoundingVolume()
getBoundingVolume():
BoundingVolume
Defined in: libs/scene/src/scene/scene_node.ts:715
Gets the bounding volume of the node
Returns
The bounding volume of the node
Inherited from
MeshBase.getBoundingVolume
setBoundingVolume()
setBoundingVolume(
bv):void
Defined in: libs/scene/src/scene/scene_node.ts:726
Sets the bounding volume of the node
Parameters
bv
The bounding volume to set
Returns
void
Inherited from
MeshBase.setBoundingVolume
getWorldBoundingVolume()
getWorldBoundingVolume():
BoundingVolume
Defined in: libs/scene/src/scene/scene_node.ts:737
Gets the world space bounding volume of the node
Returns
The world space bounding volume of the node
Inherited from
MeshBase.getWorldBoundingVolume
computeWorldBoundingVolume()
computeWorldBoundingVolume(
localBV):BoundingVolume
Defined in: libs/scene/src/scene/scene_node.ts:747
Computes the world space bounding volume of the node
Parameters
localBV
Returns
The output bounding volume
Inherited from
MeshBase.computeWorldBoundingVolume
invalidateBoundingVolume()
invalidateBoundingVolume():
void
Defined in: libs/scene/src/scene/scene_node.ts:753
Force the bounding volume to be recalculated
Returns
void
Inherited from
MeshBase.invalidateBoundingVolume
invalidateWorldBoundingVolume()
invalidateWorldBoundingVolume(
transformChanged):void
Defined in: libs/scene/src/scene/scene_node.ts:758
Force the world space bounding volume to be recalculated
Parameters
transformChanged
boolean
Returns
void
Inherited from
MeshBase.invalidateWorldBoundingVolume
findNodeById()
findNodeById<
T>(id):T
Defined in: libs/scene/src/scene/scene_node.ts:830
Finds a scene node by its persistent ID.
Type Parameters
T
T extends SceneNode
Expected node type.
Parameters
id
string
Persistent identifier to match against SceneNode.persistentId.
Returns
T
The first matching node, or null if not found.
Inherited from
MeshBase.findNodeById
findSkeletonById()
findSkeletonById(
id):SkinBinding
Defined in: libs/scene/src/scene/scene_node.ts:845
Finds a skeleton object by its persistent ID.
Parameters
id
string
Persistent identifier to match against Skeleton.persistentId.
Returns
The first matchign node, or null if not found.
Inherited from
MeshBase.findSkeletonById
findSkinBindingById()
findSkinBindingById(
id):SkinBinding
Defined in: libs/scene/src/scene/scene_node.ts:853
Finds a skin binding by its persistent ID.
Parameters
id
string
Persistent identifier to match against SkinBinding.persistentId.
Returns
The first matching binding, or null if not found.
Inherited from
MeshBase.findSkinBindingById
findSkeletonRigById()
findSkeletonRigById(
id):SkeletonRig
Defined in: libs/scene/src/scene/scene_node.ts:868
Finds a shared skeleton rig by its persistent ID.
Parameters
id
string
Persistent identifier to match against SkeletonRig.persistentId.
Returns
The first matching rig, or null if not found.
Inherited from
MeshBase.findSkeletonRigById
findNodeByName()
findNodeByName<
T>(name):T
Defined in: libs/scene/src/scene/scene_node.ts:890
Finds a scene node by name.
If multiple nodes share the same name, returns the first match encountered during traversal.
Type Parameters
T
T extends SceneNode
Expected node type.
Parameters
name
string
Node name to match.
Returns
T
The first matching node, or null if not found.
Remarks
Names are not guaranteed unique. Prefer IDs for stable references.
Inherited from
MeshBase.findNodeByName
getSerializedMorphTargetGroups()
getSerializedMorphTargetGroups():
SerializedMorphTargetGroup[]
Defined in: libs/scene/src/scene/scene_node.ts:973
Returns serialized morph target groups for this node.
Returns
Inherited from
MeshBase.getSerializedMorphTargetGroups
setSerializedMorphTargetGroups()
setSerializedMorphTargetGroups(
groups):void
Defined in: libs/scene/src/scene/scene_node.ts:991
Restores serialized morph target groups for this node.
Parameters
groups
Returns
void
Inherited from
MeshBase.setSerializedMorphTargetGroups
invalidateTransform()
invalidateTransform(
invalidateLocal?):void
Defined in: libs/scene/src/scene/scene_node.ts:1027
Force transform update and notify descendants.
Parameters
invalidateLocal?
boolean = true
If true, also invalidate local matrix; otherwise only invalidate world matrix.
Returns
void
Inherited from
MeshBase.invalidateTransform
setMorphTargetWeight()
setMorphTargetWeight(
name,weight):void
Defined in: libs/scene/src/scene/scene_node.ts:1035
Set morph target weight by name for all meshes in the subtree.
Parameters
name
string
Morph target name
weight
number
Morph target weight
Returns
void
Inherited from
MeshBase.setMorphTargetWeight
setMorphTargetGroupWeight()
setMorphTargetGroupWeight(
name,weight):void
Defined in: libs/scene/src/scene/scene_node.ts:1051
Set morph target group weight for the model instance.
Parameters
name
string
Morph target group name
weight
number
Group weight
Returns
void
Inherited from
MeshBase.setMorphTargetGroupWeight
getMorphTargetGroupWeight()
getMorphTargetGroupWeight(
name):number
Defined in: libs/scene/src/scene/scene_node.ts:1073
Get morph target group weight.
Parameters
name
string
Morph target group name
Returns
number
The group weight, or 0 if no group was found
Inherited from
MeshBase.getMorphTargetGroupWeight
collectMorphTargetNames()
collectMorphTargetNames():
string[]
Defined in: libs/scene/src/scene/scene_node.ts:1081
Collect all morph target names from meshes in the subtree.
Returns
string[]
Array of unique morph target names
Inherited from
MeshBase.collectMorphTargetNames
collectMorphTargetGroupNames()
collectMorphTargetGroupNames():
string[]
Defined in: libs/scene/src/scene/scene_node.ts:1097
Collect all model-level morph target group names.
Returns
string[]
Array of morph target group names
Inherited from
MeshBase.collectMorphTargetGroupNames
onPostClone()
protectedonPostClone():void|Promise<void>
Defined in: libs/scene/src/scene/scene_node.ts:1106
Get called when the node was just created by cloning from other node
Returns
void | Promise<void>
Inherited from
MeshBase.onPostClone
_onAttached()
protected_onAttached():void
Defined in: libs/scene/src/scene/scene_node.ts:1174
Get called when this node is attached to scene
Returns
void
Inherited from
MeshBase._onAttached
_onDetached()
protected_onDetached():void
Defined in: libs/scene/src/scene/scene_node.ts:1178
Get called when this node is detached from scene
Returns
void
Inherited from
MeshBase._onDetached
worldToThis()
Call Signature
worldToThis(
v,result?):Vector3
Defined in: libs/scene/src/scene/scene_node.ts:1249
Transform world coordinate to local space
Parameters
v
Vector3
point or vector in world space
result?
Vector3
The output result
Returns
Vector3
The transformed local space coordinate
Inherited from
MeshBase.worldToThis
Call Signature
worldToThis(
v,result?):Vector4
Defined in: libs/scene/src/scene/scene_node.ts:1250
Transform world coordinate to local space
Parameters
v
Vector4
point or vector in world space
result?
Vector4
The output result
Returns
Vector4
The transformed local space coordinate
Inherited from
MeshBase.worldToThis
otherToThis()
Call Signature
otherToThis(
other,v,result?):Vector3
Defined in: libs/scene/src/scene/scene_node.ts:1269
Transform coordinate in other coordinate space to local space
Parameters
other
The other coordinate space
v
Vector3
point or vector in other coordinate space
result?
Vector3
The output result
Returns
Vector3
The transformed local space coordinate
Inherited from
MeshBase.otherToThis
Call Signature
otherToThis(
other,v,result?):Vector4
Defined in: libs/scene/src/scene/scene_node.ts:1270
Transform coordinate in other coordinate space to local space
Parameters
other
The other coordinate space
v
Vector4
point or vector in other coordinate space
result?
Vector4
The output result
Returns
Vector4
The transformed local space coordinate
Inherited from
MeshBase.otherToThis
thisToWorld()
Call Signature
thisToWorld(
v,result?):Vector3
Defined in: libs/scene/src/scene/scene_node.ts:1280
Transform local coordinate to world space
Parameters
v
Vector3
point or vector in local space
result?
Vector3
The output result
Returns
Vector3
The transformed world space coordinate
Inherited from
MeshBase.thisToWorld
Call Signature
thisToWorld(
v,result?):Vector4
Defined in: libs/scene/src/scene/scene_node.ts:1281
Transform local coordinate to world space
Parameters
v
Vector4
point or vector in local space
result?
Vector4
The output result
Returns
Vector4
The transformed world space coordinate
Inherited from
MeshBase.thisToWorld
thisToOther()
Call Signature
thisToOther(
other,v,result?):Vector3
Defined in: libs/scene/src/scene/scene_node.ts:1300
Transform local space coordinate to other coordinate space
Parameters
other
The other coordinate space
v
Vector3
point or vector in localspace
result?
Vector3
The output result
Returns
Vector3
The transformed coordinate in other coordinate space
Inherited from
MeshBase.thisToOther
Call Signature
thisToOther(
other,v,result?):Vector4
Defined in: libs/scene/src/scene/scene_node.ts:1301
Transform local space coordinate to other coordinate space
Parameters
other
The other coordinate space
v
Vector4
point or vector in localspace
result?
Vector4
The output result
Returns
Vector4
The transformed coordinate in other coordinate space
Inherited from
MeshBase.thisToOther
getWorldPosition()
getWorldPosition(
outPos?):Vector3
Defined in: libs/scene/src/scene/scene_node.ts:1309
Gets the position of the xform in world space
Parameters
outPos?
Vector3
Returns
Vector3
position of the xform in world space
Inherited from
MeshBase.getWorldPosition
moveBy()
moveBy(
delta):Mesh
Defined in: libs/scene/src/scene/scene_node.ts:1320
Moves the xform by an offset vector
Parameters
delta
Vector3
The offset vector
Returns
Mesh
self
Inherited from
MeshBase.moveBy
scaleBy()
scaleBy(
factor):Mesh
Defined in: libs/scene/src/scene/scene_node.ts:1329
Scales the xform by a given scale factor
Parameters
factor
Vector3
The scale factor
Returns
Mesh
self
Inherited from
MeshBase.scaleBy
setLocalTransform()
setLocalTransform(
matrix):Mesh
Defined in: libs/scene/src/scene/scene_node.ts:1338
Sets the local transform matrix of the xform
Parameters
matrix
Matrix4x4
The transform matrix to set
Returns
Mesh
self
Inherited from
MeshBase.setLocalTransform
calculateLocalTransform()
calculateLocalTransform(
outMatrix):void
Defined in: libs/scene/src/scene/scene_node.ts:1375
Calculate local transform matrix
Parameters
outMatrix
Matrix4x4
Matrix object that holds the result of calculation
Returns
void
Inherited from
MeshBase.calculateLocalTransform
calculateWorldTransform()
calculateWorldTransform(
outMatrix):void
Defined in: libs/scene/src/scene/scene_node.ts:1382
Calculate world transform matrix
Parameters
outMatrix
Matrix4x4
Matrix object that holds the result of calculation
Returns
void
Inherited from
MeshBase.calculateWorldTransform
lookAt()
lookAt(
eye,target,up):Mesh
Defined in: libs/scene/src/scene/scene_node.ts:1396
Sets the local tranformation matrix by a look-at matrix
Parameters
eye
Vector3
The eye position used to make the look-at matrix
target
Vector3
The target position used to make the look-at matrix
up
Vector3
The up vector used to make the look-at matrix
Returns
Mesh
self
Inherited from
MeshBase.lookAt
updatePerCamera()
updatePerCamera(
_camera,_elapsedInSeconds,_deltaInSeconds):void
Defined in: libs/scene/src/scene/scene_node.ts:1426
Update node state once per-camera
Parameters
_camera
Updates according to which camera
_elapsedInSeconds
number
Elapsed time from game start in seconds
_deltaInSeconds
number
Elapsed time since previous frame in seconds
Returns
void
Inherited from
MeshBase.updatePerCamera
reparent()
reparent(
p?):Mesh
Defined in: libs/scene/src/scene/scene_node.ts:1432
Removes this node from it's parent and add this node to another parent node if required
Parameters
p?
The new parent node that this node should be added to or null
Returns
Mesh
self
Inherited from
MeshBase.reparent