scena 1.5.1

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

use crate::assets::{AssetPath, TextureDesc, TextureSamplerDesc, TextureSourceFormat};
use crate::material::TextureColorSpace;

#[test]
fn material_resources_define_shader_visible_texture_bindings() {
    let source = include_str!("../materials.rs");
    let bind_group_source = include_str!("bind_group.rs");
    let bindings_source = include_str!("../material_bindings.rs");
    let batched_source = include_str!("../material_batched.rs");
    assert!(
        bindings_source.contains("SamplerBindingType::Filtering")
            && bindings_source.contains("TextureSampleType::Float { filterable: true }")
            && bindings_source.contains("NORMAL_BINDINGS")
            && bindings_source.contains("METALLIC_ROUGHNESS_BINDINGS")
            && bindings_source.contains("OCCLUSION_BINDINGS")
            && bindings_source.contains("EMISSIVE_BINDINGS")
            && bindings_source.contains("CLEARCOAT_BINDINGS")
            && bindings_source.contains("CLEARCOAT_ROUGHNESS_BINDINGS")
            && bindings_source.contains("CLEARCOAT_NORMAL_BINDINGS")
            && bindings_source.contains("SHEEN_COLOR_BINDINGS")
            && bindings_source.contains("SHEEN_ROUGHNESS_BINDINGS")
            && bindings_source.contains("ANISOTROPY_BINDINGS")
            && bindings_source.contains("IRIDESCENCE_BINDINGS")
            && bindings_source.contains("IRIDESCENCE_THICKNESS_BINDINGS")
            && bindings_source.contains("MATERIAL_TEXTURE_BINDING_INDICES")
            && bindings_source.contains("Self::Texture2d => wgpu::TextureViewDimension::D2")
            && bindings_source.contains("TextureViewDimension::D2Array")
            && source.contains("MaterialTextureUpload")
            && source.contains("MaterialUniformUpload")
            && source.contains("binding: 2")
            && source.contains("scena.material.uniform")
            && source.contains("scena.material.base_color")
            && source.contains("scena.material.normal")
            && source.contains("scena.material.metallic_roughness")
            && source.contains("scena.material.occlusion")
            && source.contains("scena.material.emissive")
            && source.contains("scena.material.clearcoat")
            && source.contains("scena.material.clearcoat_roughness")
            && source.contains("scena.material.clearcoat_normal")
            && source.contains("scena.material.sheen_color")
            && source.contains("scena.material.sheen_roughness")
            && source.contains("scena.material.anisotropy")
            && source.contains("scena.material.iridescence")
            && source.contains("scena.material.iridescence_thickness")
            && source.contains("scena.material.fallback_base_color")
            && bind_group_source.contains("scena.material.fallback_bind_group")
            && batched_source.contains("scena.material.batched_uniform")
            && batched_source.contains("scena.material.batched_clearcoat")
            && batched_source.contains("scena.material.batched_clearcoat_roughness")
            && batched_source.contains("scena.material.batched_clearcoat_normal")
            && batched_source.contains("scena.material.batched_sheen_color")
            && batched_source.contains("scena.material.batched_sheen_roughness")
            && batched_source.contains("scena.material.batched_anisotropy")
            && batched_source.contains("scena.material.batched_iridescence")
            && batched_source.contains("scena.material.batched_iridescence_thickness")
            && batched_source.contains("template.browser_image.is_some()")
            && batched_source.contains("wgpu::TextureUsages::RENDER_ATTACHMENT"),
        "backend material scaffolding must allocate a sampler, texture view, and bind group \
         plus the batched array path and browser ImageBitmap upload usage that closes plan line 778"
    );
}

#[test]
fn decoded_base_color_texture_becomes_backend_upload() {
    let texture = TextureDesc::new_with_bytes(
        AssetPath::from(
            "data:image/png;base64,\
             iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR4nGP4z8DwHwAFAAH/iZk9HQAAAABJRU5ErkJggg==",
        ),
        TextureColorSpace::Srgb,
        TextureSamplerDesc::default(),
        TextureSourceFormat::Png,
        None,
    )
    .expect("inline PNG texture decodes");

    let upload = super::MaterialTextureUpload::from_base_color_texture(Some(&texture));

    assert!(upload.uses_decoded_texture);
    assert_eq!(upload.width, 1);
    assert_eq!(upload.height, 1);
    assert_eq!(upload.rgba8, &[255, 0, 0, 255]);
    assert_eq!(upload.format, wgpu::TextureFormat::Rgba8UnormSrgb);
}

#[test]
fn wgpu_material_upload_uses_texture_sampler_metadata() {
    let source = include_str!("../materials.rs");
    let upload_source = include_str!("../material_upload.rs");
    assert!(
        source.contains("address_mode(upload.sampler.wrap_s())")
            && source.contains("address_mode(upload.sampler.wrap_t())")
            && source.contains("filter_mode(upload.sampler.mag_filter())")
            && source.contains("filter_mode(upload.sampler.min_filter())")
            && source.contains("mipmap_filter_mode(upload.sampler.min_filter())")
            && upload_source
                .contains("TextureWrap::MirroredRepeat => wgpu::AddressMode::MirrorRepeat")
            && upload_source.contains("TextureWrap::Repeat => wgpu::AddressMode::Repeat")
            && upload_source.contains("TextureFilter::Nearest")
            && upload_source.contains("TextureFilter::LinearMipmapLinear"),
        "wgpu material upload must honor glTF sampler wrap/filter metadata instead of \
         hardcoding linear clamp-to-edge"
    );
}