thermion-loading-gltf

name

thermion-loading-gltf

description

Load, inspect, instance, and clean up glTF/GLB models in Thermion. Covers loadGltf and loadGltfFromBuffer parameters (addToScene, initialInstances, releaseSourceData, rebuildVertices, resourceUri), the ThermionAsset API (entity, child-entity queries, bounding boxes, transformToUnitCube, createInstance/getInstance for GPU instancing), scene add/remove, visibility layers, and destroyAsset/destroyAssets. Use when loading 3d models, spawning copies or instances, traversing an asset's entities, or freeing assets. Triggers: load gltf, load glb, load model, ThermionAsset, instances, gpu instancing, child entities, bounding box, unit cube, visibility layer, destroy asset, free asset, assimp, obj.

Everything in a Thermion scene is an entity; a loaded glTF becomes a ThermionAsset whose root entity owns a subtree of child entities (meshes, bones, lights). This skill covers loading that asset, querying it, instancing it, and destroying it.

Loading

final asset = await viewer.loadGltf('assets/scene.glb');

Key parameters:

final asset = await viewer.loadGltf(
  'assets/scene.gltf',
  addToScene: true,          // add renderables to the scene immediately
  initialInstances: 4,       // pre-allocate N GPU instances (>= 1)
  releaseSourceData: false,  // true: no further createInstance calls possible
  rebuildVertices: false,    // true: rebuild vertices with barycentrics/etc,
                             //      enabling free material swapping (wireframe,
                             //      flat shading, stencil highlights). ~3x vertex memory.
  resourceUri: null,         // for .gltf: where relative resources live
                             //      (defaults to the .gltf file's own URI)
);

URI schemes: file:// always works; asset:// (and plain paths, which are treated as asset paths) only inside a Flutter application. .glb is self-contained; resolves its /textures relative to its own URI unless you pass .