Struct EmissiveMaterial 

pub struct EmissiveMaterial {
    pub emissive_color: LinearRgba,
    pub intensity: f32,
    pub alpha_mode: AlphaMode,
}

A material that emits light without being affected by scene lighting.

Emissive materials are perfect for objects that should glow or appear self-illuminated, such as neon signs, magical effects, UI elements, LED displays, or light sources. They render at full brightness regardless of lighting conditions.

HDR Support

The intensity parameter allows values greater than 1.0, enabling High Dynamic Range (HDR) emissive effects. This is particularly useful for bloom post-processing effects where bright emissive surfaces can “bleed” light into surrounding areas.

Examples

use khora_core::asset::EmissiveMaterial;
use khora_core::math::LinearRgba;

// Create a bright red glowing sign
let neon_sign = EmissiveMaterial {
    emissive_color: LinearRgba::new(1.0, 0.0, 0.0, 1.0),
    intensity: 2.0,  // HDR intensity for bloom
    ..Default::default()
};

// Create a subtle blue glow
let subtle_glow = EmissiveMaterial {
    emissive_color: LinearRgba::new(0.3, 0.5, 1.0, 1.0),
    intensity: 0.5,
    ..Default::default()
};

Fields

emissive_color: LinearRgba

The emissive color of the material.

This color is directly output to the framebuffer without any lighting calculations. The RGB values represent the color of the emitted light.

intensity: f32

Optional texture for emissive color.

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

Future work: Texture asset system integration pending. Intensity multiplier for the emissive color.

Values greater than 1.0 enable HDR effects and are particularly useful for bloom post-processing. A value of 1.0 produces standard emissive output.

Recommended ranges:

• 0.0-1.0: Subtle emission
• 1.0-3.0: Strong emission with bloom
• 3.0+: Very bright, suitable for light sources

alpha_mode: AlphaMode

The alpha blending mode for this material.

Determines how transparency is handled. See AlphaMode for details.

Trait Implementations

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

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 EmissiveMaterial

fn clone(&self) -> EmissiveMaterial

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmissiveMaterial

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

Formats the value using the given formatter.

impl<__Context> Decode<__Context> for EmissiveMaterial

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

Attempt to decode this type with the given Decode.

impl Default for EmissiveMaterial

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EmissiveMaterial

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encode for EmissiveMaterial

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

Encode a given type.

impl Material for EmissiveMaterial

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 EmissiveMaterial

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 EmissiveMaterial