TilemapComponent

Defined in: tilemap/src/TilemapComponent.ts:56

Component that renders a Tiled map using @pixi/tilemap.

Extends

• VisualComponent

Constructors

Constructor

new TilemapComponent(options): TilemapComponent

Defined in: tilemap/src/TilemapComponent.ts:78

Parameters

options

TilemapComponentOptions

Returns

TilemapComponent

Overrides

VisualComponent.constructor

Properties

container

readonly container: DisplayContainer

Defined in: tilemap/src/TilemapComponent.ts:61

---

data

readonly data: TilemapData

Defined in: tilemap/src/TilemapComponent.ts:62

---

entity

entity: Entity

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

Back-reference to the owning entity. Set by the engine when the component is added to an entity. Do not set manually.

Inherited from

VisualComponent.entity

---

fx

readonly fx: EffectsHost

Defined in: renderer/dist/index.d.ts:252

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

---

keyPrefix

readonly keyPrefix: string | null

Defined in: tilemap/src/TilemapComponent.ts:66

Prefix used to derive auto-keys for entities spawned from objects.

---

mapKey

readonly mapKey: string | null

Defined in: tilemap/src/TilemapComponent.ts:64

Asset path of this map, or null if constructed from a raw TiledMapData without one.

---

modifiers

readonly modifiers: VisualModifierHost

Defined in: renderer/dist/index.d.ts:257

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 inspectExclude: string[]

Defined in: tilemap/src/TilemapComponent.ts:59

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"];
}

Overrides

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/dist/index.d.ts:311

Get the requested alpha before transient opacity modifiers.

Returns

number

Set Signature

set alpha(alpha): void

Defined in: renderer/dist/index.d.ts:309

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/dist/index.d.ts:315

Get the container’s blend mode.

Returns

BLEND_MODES

Set Signature

set blendMode(mode): void

Defined in: renderer/dist/index.d.ts:313

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

Parameters

mode

BLEND_MODES

Returns

void

Inherited from

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

VisualComponent.enabled

---

heightPx

Get Signature

get heightPx(): number

Defined in: tilemap/src/TilemapComponent.ts:188

Map height in pixels.

Returns

number

---

layerName

Get Signature

get layerName(): string

Defined in: renderer/dist/index.d.ts:290

The layer this visual draws on. See setLayer.

Returns

string

Inherited from

VisualComponent.layerName

---

mask

Get Signature

get mask(): MaskHandle | undefined

Defined in: renderer/dist/index.d.ts:333

The currently attached mask handle, if any.

Returns

MaskHandle | undefined

Inherited from

VisualComponent.mask

---

renderAboveEffects

Get Signature

get renderAboveEffects(): boolean

Defined in: renderer/dist/index.d.ts:287

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/dist/index.d.ts:288

Parameters

value

boolean

Returns

void

Inherited from

VisualComponent.renderAboveEffects

---

renderObject

Get Signature

get renderObject(): DisplayContainer

Defined in: tilemap/src/TilemapComponent.ts:135

The underlying tilemap container.

Returns

DisplayContainer

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

---

tileHeight

Get Signature

get tileHeight(): number

Defined in: tilemap/src/TilemapComponent.ts:198

Tile height in pixels.

Returns

number

---

tileWidth

Get Signature

get tileWidth(): number

Defined in: tilemap/src/TilemapComponent.ts:193

Tile width in pixels.

Returns

number

---

tint

Get Signature

get tint(): number

Defined in: tilemap/src/TilemapComponent.ts:146

Set the container’s tint color.

Returns

number

Set Signature

set tint(color): void

Defined in: tilemap/src/TilemapComponent.ts:141

Set the container’s tint color.

Parameters

color

ColorSource

Returns

void

Overrides

VisualComponent.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/dist/index.d.ts:322

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

Returns

boolean

Set Signature

set visible(value): void

Defined in: renderer/dist/index.d.ts:320

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

---

widthPx

Get Signature

get widthPx(): number

Defined in: tilemap/src/TilemapComponent.ts:183

Map width in pixels.

Returns

number

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: tilemap/src/TilemapComponent.ts:150

Apply the final alpha after transient modifiers.

Parameters

alpha

number

Returns

void

Overrides

VisualComponent.applyEffectiveAlpha

---

applyVisualOptions()

protected applyVisualOptions(options): void

Defined in: renderer/dist/index.d.ts:275

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/dist/index.d.ts:331

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

Defined in: tilemap/src/TilemapComponent.ts:409

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

Overrides

VisualComponent.destroyOptions

---

findObject()

findObject(id): MapObject | undefined

Defined in: tilemap/src/TilemapComponent.ts:364

Find an object by its Tiled id. Searches every object layer.

Parameters

id

number

Returns

MapObject | undefined

---

findObjectByName()

findObjectByName(name): MapObject | undefined

Defined in: tilemap/src/TilemapComponent.ts:374

Find the first object with a matching name. Searches every object layer.

Parameters

name

string

Returns

MapObject | undefined

---

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

---

forEachObject()

forEachObject(layerName, fn): void

Defined in: tilemap/src/TilemapComponent.ts:334

