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
88
89
90
91
92
93
94
95
96

use crate::api::materials::catalog::MaterialCatalog;
use crate::core::engine::rendering::raytracing::{Material, Sphere, Triangle, Vec3};

/// High-level scene object that can be flattened into raytracing primitives.
#[derive(Debug, Clone)]
pub enum SceneObject {
    /// Sphere primitive.
    Sphere {
        /// Sphere center.
        center: Vec3,
        /// Sphere radius.
        radius: f64,
        /// Surface material.
        material: Material,
    },
    /// Triangle primitive.
    Triangle {
        /// First vertex.
        a: Vec3,
        /// Second vertex.
        b: Vec3,
        /// Third vertex.
        c: Vec3,
        /// Surface material.
        material: Material,
    },
    /// Recursive group of scene objects.
    Group(Vec<SceneObject>),
}

impl SceneObject {
    /// Creates a sphere using a named catalog material.
    pub fn sphere(center: [f64; 3], radius: f64, material_name: &str) -> Self {
        Self::Sphere {
            center: Vec3::new(center[0], center[1], center[2]),
            radius: radius.max(0.01),
            material: MaterialCatalog.by_name(material_name),
        }
    }

    /// Creates a sphere from explicit center and material values.
    pub fn sphere_with(center: Vec3, radius: f64, material: Material) -> Self {
        Self::Sphere {
            center,
            radius: radius.max(0.01),
            material,
        }
    }

    /// Creates a triangle using a named catalog material.
    pub fn triangle(a: [f64; 3], b: [f64; 3], c: [f64; 3], material_name: &str) -> Self {
        Self::Triangle {
            a: Vec3::new(a[0], a[1], a[2]),
            b: Vec3::new(b[0], b[1], b[2]),
            c: Vec3::new(c[0], c[1], c[2]),
            material: MaterialCatalog.by_name(material_name),
        }
    }

    /// Creates a grouped scene object.
    pub fn group(objects: Vec<SceneObject>) -> Self {
        Self::Group(objects)
    }

    /// Flattens the object hierarchy into sphere and triangle lists.
    pub fn into_primitives(self) -> (Vec<Sphere>, Vec<Triangle>) {
        let mut spheres = Vec::new();
        let mut triangles = Vec::new();
        self.collect(&mut spheres, &mut triangles);
        (spheres, triangles)
    }

    fn collect(self, spheres: &mut Vec<Sphere>, triangles: &mut Vec<Triangle>) {
        match self {
            Self::Sphere {
                center,
                radius,
                material,
            } => {
                spheres.push(Sphere {
                    center,
                    radius,
                    material,
                });
            }
            Self::Triangle { a, b, c, material } => {
                triangles.push(Triangle::flat(a, b, c, material));
            }
            Self::Group(children) => {
                for child in children {
                    child.collect(spheres, triangles);
                }
            }
        }
    }
}