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
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

use std::collections::BTreeMap;

use serde::{Deserialize, Serialize};
use serde_json::Value;

mod authoring;
mod build_manifest;
mod expectations;
mod overlays;
#[cfg(all(feature = "inspection", feature = "scene-host"))]
mod render_result;
mod setup;
pub use authoring::{
    SceneRecipeAlphaModeV1, SceneRecipeAnimationChannelV1, SceneRecipeAnimationV1,
    SceneRecipeCameraFramingV1, SceneRecipeCameraV1, SceneRecipeClippingPlaneV1,
    SceneRecipeColorV1, SceneRecipeExpectedExtentV1, SceneRecipeFontV1, SceneRecipeGeometryV1,
    SceneRecipeImportV1, SceneRecipeInstanceSetV1, SceneRecipeInstanceV1, SceneRecipeLabelV1,
    SceneRecipeLightV1, SceneRecipeLookAtTargetV1, SceneRecipeMaterialV1, SceneRecipeMeshV1,
    SceneRecipeMorphTargetV1, SceneRecipeMorphV1, SceneRecipeNodeLodV1,
    SceneRecipeNodeSkinBindingV1, SceneRecipeNodeV1, SceneRecipeParticleSetV1,
    SceneRecipeParticleV1, SceneRecipePrimitiveV1, SceneRecipeSkinV1,
    SceneRecipeTextureColorSpaceV1, SceneRecipeTextureSlotV1, SceneRecipeTransformV1,
};
pub use build_manifest::{
    SceneRecipeBuildAnimationV1, SceneRecipeBuildImportV1, SceneRecipeBuildResourceV1,
    SceneRecipeBuildSkippedV1, SceneRecipeBuildTargetV1, SceneRecipeBuildV1,
    SceneRecipeDiagnosticV1, SceneRecipeValidationReportV1,
};
pub use expectations::{
    SceneRecipeBackendExpectationV1, SceneRecipeBboxFitExpectationV1,
    SceneRecipeClippingExpectationV1, SceneRecipeColorExpectationV1, SceneRecipeExpectV1,
    SceneRecipeGroundedExpectationV1, SceneRecipeHelperOcclusionExpectationV1,
    SceneRecipePickExpectationV1, SceneRecipeQualityAreaLightV1, SceneRecipeQualityContrastV1,
    SceneRecipeQualityDepthOfFieldV1, SceneRecipeQualityExpectationV1,
    SceneRecipeQualityExposureV1, SceneRecipeQualityGeometryV1, SceneRecipeQualityGroundingV1,
    SceneRecipeQualityLineV1, SceneRecipeQualityNoiseV1, SceneRecipeQualityReflectionV1,
    SceneRecipeQualityTextV1, SceneRecipeReferenceExpectationV1,
    SceneRecipeSeparationExpectationV1, SceneRecipeStateExpectationV1,
    SceneRecipeTransformExpectationV1, SceneRecipeVisibleExpectationV1,
};
pub use overlays::{
    SceneRecipeCalloutTargetV1, SceneRecipeCalloutV1, SceneRecipeCaptureV1,
    SceneRecipeExplodedViewModeV1, SceneRecipeExplodedViewV1, SceneRecipeMeasurementV1,
    SceneRecipeSectionBoxV1, SceneRecipeTargetV1,
};
#[cfg(all(feature = "inspection", feature = "scene-host"))]
pub use render_result::{
    SCENE_COMPOSITION_SCHEMA_V1, SCENE_RECIPE_RENDER_RESULT_SCHEMA_V1, SceneCompositionCheckV1,
    SceneCompositionRegionV1, SceneCompositionReportV1, SceneCompositionStatusV1,
    SceneCompositionSummaryV1, SceneRecipeRenderResultV1, SceneRecipeVerificationReasonV1,
    SceneRecipeVerificationReportV1, SceneRecipeVerificationSummaryV1,
};
pub use setup::{
    SceneRecipeAutoExposureV1, SceneRecipeBackgroundV1, SceneRecipeBloomV1,
    SceneRecipeDepthOfFieldV1, SceneRecipeEnvironmentV1, SceneRecipeGridReflectionV1,
    SceneRecipeGridV1, SceneRecipeRenderV1, SceneRecipeSceneV1,
    SceneRecipeScreenSpaceReflectionsV1, SceneRecipeSsaoV1,
};

pub const SCENE_RECIPE_SCHEMA_V1: &str = "scena.scene_recipe.v1";
pub const SCENE_RECIPE_VALIDATION_SCHEMA_V1: &str = "scena.scene_recipe_validation.v1";
pub const SCENE_RECIPE_BUILD_SCHEMA_V1: &str = "scena.scene_recipe_build.v1";

#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SceneRecipeV1 {
    pub schema: String,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub imports: Vec<SceneRecipeImportV1>,
    #[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
    pub colors: BTreeMap<String, SceneRecipeColorV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub geometries: Vec<SceneRecipeGeometryV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub morphs: Vec<SceneRecipeMorphV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub skins: Vec<SceneRecipeSkinV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub materials: Vec<SceneRecipeMaterialV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub nodes: Vec<SceneRecipeNodeV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub instance_sets: Vec<SceneRecipeInstanceSetV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub particles: Vec<SceneRecipeParticleSetV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub fonts: Vec<SceneRecipeFontV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub labels: Vec<SceneRecipeLabelV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub clipping_planes: Vec<SceneRecipeClippingPlaneV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub animations: Vec<SceneRecipeAnimationV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub cameras: Vec<SceneRecipeCameraV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub lights: Vec<SceneRecipeLightV1>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub scene: Option<SceneRecipeSceneV1>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub render: Option<SceneRecipeRenderV1>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub expect: Option<SceneRecipeExpectV1>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub section_box: Option<SceneRecipeSectionBoxV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub measurements: Vec<SceneRecipeMeasurementV1>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub callouts: Vec<SceneRecipeCalloutV1>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub exploded_view: Option<SceneRecipeExplodedViewV1>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub capture: Option<SceneRecipeCaptureV1>,
    #[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
    pub metadata: BTreeMap<String, Value>,
}

pub(super) fn default_transform_scale() -> [f64; 3] {
    [1.0, 1.0, 1.0]
}

pub(super) fn default_transform_up() -> [f64; 3] {
    [0.0, 1.0, 0.0]
}

pub(super) fn is_zero_vec3(value: &[f64; 3]) -> bool {
    *value == [0.0, 0.0, 0.0]
}

pub(super) fn is_zero_f64(value: &f64) -> bool {
    *value == 0.0
}

pub(super) fn is_default_scale(value: &[f64; 3]) -> bool {
    *value == default_transform_scale()
}

pub(super) fn is_default_up(value: &[f64; 3]) -> bool {
    *value == default_transform_up()
}

pub(super) fn is_false(value: &bool) -> bool {
    !*value
}

pub(super) fn is_true(value: &bool) -> bool {
    *value
}

pub(super) fn default_true() -> bool {
    true
}