Iterate every object on the given layer (or every layer if omitted), passing the auto-derived stable key alongside each object so callers can spawn entities with scene.spawn(Class, params, { key }).

Skips objects that don’t have a key prefix (component constructed from raw map: without mapKey or keyPrefix) — those callers should iterate getObjects directly.

Parameters

layerName

string | undefined

fn

(obj, key) => void

Returns

void

---

getAllObjects()

getAllObjects(): MapObject[]

Defined in: tilemap/src/TilemapComponent.ts:315

Flat list of every object across every object layer. Memoized — safe because parsed map data is immutable post-construction.

Returns

MapObject[]

---

getCollisionShapes()

getCollisionShapes(objectLayerName?): TilemapColliderConfig[]

Defined in: tilemap/src/TilemapComponent.ts:257

Extract physics-agnostic collision shapes from object layers.

Parameters

objectLayerName?

string

Returns

TilemapColliderConfig[]

---

getObjectGroups()

getObjectGroups(objectLayerName?): MapObjectGroup[]

Defined in: tilemap/src/TilemapComponent.ts:286

Objects grouped strictly by object layer and class.

Parameters

objectLayerName?

string

Returns

MapObjectGroup[]

---

getObjects()

getObjects(objectLayerName?): Record<string, MapObject[]>

Defined in: tilemap/src/TilemapComponent.ts:265

Objects grouped by class ?? name. Use getObjectGroups when the source layer must be preserved.

Parameters

objectLayerName?

string

Returns

Record<string, MapObject[]>

---

getProperty()

getProperty<T>(obj, name): T | undefined

Defined in: tilemap/src/TilemapComponent.ts:384

Read a typed custom property from any tilemap data that has properties.

Type Parameters

T

T = unknown

Parameters

obj

HasProperties

name

string

Returns

T | undefined

---

getPropertyArray()

getPropertyArray<T>(obj, name): T[]

Defined in: tilemap/src/TilemapComponent.ts:392

Read an indexed property bag (name[0], name[1], …) as an array. Throws when the indices skip one.

Type Parameters

T

T = unknown

Parameters

obj

HasProperties

name

string

Returns

T[]

---

getTileAt()

getTileAt(worldX, worldY, layerName?): number | null

Defined in: tilemap/src/TilemapComponent.ts:225

Returns the tile id at a world position. The point is converted through the inverse of the entity’s world transform, so a map that is parented, scaled or rotated answers where its tiles are drawn; each layer’s own draw offset is then applied. Returns null if the position is outside every layer or the tile is empty.

A world scale of 0 on either axis collapses the map, so no world point maps back to a cell and the method returns null.

A tileset’s tileoffset is not reversed here: it moves where a tile’s image is drawn, not which cell the tile occupies, and one layer can mix tilesets that offset differently. So a tile from an offset tileset answers at its cell, which is where its collision and neighbours are, rather than under the part of the image that overhangs. A tile image that does not match the grid is the same case: it sits on its cell’s bottom edge, and the cells its image reaches into answer with whatever they hold themselves.

Tiled’s flip bits are stripped, so the id compares against a tileset’s numbering whichever way the tile faces. Read them from the raw layer data with readTileGid when orientation matters.

Parameters

worldX

number

worldY

number

layerName?

string

Returns

number | null

---

inspectRender()

inspectRender(): object

Defined in: renderer/dist/index.d.ts:340

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

---

objectKey()

objectKey(obj): string

Defined in: tilemap/src/TilemapComponent.ts:354

Auto-derived stable key for an object: <keyPrefix>#object:<id>.

Parameters

obj

MapObject

Returns

string

---

onAdd()

onAdd(): void

Defined in: tilemap/src/TilemapComponent.ts:155

Returns

void

Overrides

VisualComponent.onAdd

---

onDestroy()

onDestroy(): void

Defined in: tilemap/src/TilemapComponent.ts:413

Returns

void

Overrides

VisualComponent.onDestroy

---

onDisable()

onDisable(): void

Defined in: renderer/dist/index.d.ts:343

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/dist/index.d.ts:342

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

---

resolveRef()

resolveRef(obj, propName): MapObject | undefined

Defined in: tilemap/src/TilemapComponent.ts:400

Resolve a Tiled object-reference property to the actual object. Auto-collects across every layer so callers don’t have to.

Parameters

obj

HasProperties

propName

string

Returns

MapObject | undefined

---

resolveRefArray()

resolveRefArray(obj, propName): MapObject[]

Defined in: tilemap/src/TilemapComponent.ts:405

Same as resolveRef, but for indexed object-reference arrays.

Parameters

obj

HasProperties

propName

string

Returns

MapObject[]

---

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/dist/index.d.ts:303

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/dist/index.d.ts:329

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

factory

MaskFactory

Returns

MaskHandle

Inherited from

VisualComponent.setMask

---

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

---

update()

update(deltaSeconds): void

Defined in: tilemap/src/TilemapComponent.ts:173

Advance the tile-animation clock. ComponentUpdateSystem supplies time already scaled by the scene and the entity, and skips paused scenes, so a paused game freezes its tilemaps and timeScale slows them.

Parameters

deltaSeconds

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