API

Interface HierarchyInstancePool

A fixed-capacity thin-instance pool for a transform-node hierarchy.

The source meshes become the render carriers for the pool: each descendant mesh receives its own thin-instance matrix buffer, and one logical hierarchy instance updates the matching slot in every buffer.

An instance matrix composes with the template's own world matrices, exactly like adding a parent transform node above the hierarchy root: the identity matrix reproduces the template unchanged.

interface HierarchyInstancePool {
    capacity: number;
    count: number;
    meshes: readonly Mesh[];
    root: SceneNode;
}
Index
capacity: number

Maximum number of logical hierarchy instances that can be active.

count: number

Current active logical hierarchy instance count. Prefer addHierarchyInstance, removeHierarchyInstance, and setHierarchyInstanceCount over mutating this field directly.

meshes: readonly Mesh[]

Descendant meshes driven by this pool.

root: SceneNode

Template hierarchy root used to build the pool.