enginerenderer 0.0.1

A zero-dependency offline rendering engine in pure Rust — CPU path tracing, BVH acceleration, 16-band spectral rendering, PBR materials, animation & video export.
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

use crate::core::engine::rendering::materials::material::MaterialLibrary;
use crate::core::engine::rendering::raytracing::{Material, Vec3};

/// Name-based material catalog used by the public API.
#[derive(Debug)]
pub struct MaterialCatalog;

impl MaterialCatalog {
    /// Returns a predefined material by catalog name.
    pub fn by_name(&self, name: &str) -> Material {
        match name {
            "stellar_surface" => MaterialLibrary::stellar_surface(),
            "rocky_world" => MaterialLibrary::rocky_world(Vec3::new(0.71, 0.42, 0.26)),
            "ocean_world" => MaterialLibrary::ocean_world(),
            "icy_world" => MaterialLibrary::icy_world(),
            "metallic_moon" => MaterialLibrary::metallic_moon(),
            "automotive_paint" => MaterialLibrary::automotive_paint(Vec3::new(0.72, 0.10, 0.14)),
            "window_glass" => MaterialLibrary::window_glass(),
            "architectural_plaster" => MaterialLibrary::architectural_plaster(),
            "roof_tiles" => MaterialLibrary::roof_tiles(),
            "tree_bark" => MaterialLibrary::tree_bark(),
            "tree_foliage" => MaterialLibrary::tree_foliage(),
            "asphalt" => MaterialLibrary::asphalt(),
            "lush_planet" => MaterialLibrary::lush_planet(),
            "solar_corona" => MaterialLibrary::solar_corona(),
            "accretion_disk" => MaterialLibrary::accretion_disk(),
            "event_horizon" => MaterialLibrary::event_horizon(),
            "rubber_tire" => MaterialLibrary::rubber_tire(),
            _ => self.fallback(),
        }
    }

    /// Returns a rocky world material tinted with the provided RGB color.
    pub fn rocky_world_colored(&self, r: f64, g: f64, b: f64) -> Material {
        MaterialLibrary::rocky_world(Vec3::new(r, g, b))
    }

    /// Returns an automotive paint material tinted with the provided RGB color.
    pub fn automotive_paint_colored(&self, r: f64, g: f64, b: f64) -> Material {
        MaterialLibrary::automotive_paint(Vec3::new(r, g, b))
    }

    /// Builds a fully custom material from physically-based parameters.
    pub fn custom(
        &self,
        albedo: [f64; 3],
        roughness: f64,
        metallic: f64,
        reflectivity: f64,
        emission: [f64; 3],
    ) -> Material {
        Material::new(
            Vec3::new(albedo[0], albedo[1], albedo[2]),
            roughness,
            metallic,
            reflectivity,
            Vec3::new(emission[0], emission[1], emission[2]),
        )
    }

    /// Returns the list of supported catalog material names.
    pub fn all_names(&self) -> &'static [&'static str] {
        &[
            "stellar_surface",
            "rocky_world",
            "ocean_world",
            "icy_world",
            "metallic_moon",
            "automotive_paint",
            "window_glass",
            "architectural_plaster",
            "roof_tiles",
            "tree_bark",
            "tree_foliage",
            "asphalt",
            "lush_planet",
            "solar_corona",
            "accretion_disk",
            "event_horizon",
            "rubber_tire",
        ]
    }

    fn fallback(&self) -> Material {
        Material::new(Vec3::new(0.5, 0.5, 0.5), 0.5, 0.0, 0.04, Vec3::ZERO)
    }
}