What problem does it solve?
PixiJS scene graphs become hard to manage when you need consistent grouping, layout transforms, and render ordering across many display objects, especially when moving between local and global coordinates.
Core Features & Use Cases
- Scene-graph grouping with Container: Create branch nodes that apply transforms, alpha, tint, and blend mode to entire subtrees.
- Hierarchy operations and reordering: Add, remove, insert, swap, and reindex children with predictable render order and zIndex sorting via sortableChildren.
- Transform and coordinate utilities: Set and combine position/scale/rotation/pivot/origin/skew, then use getBounds, toGlobal, toLocal, and getGlobalPosition to support layout math and interaction logic.
- Performance-oriented container options: Use isRenderGroup and boundsArea to reduce per-frame CPU work for stable or predictable subtrees, and apply culling-related options when appropriate.
- Lifecycle and cleanup: Use onRender for lightweight per-frame container updates and destroy options to correctly tear down subtrees and GPU resources.
Quick Start
Create a Container with sortableChildren enabled, add sprites as children, set a pivot/origin for the desired transform center, and attach it to app.stage.