scena 1.3.0

A Rust-native scene-graph renderer with typed scene state, glTF assets, and explicit prepare/render lifecycles.
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

use scena::{
    Assets, AutoExposureConfig, FramingOptions, GridFloorOptions, OrbitControls, PerspectiveCamera,
    Renderer, Scene, Transform,
};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let assets = Assets::new();
    let model = pollster::block_on(
        assets.load_scene("tests/assets/gltf/mesh_material_vertex_color_scene.gltf"),
    )?;

    let mut scene = Scene::new();
    let import = scene.instantiate(&model)?;
    scene.add_studio_lighting()?;

    let bounds = import
        .bounds_world(&scene)
        .ok_or("import has no renderable bounds")?;
    scene.add_grid_floor(&assets, GridFloorOptions::new().under_bounds(bounds))?;

    let width = 640;
    let height = 360;
    let camera = scene.add_perspective_camera(
        scene.root(),
        PerspectiveCamera::default().with_aspect(width as f32 / height as f32),
        Transform::default(),
    )?;
    let framing = scene.frame_bounds(
        camera,
        bounds,
        FramingOptions::new()
            .three_quarter_front_right()
            .fill(0.72)
            .margin_px(32.0)
            .viewport(width, height),
    )?;

    let orbit = OrbitControls::from_framing(framing);
    let mut renderer = Renderer::headless(width, height)?;
    renderer.set_auto_exposure(AutoExposureConfig::default());
    renderer.prepare_with_assets(&mut scene, &assets)?;
    renderer.render(&scene, camera)?;

    println!(
        "easy_model_viewer roots={} fill={:.2} orbit_target={:?}",
        import.roots().len(),
        framing.projected_rect.fill_fraction(width, height),
        orbit.target()
    );
    Ok(())
}