AnimatedSpriteComponent

Component-scope effects host. .fx.addEffect(...) attaches a filter to this component’s render object; the effect is torn down automatically when the entity or component is destroyed. .fx.findEffect(definition) recovers the handle for the first matching effect.

Inherited from

VisualComponent.fx

modifiers

readonly modifiers: VisualModifierHost

Defined in: renderer/src/VisualComponent.ts:105

Render-only transform, opacity, and visibility contributions. Modifiers combine with the component’s live base values and are never serialized.

Inherited from

VisualComponent.modifiers

inspectExclude?

static optional inspectExclude?: readonly string[]

Defined in: core/dist/index.d.ts:4338

Own fields and getters the Inspector leaves out of this component’s reflected state. Use it for bulk data that is not worth a diagnostic copy — a parsed tilemap, a large lookup table. Lists merge down the class chain, so a subclass adds to its base class’s exclusions.

class TilemapComponent extends VisualComponent {
  static inspectExclude = ["data"];
}

Inherited from

VisualComponent.inspectExclude

updatePriority?

static optional updatePriority?: number

Defined in: core/dist/index.d.ts:4325

Class-level default for updatePriority: every instance runs at this priority unless its own updatePriority is written. Undeclared = 0. Subclasses inherit their base class’s value unless they declare their own. Declare it on a component whose behavior depends on running after (or before) a sibling, so the entity that adds it does not have to control the add order.

class BoundsClamp extends Component {
  static updatePriority = 10; // after the follow that moves the camera
}

Inherited from

VisualComponent.updatePriority

Accessors

alpha

Get Signature

get alpha(): number

Defined in: renderer/src/VisualComponent.ts:226

Get the requested alpha before transient opacity modifiers.

Returns

number

Set Signature

set alpha(alpha): void

Defined in: renderer/src/VisualComponent.ts:220

Set the container’s alpha (opacity).

Parameters

alpha

number

Returns

void

Inherited from

VisualComponent.alpha

blendMode

Get Signature

get blendMode(): BLEND_MODES

Defined in: renderer/src/VisualComponent.ts:236

Get the container’s blend mode.

Returns

BLEND_MODES

Set Signature

set blendMode(mode): void

Defined in: renderer/src/VisualComponent.ts:231

Set how the container combines with what is drawn beneath it.

Parameters

mode

BLEND_MODES

Returns

void

Inherited from

SplitTextComponent.blendMode

context

Get Signature

get context(): EngineContext

Defined in: core/dist/index.d.ts:4171

Access the EngineContext from the entity’s scene. Throws if the entity is not in a scene.

Returns

EngineContext

Inherited from

VisualComponent.context

effectiveEnabled

Get Signature

get effectiveEnabled(): boolean

Defined in: core/dist/index.d.ts:4141

Whether the component is actually running: enabled, on an active entity, and past onAdd. This is the state onEnable and onDisable track — read it when a method has to behave one way live and another way dormant.

Returns

boolean

Inherited from

VisualComponent.effectiveEnabled

enabled

Get Signature

get enabled(): boolean

Defined in: core/dist/index.d.ts:4133

Whether this component runs. Disabled components are skipped by ComponentUpdateSystem.

Writing this fires onEnable / onDisable when the effective state changes — enabled && entity.isActive. A component disabled here stays disabled through a setActive(false) / setActive(true) cycle on its entity.

Returns

boolean

Set Signature

set enabled(value): void

Defined in: core/dist/index.d.ts:4134

Parameters

value

boolean

Returns

void

Inherited from

SpriteComponent.enabled

frame

Get Signature

get frame(): number

Defined in: renderer/src/AnimatedSpriteComponent.ts:151

Current frame index of the underlying AnimatedSprite.

Returns

number

isPlaying

Get Signature

get isPlaying(): boolean

Defined in: renderer/src/AnimatedSpriteComponent.ts:156

Whether the animation is currently playing.

Returns

boolean

layerName

Get Signature

get layerName(): string

Defined in: renderer/src/VisualComponent.ts:179

The layer this visual draws on. See setLayer.

Returns

string

Inherited from

