TextsController

Creates and manages dynamic Pixi.js Text/BitmapText nodes attached to Spine slots. Accessed via layout.texts.

Methods

getInstances(): Map<SpineID, Text | BitmapText>

Returns all active text instances (both Text and BitmapText) keyed by bone name.

getBitmapInstances(): Map<SpineID, BitmapText>

Returns only the BitmapText instances, keyed by bone name.

getBySpine(): Map<string, string[]>

Returns a map of spineID → list of text slot names for each spine that has text slots.

getVal(textID: string): string | undefined

Returns the current string value of a text node by its bone name.

set(boneName: string, text: string, animate?: boolean): void

Sets the text value. When animate=true (or animateNumber is set in config), numeric values count up/down over 500ms.

setOffset(boneName: string, offset: { x: number; y: number }): void

Moves a text node by the given pixel offset relative to its bone position.

setMaxWidth(boneName: string, maxWidth: number): void

Constrains a text node to a max pixel width by scaling it down uniformly when it overflows.

setStyle(boneName: string, style: Partial<Text["style"]>): void

Applies a partial Pixi.js TextStyle to the named text node.

setTextType(boneName: string, newType: "text" | "bitmapText"): void

Swaps a text node between Text and BitmapText at runtime, preserving its current value.

set settings(settings: Record<string, TextsJsonEntry>)

Overrides the text configuration loaded from settings/texts.json.