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

use crate::api::materials::catalog::MaterialCatalog;
use crate::api::objects::SceneObject;
use crate::core::engine::rendering::raytracing::Vec3;

pub use crate::core::engine::rendering::mesh::asset::MeshAsset;
pub use crate::core::engine::rendering::mesh::generators::{
    ground_plane, icosphere, torus, unit_cube,
};
pub use crate::core::engine::rendering::mesh::operations::{
    compute_tangents, recalculate_normals, subdivide,
};
pub use crate::core::engine::rendering::mesh::vertex::{cube, geometric_density, plane, uv_sphere};
pub use crate::core::engine::rendering::preprocessing::bvh_builder::Aabb;
pub use crate::core::engine::rendering::raytracing::{Material, Ray, Scene, Sphere, Triangle};

impl SceneObject {
    /// Creates a star sphere with the stellar surface material.
    pub fn star(center: [f64; 3], radius: f64) -> Self {
        Self::sphere(center, radius, "stellar_surface")
    }

    /// Creates a rocky planet sphere.
    pub fn planet(center: [f64; 3], radius: f64) -> Self {
        Self::sphere(center, radius, "rocky_world")
    }

    /// Creates an ocean planet sphere.
    pub fn ocean_planet(center: [f64; 3], radius: f64) -> Self {
        Self::sphere(center, radius, "ocean_world")
    }

    /// Creates an ice planet sphere.
    pub fn ice_planet(center: [f64; 3], radius: f64) -> Self {
        Self::sphere(center, radius, "icy_world")
    }

    /// Creates a moon sphere with a metallic material.
    pub fn moon(center: [f64; 3], radius: f64) -> Self {
        Self::sphere(center, radius, "metallic_moon")
    }

    /// Creates a lush planet sphere.
    pub fn lush_planet(center: [f64; 3], radius: f64) -> Self {
        Self::sphere(center, radius, "lush_planet")
    }

    /// Creates a black-hole proxy sphere.
    pub fn black_hole(center: [f64; 3], radius: f64) -> Self {
        Self::sphere(center, radius, "event_horizon")
    }

    /// Creates a large sphere used as a ground plane approximation.
    pub fn ground_plane(y: f64, material_name: &str) -> Self {
        Self::sphere([0.0, y - 200.0, 0.0], 200.0, material_name)
    }

    /// Creates a sphere with an explicit RGB material.
    pub fn colored_sphere(center: [f64; 3], radius: f64, rgb: [f64; 3], roughness: f64) -> Self {
        let mat = MaterialCatalog.custom(rgb, roughness, 0.0, 0.04, [0.0, 0.0, 0.0]);
        Self::Sphere {
            center: Vec3::new(center[0], center[1], center[2]),
            radius: radius.max(0.01),
            material: mat,
        }
    }
}