Files

T

Mathias Agopian ca3ff7e08e Use the Perfetto SDK instead of ATRACE

Perfetto has significantly less overhead. The User facing API is
mostly unchanged:

Here are the differences:

- SYSTRACE_ENABLE() does nothing on ANDROID, initializes systraces on darwin.
- SYSTRACE_DISABLE() is removed.
- A new "gltfio" tag is added.
- SYSTRACE_TAG *must* be defined before including `utils/Systrace.h`
- `utils/Systrace.h` should not be used from a public header
- the new SYSTRACE_TAG_DISABLE disables systrace at compile time


For android a data source MUST be created in the perfetto config:

```
data_sources {
  config {
    name: "track_event"
    track_event_config {
      enabled_categories: ["filament", "jobsystem", "gltfio"]
      disabled_categories: "*"
    }
  }
}
```

This can for example be added to AGI's custom/advanced config.

FIXES=[407572663]

2025-04-22 09:31:29 -07:00

include/gltfio

Add support for KHR_materials_Specular (#7564 )

2024-06-21 17:06:17 +00:00

materials

Add support for KHR_materials_Specular (#7564 )

2024-06-21 17:06:17 +00:00

src

Use the Perfetto SDK instead of ATRACE

2025-04-22 09:31:29 -07:00

test

switch to new morphing API

2024-06-28 12:14:57 -07:00

CMakeLists.txt

Add support for compiling under c++20 on clang-based compilers. The warnings that this change ignores are tricky to fix in the code in a way that is backwards compatible with c++17, but it is possible to do and it would allow these warnings to be reinstated. (#8199 )

2024-10-15 16:45:32 -04: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.