Class MaterialData

java.lang.Object

dev.engine.core.material.MaterialData

All Implemented Interfaces:

Component

public final class MaterialData
extends Object
implements Component

Immutable material data — a typed property map that is a component.

The shader always accesses material data through a generated Slang interface. The engine generates the appropriate implementation (UBO, SSBO, bindless) based on the upload strategy. Shader code never changes.

Render state overrides are stored in a nested PropertyMap<RenderState> under the RENDER_STATE key, keeping material and render state concerns separated.

var mat = MaterialData.create()
    .set(MaterialData.ALBEDO_COLOR, new Vec3(1, 0, 0))
    .set(MaterialData.ROUGHNESS, 0.5f)
    .withRenderState(RenderState.CULL_MODE, CullMode.FRONT);
entity.add(mat);

Field Summary

Fields

Modifier and Type	Field	Description
static final PropertyKey<MaterialData, Vec3>	ALBEDO_COLOR
static final PropertyKey<MaterialData, Vec3>	COLOR
static final PropertyKey<MaterialData, Vec3>	EMISSIVE
static final PropertyKey<MaterialData, Float>	METALLIC
static final PropertyKey<MaterialData, Float>	NORMAL_STRENGTH
static final PropertyKey<MaterialData, Float>	OPACITY
static final PropertyKey<MaterialData, PropertyMap<?>>	RENDER_STATE
static final PropertyKey<MaterialData, Float>	ROUGHNESS

Method Summary

Modifier and Type	Method	Description
static MaterialData	create()	Creates an empty material.
static MaterialData	create(String shaderHint)	Creates with an explicit shader hint (e.g.
<T> T	get(PropertyKey<MaterialData, T> key)
boolean	has(PropertyKey<MaterialData, ?> key)
Set<PropertyKey<MaterialData, ?>>	keys()
static MaterialData	pbr(Vec3 albedo, float roughness, float metallic)
PropertyMap<MaterialData>	properties()
<R> PropertyMap<R>	renderState()	Returns the render state overrides for this material, or null if none.
<T> MaterialData	set(PropertyKey<MaterialData, T> key, T value)
String	shaderHint()
int	size()
Class<? extends Component>	slotType()	One slot per entity — replaces any existing material.
String	toString()
static MaterialData	unlit(Vec3 color)
<R,T> MaterialData	withRenderState(PropertyKey<R,T> key, T value)	Adds a render state override to this material.
MaterialData	withShader(String hint)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

ALBEDO_COLOR

public static final PropertyKey<MaterialData, Vec3> ALBEDO_COLOR

ROUGHNESS

public static final PropertyKey<MaterialData, Float> ROUGHNESS

METALLIC

public static final PropertyKey<MaterialData, Float> METALLIC

EMISSIVE

public static final PropertyKey<MaterialData, Vec3> EMISSIVE

OPACITY

public static final PropertyKey<MaterialData, Float> OPACITY

NORMAL_STRENGTH

public static final PropertyKey<MaterialData, Float> NORMAL_STRENGTH

COLOR

public static final PropertyKey<MaterialData, Vec3> COLOR

RENDER_STATE

public static final PropertyKey<MaterialData, PropertyMap<?>> RENDER_STATE

Method Details

create

public static MaterialData create()

Creates an empty material.

create

public static MaterialData create(String shaderHint)

Creates with an explicit shader hint (e.g. "PBR", "UNLIT", "custom/toon.slang").

set

public <T> MaterialData set(PropertyKey<MaterialData, T> key,
 T value)

withRenderState

public <R,T> MaterialData withRenderState(PropertyKey<R,T> key,
 T value)

Adds a render state override to this material. Render state keys are stored in a nested PropertyMap under RENDER_STATE.

renderState

public <R> PropertyMap<R> renderState()

Returns the render state overrides for this material, or null if none.

withShader

public MaterialData withShader(String hint)

get

public <T> T get(PropertyKey<MaterialData, T> key)

has

public boolean has(PropertyKey<MaterialData, ?> key)

keys

public Set<PropertyKey<MaterialData, ?>> keys()

size

public int size()

properties

public PropertyMap<MaterialData> properties()

shaderHint

public String shaderHint()

pbr

public static MaterialData pbr(Vec3 albedo,
 float roughness,
 float metallic)

unlit

public static MaterialData unlit(Vec3 color)

slotType

public Class<? extends Component> slotType()

One slot per entity — replaces any existing material.

Specified by:

slotType in interface Component

toString

public String toString()

Overrides:

toString in class Object