VisualComponent.layerName

mask

Get Signature

get mask(): MaskHandle | undefined

Defined in: renderer/src/VisualComponent.ts:273

The currently attached mask handle, if any.

Returns

MaskHandle | undefined

Inherited from

VisualComponent.mask

renderAboveEffects

Get Signature

get renderAboveEffects(): boolean

Defined in: renderer/src/VisualComponent.ts:163

Whether this visual draws after the scene’s layers, outside every layer- and scene-scope effect and mask, while keeping its logical parent (position, alpha, visibility, camera). Screen-scope effects still cover it, and hit testing follows the logical tree — a UI element drawn under an escaped visual still receives the pointer first.

Set while the visual is out of the display tree — in a subclass constructor, or on a component not yet added — it records the flag and applies it on add.

Returns

boolean

Set Signature

set renderAboveEffects(value): void

Defined in: renderer/src/VisualComponent.ts:167

Parameters

value

boolean

Returns

void

Inherited from

VisualComponent.renderAboveEffects

renderObject

Get Signature

get renderObject(): AnimatedSprite

Defined in: renderer/src/AnimatedSpriteComponent.ts:62

The underlying Pixi display object.

Returns

AnimatedSprite

The underlying Pixi display object.

Overrides

VisualComponent.renderObject

scene

Get Signature

get scene(): Scene

Defined in: core/dist/index.d.ts:4166

Access the entity’s scene. Throws if the entity is not in a scene. Prefer this over threading through this.entity.scene in component code.

Returns

Scene

Inherited from

VisualComponent.scene

speed

Get Signature

get speed(): number

Defined in: renderer/src/AnimatedSpriteComponent.ts:181

Playback rate of the underlying sprite: frames advanced per tick at 60 fps, so 0.15 moves on about every seventh tick and 1 on every tick. Defaults to 1. Writing it retimes the clip that is already running, without restarting it, and reads back the same number play({ speed }) writes.

0 holds the current frame while isPlaying stays true, and a negative value plays backwards. Scene and entity timeScale multiply this. A non-finite value throws.

With an AnimationController on the entity this reads the rate the sprite is actually running at: the animation definition’s speed, times the controller’s speed, times the playOneShot({ speed }) factor. The controller writes it again at its next animation switch and whenever its own speed is written. Set AnimationController.speed to retime every animation; set this to retime only the clip on screen. Writing this does not retime a running one-shot’s lock: the lock keeps the duration computed when the one-shot started, so the clip and the lock can end at different times.

Returns

number

Set Signature

set speed(value): void

Defined in: renderer/src/AnimatedSpriteComponent.ts:185

Parameters

value

number

Returns

void

tint

Get Signature

get tint(): number

Defined in: renderer/src/VisualComponent.ts:215

Get the container’s tint color.

Returns

number

Set Signature

set tint(color): void

Defined in: renderer/src/VisualComponent.ts:210

Set the container’s tint color.

Parameters

color

ColorSource

Returns

void

Inherited from

SplitTextComponent.tint

updatePriority

Get Signature

get updatePriority(): number

Defined in: core/dist/index.d.ts:4159

Where this component runs among its siblings. ComponentUpdateSystem calls update / fixedUpdate on an entity’s components in ascending priority; equal priorities run in add order. Undeclared = 0, so a negative value runs before siblings that keep the default and a positive value runs after them. Writable at any time, before or after add(). Defaults to the class’s static updatePriority.

class Player extends Entity {
  setup() {
    this.add(new Mover());
    this.add(new Brain()).updatePriority = -1; // decides before Mover moves
  }
}

Returns

number

Set Signature

set updatePriority(value): void

Defined in: core/dist/index.d.ts:4160

Parameters

value

number

Returns

void

Inherited from

VisualComponent.updatePriority

visible

Get Signature

get visible(): boolean

Defined in: renderer/src/VisualComponent.ts:250

Get the requested visibility, whatever the entity’s activeness.

Returns

boolean

Set Signature

set visible(value): void

Defined in: renderer/src/VisualComponent.ts:244

Set the container’s visibility. Written while the entity is dormant, it is remembered and applied when the entity is activated.

