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 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<(), Error>

Formats the value using the given formatter.

impl Default for UnlitMaterial

fn default() -> UnlitMaterial

Returns the “default value” for a 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).

impl Asset for UnlitMaterial