Files
DOSSIER-STANDALONE/src-tauri/render2d/src/web.rs
T
karim ce6bd26ff7 2D-Engine-Parität: WASM-Pfad rendert deckungsgleich zum SVG-Referenzpfad
Sechs Lücken geschlossen: Text-Massstab vom Geometrie-Massstab entkoppelt
(set_text_scale, spiegelt SVG-Referenzskala); glyphon auf ColorMode::Web
(Text war linear-konvertiert zu dunkel); z-basierte Maler-Reihenfolge
(interleavte draw_sequence statt fills-vor-lines, Alt-Szenen unverändert);
CSS-Klassenfarben/-Opacities in toRenderScene gespiegelt (Türschwenk etc.);
greyed-Dimmung 0.3 auf allen Primitiven; Dämmschraffur am Modell-Ursprung
verankert (userSpaceOnUse), exakte Bézier-Wellenform statt Sinus und
kachelgekoppelte Strichbreite (widthScreen-Modus). Probe
scripts/probe-engine-parity.mjs vergleicht ?gl=0 gegen ?engine=wasm;
Rest-Diff nur AA/Glyphen-Rasterung. cargo 17/17, vitest 94/94, Builds grün.
2026-07-03 08:17:01 +02:00

198 lines
7.6 KiB
Rust

