ifcviewer-web: wire WebViewportHost + ViewportCore (#87)

Replaces the standalone wgpu-only clear-color spike in main_web.cpp with a real WebViewportHost implementation: surface creation via the emdawnwebgpu canvas-selector source, framebufferSize through emscripten_get_element_css_size + dpr, requestFrame as a deferred flag the RAF main_loop consumes, quit through emscripten_force_exit. main_web.cpp now does the same lifecycle the desktop initWgpu shell does: core_.initWgpu(web_limits=true) → buildPipelines → buildHiz/ Edge/Pick. The render loop runs core_.render() once per RAF tick when the host has flagged a frame pending, with a surface reconfigure on size changes. Builds clean under emcc 6.0 + emdawnwebgpu (1.4 MB wasm, 278 KB JS glue). Renders an empty scene with the configured background — the plumbing is end-to-end through the same ViewportCore code path the desktop build uses. No sidecar load yet: that lands with the emscripten_fetch streaming backend (#88).
2026-09-12 06:32:09 +00:00 · 2026-06-06 21:09:35 +10:00
parent 50014f4842
commit 1fc15e78f2
4 changed files with 213 additions and 157 deletions
@@ -0,0 +1,62 @@
+/********************************************************************************
+ *                                                                              *
+ * This file is part of IfcOpenShell.                                           *
+ *                                                                              *
+ * IfcOpenShell is free software: you can redistribute it and/or modify         *
+ * it under the terms of the Lesser GNU General Public License as published by  *
+ * the Free Software Foundation, either version 3.0 of the License, or          *
+ * (at your option) any later version.                                          *
+ *                                                                              *
+ * IfcOpenShell is distributed in the hope that it will be useful,              *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of               *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the                 *
+ * Lesser GNU General Public License for more details.                          *
+ *                                                                              *
+ * You should have received a copy of the Lesser GNU General Public License     *
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.         *
+ *                                                                              *
+ ********************************************************************************/
+
+#ifndef WEBVIEWPORTHOST_H
+#define WEBVIEWPORTHOST_H
+
+// Web implementation of ViewportHost. ViewportCore owns the wgpu state
+// + render path; this class adapts the embedder hooks to a browser
+// canvas (surface creation via emdawnwebgpu's canvas-selector extension,
+// framebuffer size from the canvas element, requestFrame via
+// requestAnimationFrame, quit via emscripten_force_exit). All
+// notifications fall through to the base class no-ops for now —
+// future iterations route them to DOM events / a status bar.
+
+#include "ViewportHost.h"
+
+#include <string>
+
+class WebViewportHost final : public ViewportHost {
+public:
+    // `canvas_selector` is the CSS selector for the host <canvas> (e.g.
+    // "#viewer-canvas" — matches shell.html). The string is stored;
+    // it must outlive the host.
+    explicit WebViewportHost(std::string canvas_selector);
+
+    WGPUSurface createSurface(WGPUInstance instance) override;
+    void  framebufferSize(int& width_px, int& height_px) const override;
+    float dpr() const override;
+    // Sets request_frame_pending_ so the RAF callback knows to render
+    // on the next browser tick. The actual frame scheduling is done by
+    // the main_web.cpp loop; this avoids spamming RAF callbacks when
+    // multiple sources request a frame in the same tick.
+    void  requestFrame() override;
+    void  quit() override;
+
+    // True when ViewportCore has asked for a frame since the last one
+    // was rendered. The main loop clears this before invoking
+    // core.render().
+    bool consumeFrameRequest();
+
+private:
+    std::string canvas_selector_;
+    bool        request_frame_pending_ = true;  // arm an initial frame
+};
+
+#endif  // WEBVIEWPORTHOST_H