Skip to content

armgit / 67.js

Public Imported from GitHub
0

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.html
index 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.json
index 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.mjs
index 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.js
deleted file mode 100644
index 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.js
index 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.js
index 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.css
index 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; } }