filament/io.github.erkko68.filament/Material/Builder

Builder

Builder for creating Material objects from compiled material packages.

The Builder takes a material package (binary blob from the matc compiler) and configures rendering quality and batching options before building the final Material.

Constructors

Builder

constructor()

Types

ShadowSamplingQuality

enum ShadowSamplingQuality : Enum<Material.Builder.ShadowSamplingQuality>

Shadow sampling quality affects how soft shadows are rendered.

Functions

build

fun build(engine: Engine): Material?

Creates the Material and returns it.

constant

fun constant(name: String, value: Boolean): Material.Builder

fun constant(name: String, value: Float): Material.Builder

fun constant(name: String, value: Int): Material.Builder

Specializes a constant parameter specified in the material definition with a concrete value for this material. Once build() is called, this constant cannot be changed. Will panic if the name doesn't correspond to a constant specified in the material definition, or if the type differs.

payload

fun payload(data: ByteArray): Material.Builder

Specifies the material data (compiled binary blob); C++'s package, a Kotlin keyword.

shadowSamplingQuality

fun shadowSamplingQuality(quality: Material.Builder.ShadowSamplingQuality): Material.Builder

Set the quality of shadow sampling.

sphericalHarmonicsBandCount

fun sphericalHarmonicsBandCount(shBandCount: Int): Material.Builder

Sets the quality of the indirect light computations.

uboBatching

fun uboBatching(uboBatchingMode: Material.UboBatchingMode): Material.Builder

Set the batching mode of the instances created from this material.