Class ZContainer

HTML div–based display object that mirrors the ZContainer interface from the PIXI and Phaser versions of zImporter.

Each ZContainer owns a single HTMLDivElement (el).
The element is position:absolute; left:0; top:0; width:0; height:0; overflow:visible so that children are positioned relative to its (0,0) origin and the CSS transform maps 1-to-1 to PIXI's transform model:

T(x, y) · R(rotation) · S(scaleX, scaleY) · T(-pivotX, -pivotY)

This is identical to how PIXI.Container resolves world coordinates.

Hierarchy (View Summary)

ZContainer

Constructors

constructor

new ZContainer(): ZContainer
Returns ZContainer
- Defined in ZContainer.ts:69

Properties

_fitToScreen

_fitToScreen: boolean = false

`Optional`_props

_props?: any

children

children: ZContainer[] = []

Typed child list (mirrors PIXI's children array).

currentTransform

currentTransform: OrientationData

`Readonly`el

el: HTMLDivElement

The root div element for this container.

`Optional`fixedBoxSize

fixedBoxSize?: boolean

interactive

interactive: boolean = false

interactiveChildren

interactiveChildren: boolean = true

landscape

landscape: OrientationData

`Optional`originalFontSize

originalFontSize?: number

`Optional`originalTextHeight

originalTextHeight?: number

`Optional`originalTextWidth

originalTextWidth?: number

parent

parent: ZContainer | null = null

portrait

portrait: OrientationData

resizeable

resizeable: boolean = true

`Readonly`scale

scale: { x: number; y: number }

PIXI-compatible scale object. Setting .x / .y delegates to the scaleX / scaleY setters so that ZScene can write stage.scale.x = s exactly as in the PIXI version.

Initialised in the constructor so this is captured correctly.

`Static`stageOffsetX

stageOffsetX: number = 0

Current CSS-pixel X offset of the stage from the viewport edge.

`Static`stageOffsetY

stageOffsetY: number = 0

Current CSS-pixel Y offset of the stage from the viewport edge.

`Static`stageScale

stageScale: number = 1

Current uniform CSS scale applied to the stage element.

Accessors

alpha

get alpha(): number
Returns number
- Defined in ZContainer.ts:217
set alpha(value: number): void
Parameters
- value: number
Returns void
- Defined in ZContainer.ts:218

cursor

get cursor(): string
Returns string
- Defined in ZContainer.ts:525
set cursor(value: string): void
Parameters
- value: string
Returns void
- Defined in ZContainer.ts:522

name

get name(): string
Returns string
- Defined in ZContainer.ts:37
set name(value: string): void
Parameters
- value: string
Returns void
- Defined in ZContainer.ts:38

pivotX

get pivotX(): number
Returns number
- Defined in ZContainer.ts:203
set pivotX(value: number): void
Parameters
- value: number
Returns void
- Defined in ZContainer.ts:204

pivotY

get pivotY(): number
Returns number
- Defined in ZContainer.ts:210
set pivotY(value: number): void
Parameters
- value: number
Returns void
- Defined in ZContainer.ts:211

rotation

get rotation(): number
Returns number
- Defined in ZContainer.ts:181
set rotation(value: number): void
Parameters
- value: number
Returns void
- Defined in ZContainer.ts:182

scaleX

get scaleX(): number
Returns number
- Defined in ZContainer.ts:189
set scaleX(value: number): void
Parameters
- value: number
Returns void
- Defined in ZContainer.ts:190

scaleY

get scaleY(): number
Returns number
- Defined in ZContainer.ts:196
set scaleY(value: number): void
Parameters
- value: number
Returns void
- Defined in ZContainer.ts:197

visible

get visible(): boolean
Returns boolean
- Defined in ZContainer.ts:223
set visible(value: boolean): void
Parameters
- value: boolean
Returns void
- Defined in ZContainer.ts:224

x

get x(): number
Returns number
- Defined in ZContainer.ts:167
set x(value: number): void
Parameters
- value: number
Returns void
- Defined in ZContainer.ts:168

y

get y(): number
Returns number
- Defined in ZContainer.ts:174
set y(value: number): void
Parameters
- value: number
Returns void
- Defined in ZContainer.ts:175

Methods

addChild

addChild(child: ZContainer): ZContainer
Parameters
- child: ZContainer
Returns ZContainer
- Defined in ZContainer.ts:90

applyTransform

applyTransform(): void
Returns void
- Defined in ZContainer.ts:347

emit

emit(event: string, ...args: any[]): void
Parameters
- event: string
- ...args: any[]
Returns void
- Defined in ZContainer.ts:556

executeFitToScreen

executeFitToScreen(
    viewportW: number,
    viewportH: number,
    stageOffsetX: number,
    stageOffsetY: number,
    stageScale: number,
): void
Stretches this container to visually cover the entire browser viewport. Mirrors PIXI's executeFitToScreen — positions the container at the viewport's top-left (expressed in stage / scene-unit coords) and scales the first child image element to fill the viewport dimensions.
Parameters
- viewportW: number
  Current browser viewport width in CSS pixels.
- viewportH: number
  Current browser viewport height in CSS pixels.
- stageOffsetX: number
  CSS-pixel X offset of the scaled stage from the viewport edge.
- stageOffsetY: number
  CSS-pixel Y offset of the scaled stage from the viewport edge.
- stageScale: number
  Uniform CSS scale applied to the stage.
Returns void
- Defined in ZContainer.ts:285

get

get(childName: string): ZContainer | null
Parameters
- childName: string
Returns ZContainer | null
- Defined in ZContainer.ts:129

getAll

getAll(childName: string): ZContainer[]
Parameters
- childName: string
Returns ZContainer[]
- Defined in ZContainer.ts:139

getAllOfType

getAllOfType(type: string): ZContainer[]
Parameters
- type: string
Returns ZContainer[]
- Defined in ZContainer.ts:150

getAlpha

getAlpha(): number
Returns number
- Defined in ZContainer.ts:443

getChildAt

getChildAt(index: number): ZContainer
Parameters
- index: number
Returns ZContainer
- Defined in ZContainer.ts:123

getChildByName

getChildByName(name: string): ZContainer | null
Parameters
- name: string
Returns ZContainer | null
- Defined in ZContainer.ts:116

getProps

getProps(): any
Returns any
- Defined in ZContainer.ts:453

getTextField

getTextField(): HTMLElement | null
Finds the first text element (a <span class="z-text">) among children. Mirrors PIXI's getTextField().

Returns HTMLElement | null
- Defined in ZContainer.ts:467

getTextStyle

getTextStyle(): CSSStyleDeclaration | null
Returns CSSStyleDeclaration | null
- Defined in ZContainer.ts:492

getType

getType(): string
Returns string
- Defined in ZContainer.ts:455

getVisible

getVisible(): boolean
Returns boolean
- Defined in ZContainer.ts:451

init

init(): void
Called once all children have been added. Captures original text dimensions.

Returns void
- Defined in ZContainer.ts:509

isAnchored

isAnchored(): boolean
Returns boolean
- Defined in ZContainer.ts:429

off

off(event: string, listener: Function): this
Parameters
- event: string
- listener: Function
Returns this
- Defined in ZContainer.ts:542

on

on(event: string, listener: Function): this
Parameters
- event: string
- listener: Function
Returns this
- Defined in ZContainer.ts:535

reapplyAnchor

reapplyAnchor(): void
Public entry point for ZScene to re-run the anchor computation after all containers in the resize map have been updated to the new orientation. This guarantees that ancestor _x / _y values are current when chain inversion runs.

Returns void
- Defined in ZContainer.ts:375

removeAllListeners

removeAllListeners(event?: string): this
Parameters
- Optionalevent: string
Returns this
- Defined in ZContainer.ts:547

removeChild

removeChild(child: ZContainer): ZContainer
Parameters
- child: ZContainer
Returns ZContainer
- Defined in ZContainer.ts:100

removeChildren

removeChildren(): void
Returns void
- Defined in ZContainer.ts:112

resize

resize(
    width: number,
    height: number,
    orientation: "portrait" | "landscape",
): void
Parameters
- width: number
- height: number
- orientation: "portrait" | "landscape"
Returns void
- Defined in ZContainer.ts:424

setAlpha

setAlpha(value: number): void
Parameters
- value: number
Returns void
- Defined in ZContainer.ts:437

setFixedBoxSize

setFixedBoxSize(value: boolean): void
Parameters
- value: boolean
Returns void
- Defined in ZContainer.ts:457

setInstanceData

setInstanceData(data: InstanceData, orientation: string): void
Parameters
- data: InstanceData
- orientation: string
Returns void
- Defined in ZContainer.ts:259

setText

setText(text: string): void
Parameters
- text: string
Returns void
- Defined in ZContainer.ts:478

setTextStyle

setTextStyle(data: Partial<CSSStyleDeclaration>): void
Parameters
- data: Partial<CSSStyleDeclaration>
Returns void
- Defined in ZContainer.ts:486

setVisible

setVisible(value: boolean): void
Parameters
- value: boolean
Returns void
- Defined in ZContainer.ts:445

Class ZContainer

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns ZContainer

Properties

_fitToScreen

Optional_props

children

currentTransform

Readonlyel

OptionalfixedBoxSize

interactive

interactiveChildren

landscape

OptionaloriginalFontSize

OptionaloriginalTextHeight

OptionaloriginalTextWidth

parent

portrait

resizeable

Readonlyscale

StaticstageOffsetX

StaticstageOffsetY

StaticstageScale

Accessors

alpha

Returns number

Parameters

Returns void

cursor

Returns string

Parameters

Returns void

name

Returns string

Parameters

Returns void

pivotX

Returns number

Parameters

Returns void

pivotY

Returns number

Parameters

Returns void

rotation

Returns number

Parameters

Returns void

scaleX

Returns number

Parameters

Returns void

scaleY

Returns number

Parameters

Returns void

visible

Returns boolean

Parameters

Returns void

x

Returns number

Parameters

Returns void

y

Returns number

Parameters

Returns void

Methods

addChild

Parameters

Returns ZContainer

applyTransform

`Optional`_props

`Readonly`el

`Optional`fixedBoxSize

`Optional`originalFontSize

`Optional`originalTextHeight

`Optional`originalTextWidth

`Readonly`scale

`Static`stageOffsetX

`Static`stageOffsetY

`Static`stageScale