Documentation / scene / TextSprite

Class: TextSprite

Defined in: libs/scene/src/scene/textsprite.ts:15

3D Text Sprite node

Extends

• BaseSprite<StandardSpriteMaterial>

Constructors

Constructor

new TextSprite(scene): TextSprite

Defined in: libs/scene/src/scene/textsprite.ts:22

Parameters

scene

Scene

Returns

TextSprite

Overrides

BaseSprite.constructor

Properties

objectColor

readonly objectColor: Vector4

Defined in: libs/scene/src/render/drawable_mixin.ts:13

Inherited from

BaseSprite.objectColor

---

BBOXDRAW_INHERITED

readonly static BBOXDRAW_INHERITED: -1 = -1

Defined in: libs/scene/src/scene/scene_node.ts:167

Bounding-box draw mode inherited from nearest graph ancestor.

Inherited from

BaseSprite.BBOXDRAW_INHERITED

---

BBOXDRAW_DISABLED

readonly static BBOXDRAW_DISABLED: 0 = 0

Defined in: libs/scene/src/scene/scene_node.ts:169

Disable bounding-box visualization.

Inherited from

BaseSprite.BBOXDRAW_DISABLED

---

BBOXDRAW_LOCAL

readonly static BBOXDRAW_LOCAL: 1 = 1

Defined in: libs/scene/src/scene/scene_node.ts:171

Draw local-space bounding box.

Inherited from

BaseSprite.BBOXDRAW_LOCAL

---

BBOXDRAW_WORLD

readonly static BBOXDRAW_WORLD: 2 = 2

Defined in: libs/scene/src/scene/scene_node.ts:173

Draw world-space bounding box.

Inherited from

BaseSprite.BBOXDRAW_WORLD

Accessors

disposed

Get Signature

get disposed(): boolean

Defined in: libs/base/dist/index.d.ts:6107

Returns

boolean

Inherited from

BaseSprite.disposed

---

material

Get Signature

get material(): M

Defined in: libs/scene/src/scene/basesprite.ts:89

Material of the mesh

Returns

M

Set Signature

set material(m): void

Defined in: libs/scene/src/scene/basesprite.ts:92

Parameters

m

M

Returns

void

Inherited from

BaseSprite.material

---

anchorX

Get Signature

get anchorX(): number

Defined in: libs/scene/src/scene/basesprite.ts:104

Returns

number

Set Signature

set anchorX(value): void

Defined in: libs/scene/src/scene/basesprite.ts:107

Parameters

value

number

Returns

void

Inherited from

BaseSprite.anchorX

---

anchorY

Get Signature

get anchorY(): number

Defined in: libs/scene/src/scene/basesprite.ts:117

Returns

number

Set Signature

set anchorY(value): void

Defined in: libs/scene/src/scene/basesprite.ts:120

Parameters

value

number

Returns

void

Inherited from

BaseSprite.anchorY

---

uvTopLeft

Get Signature

get uvTopLeft(): Vector2

Defined in: libs/scene/src/scene/basesprite.ts:130

Returns

Vector2

Set Signature

set uvTopLeft(value): void

Defined in: libs/scene/src/scene/basesprite.ts:134

Parameters

value

Vector2

Returns

void

Inherited from

BaseSprite.uvTopLeft

---

uvBottomRight

Get Signature

get uvBottomRight(): Vector2

Defined in: libs/scene/src/scene/basesprite.ts:138

Returns

Vector2

Set Signature

set uvBottomRight(value): void

Defined in: libs/scene/src/scene/basesprite.ts:142

Parameters

value

Vector2

Returns

void

Inherited from

BaseSprite.uvBottomRight

---

placeToOctree

Get Signature

get placeToOctree(): boolean

Defined in: libs/scene/src/scene/scene_node.ts:313

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:316

Parameters

val

boolean

Returns

void

Inherited from

BaseSprite.placeToOctree

---

runtimeId

Get Signature

get runtimeId(): number

Defined in: libs/scene/src/scene/scene_node.ts:327

Node's runtime unique identifier

Returns

number

Inherited from

BaseSprite.runtimeId

---

persistentId

Get Signature

get persistentId(): string

Defined in: libs/scene/src/scene/scene_node.ts:336

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:339

Parameters

id

string

Returns

void

Inherited from

BaseSprite.persistentId

---

prefabId

Get Signature

get prefabId(): string

Defined in: libs/scene/src/scene/scene_node.ts:348

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:351

Parameters

id

string

Returns

void

Inherited from

BaseSprite.prefabId

---

jointTypeT

Get Signature

get jointTypeT(): "none" | "animated" | "static"

Defined in: libs/scene/src/scene/scene_node.ts:367

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:370

Parameters

val

"none" | "animated" | "static"

Returns

void

Inherited from

BaseSprite.jointTypeT

---

jointTypeS

Get Signature

get jointTypeS(): "none" | "animated" | "static"

Defined in: libs/scene/src/scene/scene_node.ts:379

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:382

Parameters

val

"none" | "animated" | "static"

Returns

void

Inherited from

BaseSprite.jointTypeS

---

jointTypeR

Get Signature

