Crate rustic_zen

Photon Garden Raytracer Impementation.

Rustic Zen renders artworks from a scene definition by simulating individual photons and tracing their path as they bounce through a 2D. space.

Photons are generated by Lights and interact with Objects. Each interaction results in either the photon being absorbed, or being allowed to continue with a new direction, based on the rules defined by the Object’s Material.

Example usage:

extern crate rustic_zen;
use rustic_zen::prelude::*;
use rustic_zen::material::hqz_legacy;
use std::sync::Arc;

fn main() {
    // Set up constants.
    let width: f64 = 1920.0;
    let height: f64 = 1080.0;

    // Build a basic Material
    let m = hqz_legacy(0.3, 0.3, 0.3);

    // Build a basic Object
    let o = Segment::line_from_points((0.0,(height * 0.75)), (width, (height * 0.75)), m);

    // Build a basic Light
    let l = Light::new((width / 2.0, height / 2.0), 1.0, 0.0, 0.0, (360.0, 0.0), Sampler::new_blackbody(5800.0));

    // Construct a renderer object and add the light and object to it.
    let s = Scene::new(width as usize, height as usize).with_object(o).with_light(l);

    // Create an image to render into.
    let mut i = Arc::new(Image::new(width as usize, height as usize));

    // Render Image
    println!("Tracing Rays");
    let rays = s.render(RenderConstraint::TimeMS(1000), 1, &mut i);
    // this call should probably be more like 5000 - 15000 ms and use your number of threads,
    // but this example is run by various CI tools, and tests can't take too long.

    // Output the Image as a Vec<u8>
    println!("Serializing!");
    let data = i.to_rgba8(rays, 0.7, 1.2);
     
    // Do Export to a PNG or whatever you want here.
}

Modules

• geom
  Rustic Zen’s native geometry primitives.
• image
  Module providing render targets for both Software and Hardware accelerated image rendering.
• material
  Materials in Rustic Zen are defined as closures that act on a single ray when intersecting wtth an object.
• prelude
  This prelude contains everything to quickstart using Rustic Zen.
• sampler
  Wrappers for stochastically sampled variables.
• scene
  Scene Definition and Rendering Control.