Enum ShadingModel 

pub enum ShadingModel {
    Phong,
    Pbr,
    Matcap(MatcapId),
    Flat,
}

Lit shading model selected by a Material.

The variants are mutually exclusive: a material picks one path. The unlit per-item bypass on ItemSettings is checked independently and takes precedence over the shading model.

New shading models (Toon, SSS, Gooch, …) are added here as new variants. The glTF PBR extensions (clearcoat, sheen, anisotropy, iridescence) layer on top of Pbr as separate fields on Material rather than as variants here.

Variants

Phong

Blinn-Phong lit shading using ambient / diffuse / specular / shininess.

Pbr

Cook-Torrance GGX physically based shading driven by metallic and roughness.

Matcap(MatcapId)

Matcap lookup. Replaces the lit path with a captured-lighting texture. Blendable matcaps tint with base_colour; static matcaps override colour entirely.

Flat

Flat (faceted) shading: the per-vertex normal is discarded and a geometric normal is recomputed per-fragment from screen-space derivatives of world position. Produces visible polygon edges on triangulated meshes without changing the lighting block; everything else (hemisphere ambient, scene lights, shadows, AO, alpha mode) runs as it does for [Phong].

Edges appear at the triangulation level, not at logical-face boundaries. A quad authored as two triangles shows both; a CAD surface tessellated finely shows the tessellation.

Trait Implementations

impl Clone for ShadingModel

fn clone(&self) -> ShadingModel

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ShadingModel

impl Debug for ShadingModel

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ShadingModel

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ShadingModel

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ShadingModel

impl PartialEq for ShadingModel

fn eq(&self, other: &ShadingModel) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ShadingModel

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ShadingModel