//! The eframe web runner: canvas lookup, backend selection, the loading screen's startup steps, //! browser shortcuts the app takes over, and startup errors shown in the page. use materialcraft_ui_egui::MaterialCraftApp; use wasm_bindgen::JsCast as _; use wasm_bindgen::closure::Closure; const CANVAS_ID: &str = "materialcraft_canvas"; const LOADING_ID: &str = "materialcraft_loading"; const STATUS_ID: &str = "materialcraft_status"; const PROGRESS_ID: &str = "materialcraft_progress"; pub fn start() { eframe::WebLogger::init(log::LevelFilter::Info).ok(); capture_app_shortcuts(); wasm_bindgen_futures::spawn_local(async { let Some(document) = web_sys::window().and_then(|w| w.document()) else { log::error!("no document"); return; }; let result = match document.get_element_by_id(CANVAS_ID).and_then(|e| e.dyn_into::().ok()) { Some(canvas) => run(canvas).await, None => Err(format!("the page has no ")), }; if let Some(el) = document.get_element_by_id(LOADING_ID) { match result { Ok(()) => el.remove(), Err(e) => { log::error!("MaterialCraft failed to start: {e}"); el.set_text_content(Some(&format!( "MaterialCraft failed to start: {e}. It needs a browser with WebGPU (current Chrome, Edge or Safari) or at least WebGL2." ))); } } } }); } async fn run(canvas: web_sys::HtmlCanvasElement) -> Result<(), String> { // The WebAssembly has downloaded and compiled when this runs. step(0.5, "Preparing a new package…").await; let session = materialcraft_engine::new_session(); step(0.8, "Starting the renderer…").await; let mut options = eframe::WebOptions::default(); if query().contains("webgl") && let eframe::egui_wgpu::WgpuSetup::CreateNew(create) = &mut options.wgpu_options.wgpu_setup { create.instance_descriptor.backends = eframe::wgpu::Backends::GL; } eframe::WebRunner::new() .start( canvas, options, Box::new(|cc| { let mut app = MaterialCraftApp::new(cc, session); // One thread cooks in the browser: keep previews small. app.ui.prefs.preview_size = app.ui.prefs.preview_size.clamp(128, 256); Ok(Box::new(app)) }), ) .await .map_err(|e| e.as_string().unwrap_or_else(|| format!("{e:?}"))) } /// Show a startup step on the loading screen and let the browser paint it before the next /// (blocking) step runs. async fn step(progress: f32, status: &str) { let Some(document) = web_sys::window().and_then(|w| w.document()) else { return }; if let Some(el) = document.get_element_by_id(STATUS_ID) { el.set_text_content(Some(status)); } if let Some(el) = document.get_element_by_id(PROGRESS_ID) { let _ = el.set_attribute("value", &progress.to_string()); } // A timer longer than a frame lets the browser paint the step before work resumes. Not // `requestAnimationFrame`: it never fires in a background tab, which would stall startup. let promise = js_sys::Promise::new(&mut |resolve, _| { if let Some(w) = web_sys::window() { let _ = w.set_timeout_with_callback_and_timeout_and_arguments_0(&resolve, 20); } }); let _ = wasm_bindgen_futures::JsFuture::from(promise).await; } /// The app's shortcuts (Ctrl+S, Ctrl+O, Ctrl+D, F5…) would also trigger the browser's own /// actions; take them first. Copy, cut and paste stay with the browser, which turns them into /// the clipboard events egui reads. Shortcuts the browser reserves (Ctrl+N, Ctrl+T, Ctrl+W) /// never reach the page. fn capture_app_shortcuts() { let Some(window) = web_sys::window() else { return }; let on_key = Closure::::new(|e: web_sys::KeyboardEvent| { let ctrl = e.ctrl_key() || e.meta_key(); let k = e.key().to_ascii_lowercase(); let taken = (ctrl && ["s", "o", "d", "a", "z", "y", "e"].contains(&k.as_str())) || k == "f5" || (k == " " && !ctrl); if taken { e.prevent_default(); } }); let options = web_sys::AddEventListenerOptions::new(); options.set_capture(true); if let Err(e) = window.add_event_listener_with_callback_and_add_event_listener_options("keydown", on_key.as_ref().unchecked_ref(), &options) { log::warn!("couldn't take over the browser's shortcuts: {e:?}"); } // The listener lives as long as the page. on_key.forget(); } fn query() -> String { web_sys::window().and_then(|w| w.location().search().ok()).unwrap_or_default() }