Struct UnlitMaterial 

pub struct UnlitMaterial {
    pub base_color: LinearRgba,
    pub alpha_mode: AlphaMode,
    pub alpha_cutoff: f32,
}

A simple, unlit material.

This material does not react to lighting and simply renders with a solid base color, optionally modulated by a texture. It’s the most basic and performant type of material, ideal for:

• UI elements and 2D sprites
• Debug visualization
• Performance-critical scenarios
• Stylized games that don’t use lighting
• Skyboxes and distant geometry

Performance

UnlitMaterial is the fastest material type in Khora. It requires minimal shader calculations and is suitable for scenes with thousands of objects. The RenderAgent may choose unlit rendering as a fallback strategy when performance budgets are tight.

Examples

use khora_core::asset::{UnlitMaterial, AlphaMode};
use khora_core::math::LinearRgba;

// Create a solid red unlit material
let red = UnlitMaterial {
    base_color: LinearRgba::new(1.0, 0.0, 0.0, 1.0),
    ..Default::default()
};

// Create an unlit material with alpha masking (e.g., foliage)
let foliage = UnlitMaterial {
    base_color: LinearRgba::new(0.2, 0.8, 0.2, 1.0),
    alpha_mode: AlphaMode::Mask(0.5),
    ..Default::default()
};

Fields

base_color: LinearRgba

The base color of the material.

This color is directly output without any lighting calculations. When a texture is present, the texture color is multiplied with this value.

alpha_mode: AlphaMode

Optional texture for the base color.

If present, the texture’s RGB values are multiplied with base_color. The alpha channel can be used for transparency when combined with appropriate alpha_mode.

Future work: This will be connected to the texture asset system when texture loading is fully implemented. The alpha blending mode for this material.

Determines how transparency is handled. See AlphaMode for details.

alpha_cutoff: f32

The alpha cutoff threshold when using AlphaMode::Mask.

Fragments with alpha values below this threshold are discarded. Typically set to 0.5. Only used when alpha_mode is AlphaMode::Mask.

Trait Implementations

impl<'__de, __Context> BorrowDecode<'__de, __Context> for UnlitMaterial

fn borrow_decode<__D: BorrowDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.

impl Clone for UnlitMaterial

fn clone(&self) -> UnlitMaterial

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnlitMaterial

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

Formats the value using the given formatter.

impl<__Context> Decode<__Context> for UnlitMaterial

fn decode<__D: Decoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl Default for UnlitMaterial

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UnlitMaterial

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encode for UnlitMaterial

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.

impl Material for UnlitMaterial

fn base_color(&self) -> LinearRgba

Returns the base color (albedo or diffuse) of the material. Default implementation is White.

fn emissive_color(&self) -> LinearRgba

Returns the emissive color of the material. Default implementation is Black.

fn specular_power(&self) -> f32

Returns the specular power or roughness conversion for the material. Default implementation is 32.0.

fn ambient_color(&self) -> LinearRgba

Returns the ambient color modifier for the material. Default implementation is (0.1, 0.1, 0.1, 0.0).

fn metallic(&self) -> f32

Returns the metallic factor (0.0 = dielectric, 1.0 = metal). Default implementation is 0.0.

fn roughness(&self) -> f32

Returns the roughness factor (0.0 = smooth, 1.0 = rough). Default implementation is 1.0.

fn base_color_texture(&self) -> Option<AssetUUID>

Returns the UUID of the base-color (albedo) texture, if any. Default implementation is None (untextured).

fn metallic_roughness_texture(&self) -> Option<AssetUUID>

Returns the UUID of the metallic-roughness texture, if any (glTF convention: B=metallic, G=roughness). Default implementation is None.

fn normal_map(&self) -> Option<AssetUUID>

Returns the UUID of the tangent-space normal map, if any. Default implementation is None.

fn emissive_texture(&self) -> Option<AssetUUID>

Returns the UUID of the emissive texture, if any. Default implementation is None.

fn occlusion_map(&self) -> Option<AssetUUID>

Returns the UUID of the ambient-occlusion map, if any (red channel). Attenuates the indirect (ambient/IBL) term only, never direct light. Default implementation is None.

fn alpha_mode(&self) -> AlphaMode

Returns the material’s alpha (transparency) mode. For AlphaMode::Mask the contained value is the alpha-cutoff threshold: fragments below it are discarded. Default implementation is AlphaMode::Opaque.

fn double_sided(&self) -> bool

Whether the material is rendered double-sided (back faces not culled). false (the default) culls back faces for correctly-wound meshes.

impl Serialize for UnlitMaterial

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Asset for UnlitMaterial