get jointTypeR(): "none" | "animated" | "static"

Defined in: libs/scene/src/scene/scene_node.ts:391

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:394

Parameters

val

"none" | "animated" | "static"

Returns

void

Inherited from

BaseSprite.jointTypeR

---

metaData

Get Signature

get metaData(): Metadata

Defined in: libs/scene/src/scene/scene_node.ts:403

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:406

Parameters

val

Metadata

Returns

void

Inherited from

BaseSprite.metaData

---

script

Get Signature

get script(): string

Defined in: libs/scene/src/scene/scene_node.ts:415

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:418

Parameters

fileName

string

Returns

void

Inherited from

BaseSprite.script

---

scriptConfig

Get Signature

get scriptConfig(): object | unknown[]

Defined in: libs/scene/src/scene/scene_node.ts:431

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:434

Parameters

value

object | unknown[]

Returns

void

Inherited from

BaseSprite.scriptConfig

---

scripts

Get Signature

get scripts(): ScriptAttachment[]

Defined in: libs/scene/src/scene/scene_node.ts:448

All script attachments on this node.

Returns

ScriptAttachment[]

Set Signature

set scripts(value): void

Defined in: libs/scene/src/scene/scene_node.ts:451

Parameters

value

ScriptAttachment[]

Returns

void

Inherited from

BaseSprite.scripts

---

scriptConfigs

Get Signature

get scriptConfigs(): unknown[]

Defined in: libs/scene/src/scene/scene_node.ts:457

Script configs for all script attachments.

Returns

unknown[]

Set Signature

set scriptConfigs(value): void

Defined in: libs/scene/src/scene/scene_node.ts:460

Parameters

value

unknown[]

Returns

void

Inherited from

BaseSprite.scriptConfigs

---

name

Get Signature

get name(): string

Defined in: libs/scene/src/scene/scene_node.ts:475

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:478

Parameters

val

string

Returns

void

Inherited from

BaseSprite.name

---

scene

Get Signature

get scene(): Scene

Defined in: libs/scene/src/scene/scene_node.ts:482

The owning scene.

Returns

Scene

Inherited from

BaseSprite.scene

---

attached

Get Signature

get attached(): boolean

Defined in: libs/scene/src/scene/scene_node.ts:488

Whether this node is currently attached under the scene's root.

Returns

boolean

Inherited from

BaseSprite.attached

---

sealed

Get Signature

get sealed(): boolean

Defined in: libs/scene/src/scene/scene_node.ts:502

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:505

Parameters

val

boolean

Returns

void

Inherited from

BaseSprite.sealed

---

animationSet

Get Signature

get animationSet(): AnimationSet

Defined in: libs/scene/src/scene/scene_node.ts:514

Lazily created animation set for this node.

Remarks

Accessing this schedules the node for update in the scene.

Returns

AnimationSet

Inherited from

BaseSprite.animationSet

---

sharedModel

Get Signature

get sharedModel(): SharedModel

Defined in: libs/scene/src/scene/scene_node.ts:524

Shared model reference for instancing/streaming systems.

Returns

SharedModel

Set Signature

set sharedModel(model): void

Defined in: libs/scene/src/scene/scene_node.ts:527

Parameters

model

SharedModel

Returns

void

Inherited from

BaseSprite.sharedModel

---

morphTargetGroups

Get Signature

get morphTargetGroups(): SceneMorphTargetGroup[]

Defined in: libs/scene/src/scene/scene_node.ts:531

Runtime morph target groups bound to this model instance.

Returns

SceneMorphTargetGroup[]

Set Signature

set morphTargetGroups(groups): void

Defined in: libs/scene/src/scene/scene_node.ts:534

Parameters

groups

SceneMorphTargetGroup[]

Returns

void

Inherited from

BaseSprite.morphTargetGroups

---

clipTestEnabled

Get Signature

get clipTestEnabled(): boolean

Defined in: libs/scene/src/scene/scene_node.ts:779

Clip mode

Returns

boolean

Set Signature

set clipTestEnabled(val): void

Defined in: libs/scene/src/scene/scene_node.ts:782

Parameters

val

boolean

Returns

void

Inherited from

BaseSprite.clipTestEnabled

---

hidden

Get Signature

get hidden(): boolean

Defined in: libs/scene/src/scene/scene_node.ts:786

Computed value of show state

Returns

boolean

Inherited from

BaseSprite.hidden

---

showState

Get Signature

get showState(): SceneNodeVisible

Defined in: libs/scene/src/scene/scene_node.ts:794

Show state

Returns

SceneNodeVisible

Set Signature

set showState(val): void

Defined in: libs/scene/src/scene/scene_node.ts:797

Parameters

val

SceneNodeVisible

Returns

void

Inherited from

BaseSprite.showState

---

pickable

Get Signature

get pickable(): boolean

Defined in: libs/scene/src/scene/scene_node.ts:815

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:818

Parameters

val

boolean

Returns

void

Inherited from

BaseSprite.pickable

---

gpuPickable

Get Signature

get gpuPickable(): boolean

Defined in: libs/scene/src/scene/scene_node.ts:822

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:825

Parameters

val

boolean

Returns

void

Inherited from