Parameters

value

boolean

Returns

void

Inherited from

VisualComponent.visible

Methods

_applyEnabled()

_applyEnabled(effective): void

Defined in: core/dist/index.d.ts:4273

Internal

Force an effective-enabled transition, firing the hook on a flip. Used by Entity for teardown, where enabled and the entity’s activeness both still read true.

Parameters

effective

boolean

Returns

void

Inherited from

VisualComponent._applyEnabled

_isTornDown()

_isTornDown(): boolean

Defined in: core/dist/index.d.ts:4254

Internal

Internal: true once this component has been removed or its entity destroyed. Components are terminal — Entity.add uses this to reject re-attaching an instance whose cleanups and onDestroy already ran.

Returns

boolean

Inherited from

VisualComponent._isTornDown

_markTornDown()

_markTornDown(): void

Defined in: core/dist/index.d.ts:4260

Internal

Internal: mark this component torn down. Called by Entity.remove() and Entity._performDestroy() after onDestroy runs.

Returns

void

Inherited from

VisualComponent._markTornDown

_refreshEnabled()

_refreshEnabled(): void

Defined in: core/dist/index.d.ts:4266

Internal

Recompute effective enabled-ness from enabled and the entity’s activeness, firing the hook on a flip.

Returns

void

Inherited from

VisualComponent._refreshEnabled

_runCleanups()

_runCleanups(onError?): void

Defined in: core/dist/index.d.ts:4241

Internal

Run and clear all registered cleanups. Called by Entity.remove() and Entity._performDestroy() before onDestroy.

Parameters

onError?

(error) => void

Returns

void

Inherited from

VisualComponent._runCleanups

addCleanup()

protected addCleanup(fn): void

Defined in: core/dist/index.d.ts:4229

Register a cleanup function to run when this component is removed or destroyed, before onDestroy. Use it for what listen, listenScene and listenBus do not cover, such as an unsubscribe from a custom emitter.

Parameters

fn

() => void

Returns

void

Inherited from

VisualComponent.addCleanup

applyEffectiveAlpha()

protected applyEffectiveAlpha(alpha): void

Defined in: renderer/src/VisualComponent.ts:328

Apply the final alpha after transient modifiers.

Parameters

alpha

number

Returns

void

Inherited from

VisualComponent.applyEffectiveAlpha

applyVisualOptions()

protected applyVisualOptions(options): void

Defined in: renderer/src/VisualComponent.ts:134

Apply the shared visible/tint/alpha/interactive options to renderObject. Call once from the subclass constructor, after the concrete Pixi object is created.

Parameters

options

VisualComponentOptions

Returns

void

Inherited from

VisualComponent.applyVisualOptions

clearMask()

clearMask(): void

Defined in: renderer/src/VisualComponent.ts:267

Detach and destroy the current mask, if any.

Returns

void

Inherited from

VisualComponent.clearMask

destroy()

destroy(): void

Defined in: core/dist/index.d.ts:4247

End this component’s life on its own — the same as entity.remove(SomeClass), without having to name its own class from inside itself, which breaks under subclassing.

Returns

void

Inherited from

VisualComponent.destroy

destroyOptions()

protected destroyOptions(): DestroyOptions | undefined

Defined in: renderer/src/VisualComponent.ts:323

Pixi destroy options passed to renderObject.destroy(). Default: undefined (Pixi’s own defaults). Override for a component whose destroy must cascade to children (SplitText’s per-segment display objects).

Returns

DestroyOptions | undefined

Inherited from

VisualComponent.destroyOptions

fixedUpdate()?

optional fixedUpdate(dt): void

Defined in: core/dist/index.d.ts:4310

Called every fixed timestep by the built-in ComponentUpdateSystem.

Parameters

dt

number

Fixed timestep in seconds, scaled by scene and entity timeScale.

Returns

void

Inherited from

VisualComponent.fixedUpdate

gotoFrame()

gotoFrame(index): void

Defined in: renderer/src/AnimatedSpriteComponent.ts:140

Stop playback and hold index as a static pose.

Parameters

