← Commit history

Publish 1.0.12

John Lauer ·9a1534e09b · ·parent 876dc76
5 files changed +167−23
README.md+27
@@ -58,6 +58,33 @@ state is rolled at every epoch. | intro | 1 | 0 skips the teal logo intro | | interact | 0 | 1 arms click-to-zoom (previews and demos, never load screens) | +## Why raw WebGL, and not Babylon or three.js++A load screen exists to be on screen while your real app is still fetching; an+animation that first downloads a 3D engine defeats its own purpose. The main+viewer on this page IS Babylon.js 9.18, where an engine earns its weight; the+loader is that lab distilled to one dependency-free file.++| approach | payload gzipped | requests | first frame |+|---|---|---|---|+| Babylon.js + app | ~1.4 MB engine + page | CDN + page | after download and parse |+| three.js + app | ~170 KB engine + page | CDN + page | after download and parse |+| loader.html | 9,912 bytes, everything included | zero | tens of milliseconds |++Measured on this build: 24,379 bytes on disk, 9,912 gzipped, including shaders,+the 286-point logomark vectors, the 128-sample edge profile, and the timeline.+Runtime: 0.057 ms of JS per frame (about 1.4% of a 240 Hz budget), one draw call+over 12,800 triangles / 6,561 vertices, all displacement in the vertex shader,+and requestAnimationFrame pauses it when hidden so a backgrounded webview costs+nothing.++Fidelity: tools/build-loader.py extracts the GLSL verbatim from the Babylon lab+at build time (one source of truth), reproduces Babylon's left-handed matrices+exactly, chirality pixel-verified. Camera feel is the lab's, constant for+constant: 1.2% per notch, inertia 0.9, the 6% radius and 5% centering springs at+240 fps cadence made frame-rate independent, zoom toward the cursor, glide home+before every logo.+ ## The three tuned cuts  The settings the loop was tuned to, saved live while dialing it in. All three ship in
SKILL.md+75−14
@@ -1,21 +1,82 @@ --- name: orbital-lab description: >--  The physics behind the Adom logomark: it is a hydrogen 2p orbital,-  psi = (2p_x + 2p_y)/sqrt(2), and the wiki page adom/orbital-lab holds the live-  proof plus loader.html, the animation as a single dependency-free file for-  webview load screens. Use when someone asks why the Adom logo is an orbital,-  wants the orbital demo shown, or needs the Adom loading animation for a webview.+  The physics behind the Adom logomark (it is a hydrogen 2p orbital,+  psi = (2p_x + 2p_y)/sqrt(2)) and, for developers, the Adom loading animation:+  loader.html, a single dependency-free raw-WebGL file (24,379 bytes, 9,912+  gzipped, zero requests, 0.057 ms JS per frame, one draw call) that plays the+  brand animation as a webview load screen. Use when someone asks why the Adom+  logo is an orbital, wants the orbital demo shown, needs the Adom loading+  animation or load screen for a webview, or asks how big or heavy the loader+  is and what it depends on. ---  # Orbital Lab -- Show the live lab: open https://wiki.adom.inc/adom/orbital-lab in a webview-  or pup window. The Overview IS the app; the Final tab is the finished animation.-- The loader: `loader.html` on that page is a single-file raw-WebGL version of the-  animation for load screens. Embed it as an iframe and remove it when the real-  content is ready. Knobs are URL params (pt, dt, ct, st, logo, llead, tlead, ov,-  intro); defaults are the tuned numbers. Docs with a live preview are at the-  bottom of the page Overview.-- The claim, one line: a 2p orbital along the [110] diagonal is an equal mix of-  2p_x and 2p_y, and cut to the mark's quadrants it matches the logo at 99.3% IoU.+The Adom logomark is a hydrogen 2p orbital: psi = (2p_x + 2p_y)/sqrt(2). A 2p+orbital along the [110] diagonal is an equal superposition of 2p_x and 2p_y, and+cut to the mark's quadrants it matches the logo at 99.3% IoU. The wiki page+https://wiki.adom.inc/adom/orbital-lab holds the live proof (the Overview IS the+app; the Final tab is the finished animation).++## Embed the loader (what most people come for)++`loader.html` on that page is the animation as ONE file for webview load+screens. Grab it from the page's Files tab (or `/blob/app/orbital-lab/loader.html`)+and serve it beside your app:++    <iframe src="loader.html"+            style="position:absolute;inset:0;width:100%;height:100%;border:0;background:#0d1117">+    </iframe>+    <!-- when your app is ready, fade the iframe out and remove it -->++URL params (defaults are the tuned john 1 cut): pt (4.5) free-play seconds+between epochs; dt (3) the dive onto the mark; ct (0.3) how late the outline+cheat fades in; st (0) dead-still hold; logo (100) flat-mark peak opacity in+percent; llead (1) logo fade lead seconds; tlead (1.5) teal-unification lead;+ov (1) 0 makes the cheat its own act; intro (1) 0 skips the teal intro;+interact (0) 1 arms click-to-zoom, for previews and demos only, never for real+load screens, which must stay input-transparent.++## The numbers (why it is safe in a load path)++Measured, not estimated, on the shipped build:++- One file: 24,379 bytes on disk, 9,912 bytes gzipped, and that INCLUDES the+  shaders, the 286-point logomark vectors, the 128-sample measured edge+  profile, and the whole timeline.+- Zero external requests: no CDN, no fonts, no fetch. The file is its entire+  dependency closure. First frame in tens of milliseconds.+- 0.057 ms of JavaScript per frame (16 coefficient cosines plus uniform+  uploads, about 1.4% of a 240 Hz frame budget), then one draw call over+  12,800 triangles / 6,561 vertices, all displacement in the vertex shader.+- requestAnimationFrame pauses it completely when the tab is hidden: a+  backgrounded webview costs nothing.++## Why raw WebGL and not Babylon or three.js++A load screen plays while the real app is still fetching. Babylon.js is+roughly 1.4 MB gzipped and three.js roughly 170 KB gzipped, both needing+download plus parse before the first frame; a loading animation that first+loads its own engine defeats its purpose. The MAIN viewer on the wiki page is+Babylon.js 9.18, where the engine earns its weight (ArcRotate camera, GPU+readbacks for the fit measurement); the loader is that lab distilled.++## Fidelity guarantees++- `tools/build-loader.py` extracts the GLSL VERBATIM from the Babylon lab at+  build time: one source of truth, pixel-identical rendering.+- Babylon's left-handed view and projection matrices are reproduced exactly;+  chirality is pixel-verified (teal lobe upper-right, navy lower-left).+- Camera feel matches the lab constant for constant: 1.2% per wheel notch,+  inertia 0.9, the 6% radius spring and 5% centering pull at 240 fps cadence+  made frame-rate independent, zoom toward the cursor, and a glide home before+  every logo so the mark never shows distorted.++## Rebuilding++    python3 tools/build-loader.py   # loader.html from orbital-lab.html+    python3 tools/build-readme.py   # readme.html for the wiki page++The wiki page renders readme.html (README.md is for cloners); page-visible+edits go there.
package.json+29−7
@@ -2,9 +2,16 @@   "slug": "orbital-lab",   "title": "Orbital Lab",   "type": "app",-  "version": "1.0.11",+  "version": "1.0.12",   "description": "The Adom logomark is a hydrogen 2p orbital: psi = (2p_x + 2p_y)/sqrt(2). A live Babylon.js lab that proves it (all 16 real spherical harmonics, the alignment cheat, and the directed loop), plus loader.html: the same animation as one dependency-free WebGL file for webview load screens.",-  "tags": ["brand", "physics", "babylon", "webgl", "animation", "loader"],+  "tags": [+    "brand",+    "physics",+    "babylon",+    "webgl",+    "animation",+    "loader"+  ],   "dependencies": {},   "discovery_triggers": [     "why is the adom logo an orbital",@@ -13,14 +20,29 @@     "show the orbital lab",     "webview load animation",     "adom loader animation",-    "hydrogen orbital demo"+    "hydrogen orbital demo",+    "adom load screen",+    "embed the adom loader",+    "how big is the adom loader",+    "adom loading animation"   ],   "discovery_pitch": "Open when someone asks about the physics behind the Adom logomark, wants the live orbital demo, or needs the standalone loader animation for a webview load screen.",   "sample_prompts": [-    { "label": "The lore", "prompt": "why is the adom logo a hydrogen orbital?" },-    { "label": "The loader", "prompt": "give my webview the adom loading animation" }+    {+      "label": "The lore",+      "prompt": "why is the adom logo a hydrogen orbital?"+    },+    {+      "label": "The loader",+      "prompt": "give my webview the adom loading animation"+    }   ],   "metadata": {},-  "scripts": { "install": "./install.sh", "uninstall": "./uninstall.sh" },-  "hero": { "path": "docs/hero.png" }+  "scripts": {+    "install": "./install.sh",+    "uninstall": "./uninstall.sh"+  },+  "hero": {+    "path": "docs/hero.png"+  } }
page.json+6−2
@@ -2,7 +2,7 @@   "slug": "orbital-lab",   "title": "Orbital Lab",   "type": "app",-  "version": "1.0.11",+  "version": "1.0.12",   "description": "The Adom logomark is a hydrogen 2p orbital: psi = (2p_x + 2p_y)/sqrt(2). A live Babylon.js lab that proves it (all 16 real spherical harmonics, the alignment cheat, and the directed loop), plus loader.html: the same animation as one dependency-free WebGL file for webview load screens.",   "tags": [     "brand",@@ -20,7 +20,11 @@     "show the orbital lab",     "webview load animation",     "adom loader animation",-    "hydrogen orbital demo"+    "hydrogen orbital demo",+    "adom load screen",+    "embed the adom loader",+    "how big is the adom loader",+    "adom loading animation"   ],   "discovery_pitch": "Open when someone asks about the physics behind the Adom logomark, wants the live orbital demo, or needs the standalone loader animation for a webview load screen.",   "sample_prompts": [
readme.html+30
@@ -2616,6 +2616,36 @@ window.__lab = { push, zeros, HARMONICS, setAnim:v=>{animate=v;} };      1.2% per notch, inertia, zoom toward the cursor, and the same spring that always breathes      the framing back home. Defaults are the tuned numbers; every knob is a URL parameter, and a      fresh random state is rolled at every epoch so it never repeats.</p>+  <h3>Why raw WebGL, and not Babylon or three.js</h3>+  <p>A load screen exists to be on screen while your real app is still fetching. An animation+     that first downloads and parses a 3D engine defeats its own purpose, so the loader ships+     as ONE hand-rolled WebGL file and nothing else. The main viewer at the top of this page IS+     Babylon.js 9.18, where a full engine earns its weight (ArcRotate camera, GPU pixel+     readbacks for the fit measurement, tooling); the loader is that lab distilled.</p>+  <table>+    <tr><th>approach</th><th>payload, gzipped</th><th>requests</th><th>first frame</th></tr>+    <tr><td>Babylon.js + app</td><td>~1.4 MB engine + your page</td><td>CDN + page</td><td>after download and parse</td></tr>+    <tr><td>three.js + app</td><td>~170 KB engine + your page</td><td>CDN + page</td><td>after download and parse</td></tr>+    <tr><td><b>loader.html</b></td><td><b>9,912 bytes, everything included</b></td><td><b>zero</b></td><td><b>tens of milliseconds</b></td></tr>+  </table>+  <h3>The measured numbers</h3>+  <p>Measured on this build, not estimated: <b>24,379 bytes</b> on disk and <b>9,912 bytes+     gzipped</b>, including the shaders, the 286-point logomark vectors, the 128-sample+     measured edge profile, and the whole timeline. Runtime: <b>0.057 ms of JavaScript per+     frame</b> (16 coefficient cosines and uniform uploads, about 1.4% of a 240 Hz frame+     budget), then <b>one draw call</b> over <b>12,800 triangles / 6,561 vertices</b> with all+     displacement in the vertex shader. requestAnimationFrame pauses it completely when the+     tab is hidden, so a backgrounded webview costs nothing.</p>+  <h3>Fidelity guarantees</h3>+  <p>The loader is not a re-implementation of the look. <code>tools/build-loader.py</code>+     extracts the GLSL <b>verbatim</b> from the Babylon lab at build time (one source of+     truth), reproduces Babylon's left-handed view and projection matrices exactly, and the+     chirality is pixel-verified against the lab: teal lobe upper-right, navy lower-left.+     Same equation, same cheat, same profile data, pixel-identical rendering. The camera feel+     is the lab's, constant for constant: <b>1.2% per wheel notch</b>, inertia 0.9, the 6%+     radius spring and 5% centering pull at the lab's 240 fps cadence made frame-rate+     independent, zoom toward the cursor, and a glide home before every logo so the mark+     always lands undistorted.</p>   <h3>Embed</h3>   <pre>&lt;iframe src="loader.html"         style="position:absolute;inset:0;width:100%;height:100%;border:0;background:#0d1117"&gt;