BaseSprite.gpuPickable

---

computedBoundingBoxDrawMode

Get Signature

get computedBoundingBoxDrawMode(): number

Defined in: libs/scene/src/scene/scene_node.ts:907

Computed value for bounding box draw mode

Returns

number

Inherited from

BaseSprite.computedBoundingBoxDrawMode

---

boundingBoxDrawMode

Get Signature

get boundingBoxDrawMode(): number

Defined in: libs/scene/src/scene/scene_node.ts:918

Bounding box draw mode

Returns

number

Set Signature

set boundingBoxDrawMode(mode): void

Defined in: libs/scene/src/scene/scene_node.ts:921

Parameters

mode

number

Returns

void

Inherited from

BaseSprite.boundingBoxDrawMode

---

parent

Get Signature

get parent(): SceneNode

Defined in: libs/scene/src/scene/scene_node.ts:1211

Parent of the xform

Returns

SceneNode

Set Signature

set parent(p): void

Defined in: libs/scene/src/scene/scene_node.ts:1214

Parameters

p

SceneNode

Returns

void

Inherited from

BaseSprite.parent

---

children

Get Signature

get children(): SceneNode[]

Defined in: libs/scene/src/scene/scene_node.ts:1220

Children of this xform

Returns

SceneNode[]

Inherited from

BaseSprite.children

---

position

Get Signature

get position(): Vector3

Defined in: libs/scene/src/scene/scene_node.ts:1226

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:1229

Parameters

val

Vector3

Returns

void

Inherited from

BaseSprite.position

---

scale

Get Signature

get scale(): Vector3

Defined in: libs/scene/src/scene/scene_node.ts:1235

Scaling of the xform

Returns

Vector3

Set Signature

set scale(val): void

Defined in: libs/scene/src/scene/scene_node.ts:1238

Parameters

val

Vector3

Returns

void

Inherited from

BaseSprite.scale

---

rotation

Get Signature

get rotation(): Quaternion

Defined in: libs/scene/src/scene/scene_node.ts:1244

Rotation of the xform

Returns

Quaternion

Set Signature

set rotation(val): void

Defined in: libs/scene/src/scene/scene_node.ts:1247

Parameters

val

Quaternion

Returns

void

Inherited from

BaseSprite.rotation

---

localMatrix

Get Signature

get localMatrix(): Immutable<Matrix4x4>

Defined in: libs/scene/src/scene/scene_node.ts:1353

Local transformation matrix of the xform

Returns

Immutable<Matrix4x4>

Set Signature

set localMatrix(matrix): void

Defined in: libs/scene/src/scene/scene_node.ts:1360

Parameters

matrix

Immutable<Matrix4x4>

Returns

void

Inherited from

BaseSprite.localMatrix

---

worldMatrix

Get Signature

get worldMatrix(): Immutable<Matrix4x4>

Defined in: libs/scene/src/scene/scene_node.ts:1364

World transformation matrix of the xform

Returns

Immutable<Matrix4x4>

Inherited from

BaseSprite.worldMatrix

---

worldMatrixDet

Get Signature

get worldMatrixDet(): number

Defined in: libs/scene/src/scene/scene_node.ts:1369

The determinant of world matrix

Returns

number

Inherited from

BaseSprite.worldMatrixDet

---

invWorldMatrix

Get Signature

get invWorldMatrix(): Immutable<Matrix4x4>

Defined in: libs/scene/src/scene/scene_node.ts:1374

Inverse of the world transformation matrix of the xform

Returns

Immutable<Matrix4x4>

Inherited from

BaseSprite.invWorldMatrix

---

resolutionX

Get Signature

get resolutionX(): number

Defined in: libs/scene/src/scene/textsprite.ts:38

Returns

number

Set Signature

set resolutionX(value): void

Defined in: libs/scene/src/scene/textsprite.ts:41

Parameters

value

number

Returns

void

---

resolutionY

Get Signature

get resolutionY(): number

Defined in: libs/scene/src/scene/textsprite.ts:47

Returns

number

Set Signature

set resolutionY(value): void

Defined in: libs/scene/src/scene/textsprite.ts:50

Parameters

value

number

Returns

void

---

text

Get Signature

get text(): string

Defined in: libs/scene/src/scene/textsprite.ts:56

Returns

string

Set Signature

set text(value): void

Defined in: libs/scene/src/scene/textsprite.ts:59

Parameters

value

string

Returns

void

---

textColor

Get Signature

get textColor(): Immutable<Vector3>

Defined in: libs/scene/src/scene/textsprite.ts:65

Returns

Immutable<Vector3>

Set Signature

set textColor(value): void

Defined in: libs/scene/src/scene/textsprite.ts:68

Parameters

value

Immutable<Vector3>

Returns

void

---

font

Get Signature

get font(): string

Defined in: libs/scene/src/scene/textsprite.ts:74

Returns

string

Set Signature

set font(value): void

Defined in: libs/scene/src/scene/textsprite.ts:77

Parameters

value

string

Returns

void

Methods

isPrototypeOf()

static isPrototypeOf(v): boolean

Defined in: libs/base/dist/index.d.ts:80

Parameters