index

number

Returns

void

inspectRender()

inspectRender(): object

Defined in: renderer/src/VisualComponent.ts:283

Derived render facet for the Inspector — world-space bounds and the component’s own (local, non-inherited) visible flag, computed on demand from the live render object. See computeRenderFacet for the bounds coordinate space.

Returns

bounds

bounds: { height: number; width: number; x: number; y: number; } | null

Axis-aligned bounding box of the component’s geometry, in world space (the same coordinate space the Inspector reports for entity.transform — pixels, before camera/viewport projection). Measured from the geometry itself, so a sized-but-hidden object still reports its real box; null means there is no measurable geometry at all (an empty Graphics, a zero-area object), NOT that the object is hidden. Read RenderFacetSnapshot.visible for the hidden/shown state.

visible

visible: boolean

The component’s own (local, non-inherited) visibility flag at snapshot time. A hidden ancestor (e.g. a parent/layer container set invisible) is NOT folded in — read the relevant parent separately if you need the fully resolved on-screen state.

Inherited from

VisualComponent.inspectRender

listen()

protected listen<T>(source, token, handler): void

Defined in: core/dist/index.d.ts:4211

Subscribe to events from an entity or a state machine, auto-unsubscribe on removal.

this.listen(this.entity, Hurt, ({ dir }) => this.knockback(dir));
this.listen(brain.mode, brain.mode.events.entered, ({ state }) =>
  this.anim.play(state),
);

Type Parameters

T

T

Parameters

source

EventSource

token

EventToken<T>

handler

(data) => void

Returns

void

Inherited from

VisualComponent.listen

listenBus()

protected listenBus<K>(event, handler): void

Defined in: core/dist/index.d.ts:4222

Subscribe to an engine EventBus event, auto-unsubscribe on removal. Throws when the entity is not in a scene, like listenScene.

Type Parameters

K

K extends keyof EngineEvents

Parameters

event

K

handler

(data) => void

Returns

void

Inherited from

VisualComponent.listenBus

listenScene()

protected listenScene<T>(token, handler): void

Defined in: core/dist/index.d.ts:4217

Subscribe to scene-level events, auto-unsubscribe on removal. Handlers fire for bubbled entity events (entity = source) and scene.emit events (entity = undefined).

Type Parameters

T

T

Parameters

token

EventToken<T>

handler

(data, entity?) => void

Returns

void

Inherited from

VisualComponent.listenScene

onAdd()

onAdd(): void

Defined in: renderer/src/VisualComponent.ts:287

Called when the component is added to an entity. Validate dependencies here — a service, a sibling component, a render layer — and throw when one is missing. The throw is attributed to this component, recorded in Inspector.getErrors().callbackErrors, and rethrown, so it reaches the caller of entity.add() unchanged.

Returns

void

Inherited from

VisualComponent.onAdd

onDestroy()

onDestroy(): void

Defined in: renderer/src/VisualComponent.ts:308

Called when the component is destroyed (entity destroyed or component removed).

Returns

void

Inherited from

VisualComponent.onDestroy

onDisable()

onDisable(): void

Defined in: renderer/src/VisualComponent.ts:304

Called when the component stops being effectively enabled — enabled went false, the entity (or an ancestor) was deactivated, or the component is being removed or destroyed. Put live resources to sleep here; the component is reused afterwards, so do not free anything onEnable cannot rebuild.

Returns

void

Inherited from

VisualComponent.onDisable

onEnable()

onEnable(): void

Defined in: renderer/src/VisualComponent.ts:300

Called when the component becomes effectively enabled — enabled is true and the entity is active. Fires right after onAdd() for a component added to an active entity, and again on every later flip. Bring live resources back online here (unpause a sound, show a display object, re-enable a physics body). Game-state reset does not belong here: the hook sees whatever state the component held while dormant.

Returns

void

Inherited from

VisualComponent.onEnable

onFrameChange()

onFrameChange(listener): () => void

Defined in: renderer/src/AnimatedSpriteComponent.ts:117

Subscribe to frame changes on the underlying sprite. Returns an unsubscribe function, so this.addCleanup(sprite.onFrameChange(fn)) drops the listener with the subscribing component.

