scena 1.1.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
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

use std::future::Future;

use crate::diagnostics::AssetError;

use super::AssetPath;

/// Source-byte provider for asset loading.
pub trait AssetFetcher {
    type Future<'a>: Future<Output = Result<Vec<u8>, AssetError>> + 'a
    where
        Self: 'a;

    fn fetch<'a>(&'a self, path: &'a AssetPath) -> Self::Future<'a>;
}

#[cfg(not(target_arch = "wasm32"))]
pub type DefaultAssetFetcher = FileAssetFetcher;

#[cfg(target_arch = "wasm32")]
pub type DefaultAssetFetcher = BrowserAssetFetcher;

#[cfg(not(target_arch = "wasm32"))]
#[derive(Debug, Clone, Copy, Default)]
pub struct FileAssetFetcher;

#[cfg(not(target_arch = "wasm32"))]
impl AssetFetcher for FileAssetFetcher {
    type Future<'a> = std::future::Ready<Result<Vec<u8>, AssetError>>;

    fn fetch<'a>(&'a self, path: &'a AssetPath) -> Self::Future<'a> {
        std::future::ready(
            std::fs::read(path.as_str()).map_err(|error| AssetError::Io {
                path: path.as_str().to_string(),
                reason: error.to_string(),
            }),
        )
    }
}

#[cfg(target_arch = "wasm32")]
#[derive(Debug, Clone, Copy, Default)]
pub struct BrowserAssetFetcher;

#[cfg(target_arch = "wasm32")]
impl AssetFetcher for BrowserAssetFetcher {
    type Future<'a> = std::pin::Pin<Box<dyn Future<Output = Result<Vec<u8>, AssetError>> + 'a>>;

    fn fetch<'a>(&'a self, path: &'a AssetPath) -> Self::Future<'a> {
        Box::pin(async move { fetch_browser_bytes(path).await })
    }
}

#[cfg(target_arch = "wasm32")]
async fn fetch_browser_bytes(path: &AssetPath) -> Result<Vec<u8>, AssetError> {
    use wasm_bindgen::JsCast;
    use wasm_bindgen_futures::JsFuture;

    let window = web_sys::window().ok_or_else(|| AssetError::Io {
        path: path.as_str().to_string(),
        reason: "browser fetch requires a Window".to_string(),
    })?;
    let response_value = JsFuture::from(window.fetch_with_str(path.as_str()))
        .await
        .map_err(|error| js_asset_error(path, "browser fetch failed", error))?;
    let response = response_value
        .dyn_into::<web_sys::Response>()
        .map_err(|error| js_asset_error(path, "browser fetch did not return a Response", error))?;

    if !response.ok() {
        return Err(if response.status() == 404 {
            AssetError::NotFound {
                path: path.as_str().to_string(),
            }
        } else {
            AssetError::Io {
                path: path.as_str().to_string(),
                reason: format!("browser fetch returned HTTP {}", response.status()),
            }
        });
    }

    let buffer_promise = response
        .array_buffer()
        .map_err(|error| js_asset_error(path, "browser response.arrayBuffer failed", error))?;
    let buffer = JsFuture::from(buffer_promise)
        .await
        .map_err(|error| js_asset_error(path, "browser arrayBuffer await failed", error))?;
    let array = js_sys::Uint8Array::new(&buffer);
    let mut bytes = vec![0; array.length() as usize];
    array.copy_to(&mut bytes);
    Ok(bytes)
}

#[cfg(target_arch = "wasm32")]
fn js_asset_error(path: &AssetPath, context: &str, error: wasm_bindgen::JsValue) -> AssetError {
    AssetError::Io {
        path: path.as_str().to_string(),
        reason: error
            .as_string()
            .unwrap_or_else(|| format!("{context}: {error:?}")),
    }
}