Files

Mathias Agopian e674420e9c improvements to EntityManagers and Filament APIs (#7302 )

* prevent public classes from being created on the stack

- we used to to this by deleting operator delete, but this prevented
  the internal "F" classes from being virtual; which can be useful
  when using EntityManger::Listener.
  now we just make the destructor protected in each class.

- EntityManger::Listener now has a virtual destructor so that
  objects could be correctly destroyed from Listener*

* improve EntityManger and Component managers

- all component managers now have the same "base" API
    - getComponentCount()
	- empty()
    - getEntity()
    - getEntities()

- Scene now has getEntityCount()

- EntityManager now has getEntityCount()

- all component manager implement gc() the same way, by calling destroy()

- SingleInstanceComponentManager::gc() that calls removeComponent() has
  been removed because it's dangerous. removeComponent() is often
  not enough, some additional cleanup might be needed.

2023-10-26 13:10:43 -07:00

include/gltfio

Cleanup function signatures

2023-10-23 15:30:49 -07:00

materials

Don't force masked blending for transmission/volume materials (#7126 )

2023-08-30 13:34:49 -07:00

src

improvements to EntityManagers and Filament APIs (#7302 )

2023-10-26 13:10:43 -07:00

test

Fix test_gltfio cmake duplicate libs and failed UT. (#7199 )

2023-09-25 12:52:46 -07:00

CMakeLists.txt

fix ubershader index for transmission&volume material (#7244 )

2023-10-16 12:15:47 -07:00

README.md

gltfio: Rename all plugin classes to have "provider" suffix.

2022-06-06 16:25:02 -07:00

README.md

Description

gltfio is a loader library that consumes gltf or glb content and produces Filament objects. For usage details, see the docstring for AssetLoader.

gltfio has two plug-in interfaces, TextureProvider and MaterialProvider. Filament ships with several ready-to-go implementations described below.

MaterialProvider creates Filament materials in response to certain glTF requirements.
- UbershaderProvider loads pre-built materials.
- JitShaderProvider builds materials at run time using the filamat library.
TextureProvider creates and populates Filament Texture objects.
- StbProvider uses the STB library to read PNG and JPEG files.
- Ktx2Provider uses the BasisU library to read KTX2 files.

UbershaderProvider

UbershaderProvider is a ready-to-go implementation of the MaterialProvider interface that should be used in applications that need fast startup times. There is no material compilation that occurs at run time, but the shaders might be relatively large and complex.

At load time, the ubershader loader consumes an ubershader archive which is a precompiled set of materials bundled with formal descriptions of the glTF features that they support.

The uberz command line tool consumes a list of .spec and .filamat files and produces a single .uberz file. For details on these two file formats, see the README in libs/uberz.