EmissiveMaterial

Struct EmissiveMaterial 

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

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§

Source§

impl Clone for EmissiveMaterial

Source§

fn clone(&self) -> EmissiveMaterial

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for EmissiveMaterial

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for EmissiveMaterial

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Material for EmissiveMaterial

Source§

fn base_color(&self) -> LinearRgba

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

fn emissive_color(&self) -> LinearRgba

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

fn specular_power(&self) -> f32

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

fn ambient_color(&self) -> LinearRgba

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

impl Asset for EmissiveMaterial

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> AsAny for T
where T: Any,

Source§

fn as_any(&self) -> &(dyn Any + 'static)

Returns a reference to the inner value as &dyn Any.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.