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
97
98
99
100
101
102
103
104
105
106
107
108
109

use std::error::Error;

use crate::api::scenes::builder::SceneBuilder;
use crate::api::types::{Quality, RenderRequest, RenderResult};
use crate::core::engine::rendering::renderer::Renderer;
use crate::core::engine::rendering::renderer::types::RenderPreset;

use super::capabilities;
use super::prompt;

/// High-level AI rendering facade.
#[derive(Debug)]
pub struct AiRenderer {
    preset_hd: RenderPreset,
    preset_production: RenderPreset,
}

impl Default for AiRenderer {
    fn default() -> Self {
        Self::new()
    }
}

impl AiRenderer {
    /// Creates a renderer with default HD and production presets.
    pub fn new() -> Self {
        Self {
            preset_hd: RenderPreset::UltraHdCpu,
            preset_production: RenderPreset::ProductionReference,
        }
    }

    /// Renders a scene built from a [`SceneBuilder`] and request parameters.
    pub fn render_scene_builder(
        &self,
        builder: SceneBuilder,
        request: &RenderRequest,
    ) -> Result<RenderResult, Box<dyn Error>> {
        let (scene, camera) = builder.build(request.aspect_ratio());
        let renderer = Renderer::with_resolution(request.width, request.height);
        let preset = self.preset_for(request);
        let output_path = request.output_path();
        let report = renderer.render_scene_to_file(&scene, &camera, &output_path, preset)?;

        Ok(RenderResult {
            output_path,
            width: report.width,
            height: report.height,
            rendered_pixels: report.rendered_pixels,
            duration_ms: report.duration_ms,
            object_count: report.object_count,
            triangle_count: report.triangle_count,
            average_luminance: report.average_luminance,
            min_luminance: report.min_luminance,
            max_luminance: report.max_luminance,
            estimated_samples_per_pixel: report.estimated_samples_per_pixel,
        })
    }

    /// Renders the built-in showcase scene.
    pub fn render_showcase(&self, request: &RenderRequest) -> Result<RenderResult, Box<dyn Error>> {
        let renderer = Renderer::with_resolution(request.width, request.height);
        let preset = self.preset_for(request);
        let output_path = request.output_path();
        let report = renderer.render_to_file(&output_path, preset)?;

        Ok(RenderResult {
            output_path,
            width: report.width,
            height: report.height,
            rendered_pixels: report.rendered_pixels,
            duration_ms: report.duration_ms,
            object_count: report.object_count,
            triangle_count: report.triangle_count,
            average_luminance: report.average_luminance,
            min_luminance: report.min_luminance,
            max_luminance: report.max_luminance,
            estimated_samples_per_pixel: report.estimated_samples_per_pixel,
        })
    }

    /// Builds a scene from a text prompt and renders it.
    pub fn render_prompt(
        &self,
        prompt: &str,
        request: &RenderRequest,
    ) -> Result<RenderResult, Box<dyn Error>> {
        let builder = self.scene_from_prompt(prompt).auto_frame();
        self.render_scene_builder(builder, request)
    }

    /// Converts a text prompt into a scene builder.
    pub fn scene_from_prompt(&self, prompt: &str) -> SceneBuilder {
        prompt::scene_from_prompt(prompt)
    }

    /// Returns runtime capabilities available to the AI renderer.
    pub fn capabilities(&self) -> capabilities::Capabilities {
        capabilities::discover()
    }

    fn preset_for(&self, request: &RenderRequest) -> RenderPreset {
        match request.quality {
            Quality::Preview => RenderPreset::PreviewCpu,
            Quality::Hd => self.preset_hd,
            Quality::Production => self.preset_production,
        }
    }
}