euv-engine 0.18.62

A high-performance 2D game engine built on the euv framework, featuring ECS, fixed-timestep game loop, canvas rendering, physics, collision detection, sprite animation, and audio.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

use super::*;

/// A light source contributing illumination to a shaded point.
///
/// The fields have meanings that depend on [`LightType`]:
///
/// - For [`LightType::Directional`], `position` is unused and `direction` is
///   the unit vector pointing from the surface toward the light.
/// - For [`LightType::Point`], `position` is the world position of the light
///   and `direction` is unused.
/// - For [`LightType::Spot`], both `position` and `direction` are meaningful
///   and `spot_cos` carries `cos(half_angle)` of the spotlight cone.
#[derive(Clone, Data, Debug, New, PartialEq)]
pub struct Light {
    /// The kind of light source (directional, point, or spot).
    #[get(type(copy))]
    pub(crate) kind: LightType,
    /// World-space position for point and spot lights; otherwise unused.
    #[get(type(copy))]
    pub(crate) position: Vector3D,
    /// Unit direction for directional and spot lights; otherwise unused.
    #[get(type(copy))]
    pub(crate) direction: Vector3D,
    /// RGB intensity multiplier applied to the contribution.
    #[get(type(copy))]
    pub(crate) color: Vector3D,
    /// Overall intensity scalar in the range 0.0..=infinity.
    #[get(type(copy))]
    pub(crate) intensity: f64,
    /// Inverse-square falloff factor for point and spot lights.
    #[get(type(copy))]
    pub(crate) falloff: f64,
    /// `cos(half_angle)` for spot lights; zero for other kinds.
    #[get(type(copy))]
    pub(crate) spot_cos: f64,
}

/// A material describing how a surface responds to illumination.
#[derive(Clone, Data, Debug, New, PartialEq)]
pub struct Material {
    /// The shading model applied during evaluation.
    #[get(type(copy))]
    pub(crate) kind: MaterialKind,
    /// The base reflectance color in the range 0.0..=1.0 per channel.
    #[get(type(copy))]
    pub(crate) albedo: Vector3D,
    /// Specular intensity multiplier in the range 0.0..=1.0.
    #[get(type(copy))]
    pub(crate) specular: f64,
    /// Phong specular exponent; larger values produce tighter highlights.
    #[get(type(copy))]
    pub(crate) shininess: f64,
    /// Self-illumination term used when a surface is also a light source
    /// (e.g. an emissive sphere visible through ray tracing).
    #[get(type(copy))]
    pub(crate) emissive: Vector3D,
}

/// Bundles of uniforms supplied to lighting and shading routines.
#[derive(Clone, Data, Debug, New, PartialEq)]
pub struct LightingUniforms {
    /// All lights contributing to the scene.
    #[get(pub(crate), type(clone))]
    pub(crate) lights: Vec<Light>,
    /// Ambient light contribution applied to every shaded point.
    #[get(type(copy))]
    pub(crate) ambient: Vector3D,
    /// View position used for specular term calculation.
    #[get(type(copy))]
    pub(crate) eye: Vector3D,
}