v

object

Returns

boolean

Inherited from

BaseSprite.isPrototypeOf

---

on()

Call Signature

on<K>(type, listener, context?): void

Defined in: libs/base/dist/index.d.ts:671

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

BaseSprite.on

Call Signature

on<K>(type, listener, context?): void

Defined in: libs/base/dist/index.d.ts:630

IEventTarget.on

Type Parameters

K

K extends "dispose"

Parameters

type

K

listener

EventListener<{ dispose: []; }, K>

context?

unknown

Returns

void

Inherited from

BaseSprite.on

---

once()

Call Signature

once<K>(type, listener, context?): void

Defined in: libs/base/dist/index.d.ts:675

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

BaseSprite.once

Call Signature

once<K>(type, listener, context?): void

Defined in: libs/base/dist/index.d.ts:634

IEventTarget.once

Type Parameters

K

K extends "dispose"

Parameters

type

K

listener

EventListener<{ dispose: []; }, K>

context?

unknown

Returns

void

Inherited from

BaseSprite.once

---

off()

Call Signature

off<K>(type, listener, context?): void

Defined in: libs/base/dist/index.d.ts:679

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

BaseSprite.off

Call Signature

off<K>(type, listener?, context?): void

Defined in: libs/base/dist/index.d.ts:638

IEventTarget.off

Type Parameters

K

K extends "dispose"

Parameters

type

K

listener?

EventListener<{ dispose: []; }>

context?

unknown

Returns

void

Inherited from

BaseSprite.off

---

dispatchEvent()

Call Signature

dispatchEvent<K>(type, ...args): void

Defined in: libs/base/dist/index.d.ts:683

IEventTarget.dispatchEvent

Type Parameters

K

K extends "dispose" | "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged"

Parameters

type

K

args

...object & object[K]

Returns

void

Inherited from

BaseSprite.dispatchEvent

Call Signature

dispatchEvent<K>(type, ...args): void

Defined in: libs/base/dist/index.d.ts:642

IEventTarget.dispatchEvent

Type Parameters

K

K extends "dispose"

Parameters

type

K

args

...object[K]

Returns

void

Inherited from

BaseSprite.dispatchEvent

---

dispose()

dispose(): void

Defined in: libs/base/dist/index.d.ts:6108

Releases all GPU resources and detaches from the renderer.

Returns

void

Inherited from

BaseSprite.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

Inherited from

BaseSprite.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

RenderQueueRef

Returns

void

Inherited from

BaseSprite.pushRenderQueueRef

---

applyInstanceOffsetAndStride()

applyInstanceOffsetAndStride(renderQueue, stride, offset): void

Defined in: libs/scene/src/render/drawable_mixin.ts:16

Parameters

renderQueue

RenderQueue

stride

number

offset

number

Returns

void

Inherited from

BaseSprite.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

RenderQueue

The current render queue issuing this draw.

Returns

void

Inherited from

BaseSprite.applyTransformUniforms

---

applyMaterialUniforms()

applyMaterialUniforms(instanceInfo): void

Defined in: libs/scene/src/render/drawable_mixin.ts:18

Parameters

instanceInfo

DrawableInstanceInfo

Returns

void

Inherited from

BaseSprite.applyMaterialUniforms

---

applyMaterialUniformsAll()

applyMaterialUniformsAll(): void

Defined in: libs/scene/src/render/drawable_mixin.ts:19

Returns

void

Inherited from

BaseSprite.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

Inherited from

BaseSprite.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

Inherited from

BaseSprite.updateState

---

bind()

bind(ctx, renderQueue): void

Defined in: libs/scene/src/render/drawable_mixin.ts:22

Parameters

ctx

DrawContext

renderQueue

RenderQueue

Returns

void

Inherited from

BaseSprite.bind

---

getInstanceId()

getInstanceId(_renderPass): string

Defined in: libs/scene/src/scene/basesprite.ts:70

Returns the batch instance ID for the current render pass.

Parameters

_renderPass

RenderPass

Returns

string

Inherited from

BaseSprite.getInstanceId

---

getInstanceUniforms()

getInstanceUniforms(): Float32Array<ArrayBuffer>

Defined in: libs/scene/src/scene/basesprite.ts:76

Returns the packed instance-uniform buffer used for batching.

Returns

Float32Array<ArrayBuffer>

Inherited from

BaseSprite.getInstanceUniforms

---

getPickTarget()

getPickTarget(): PickTarget

Defined in: libs/scene/src/scene/basesprite.ts:82

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

PickTarget

Inherited from

BaseSprite.getPickTarget

---

setPickTarget()

setPickTarget(node, label?): void

Defined in: libs/scene/src/scene/basesprite.ts:85

Parameters

node

SceneNode

label?

string

Returns

void

Inherited from

BaseSprite.setPickTarget

---

getMorphData()

getMorphData(): any

Defined in: libs/scene/src/scene/basesprite.ts:149

Returns the morph target data texture (if morphing is used).

Returns

any

Inherited from

BaseSprite.getMorphData

---

getMorphInfo()

getMorphInfo(): any

Defined in: libs/scene/src/scene/basesprite.ts:155

