feature!:

This is a breaking change needed to fully implement instancing and stencil highlighting.

Previously, users would work directly with entities (on the Dart side, ThermionEntity), e.g.

final entity = await viewer.loadGlb("some.glb");

However, Filament "entities" are a lower-level abstraction.

Loading a glTF file, for example, inserts multiple entities into the scene.

For example, each mesh, light, and camera within a glTF asset will be assigned an entity. A top-level (non-renderable) entity will also be created for the glTF asset, which can be used to transform the entire hierarchy.

"Asset" is a better representation for loading/inserting objects into the scene; think of this as a bundle of entities.

Unless you need to work directly with transforms, instancing, materials and renderables, you can work directly with ThermionAsset.

thermion_dart/ffigen/native.yaml

@@ -1,21 +1,11 @@
 output: '../lib/src/viewer/src/ffi/src/thermion_dart.g.dart'
 headers:
   entry-points:
-    - '../native/include/ThermionDartRenderThreadApi.h'
-    - '../native/include/ThermionDartApi.h'
-    - '../native/include/TView.h'
-    - '../native/include/TCamera.h'
-    - '../native/include/TGizmo.h'
+    - '../native/include/c_api/*.h'
     - '../native/include/ResourceBuffer.h'
   include-directives:
-    - '../native/include/ThermionDartRenderThreadApi.h'
-    - '../native/include/ThermionDartApi.h'
-    - '../native/include/TView.h'
-    - '../native/include/TCamera.h'
-    - '../native/include/TGizmo.h'
-    - '../native/include/TMaterialInstance.h'
+    - '../native/include/c_api/*.h'
     - '../native/include/ResourceBuffer.h'
-    - '../native/include/APIBoundaryTypes.h'
 ffi-native:
   assetId: package:thermion_dart/thermion_dart.dart
 ignore-source-errors: true