Pixi delivers a frame change on play, on a frame advance, and on the frame reset an animation switch performs, so a listener sees controller switches too. Assigning animatedSprite.onFrameChange directly replaces the dispatcher this installs and silences every subscriber.

Parameters

listener

(frame) => void

Returns

() => void

play()

play(options?): void

Defined in: renderer/src/AnimatedSpriteComponent.ts:76

Resumes from the current frame; fromStart: true restarts at frame 0.

speed and loop are sticky — the next play keeps whatever this one set. onComplete is not: a play owns its completion callback, so a play without one clears the callback the previous play installed.

Use the AnimatedSpriteComponent.speed property to retime a clip that is already running.

Parameters

options?

fromStart?

boolean

loop?

boolean

onComplete?

() => void

speed?

number

Returns

void

service()

protected service<T>(key): T

Defined in: core/dist/index.d.ts:4188

Lazy proxy-based service resolution. Can be used at field-declaration time:

readonly input = this.service(InputManagerKey);

The actual resolution is deferred until first property access.

Type Parameters

T

T extends object

Parameters

key

ServiceKey<T>

Returns

T

Inherited from

VisualComponent.service

setLayer()

setLayer(name): void

Defined in: renderer/src/VisualComponent.ts:195

Draw this visual on another layer.

Called before the component reaches the display tree — in a subclass constructor, or on a component that has not been added yet — it records the name and nothing else. Called afterwards it detaches the render object and re-parents it through the same resolution onAdd uses, so a SortGroupComponent on the new layer still claims it.

The visual joins its new parent last, which on a layer with no sort means it draws in front of everything already there.

Parameters

name

string

Returns

void

Inherited from

VisualComponent.setLayer

setMask()

setMask(factory): MaskHandle

Defined in: renderer/src/VisualComponent.ts:260

Attach a mask to this component’s render object, replacing any existing mask. Returns a handle for inverse toggling, redraw (graphicsMask), or removal. The mask is torn down automatically when the component is destroyed.

Parameters

sibling()

protected sibling<C>(cls): C

Defined in: core/dist/index.d.ts:4199

Lazy proxy-based sibling component resolution. Can be used at field-declaration time:

readonly anim = this.sibling(AnimatedSpriteComponent);

The actual resolution is deferred until first property access. The reference passes instanceof cls before it resolves, so an engine API that checks the type of what it is handed (camera.follow(this.transform)) accepts it.

Type Parameters

C

C extends Component

Parameters

cls

ComponentClass<C>

Returns

C

Inherited from

VisualComponent.sibling

stateMachine()

protected stateMachine<S>(states, initial, options?): StateMachine<S>

Defined in: core/dist/index.d.ts:4235

Create a state machine whose hooks and event handlers are attributed to this component when they throw. The machine can be declared as a field because service lookup waits until a hook runs.

Type Parameters

S

S extends string

Parameters

states

StateDefinitions<S>

initial

NoInfer<S>

options?

StateMachineOptions

Returns

StateMachine<S>

Inherited from

VisualComponent.stateMachine

stop()

stop(): void

Defined in: renderer/src/AnimatedSpriteComponent.ts:135

Stop the animation.

Returns

void

update()

update(dt): void

Defined in: renderer/src/AnimatedSpriteComponent.ts:191

Advance playback using engine-scaled time.

Parameters

dt

number

Returns

void

Overrides

VisualComponent.update

use()

protected use<T>(key): T

Defined in: core/dist/index.d.ts:4179

Resolve a service by key, cached after first lookup. Scene-scoped values (registered via scene._registerScoped) take precedence over engine scope. A key declared with scope: "scene" that falls back to engine scope emits a one-shot dev warning — almost always signals a missed beforeEnter hook.

Type Parameters

T

T

Parameters

key

ServiceKey<T>

Returns

T

Inherited from

VisualComponent.use

Coding agents: fetch https://yage.dev/llms.txt first and prefer the Markdown references it links over these HTML pages. This page's Markdown counterpart is /llms/packages/renderer.md.