Returns the morph information buffer (weights, ranges, etc.).

Returns

any

Inherited from

BaseSprite.getMorphInfo

---

isBatchable()

isBatchable(): this is BatchDrawable

Defined in: libs/scene/src/scene/basesprite.ts:161

Returns true if the object supports instanced rendering.

When true, the object should also implement the BatchDrawable methods.

Returns

this is BatchDrawable

Inherited from

BaseSprite.isBatchable

---

getQueueType()

getQueueType(): number

Defined in: libs/scene/src/scene/basesprite.ts:167

Returns the type/category of render queue this object belongs to.

Returns

number

Inherited from

BaseSprite.getQueueType

---

isUnlit()

isUnlit(): boolean

Defined in: libs/scene/src/scene/basesprite.ts:173

True if shading is unlit (does not depend on scene lighting).

Returns

boolean

Inherited from

BaseSprite.isUnlit

---

needSceneColor()

needSceneColor(): boolean

Defined in: libs/scene/src/scene/basesprite.ts:179

Whether the object requires access to the scene color buffer.

Returns

boolean

Inherited from

BaseSprite.needSceneColor

---

needSceneDepth()

needSceneDepth(): boolean

Defined in: libs/scene/src/scene/basesprite.ts:185

Whether the object requires access to the scene depth (linear or non-linear).

Returns

boolean

Inherited from

BaseSprite.needSceneDepth

---

draw()

draw(ctx, renderQueue, hash?): void

Defined in: libs/scene/src/scene/basesprite.ts:191

Issues draw commands for this object.

Parameters

ctx

DrawContext

Full draw context for the current pass.

renderQueue

RenderQueue

The current render queue issuing this draw.

hash?

string

Optional hash key for render bundle or pipeline caching.

Returns

void

Inherited from

BaseSprite.draw

---

getMaterial()

getMaterial(): StandardSpriteMaterial

Defined in: libs/scene/src/scene/basesprite.ts:218

Returns the bound material driving shading for this drawable.

Returns

StandardSpriteMaterial

Inherited from

BaseSprite.getMaterial

---

getPrimitive()

getPrimitive(): Primitive

Defined in: libs/scene/src/scene/basesprite.ts:224

Returns the geometry primitive to be drawn.

Returns

Primitive

Inherited from

BaseSprite.getPrimitive

---

getBoneMatrices()

getBoneMatrices(): any

Defined in: libs/scene/src/scene/basesprite.ts:238

Returns the texture containing bone matrices for skinned meshes.

Returns

any

Inherited from

BaseSprite.getBoneMatrices

---

getSkinInfluenceData()

getSkinInfluenceData(): SkinInfluenceData

Defined in: libs/scene/src/scene/basesprite.ts:244

Returns additional per-vertex skinning influences packed in a texture, if needed.

Returns

SkinInfluenceData

Inherited from

BaseSprite.getSkinInfluenceData

---

getNode()

getNode(): TextSprite

Defined in: libs/scene/src/scene/basesprite.ts:250

Returns the owning scene node (transform and hierarchy).

Returns

TextSprite

Inherited from

BaseSprite.getNode

---

computeBoundingVolume()

computeBoundingVolume(): any

Defined in: libs/scene/src/scene/basesprite.ts:257

Computes the bounding volume of the node

Returns

any

The output bounding volume

Inherited from

BaseSprite.computeBoundingVolume

---

computeWorldBoundingVolume()

computeWorldBoundingVolume(): BoundingBox

Defined in: libs/scene/src/scene/basesprite.ts:263

Computes the world space bounding volume of the node

Returns

BoundingBox

The output bounding volume

Inherited from

BaseSprite.computeWorldBoundingVolume

---

calculateLocalTransform()

calculateLocalTransform(outMatrix): void

Defined in: libs/scene/src/scene/basesprite.ts:279

Calculate local transform matrix

Parameters

outMatrix

Matrix4x4

Matrix object that holds the result of calculation

Returns

void

Inherited from

BaseSprite.calculateLocalTransform

---

calculateWorldTransform()

calculateWorldTransform(outMatrix): void

Defined in: libs/scene/src/scene/basesprite.ts:290

Calculate world transform matrix

Parameters

outMatrix

Matrix4x4

Matrix object that holds the result of calculation

Returns

void

Inherited from

BaseSprite.calculateWorldTransform

---

onSetMaterial()

protected onSetMaterial(material): void

Defined in: libs/scene/src/scene/basesprite.ts:299

Called when new material is set

Parameters

material

StandardSpriteMaterial

Returns

void

Inherited from

BaseSprite.onSetMaterial

---

onDispose()

protected onDispose(): void

Defined in: libs/scene/src/scene/basesprite.ts:304

Disposes the mesh node

Returns

void

Inherited from

BaseSprite.onDispose

---

getName()

getName(): string

Defined in: libs/scene/src/scene/graph_node.ts:36

Gets the name

Returns

string

Inherited from

BaseSprite.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

BaseSprite.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

Camera from which to compute distance (usually camera -> object).

Returns

number

Inherited from

BaseSprite.getSortDistance

---

getPrefabNode()

getPrefabNode(): SceneNode

