Instance transforms format
VGAI Reference 0.3
Planned versioned generated-schema truth covering Render settings, features, and automatic batching.
planned · generated · immutable Reference 0.3
Lifecycle and constraints
Detailed constraints will publish with the generated or reviewed entry.
Runnable Learn material
Generated format inventory
Inventory only — AC-REF-002 is not passed. Valid parser-verified examples, narrative guidance, complete cross-field/runtime constraints, and version history remain deferred. This page must not be treated as a complete format contract.
Source: packages/engine/src/scene/schema/instances.ts ·
12 branch-sensitive field records ·
11 source-described.
This source intentionally supersedes the frozen study boundary.
InstancesFile · file · 12 fields
| Field / branch | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
# $ | array | yes | none | none | Instance-transform asset (.instances.json): an array of 10-number tuples [posX,posY,posZ, quatX,quatY,quatZ,quatW, scaleX,scaleY,scaleZ], one per instance. Referenced by a mesh via `mesh.instances` and rendered as a single THREE.InstancedMesh (one draw call). |
# $[] | array | yes | none | none | Missing source description |
# $[][0] | number | yes | none | none | posX |
# $[][1] | number | yes | none | none | posY |
# $[][2] | number | yes | none | none | posZ |
# $[][3] | number | yes | none | none | quatX |
# $[][4] | number | yes | none | none | quatY |
# $[][5] | number | yes | none | none | quatZ |
# $[][6] | number | yes | none | none | quatW |
# $[][7] | number | yes | none | none | scaleX |
# $[][8] | number | yes | none | none | scaleY |
# $[][9] | number | yes | none | none | scaleZ |