3D engine that AI agents drive
Show a showcase scene in the hero instead of the WALL·E preview
Nguyen Xuan Ana3268d3cf82c
diff --git a/index.html b/index.htmlindex 2aeb50d7..105ddf5c 100644--- a/index.html+++ b/index.html@@ -10,8 +10,8 @@<meta property="og:title" content="67js · a 3D engine agents can drive" /><meta property="og:description" content="WebGL2 rendering, deterministic animation and an MCP server in one npm package." /><meta property="og:url" content="https://67js.codepawl.com/" />- <meta property="og:image" content="https://67js.codepawl.com/previews/wall-e.png" />- <meta property="og:image:alt" content="WALL·E rendered by 67js" />+ <meta property="og:image" content="https://67js.codepawl.com/previews/showcase-airport.webp" />+ <meta property="og:image:alt" content="An airport ramp rendered by 67js" /><meta name="twitter:card" content="summary_large_image" /><link rel="canonical" href="https://67js.codepawl.com/" /><title>67js · a 3D engine agents can drive</title>@@ -52,14 +52,10 @@</div></header>- <section class="feature-showcase live-showcase" aria-label="Interactive 3D preview">- <canvas id="home-preview" tabindex="0" aria-label="WALL·E 3D model. Drag or use arrow keys to rotate. Use plus and minus to zoom. Press Space to pause or resume animation."></canvas>- <p id="home-preview-status" role="status">Loading 3D preview…</p>- <div class="preview-assembly">- <div class="preview-assembly-label"><label for="preview-assembly">Take it apart</label><output id="preview-assembly-value" for="preview-assembly">Assembled</output></div>- <input id="preview-assembly" type="range" min="0" max="100" step="1" value="0" aria-valuetext="Assembled" />- </div>- </section>+ <a class="hero-shot" href="./showcase.html?scene=airport" aria-label="Open the airport ramp as a live 3D scene">+ <img src="./previews/showcase-airport.webp" alt="An airport ramp with a 787 at its stand and the turnaround crew, rendered by 67js" width="1280" height="720" fetchpriority="high" />+ <span class="hero-shot-label">Open the live scene</span>+ </a></section><section id="code" class="code-section" aria-labelledby="code-title">@@ -67,22 +63,22 @@<h2 id="code-title">A scene in a few lines</h2><div class="code-block"><pre><code id="home-code">import { Renderer67 } from '67js';-import { createModel } from '67js/addons/model';+import { loadGltf } from '67js/addons/gltf';+import { loadHdri } from '67js/addons/hdri';-const renderer = new Renderer67(canvas, createModel(), {- samples: 4,- memoryBudgetMiB: 256,+const { parts } = await loadGltf('/airport.glb');+const map = await loadHdri('/sky.hdr');+const renderer = new Renderer67(canvas, parts, {+ hdr: true,+ ground: false,+ environment: { map },});-renderer.render({- eye: [4, 3, 7],- target: [0, 1.5, 0],- assemblyAmount: 0.5,-});</code></pre>+renderer.render({ eye: [58, 31, 84], target: [-8, 3, -18] });</code></pre><button data-copy-code="home-code" aria-label="Copy the code example">Copy</button></div></div>- <img class="code-result" src="./previews/wall-e-exploded.webp" alt="WALL·E pulled apart into its 574 parts, rendered by the code on the left" width="1280" height="720" loading="lazy" />+ <img class="code-result" src="./previews/showcase-datacenter.webp" alt="A cutaway AI data center hall rendered by 67js from a GLB and an HDRI" width="1280" height="720" loading="lazy" /></section><section id="examples" class="examples" aria-labelledby="examples-title">diff --git a/public/showcase/port/scene.json b/public/showcase/port/scene.jsonindex dd804c89..0359eac6 100644--- a/public/showcase/port/scene.json+++ b/public/showcase/port/scene.json@@ -32,7 +32,7 @@"credits": [{ "model": "Gantry Crane (yard cranes, decimated and repainted)", "author": "alanUscanga", "licence": "CC BY 4.0", "source": "https://sketchfab.com/3d-models/76119b46c26f436ba78f4b53c98fc935" },{ "model": "[XYZ] KR Scania R_Draft (terminal tractors and wheels, repainted)", "author": "radzig541", "licence": "CC BY", "source": "https://sketchfab.com/3d-models/c46e8ee246aa4863a2cf602cddf1bfeb" },- { "model": "Ship, quay cranes, containers, quay, road and harbour craft", "author": "codepawl (built in Blender for this scene)", "licence": "CC0", "source": "https://67js.codepawl.com" },+ { "model": "Ship, quay cranes, containers, quay, road and harbour craft", "author": "CodePawl", "licence": "MIT", "source": "https://github.com/anxuanng/67.js" },{ "model": "concrete_floor_worn_001 (ground and quay textures)", "author": "Poly Haven", "licence": "CC0", "source": "https://polyhaven.com/a/concrete_floor_worn_001" },{ "model": "asphalt_02 (road texture)", "author": "Poly Haven", "licence": "CC0", "source": "https://polyhaven.com/a/asphalt_02" },{ "model": "rusty_painted_metal, rust_coarse_01, blue_metal_plate, metal_grate_rusty, rusty_metal_03, metal_plate_02, container_side (baked into container, hull and paint textures)", "author": "Poly Haven", "licence": "CC0", "source": "https://polyhaven.com/textures" },diff --git a/scripts/smoke-site.mjs b/scripts/smoke-site.mjsindex de1359f3..6d6c9548 100644--- a/scripts/smoke-site.mjs+++ b/scripts/smoke-site.mjs@@ -68,60 +68,15 @@ try {assert.equal(await page.locator('#downloads').count(), 1, 'Homepage install controls are missing');const scenePaths = await page.locator('.gallery .example').evaluateAll(links => links.map(link => { const url = new URL(link.href); return url.pathname + url.search; }));assert.equal(new Set(scenePaths).size, scenePaths.length, 'Showcase repeats the same scene');- await page.locator('#home-preview').scrollIntoViewIfNeeded();- await page.waitForFunction(() => window.__homePreview?.renderer && window.__homePreview.state.visible);- const initialDistance = await page.evaluate(() => window.__homePreview.state.distance);- await page.locator('#home-preview').focus();- await page.keyboard.press('+');- assert.ok(await page.evaluate(() => window.__homePreview.state.distance) < initialDistance);- await page.locator('#home-preview').focus();- await page.keyboard.press('ArrowRight');- assert.ok(await page.evaluate(() => window.__homePreview.state.yaw) > 0.6);- await page.keyboard.press('Home');- assert.equal(await page.evaluate(() => window.__homePreview.state.yaw), 0.6);- assert.equal(await page.locator('.preview-tools, .showcase-caption').count(), 0);- assert.equal(await page.evaluate(() => window.__homePreview.state.playing), false);- await page.emulateMedia({ reducedMotion:'no-preference' });- await page.waitForFunction(() => window.__homePreview.state.time > 0.1);- await page.locator('#preview-assembly').evaluate(slider => {- slider.value = '100';- slider.dispatchEvent(new Event('input', { bubbles:true }));- slider.dispatchEvent(new Event('change', { bubbles:true }));- });- assert.equal(await page.evaluate(() => window.__homePreview.state.assemblyTarget), 1);- assert.ok(await page.evaluate(() => window.__homePreview.state.assembly) < 1, 'Assembly jumped to the target');- assert.equal(await page.evaluate(() => window.__homePreview.state.playing), false);- const frozenTime = await page.evaluate(() => window.__homePreview.state.time);- await page.waitForTimeout(150);- assert.equal(await page.evaluate(() => window.__homePreview.state.time), frozenTime);- await page.waitForFunction(() => window.__homePreview.state.assembly === 1);- await page.locator('#home-preview').focus();- await page.keyboard.press('Space');- assert.equal(await page.evaluate(() => window.__homePreview.state.playing), false, 'Exploded model resumes from Space');- await page.locator('#preview-assembly').evaluate(slider => {- slider.value = '0';- slider.dispatchEvent(new Event('input', { bubbles:true }));- slider.dispatchEvent(new Event('change', { bubbles:true }));- });- assert.equal(await page.evaluate(() => window.__homePreview.state.playing), false, 'Drive resumed before reassembly completed');- await page.waitForFunction(() => window.__homePreview.state.playing);- assert.ok(await page.evaluate(() => window.__homePreview.state.speed) < 0.4, 'Drive restarts at full speed');- await page.waitForFunction(() => window.__homePreview.state.speed === 1);- await page.emulateMedia({ reducedMotion:'reduce' });- await page.waitForFunction(() => !window.__homePreview.state.playing);- assert.equal(await page.evaluate(() => window.__homePreview.state.playing), false);- const backgroundAlpha = await page.evaluate(() => {- window.__homePreview.draw();- const context = window.__homePreview.renderer.context;- const pixel = new Uint8Array(4);- context.readPixels(0, 0, 1, 1, context.RGBA, context.UNSIGNED_BYTE, pixel);- return pixel[3];- });- assert.equal(backgroundAlpha, 0, 'Preview background is opaque');- assert.equal(await page.evaluate(() => window.__homePreview.renderer.context.getError()), 0);- assert.ok(await page.evaluate(() => window.__homePreview.renderer.memoryPlan.estimatedBytes) <= 192 * 1048576);- await page.screenshot({ path:'artifacts/home-live-preview.png' });- report.interactions.push('Live WALL·E, keyboard orbit, transparent render and paused assembly with gradual drive restart');+ assert.equal(new URL(await page.locator('.hero-shot').evaluate(link => link.href)).search, '?scene=airport');+ const showcase = await browser.newPage({ viewport:{ width:1440,height:900 }, reducedMotion:'reduce' });+ showcase.on('pageerror', error => errors.push(error.message));+ await showcase.goto(origin + '/showcase.html?scene=datacenter');+ await showcase.waitForFunction(() => window.__showcase?.renderer, null, { timeout:60000 });+ assert.equal(await showcase.evaluate(() => window.__showcase.renderer.context.getError()), 0);+ assert.equal(await showcase.locator('#showcase-tabs button').count(), 3);+ await showcase.close();+ report.interactions.push('Hero links to the live airport scene, and the showcase opens the data center scene');}if (['/', '/downloads.html'].includes(route)) {if (route === '/downloads.html') assert.match(page.url(), /\/#downloads$/);diff --git a/src/home-preview.js b/src/home-preview.jsdeleted file mode 100644index c2e71c0b..00000000--- a/src/home-preview.js+++ /dev/null@@ -1,248 +0,0 @@-import { Renderer67 } from './renderer.js';-import { createWallEPreviewScene } from './wall-e-preview-scene.js';-import { approachValue } from './preview-transition.js';--const canvas = document.querySelector('#home-preview');-const status = document.querySelector('#home-preview-status');-const assemblySlider = document.querySelector('#preview-assembly');-const assemblyValue = document.querySelector('#preview-assembly-value');-const reducedMotion = matchMedia('(prefers-reduced-motion: reduce)');-const state = { yaw:0.6, pitch:0.28, distance:7.5, time:0, playing:!reducedMotion.matches, visible:false, assembly:0, assemblyTarget:0, speed:0, interacting:false, gaze:[0,0], gazeTarget:[0,0] };-const shadowEye = [-3,6,4];-const shadowTarget = [0,1,0];-const shadowBounds = { eye:[...shadowEye], target:[...shadowTarget], extent:6, near:0.1, far:20 };-let renderer;-let scene;-let scheduledFrame = 0;-let previousTime = 0;-let pointer;-let disposed = false;--function showError(error) {- state.playing = false;- status.hidden = false;- status.textContent = `3D preview unavailable: ${error.message}. Reload the page to retry.`;- cancelAnimationFrame(scheduledFrame);- scheduledFrame = 0;-}--function draw() {- if (!renderer || disposed || document.hidden || !state.visible) return;- try {- const frame = scene.sample(state.time, { gaze:state.gaze });- for (let axis = 0; axis < 3; axis++) {- shadowBounds.eye[axis] = shadowEye[axis] + frame.rootOffset[axis];- shadowBounds.target[axis] = shadowTarget[axis] + frame.rootOffset[axis];- }- renderer.updateParts(scene.parts);- const distance = state.distance * (canvas.clientWidth < 500 ? 1.05 : 1);- const targetHeight = frame.target[1];- renderer.render({- eye:[frame.target[0] + Math.sin(state.yaw) * Math.cos(state.pitch) * distance, targetHeight + Math.sin(state.pitch) * distance, frame.target[2] + Math.cos(state.yaw) * Math.cos(state.pitch) * distance],- target:[frame.target[0],targetHeight,frame.target[2]], fov:40, near:0.025, time:state.time, exposure:1, armorColor:[0.73,0.43,0.065], armorSurface:[0.62,0.43], assemblyAmount:state.assembly, effects:{ ...frame.effects, vignette:0, grain:0 },- });- } catch (error) {- showError(error);- }-}--function animate(timestamp) {- scheduledFrame = 0;- if ((!state.playing && state.assembly === state.assemblyTarget) || !state.visible || document.hidden || disposed) return;- const elapsedSeconds = previousTime ? Math.min(0.1, (timestamp - previousTime) / 1000) : 0;- const wasTransitioning = state.assembly !== state.assemblyTarget;- state.assembly = approachValue(state.assembly, state.assemblyTarget, elapsedSeconds);- if (wasTransitioning && state.assembly === 0 && state.assemblyTarget === 0 && !state.interacting && !reducedMotion.matches) {- state.playing = true;- state.speed = 0;- }- if (state.playing) {- state.speed = Math.min(1, state.speed + elapsedSeconds / 1.2);- state.time += elapsedSeconds * state.speed;- for (let axis = 0; axis < 2; axis++) state.gaze[axis] = approachValue(state.gaze[axis], state.gazeTarget[axis], elapsedSeconds, 0.22);- }- previousTime = timestamp;- draw();- if (state.playing || state.assembly !== state.assemblyTarget) scheduledFrame = requestAnimationFrame(animate);-}--function synchronizePlayback() {- cancelAnimationFrame(scheduledFrame);- scheduledFrame = 0;- previousTime = 0;- if ((state.playing || state.assembly !== state.assemblyTarget) && state.visible && !document.hidden && !disposed) {- scheduledFrame = requestAnimationFrame(animate);- }-}--function initialize() {- if (renderer || disposed) return;- try {- scene = createWallEPreviewScene();- renderer = new Renderer67(canvas, scene.parts, {- ground:false, transparent:true, hdr:true, samples:4, pixelRatio:1.25, memoryBudgetMiB:192, shadowBounds,- });- window.__homePreview = { renderer, scene, state, draw };- status.hidden = true;- draw();- } catch (error) {- showError(error);- }-}--function zoom(multiplier) {- state.distance = Math.max(1.2, Math.min(30, state.distance * multiplier));- draw();-}--function reset() {- Object.assign(state, { yaw:0.6, pitch:0.28, distance:7.5 });- draw();-}--function pauseForAssembly() {- const wasPlaying = state.playing;- state.playing = false;- state.speed = 0;- if (wasPlaying || !scheduledFrame) synchronizePlayback();-}--function finishAssemblyInteraction() {- state.interacting = false;- state.playing = state.assembly === 0 && state.assemblyTarget === 0 && !reducedMotion.matches;- synchronizePlayback();-}--assemblySlider.addEventListener('pointerdown', () => {- state.interacting = true;- pauseForAssembly();-});-assemblySlider.addEventListener('input', () => {- state.assemblyTarget = Number(assemblySlider.value) / 100;- if (reducedMotion.matches) state.assembly = state.assemblyTarget;- pauseForAssembly();- const description = state.assemblyTarget === 0 ? 'Assembled' : Math.round(state.assemblyTarget * 100) + '% exploded';- assemblyValue.textContent = description;- assemblySlider.setAttribute('aria-valuetext', description);- draw();-});-assemblySlider.addEventListener('change', () => {- if (!state.interacting) finishAssemblyInteraction();-});-window.addEventListener('pointerup', () => {- if (state.interacting) finishAssemblyInteraction();-});-window.addEventListener('pointercancel', () => {- if (state.interacting) finishAssemblyInteraction();-});-assemblySlider.addEventListener('blur', () => {- if (state.interacting) finishAssemblyInteraction();-});--canvas.addEventListener('pointerdown', event => {- if (event.button !== 0 || pointer) return;- pointer = { id:event.pointerId, x:event.clientX, y:event.clientY };- canvas.setPointerCapture(event.pointerId);-});-canvas.addEventListener('pointermove', event => {- if (!pointer) {- const bounds = canvas.getBoundingClientRect();- state.gazeTarget[0] = Math.max(-1, Math.min(1, (event.clientX - bounds.left) / bounds.width * 2 - 1));- state.gazeTarget[1] = Math.max(-1, Math.min(1, 1 - (event.clientY - bounds.top) / bounds.height * 2));- return;- }- if (pointer.id !== event.pointerId) return;- state.yaw -= (event.clientX - pointer.x) * 0.008;- if (event.pointerType !== 'touch') {- state.pitch = Math.max(-1.1, Math.min(1.1, state.pitch + (event.clientY - pointer.y) * 0.008));- }- pointer.x = event.clientX;- pointer.y = event.clientY;- draw();-});-canvas.addEventListener('pointerleave', () => { state.gazeTarget.fill(0); });-canvas.addEventListener('lostpointercapture', () => { pointer = undefined; });-canvas.addEventListener('pointercancel', () => { pointer = undefined; });-canvas.addEventListener('pointerup', event => {- if (canvas.hasPointerCapture(event.pointerId)) canvas.releasePointerCapture(event.pointerId);- pointer = undefined;-});-canvas.addEventListener('wheel', event => {- if (!renderer) return;- event.preventDefault();- zoom(Math.exp(Math.max(-100, Math.min(100, event.deltaY)) * 0.002));-}, { passive:false });-canvas.addEventListener('keydown', event => {- if (event.code === 'Space') {- event.preventDefault();- if (state.assembly === 0 && state.assemblyTarget === 0 && !state.interacting) {- state.playing = !state.playing;- state.speed = 0;- synchronizePlayback();- }- return;- }- if (!['ArrowLeft','ArrowRight','ArrowUp','ArrowDown','+','=','-','Home'].includes(event.key)) return;- event.preventDefault();- if (event.key === 'ArrowLeft') state.yaw -= 0.12;- if (event.key === 'ArrowRight') state.yaw += 0.12;- if (event.key === 'ArrowUp') state.pitch = Math.min(1.1, state.pitch + 0.12);- if (event.key === 'ArrowDown') state.pitch = Math.max(-1.1, state.pitch - 0.12);- if (['+','='].includes(event.key)) zoom(0.85);- if (event.key === '-') zoom(1.15);- if (event.key === 'Home') reset();- draw();-});-canvas.addEventListener('webglcontextlost', event => {- event.preventDefault();- showError(new Error('Graphics context was lost'));-});-canvas.addEventListener('webglcontextrestored', () => {- renderer?.dispose();- renderer = undefined;- if (state.visible) initialize();-});--const resizeObserver = new ResizeObserver(() => {- if (!renderer || disposed) return;- try {- renderer.resize();- draw();- } catch (error) {- showError(error);- }-});-resizeObserver.observe(canvas);-const visibilityObserver = new IntersectionObserver(entries => {- state.visible = entries[0].isIntersecting;- if (state.visible) {- initialize();- draw();- }- synchronizePlayback();-}, { threshold:0.05 });-visibilityObserver.observe(canvas);-document.addEventListener('visibilitychange', () => {- if (!document.hidden) draw();- synchronizePlayback();-});-reducedMotion.addEventListener('change', () => {- if (reducedMotion.matches) state.assembly = state.assemblyTarget;- state.playing = !reducedMotion.matches && state.assembly === 0 && state.assemblyTarget === 0 && !state.interacting;- state.speed = 0;- draw();- synchronizePlayback();-});-window.addEventListener('pagehide', event => {- cancelAnimationFrame(scheduledFrame);- scheduledFrame = 0;- if (event.persisted) return;- disposed = true;- resizeObserver.disconnect();- visibilityObserver.disconnect();- renderer?.dispose();-});-window.addEventListener('pageshow', () => {- draw();- synchronizePlayback();-});diff --git a/src/home.js b/src/home.jsindex 0498148c..01bc4c4b 100644--- a/src/home.js+++ b/src/home.js@@ -144,9 +144,3 @@ document.querySelectorAll('.example img').forEach(image => {window.__home = { state, loadRelease };loadRelease();window.addEventListener('pageshow', event => { if (event.persisted) loadRelease(); });--if (document.querySelector('#home-preview')) {- import('./home-preview.js').catch(() => {- document.querySelector('#home-preview-status').textContent = '3D preview could not load. Reload the page to retry.';- });-}diff --git a/src/showcase.js b/src/showcase.jsindex 99c6ddff..891d2a02 100644--- a/src/showcase.js+++ b/src/showcase.js@@ -96,7 +96,7 @@ async function selectScene(id) {blurb.textContent = description.blurb;showCredits(description.credits);const [asset, map] = await Promise.all([- loadGltf(description.glb),+ loadGltf(description.glb, description.gltfOptions ?? {}),loadHdri(description.hdri, description.hdriOptions ?? {}),]);if (request !== loadingRequest) return;diff --git a/src/site.css b/src/site.cssindex 79638f02..9afbc66b 100644--- a/src/site.css+++ b/src/site.css@@ -243,3 +243,9 @@ body.site > main { flex: 1; width: var(--page); margin-inline: auto; padding-blo.site .section-heading { display: flex; align-items: baseline; justify-content: space-between; flex-wrap: wrap; gap: 8px 20px; }.site .section-heading a { color: var(--muted); font-size: 15px; }.site .section-heading a:hover { color: var(--text); text-decoration: underline; }+/* The hero shows a still of a showcase scene; it opens the live scene. */+.site .hero-shot { position: relative; display: block; min-width: 0; overflow: hidden; border-radius: var(--panel-radius); background: var(--surface); box-shadow: var(--shot-shadow); }+.site .hero-shot img { display: block; width: 100%; height: auto; aspect-ratio: 16 / 9; object-fit: cover; transition: transform .4s cubic-bezier(.2, 0, 0, 1); }+.site .hero-shot:hover img { transform: scale(1.02); }+.site .hero-shot-label { position: absolute; left: 14px; bottom: 14px; padding: 6px 12px; border-radius: 999px; background: color-mix(in srgb, var(--window) 88%, transparent); color: var(--text); font-size: 14px; font-weight: 500; backdrop-filter: blur(8px); }+@media (prefers-reduced-motion: reduce) { .site .hero-shot:hover img { transform: none; } }