Defined in: libs/scene/src/scene/scene_node.ts:358

Get prefab node this node belongs to, or null if this node does not belongs to any prefab

Returns

SceneNode

prefab node this node belongs to

Inherited from

BaseSprite.getPrefabNode

---

clone()

clone(): Promise<TextSprite>

Defined in: libs/scene/src/scene/scene_node.ts:548

Clone this node.

Returns

Promise<TextSprite>

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

BaseSprite.clone

---

hasChild()

hasChild(child): boolean

Defined in: libs/scene/src/scene/scene_node.ts:578

Whether the given node is a direct child of this node.

Parameters

child

SceneNode

The node to be checked

Returns

boolean

true if the given node is a direct child of this node, false otherwise

Inherited from

BaseSprite.hasChild

---

removeChildren()

removeChildren(): void

Defined in: libs/scene/src/scene/scene_node.ts:584

Remove all children from this node.

Returns

void

Inherited from

BaseSprite.removeChildren

---

isParentOf()

isParentOf(child): boolean

Defined in: libs/scene/src/scene/scene_node.ts:592

Whether this node is an ancestor (direct or indirect) of the given node.

Parameters

child

SceneNode

Returns

boolean

Inherited from

BaseSprite.isParentOf

---

remove()

remove(): TextSprite

Defined in: libs/scene/src/scene/scene_node.ts:603

Detach this node from its parent.

Returns

TextSprite

this

Inherited from

BaseSprite.remove

---

traverse()

traverse(v): void

Defined in: libs/scene/src/scene/scene_node.ts:612

Depth-first traversal of this node's subtree (pre-order).

Parameters

v

Visitor<SceneNode>

Visitor invoked on each node.

Returns

void

Inherited from

BaseSprite.traverse

---

iterate()

iterate(callback): boolean

Defined in: libs/scene/src/scene/scene_node.ts:626

Iterate self and descendants in pre-order.

Warning: Do not remove children during this iteration. To allow removal, use iterateBottomToTop.

Parameters

callback

NodeIterateFunc

Called for each node; if returns true, iteration stops.

Returns

boolean

If returns true, the iteration will immediately stop.

Inherited from

BaseSprite.iterate

---

iterateBottomToTop()

iterateBottomToTop(callback): boolean

Defined in: libs/scene/src/scene/scene_node.ts:645

Iterate self and descendants in reverse post-order (bottom-to-top).

Child nodes can be safely removed during this iteration.

Parameters

callback

NodeIterateFunc

Called for each node; if returns true, iteration stops.

Returns

boolean

If returns true, the iteration will immediately stop.

Inherited from

BaseSprite.iterateBottomToTop

---

isLight()

isLight(): this is BaseLight

Defined in: libs/scene/src/scene/scene_node.ts:662

Type guard: true if this node is a light.

Returns

this is BaseLight

Inherited from

BaseSprite.isLight

---

isMesh()

isMesh(): this is Mesh

Defined in: libs/scene/src/scene/scene_node.ts:666

Type guard: true if this node is a mesh.

Returns

this is Mesh

Inherited from

BaseSprite.isMesh

---

isMSDFTextSprite()

isMSDFTextSprite(): this is MSDFTextSprite

Defined in: libs/scene/src/scene/scene_node.ts:674

Type guard: true if this node is a MSDF text sprite

Returns

this is MSDFTextSprite

Inherited from

BaseSprite.isMSDFTextSprite

---

isMSDFText()

isMSDFText(): this is MSDFText

Defined in: libs/scene/src/scene/scene_node.ts:678

Type guard: true if this node is a MSDF text sprite

Returns

this is MSDFText

Inherited from

BaseSprite.isMSDFText

---

isWater()

isWater(): this is Water

Defined in: libs/scene/src/scene/scene_node.ts:682

Type guard: true if this node is a water node.

Returns

this is Water

Inherited from

BaseSprite.isWater

---

isHair()

isHair(): this is HairNode

Defined in: libs/scene/src/scene/scene_node.ts:686

Type guard: true if this node is a hair node.

Returns

this is HairNode

Inherited from

BaseSprite.isHair

---

isParticleSystem()

isParticleSystem(): this is ParticleSystem

Defined in: libs/scene/src/scene/scene_node.ts:690

Type guard: true if this node is a particle system.

Returns

this is ParticleSystem

Inherited from

BaseSprite.isParticleSystem

---

isBatchGroup()

isBatchGroup(): this is BatchGroup

Defined in: libs/scene/src/scene/scene_node.ts:694

Type guard: true if this node is a batch group.

Returns

this is BatchGroup

Inherited from

BaseSprite.isBatchGroup

---

isClipmapTerrain()

isClipmapTerrain(): this is ClipmapTerrain

Defined in: libs/scene/src/scene/scene_node.ts:698

Type guard: true if this node is a clipmap terrain.

Returns

this is ClipmapTerrain

Inherited from

BaseSprite.isClipmapTerrain

---

isCamera()

isCamera(): this is Camera

Defined in: libs/scene/src/scene/scene_node.ts:702

true if this is a camera node, false otherwise

Returns

this is Camera

Inherited from

