gltfio/io.github.erkko68.filament.gltfio/AssetLoader

AssetLoader

class AssetLoader(nativeHandle: NativePointer)

AssetLoader consumes glTF 2.0 content and produces FilamentAsset objects.

AssetLoader parses a blob of glTF 2.0 content (either JSON or GLB format) and produces a FilamentAsset object, which is a bundle of Filament textures, vertex buffers, index buffers, and entities. An asset is composed of one or more FilamentInstance objects containing the loaded scene hierarchy.

Clients must use AssetLoader to:

Create and destroy FilamentAsset objects (similar to how Engine creates core objects)
Not fetch external buffer data or create textures (use ResourceLoader for this)

AssetLoader uses a MaterialProvider to create materials, e.g. createUbershaderProvider's pre-compiled set.

See also

FilamentInstance

MaterialProvider

Constructors

constructor(nativeHandle: NativePointer)

Types

object Companion

Properties

materialProvider

val materialProvider: MaterialProvider

The provider this loader was configured with.

val materials: List<Material>

The materials this loader's assets use, across all its assets.

val materialsCount: Int

val nativeObject: NativePointer

The native object, for interop with code calling the Fila* C API directly. Read-only: this wrapper owns it.

Functions

fun createAsset(buffer: ByteArray): FilamentAsset?

Create a FilamentAsset from glTF 2.0 data.

fun createInstance(asset: FilamentAsset): FilamentInstance?

Create a FilamentInstance from an existing FilamentAsset.

createInstancedAsset

fun createInstancedAsset(buffer: ByteArray, instances: Array<FilamentInstance>): FilamentAsset?

Create a FilamentAsset with pre-allocated instances.

fun destroyAsset(asset: FilamentAsset)

Destroy a FilamentAsset and release all associated resources.

enableDiagnostics

fun enableDiagnostics(enable: Boolean)

Enable diagnostic output for asset loading.

fun gc()

Reclaims unused entities and components across all assets owned by this loader.