npm - @woosh/meep-engine - Versions diffs - 3.14.3 → 3.14.4 - Mend

@woosh/meep-engine 3.14.3 → 3.14.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (75) hide show

package/src/shade/playground/skinned_mesh_soup/index.html ADDED Viewed

@@ -0,0 +1,199 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>meep — skinned mesh soup</title>
+    <style>
+        :root {
+            color-scheme: dark;
+            --panel: rgba(20, 22, 26, 0.88);
+            --line: #2b3038;
+            --text: #d6dae0;
+            --muted: #8b939f;
+            --pass: #55c46a;
+            --fail: #ff6b6b;
+            --warn: #e5b54a;
+        }
+        * { box-sizing: border-box; }
+        html, body { margin: 0; height: 100%; overflow: hidden; background: #0d0f12; }
+        /* body carries tabindex so the camera controller's keyboard device has something focusable
+           to listen on; the focus ring around the whole viewport is not wanted */
+        body:focus { outline: none; }
+        #view { display: block; width: 100vw; height: 100vh; }
+        #panel {
+            position: fixed;
+            top: 12px;
+            left: 12px;
+            width: 340px;
+            padding: 12px 14px;
+            background: var(--panel);
+            border: 1px solid var(--line);
+            border-radius: 8px;
+            backdrop-filter: blur(6px);
+            color: var(--text);
+            font: 13px/1.5 system-ui, -apple-system, Segoe UI, sans-serif;
+        }
+        #panel h1 { font-size: 13px; font-weight: 600; margin: 0 0 8px; }
+        label { display: flex; align-items: center; gap: 8px; padding: 3px 0; cursor: pointer; }
+        label input { margin: 0; }
+        label .hint { color: var(--muted); font-size: 11.5px; }
+        hr { border: 0; border-top: 1px solid var(--line); margin: 10px 0; }
+        button, select, input[type=number] {
+            font: inherit;
+            padding: 5px 9px;
+            border-radius: 6px;
+            border: 1px solid var(--line);
+            background: #1c1f25;
+            color: var(--text);
+        }
+        button { cursor: pointer; }
+        button:hover:not(:disabled) { border-color: #3d4552; }
+        button:disabled { opacity: 0.45; cursor: default; }
+        select { width: 100%; cursor: pointer; }
+        .row { display: flex; gap: 6px; align-items: center; margin-top: 6px; }
+        .row button { flex: 0 0 auto; }
+        #character_count {
+            flex: 1 1 auto;
+            min-width: 0;
+            font: 12px ui-monospace, SFMono-Regular, Consolas, monospace;
+            background: #14161a;
+        }
+        #status { font-size: 12px; color: var(--muted); word-break: break-word; }
+        #status.pass { color: var(--pass); }
+        #status.fail { color: var(--fail); }
+        #status.warn { color: var(--warn); }
+        #stats {
+            margin-top: 6px;
+            font: 12px ui-monospace, SFMono-Regular, Consolas, monospace;
+            color: var(--text);
+        }
+        p.note { margin: 8px 0 0; font-size: 11.5px; color: var(--muted); }
+        code { font: 11.5px ui-monospace, SFMono-Regular, Consolas, monospace; color: var(--text); }
+        dl { margin: 6px 0 0; font-size: 11.5px; color: var(--muted); }
+        dt { color: var(--text); font-weight: 600; margin-top: 6px; }
+        dd { margin: 0; }
+    </style>
+</head>
+<body tabindex="0">
+<canvas id="view"></canvas>
+<div id="panel">
+    <h1>Skinned mesh soup</h1>
+    <p class="note">
+        The same character <code>skinned_blas_refit</code> draws, loaded through
+        <code>GLTFSceneBundleAssetLoader</code> — one bundle, one instance per placement — with the
+        pieces that could be making soup on switches.
+    </p>
+    <p class="note">
+        <strong>The answer, for the record.</strong> <code>chunk_skin_blend_mesh_local</code> needs
+        <code>inverse(mesh.global) × joint.global × inverse_bind</code> to be rigid; for this file
+        it carries a uniform <strong>100×</strong>, and a dual quaternion cannot carry a scale. So
+        <code>bind</code> below is the right character at 1/100 size — one shared matrix, one shared
+        error — and <code>animated</code> is soup, sixty-five matrices each losing a different
+        amount. The README has the measurement.
+    </p>
+    <hr>
+    <label for="skin_mode"><span>How the skin is driven</span></label>
+    <select id="skin_mode">
+        <option value="off">off — no skin registered, nothing deforms the clone</option>
+        <option value="bind">bind — skin registered, no clip</option>
+        <option value="animated">animated — the file's dance, playing</option>
+    </select>
+    <dl>
+        <dt>off</dt>
+        <dd>
+            What is drawn is the clone's memcpy of the source: the rest pose under the mesh node's
+            own transform. Michelle's carries the file's centimetre scale and its up-axis rotation,
+            so <em>correct</em> here is a 1.7 cm figure on her side. Soup here is the geometry
+            upload, not skinning.
+        </dd>
+        <dt>bind</dt>
+        <dd>
+            The skinning pass runs every frame over a pose that never moves — and that pose has an
+            answer the CPU knows exactly. <code>await diagnose()</code> reads the clone's vertices
+            back and says which are wrong, and whether the wrong ones are a vertex-slot range (the
+            workgroup stride loop) or whole meshlets (addressing).
+        </dd>
+        <dt>animated</dt>
+        <dd>
+            Soup only in this mode is the pose: the joint matrices, their range, or the order the
+            skin's joints resolved in.
+        </dd>
+    </dl>
+    <hr>
+    <label>
+        <input type="checkbox" id="path_tracing">
+        <span>Path tracer <span class="hint">— traverses the BLAS</span></span>
+    </label>
+    <p class="note">
+        Off by default. The rasterizer reads the deformed vertices directly, with no tree in the
+        way, so it is the reading to establish the answer on first: soup in <em>both</em> is the
+        vertices, soup in the tracer alone is the tree.
+    </p>
+    <div class="row">
+        <button id="animation">Freeze pose</button>
+    </div>
+    <hr>
+    <div class="row">
+        <input type="number" id="character_count" value="1" min="1" max="64" step="1">
+        <button id="respawn">Characters</button>
+    </div>
+    <p class="note">
+        One parse whatever the count — the asset hands out the model itself, and each placement gets
+        its own node tree, skins and clips from <code>instantiate_scene_bundle</code>.
+    </p>
+    <hr>
+    <div id="status"></div>
+    <div id="stats"></div>
+    <p class="note">
+        Every switch is in the url — <code>?count=1&amp;skin=bind&amp;trace=1</code> — so a state
+        worth showing someone can be sent as a link.
+    </p>
+</div>
+<script type="module">
+    import { start } from './main.js';
+    start().catch(error => {
+        const status = document.getElementById('status');
+        status.className = 'fail';
+        status.textContent = String(error?.message ?? error);
+        console.error(error);
+    });
+</script>
+</body>
+</html>

package/src/shade/playground/skinned_mesh_soup/main.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+/**
+ * Stand the page up.
+ *
+ * @returns {Promise<void>}
+ */
+export function start(): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/src/shade/playground/skinned_mesh_soup/main.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/skinned_mesh_soup/main.js"],"names":[],"mappings":"AA8PA;;;;GAIG;AACH,yBAFa,QAAQ,IAAI,CAAC,CAkTzB"}