mugl 0.1.2

Minimalistic Low-level WebGL 2.0 / WebGPU 3D graphics abstraction layer for Rust and WebAssembly
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

#![cfg(all(target_family = "wasm", feature = "backend-webgl"))]
#![no_main]

extern crate alloc;
mod app;
mod common;

use alloc::boxed::Box;
use common::App;
use mugl::{prelude::*, webgl::*};

#[global_allocator]
static ALLOC: wee_alloc::WeeAlloc = wee_alloc::WeeAlloc::INIT;

static mut APP: Option<Box<dyn App>> = None;
static mut CANVAS: Option<Canvas> = None;

#[cfg_attr(feature = "wasm-bindgen", wasm_bindgen::prelude::wasm_bindgen)]
#[no_mangle]
pub extern "C" fn app_id() -> f64 {
    // wasm-bindgen does not support newtype pattern yet, return the underlying f64 instead
    ContextId::get().0
}

#[cfg_attr(feature = "wasm-bindgen", wasm_bindgen::prelude::wasm_bindgen)]
#[no_mangle]
pub extern "C" fn init(id: u32) {
    unsafe {
        if CANVAS.is_none() {
            CANVAS = Some(Canvas::from_id("canvas"));
        }
        CANVAS.as_ref().map(|canvas| {
            APP = select_app(id, canvas);
        });
    }
}

fn select_app(id: u32, canvas: &Canvas) -> Option<Box<dyn App>> {
    match id {
        0 => create_app::<app::BasicExample>(canvas),
        1 => create_app::<app::InstancingExample>(canvas),
        2 => create_app::<app::StencilExample>(canvas),
        _ => None,
    }
}

fn create_app<A: App + 'static>(canvas: &Canvas) -> Option<Box<dyn App>> {
    let device = A::request_webgl_device(canvas)?;
    Some(Box::new(A::new(device, canvas.size())))
}

#[cfg_attr(feature = "wasm-bindgen", wasm_bindgen::prelude::wasm_bindgen)]
#[no_mangle]
pub extern "C" fn render(t: f64) -> bool {
    if let Some(app) = unsafe { APP.as_mut() } {
        app.render(t)
    } else {
        false
    }
}

#[cfg_attr(feature = "wasm-bindgen", wasm_bindgen::prelude::wasm_bindgen)]
#[no_mangle]
pub extern "C" fn resize(width: u32, height: u32) {
    if let Some(app) = unsafe { APP.as_mut() } {
        app.resize(Extent2D(width, height));
    }
}

#[cfg_attr(feature = "wasm-bindgen", wasm_bindgen::prelude::wasm_bindgen)]
#[no_mangle]
pub extern "C" fn destroy() {
    unsafe {
        APP.take();
    }
}