Files

Mathias Agopian 0ed71ab53b fix an issue causing callbacks to be called too late

We were waiting for programs from both queues to be compiled before 
calling the callback associated with one queue. In practice this caused
the callback associated with high priority programs to be called only 
after low priority programs were ready.

Also cleanup-up "token" so that it doesn't store the priority.

Update the documentation and sample to better reflect what the 
implementation does.

2023-07-27 10:02:31 -07:00

include/gltfio

expose joint inverse bind matrices via method on FilamentInstance (#6388 )

2022-12-20 15:19:19 -08:00

materials

Workaround for a bug in Adreno's shader compiler

2022-12-14 15:39:18 -08:00

src

fix an issue causing callbacks to be called too late

2023-07-27 10:02:31 -07:00

test

gltfio: simple test for asset loading (#6990 )

2023-07-26 16:50:06 -07:00

CMakeLists.txt

gltfio: exclude unsupported platforms from test (#7000 )

2023-07-26 19:11:50 -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.