scena 1.7.2

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
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

use crate::geometry::Aabb;
use crate::scene::{SceneInspectionReportV1, Transform, Vec3};

use super::{RenderIntrospectionFixV1, push_fix, round3};

pub(in crate::render) fn push_frame_bounds_fix(
    fixes: &mut Vec<RenderIntrospectionFixV1>,
    help: &str,
    inspection: &SceneInspectionReportV1,
) {
    let Some(patch) = frame_bounds_patch(inspection) else {
        return;
    };
    push_fix(
        fixes,
        "frame_bounds",
        inspection.active_camera,
        Some(patch),
        help,
    );
}

pub(in crate::render) fn frame_bounds_patch(
    inspection: &SceneInspectionReportV1,
) -> Option<serde_json::Value> {
    let bounds = combined_draw_world_bounds(inspection)?;
    let center = bounds.center();
    let radius = bounds.bounding_sphere_radius().max(0.25);
    let distance = round3((radius * 2.8).max(1.0));
    Some(serde_json::json!({
        "camera": {
            "target": [round3(center.x), round3(center.y), round3(center.z)],
            "distance": distance,
            "yaw_radians": 0.785,
            "pitch_radians": 0.524
        }
    }))
}

fn combined_draw_world_bounds(inspection: &SceneInspectionReportV1) -> Option<Aabb> {
    inspection
        .draw_list
        .iter()
        .filter_map(|draw| transform_aabb(draw.local_bounds, draw.world_transform))
        .reduce(Aabb::union)
}

fn transform_aabb(bounds: Aabb, transform: Transform) -> Option<Aabb> {
    let mut corners = [
        Vec3::new(bounds.min.x, bounds.min.y, bounds.min.z),
        Vec3::new(bounds.min.x, bounds.min.y, bounds.max.z),
        Vec3::new(bounds.min.x, bounds.max.y, bounds.min.z),
        Vec3::new(bounds.min.x, bounds.max.y, bounds.max.z),
        Vec3::new(bounds.max.x, bounds.min.y, bounds.min.z),
        Vec3::new(bounds.max.x, bounds.min.y, bounds.max.z),
        Vec3::new(bounds.max.x, bounds.max.y, bounds.min.z),
        Vec3::new(bounds.max.x, bounds.max.y, bounds.max.z),
    ];
    for corner in &mut corners {
        *corner = transform_point(*corner, transform);
        if !corner.is_finite() {
            return None;
        }
    }
    let mut min = corners[0];
    let mut max = corners[0];
    for corner in &corners[1..] {
        min = min.min(*corner);
        max = max.max(*corner);
    }
    Some(Aabb::new(min, max))
}

fn transform_point(point: Vec3, transform: Transform) -> Vec3 {
    transform.translation + transform.rotation * (point * transform.scale)
}