BaseSprite.isCamera

---

isPunctualLight()

isPunctualLight(): this is PunctualLight

Defined in: libs/scene/src/scene/scene_node.ts:706

true if this is a punctual light node, false otherwise

Returns

this is PunctualLight

Inherited from

BaseSprite.isPunctualLight

---

getBoundingVolume()

getBoundingVolume(): BoundingVolume

Defined in: libs/scene/src/scene/scene_node.ts:720

Gets the bounding volume of the node

Returns

BoundingVolume

The bounding volume of the node

Inherited from

BaseSprite.getBoundingVolume

---

setBoundingVolume()

setBoundingVolume(bv): void

Defined in: libs/scene/src/scene/scene_node.ts:731

Sets the bounding volume of the node

Parameters

bv

BoundingVolume

The bounding volume to set

Returns

void

Inherited from

BaseSprite.setBoundingVolume

---

getWorldBoundingVolume()

getWorldBoundingVolume(): BoundingVolume

Defined in: libs/scene/src/scene/scene_node.ts:742

Gets the world space bounding volume of the node

Returns

BoundingVolume

The world space bounding volume of the node

Inherited from

BaseSprite.getWorldBoundingVolume

---

invalidateBoundingVolume()

invalidateBoundingVolume(): void

Defined in: libs/scene/src/scene/scene_node.ts:758

Force the bounding volume to be recalculated

Returns

void

Inherited from

BaseSprite.invalidateBoundingVolume

---

invalidateWorldBoundingVolume()

invalidateWorldBoundingVolume(transformChanged): void

Defined in: libs/scene/src/scene/scene_node.ts:763

Force the world space bounding volume to be recalculated

Parameters

transformChanged

boolean

Returns

void

Inherited from

BaseSprite.invalidateWorldBoundingVolume

---

findNodeById()

findNodeById<T>(id): T

Defined in: libs/scene/src/scene/scene_node.ts:835

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

BaseSprite.findNodeById

---

findSkeletonById()

findSkeletonById(id): SkinBinding

Defined in: libs/scene/src/scene/scene_node.ts:850

Finds a skeleton object by its persistent ID.

Parameters

id

string

Persistent identifier to match against Skeleton.persistentId.

Returns

SkinBinding

The first matchign node, or null if not found.

Inherited from

BaseSprite.findSkeletonById

---

findSkinBindingById()

findSkinBindingById(id): SkinBinding

Defined in: libs/scene/src/scene/scene_node.ts:858

Finds a skin binding by its persistent ID.

Parameters

id

string

Persistent identifier to match against SkinBinding.persistentId.

Returns

SkinBinding

The first matching binding, or null if not found.

Inherited from

BaseSprite.findSkinBindingById

---

findSkeletonRigById()

findSkeletonRigById(id): SkeletonRig

Defined in: libs/scene/src/scene/scene_node.ts:873

Finds a shared skeleton rig by its persistent ID.

Parameters

id

string

Persistent identifier to match against SkeletonRig.persistentId.

Returns

SkeletonRig

The first matching rig, or null if not found.

Inherited from

BaseSprite.findSkeletonRigById

---

findNodeByName()

findNodeByName<T>(name): T

Defined in: libs/scene/src/scene/scene_node.ts:895

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

BaseSprite.findNodeByName

---

getSerializedMorphTargetGroups()

getSerializedMorphTargetGroups(): SerializedMorphTargetGroup[]

Defined in: libs/scene/src/scene/scene_node.ts:978

Returns serialized morph target groups for this node.

Returns

SerializedMorphTargetGroup[]

Inherited from

BaseSprite.getSerializedMorphTargetGroups

---

setSerializedMorphTargetGroups()

setSerializedMorphTargetGroups(groups): void

Defined in: libs/scene/src/scene/scene_node.ts:996

Restores serialized morph target groups for this node.

Parameters

groups

SerializedMorphTargetGroup[]

Returns

void

Inherited from

BaseSprite.setSerializedMorphTargetGroups

---

invalidateTransform()

invalidateTransform(invalidateLocal?): void

Defined in: libs/scene/src/scene/scene_node.ts:1032

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

BaseSprite.invalidateTransform

---

setMorphTargetWeight()

setMorphTargetWeight(name, weight): void

Defined in: libs/scene/src/scene/scene_node.ts:1040

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

BaseSprite.setMorphTargetWeight

---

setMorphTargetGroupWeight()

setMorphTargetGroupWeight(name, weight): void

Defined in: libs/scene/src/scene/scene_node.ts:1056

Set morph target group weight for the model instance.

Parameters

name

string

Morph target group name

weight

number

Group weight

Returns

void

Inherited from

BaseSprite.setMorphTargetGroupWeight

---

getMorphTargetGroupWeight()

getMorphTargetGroupWeight(name): number

Defined in: libs/scene/src/scene/scene_node.ts:1078

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

BaseSprite.getMorphTargetGroupWeight

---

collectMorphTargetNames()

collectMorphTargetNames(): string[]

Defined in: libs/scene/src/scene/scene_node.ts:1086

Collect all morph target names from meshes in the subtree.

Returns

string[]

Array of unique morph target names

