ed444b0615
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.
143 lines
3.9 KiB
C++
143 lines
3.9 KiB
C++
#pragma once
|
|
|
|
#include <memory>
|
|
#include <vector>
|
|
|
|
#include <filament/Engine.h>
|
|
#include <filament/RenderableManager.h>
|
|
#include <filament/VertexBuffer.h>
|
|
#include <filament/IndexBuffer.h>
|
|
#include <gltfio/FilamentAsset.h>
|
|
#include <gltfio/FilamentInstance.h>
|
|
#include <gltfio/MaterialProvider.h>
|
|
|
|
#include "scene/SceneAsset.hpp"
|
|
|
|
namespace thermion
|
|
{
|
|
|
|
using namespace filament;
|
|
|
|
class GltfSceneAssetInstance : public SceneAsset
|
|
{
|
|
public:
|
|
GltfSceneAssetInstance(
|
|
gltfio::FilamentInstance *instance,
|
|
Engine *engine,
|
|
MaterialInstance **materialInstances = nullptr,
|
|
size_t materialInstanceCount = 0,
|
|
int instanceIndex = -1) : _instance(instance),
|
|
_materialInstances(materialInstances),
|
|
_materialInstanceCount(materialInstanceCount)
|
|
{
|
|
}
|
|
|
|
~GltfSceneAssetInstance();
|
|
|
|
SceneAsset *createInstance(MaterialInstance **materialInstances = nullptr, size_t materialInstanceCount = 0) override
|
|
{
|
|
return std::nullptr_t();
|
|
};
|
|
|
|
SceneAssetType getType() override
|
|
{
|
|
return SceneAsset::SceneAssetType::Gltf;
|
|
}
|
|
|
|
bool isInstance() override
|
|
{
|
|
return true;
|
|
}
|
|
|
|
utils::Entity getEntity() override
|
|
{
|
|
return _instance->getRoot();
|
|
}
|
|
|
|
MaterialInstance **getMaterialInstances() override
|
|
{
|
|
return _materialInstances;
|
|
}
|
|
|
|
size_t getMaterialInstanceCount() override
|
|
{
|
|
return _materialInstanceCount;
|
|
}
|
|
|
|
gltfio::FilamentInstance *getInstance()
|
|
{
|
|
return _instance;
|
|
}
|
|
|
|
void addAllEntities(Scene *scene) override
|
|
{
|
|
scene->addEntities(_instance->getEntities(), _instance->getEntityCount());
|
|
}
|
|
|
|
void removeAllEntities(Scene *scene) override {
|
|
scene->removeEntities(_instance->getEntities(), _instance->getEntityCount());
|
|
}
|
|
|
|
size_t getInstanceCount() override
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
SceneAsset *getInstanceAt(size_t index) override
|
|
{
|
|
return std::nullptr_t();
|
|
}
|
|
|
|
size_t getChildEntityCount() override
|
|
{
|
|
return _instance->getEntityCount();
|
|
}
|
|
|
|
const Entity* getChildEntities() override {
|
|
return _instance->getEntities();
|
|
}
|
|
|
|
Entity findEntityByName(const char* name) override {
|
|
return Entity(); // not currently implemented
|
|
}
|
|
|
|
SceneAsset *getInstanceByEntity(utils::Entity entity) override {
|
|
return std::nullptr_t();
|
|
}
|
|
|
|
void setPriority(RenderableManager &rm, int priority) override
|
|
{
|
|
const Entity *entities = _instance->getEntities();
|
|
for (int i = 0; i < _instance->getEntityCount(); i++)
|
|
{
|
|
if (rm.hasComponent(entities[i]))
|
|
{
|
|
auto renderableInstance = rm.getInstance(entities[i]);
|
|
rm.setPriority(renderableInstance, priority);
|
|
}
|
|
}
|
|
}
|
|
|
|
void setLayer(RenderableManager &rm, int layer) override
|
|
{
|
|
const Entity *entities = _instance->getEntities();
|
|
for (int i = 0; i < _instance->getEntityCount(); i++)
|
|
{
|
|
if (rm.hasComponent(entities[i]))
|
|
{
|
|
auto renderableInstance = rm.getInstance(entities[i]);
|
|
rm.setLayerMask(renderableInstance, 0xFF, 1u << (uint8_t)layer);
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
filament::Engine *_engine;
|
|
gltfio::FilamentInstance *_instance;
|
|
MaterialInstance **_materialInstances = nullptr;
|
|
size_t _materialInstanceCount = 0;
|
|
};
|
|
|
|
} // namespace thermion
|