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/native/include/FilamentViewer.hpp

@@ -33,7 +33,7 @@
 #include <chrono>
 
 #include "ResourceBuffer.hpp"
-#include "SceneManager.hpp"
+#include "scene/SceneManager.hpp"
 #include "ThreadPool.hpp"
 
 namespace thermion
@@ -65,9 +65,6 @@ namespace thermion
         void rotateIbl(const math::mat3f &matrix);
         void createIbl(float r, float g, float b, float intensity);
 
-        void removeEntity(EntityId asset);
-        void clearEntities();
-
         void render(
             uint64_t frameTimeInNanos
         );
@@ -98,15 +95,6 @@ namespace thermion
         void clearBackgroundImage();
         void setBackgroundImagePosition(float x, float y, bool clamp, uint32_t width, uint32_t height);
         
-        typedef void (*PickCallback)(EntityId entityId, int x, int y, View *view, float depth, float fragX, float fragY, float fragZ);
-        
-        ///
-        /// Returns true if the specified entity is a gizmo, grid or background image entity.
-        ///
-        bool isNonPickableEntity(EntityId entityId);
-
-        void pick(View *view, uint32_t x, uint32_t y, PickCallback callback);
-        
         Engine* getEngine() { 
             return _engine;
         }