gltfio/io.github.erkko68.filament.gltfio/MaterialProvider

MaterialProvider

class MaterialProvider(nativeHandle: NativePointer) : AutoCloseable

MaterialProvider supplies materials to glTF assets during loading: the ubershader provider picks from a pre-compiled set of materials, see createUbershaderProvider.

Constructors

MaterialProvider

constructor(nativeHandle: NativePointer)

Properties

materials

val materials: List<Material>

The provider's cache of compiled materials (weak references).

materialsCount

val materialsCount: Int

nativeObject

val nativeObject: NativePointer

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

Functions

open override fun close()

Same as destroy; lets this be used with use { }.

createMaterialInstance

fun createMaterialInstance(config: MaterialKey, uvmap: UvMap, label: String? = "material", extras: String? = null): MaterialInstance?

Creates or fetches a compiled Filament material, then creates an instance from it.

destroy

fun destroy()

Frees the provider itself; cached materials survive unless destroyMaterials was called.

destroyMaterials

fun destroyMaterials()

Destroys all cached materials. NOT called by destroy, which lets clients take ownership of the cache if desired.

getMaterial

fun getMaterial(config: MaterialKey, uvmap: UvMap, label: String? = "material"): Material?

Creates or fetches the compiled Filament material corresponding to config, without instancing it.

needsDummyData

fun needsDummyData(attrib: VertexBuffer.VertexAttribute): Boolean

Returns true if the given vertex attribute must be present. Some providers (e.g. ubershader) require dummy attribute values when the glTF model does not provide them.

MaterialProvider

See also

Constructors

Properties

Functions