Inherited from

BaseSprite.collectMorphTargetNames

---

collectMorphTargetGroupNames()

collectMorphTargetGroupNames(): string[]

Defined in: libs/scene/src/scene/scene_node.ts:1102

Collect all model-level morph target group names.

Returns

string[]

Array of morph target group names

Inherited from

BaseSprite.collectMorphTargetGroupNames

---

onPostClone()

protected onPostClone(): void | Promise<void>

Defined in: libs/scene/src/scene/scene_node.ts:1111

Get called when the node was just created by cloning from other node

Returns

void | Promise<void>

Inherited from

BaseSprite.onPostClone

---

_onAttached()

protected _onAttached(): void

Defined in: libs/scene/src/scene/scene_node.ts:1181

Get called when this node is attached to scene

Returns

void

Inherited from

BaseSprite._onAttached

---

_onDetached()

protected _onDetached(): void

Defined in: libs/scene/src/scene/scene_node.ts:1185

Get called when this node is detached from scene

Returns

void

Inherited from

BaseSprite._onDetached

---

worldToThis()

Call Signature

worldToThis(v, result?): Vector3

Defined in: libs/scene/src/scene/scene_node.ts:1256

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

BaseSprite.worldToThis

Call Signature

worldToThis(v, result?): Vector4

Defined in: libs/scene/src/scene/scene_node.ts:1257

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

BaseSprite.worldToThis

---

otherToThis()

Call Signature

otherToThis(other, v, result?): Vector3

Defined in: libs/scene/src/scene/scene_node.ts:1276

Transform coordinate in other coordinate space to local space

Parameters

other

SceneNode

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

BaseSprite.otherToThis

Call Signature

otherToThis(other, v, result?): Vector4

Defined in: libs/scene/src/scene/scene_node.ts:1277

Transform coordinate in other coordinate space to local space

Parameters

other

SceneNode

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

BaseSprite.otherToThis

---

thisToWorld()

Call Signature

thisToWorld(v, result?): Vector3

Defined in: libs/scene/src/scene/scene_node.ts:1287

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

BaseSprite.thisToWorld

Call Signature

thisToWorld(v, result?): Vector4

Defined in: libs/scene/src/scene/scene_node.ts:1288

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

BaseSprite.thisToWorld

---

thisToOther()

Call Signature

thisToOther(other, v, result?): Vector3

Defined in: libs/scene/src/scene/scene_node.ts:1307

Transform local space coordinate to other coordinate space

Parameters

other

SceneNode

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

BaseSprite.thisToOther

Call Signature

thisToOther(other, v, result?): Vector4

Defined in: libs/scene/src/scene/scene_node.ts:1308

Transform local space coordinate to other coordinate space

Parameters

other

SceneNode

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

BaseSprite.thisToOther

---

getWorldPosition()

getWorldPosition(outPos?): Vector3

Defined in: libs/scene/src/scene/scene_node.ts:1316

Gets the position of the xform in world space

Parameters

outPos?

Vector3

Returns

Vector3

position of the xform in world space

Inherited from

BaseSprite.getWorldPosition

---

moveBy()

moveBy(delta): TextSprite

Defined in: libs/scene/src/scene/scene_node.ts:1327

Moves the xform by an offset vector

Parameters

delta

Vector3

The offset vector

Returns

TextSprite

self

Inherited from

BaseSprite.moveBy

---

scaleBy()

scaleBy(factor): TextSprite

Defined in: libs/scene/src/scene/scene_node.ts:1336

Scales the xform by a given scale factor

Parameters

factor

Vector3

The scale factor

Returns

TextSprite

self

Inherited from

BaseSprite.scaleBy

---

setLocalTransform()

setLocalTransform(matrix): TextSprite

Defined in: libs/scene/src/scene/scene_node.ts:1345

Sets the local transform matrix of the xform

Parameters

matrix

Matrix4x4

The transform matrix to set

Returns

TextSprite

self

Inherited from

BaseSprite.setLocalTransform

---

lookAt()

lookAt(eye, target, up): TextSprite

Defined in: libs/scene/src/scene/scene_node.ts:1403

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

TextSprite

self

Inherited from

BaseSprite.lookAt

---

updatePerCamera()

updatePerCamera(_camera, _elapsedInSeconds, _deltaInSeconds): void

Defined in: libs/scene/src/scene/scene_node.ts:1433

Update node state once per-camera

Parameters

_camera

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

BaseSprite.updatePerCamera

---

reparent()

reparent(p?): TextSprite

Defined in: libs/scene/src/scene/scene_node.ts:1439

Removes this node from it's parent and add this node to another parent node if required

Parameters

p?

SceneNode

The new parent node that this node should be added to or null

Returns

TextSprite

self

Inherited from

BaseSprite.reparent

---

isSprite()

isSprite(): this is Sprite

Defined in: libs/scene/src/scene/textsprite.ts:35

Type guard: true if this node is a sprite

Returns

this is Sprite

Overrides

BaseSprite.isSprite

---

update()

update(): void

Defined in: libs/scene/src/scene/textsprite.ts:83

Update node state once per-frame

Returns

void

Overrides

BaseSprite.update