Contents

struct

SushiEngine::Render::Material

A physically-based surface: its maps, its scalars, and its state.

Declared in
engine/domain/material/include/SushiEngine/material/material.hpp

The scalar fields double as tints when the matching map is set, matching glTF's factor semantics — albedo multiplies the base-colour map, and metallic/roughness multiply the packed map's blue and green channels.

Properties

albedo

Base colour tint / F0 tint when metallic.

base_alpha

Base colour alpha; drives cutout and blending.

albedo_map

sRGB base colour + alpha.

metallic

0 = dielectric, 1 = metal.

roughness

Microfacet roughness in (0, 1].

metallic_roughness_map

Packed metallic-roughness: G = roughness, B = metallic (glTF order).

packed_occlusion

The MR map is an ORM map whose red channel is ambient occlusion.

normal_map

Tangent-space normal; Z reconstructed.

normal_scale

Bump strength.

height_map

Height for parallax occlusion mapping.

height_scale

Displacement depth in UV-space units.

parallax_steps

March steps; 0 disables POM.

parallax_shadows

Self-shadow the surface along the light ray.

parallax_silhouette_clip

Discard where the ray leaves the height field.

occlusion_map

Ambient occlusion, red channel.

occlusion_strength

Blend toward unoccluded at 0.

emissive

Emissive colour, HDR.

emissive_intensity

Multiplies emissive and its map.

emissive_map

sRGB emissive.

emissive_enabled

Off means the emissive term is skipped.

detail_albedo_map

Overlaid close-up albedo detail.

detail_normal_map

Overlaid close-up normal detail.

detail_mask_map

Where the detail set applies.

detail_normal_scale

Detail bump strength.

main_transform

Tiling/offset for the base map set.

detail_transform

Tiling/offset for the detail set.

anisotropy

Stretches the specular lobe; 0 = isotropic.

anisotropy_rotation

Tangent-space rotation of the stretch, turns.

clearcoat

Strength of a second, smooth specular layer.

clearcoat_roughness
sheen_color

Retroreflective cloth rim.

sheen_roughness
transmission

Fraction of light passing through.

subsurface_color

Tint of transmitted light.

thickness

Distance light travels inside, metres.

ior

Index of refraction; drives dielectric F0.

surface_type
alpha_cutoff
cull_mode
cast_shadows
anisotropic_filtering

Sampler anisotropy, 1 = off.

wrap_mode

Sampler address mode for every map.

weather_wettable

Opts the surface into weather-driven wetness (design doc §5.3, W5): albedo darken / roughness drop.