// Browser-Bindings (wasm32 + WebGPU): fuehrt die native GPU-Schicht (`gpu::Renderer`)
// als WASM-Modul in die App-UI, mit einer HTML-Canvas als wgpu-Surface. Bewusst
// duenn — die gesamte Zeichenlogik (Tessellierung, Pipelines, Text) ist mit dem
// nativen Fenster geteilt; hier liegt nur die Canvas-/WebGPU-Anbindung + die
// wasm-bindgen-Fassade.
//
// Ablauf im Frontend (siehe src/plan/useWasmPlanRenderer.ts):
// const r = await WebPlanRenderer.new(canvas, undefined);
// r.set_scene(JSON.stringify(planToRenderScene(plan)));
// r.set_view_box(x, y, w, h); r.resize(px_w, px_h); r.render();
//
// Szenenformat = dieselbe serde-Struct wie der native Push (render2d::types::Scene),
// als JSON-String hereingereicht. Pan/Zoom aendern nur die ViewBox (kein Re-Tess).
use wasm_bindgen::prelude::*;
use web_sys::HtmlCanvasElement;
use crate::gpu::Renderer;
use crate::types::{Scene, ViewBox};
/// Eingebettete Plan-Schrift (Inter). cosmic-text findet auf wasm KEINE
/// Systemfonts — ohne eingebettete Bytes bliebe der Grundriss textlos. Die
/// Familie meldet sich als "Inter Variable"; `Renderer::load_font` uebernimmt
/// den tatsaechlichen Namen automatisch.
const INTER_TTF: &[u8] = include_bytes!("../assets/Inter.ttf");
/// Der Browser-Renderer: haelt Surface + Device/Queue + den geteilten `Renderer`
/// und die aktuelle ViewBox. Wird per `WebPlanRenderer.new(canvas)` aus JS erzeugt.
#[wasm_bindgen]
pub struct WebPlanRenderer {
surface: wgpu::Surface<'static>,
device: wgpu::Device,
queue: wgpu::Queue,
config: wgpu::SurfaceConfiguration,
renderer: Renderer,
view_box: ViewBox,
}
#[wasm_bindgen]
impl WebPlanRenderer {
/// Erzeugt den Renderer asynchron (Adapter/Device via WebGPU). `font_bytes`
/// optional — ohne Angabe wird die eingebettete Inter-Schrift genutzt.
/// Aus JS: `await WebPlanRenderer.new(canvasEl, undefined)`.
#[allow(clippy::new_ret_no_self)]
pub async fn new(
canvas: HtmlCanvasElement,
font_bytes: Option<Vec<u8>>,
) -> Result<WebPlanRenderer, JsValue> {
// Panics als lesbare Konsolen-Fehler statt "unreachable" ausgeben.
console_error_panic_hook::set_once();
let width = canvas.width().max(1);
let height = canvas.height().max(1);
let instance = wgpu::Instance::new(wgpu::InstanceDescriptor {
backends: wgpu::Backends::BROWSER_WEBGPU,
..Default::default()
});
let surface = instance
.create_surface(wgpu::SurfaceTarget::Canvas(canvas))
.map_err(|e| JsValue::from_str(&format!("create_surface: {e:?}")))?;
let adapter = instance
.request_adapter(&wgpu::RequestAdapterOptions {
power_preference: wgpu::PowerPreference::HighPerformance,
force_fallback_adapter: false,
compatible_surface: Some(&surface),
})
.await
.ok_or_else(|| JsValue::from_str("kein WebGPU-Adapter (navigator.gpu?)"))?;
let (device, queue) = adapter
.request_device(
&wgpu::DeviceDescriptor {
label: Some("render2d.web.device"),
required_features: wgpu::Features::empty(),
required_limits: wgpu::Limits::downlevel_webgl2_defaults()
.using_resolution(adapter.limits()),
memory_hints: wgpu::MemoryHints::Performance,
},
None,
)
.await
.map_err(|e| JsValue::from_str(&format!("request_device: {e:?}")))?;
// WebGPU-Canvas liefert i.d.R. bgra8unorm (kein sRGB-Format fuer die
// Surface). Wir nehmen das erste angebotene Format — MSAA-Textur nutzt
// dasselbe (siehe Renderer::ensure_msaa).
let caps = surface.get_capabilities(&adapter);
let format = caps
.formats
.iter()
.copied()
.find(|f| !f.is_srgb())
.unwrap_or(caps.formats[0]);
let config = wgpu::SurfaceConfiguration {
usage: wgpu::TextureUsages::RENDER_ATTACHMENT,
format,
width,
height,
present_mode: wgpu::PresentMode::Fifo,
alpha_mode: caps.alpha_modes[0],
view_formats: vec![],
desired_maximum_frame_latency: 2,
};
surface.configure(&device, &config);
let mut renderer = Renderer::new(&device, format);
// Font einspielen: uebergebene Bytes ODER die eingebettete Inter-Schrift.
renderer.load_font(font_bytes.unwrap_or_else(|| INTER_TTF.to_vec()));
web_sys::console::log_1(&JsValue::from_str(&format!(
"render2d WebGPU-Viewport initialisiert ({}x{}, {:?})",
width, height, format
)));
Ok(WebPlanRenderer {
surface,
device,
queue,
config,
renderer,
// Platzhalter bis set_view_box; verhindert Division durch 0.
view_box: ViewBox::new(0.0, 0.0, width as f32, height as f32),
})
}
/// Setzt die zu zeichnende Szene aus einem JSON-String (Format =
/// render2d::types::Scene, identisch zum nativen Push). Re-tesselliert + laedt
/// die GPU-Puffer; ruft NICHT selbst `render` — das macht der Aufrufer.
pub fn set_scene(&mut self, json: &str) -> Result<(), JsValue> {
let scene: Scene = serde_json::from_str(json)
.map_err(|e| JsValue::from_str(&format!("Szene parsen: {e}")))?;
self.renderer.upload_scene(&self.device, &scene);
Ok(())
}
/// Aktuellen Ausschnitt (viewBox-Einheiten, Bildschirm-Raum) setzen. Aendert
/// nur die Ortho-Matrix im naechsten `render` (kein Re-Tessellieren).
pub fn set_view_box(&mut self, x: f32, y: f32, w: f32, h: f32) {
self.view_box = ViewBox::new(x, y, w, h);
}
/// Papier-Massstab-Nenner (1:N) fuer echte mm-Strichbreiten setzen.
pub fn set_paper_scale(&mut self, n: f32) {
if n > 0.0 {
self.renderer.paper_scale_n = n;
}
}
/// Papier-Massstab-Nenner (1:N) NUR fuer die Text-Schriftgroesse setzen —
/// entkoppelt von `set_paper_scale` (siehe `Renderer::text_scale_n`-Doku).
pub fn set_text_scale(&mut self, n: f32) {
if n > 0.0 {
self.renderer.text_scale_n = n;
}
}
/// Surface an eine neue Pixelgroesse anpassen (DPR beachtet der Aufrufer).
pub fn resize(&mut self, width: u32, height: u32) {
let (w, h) = (width.max(1), height.max(1));
if self.config.width == w && self.config.height == h {
return;
}
self.config.width = w;
self.config.height = h;
self.surface.configure(&self.device, &self.config);
}
/// Zeichnet EINEN Frame in die Surface-Textur.
pub fn render(&mut self) {
let frame = match self.surface.get_current_texture() {
Ok(f) => f,
Err(wgpu::SurfaceError::Lost | wgpu::SurfaceError::Outdated) => {
self.surface.configure(&self.device, &self.config);
return;
}
Err(e) => {
web_sys::console::warn_1(&JsValue::from_str(&format!(
"render2d Surface-Fehler: {e:?}"
)));
return;
}
};
let view = frame
.texture
.create_view(&wgpu::TextureViewDescriptor::default());
self.renderer.render(
&self.device,
&self.queue,
&view,
self.view_box,
(self.config.width, self.config.height),
);
frame.present();
}
}