用这个模板做的 3 个案例
同一份提示词,不同的 [VARIABLES] 变量。点一个在上方预览。关于这个模板
Endless Hall 是一个用 three.js 构建的单页在线展览。二十四幅装裱好的照片挂在一条首尾相接的暗色走廊上,访客可以滚动、拖拽或滑动,向任一方向前进,永远走不到尽头。作品分为四个有名字的展厅,每个展厅开头都有一个漂浮在雾气中的大号斜体标题,一个细长的抬头显示框会跟踪当前展厅、作品编号和循环进度。点击照片,镜头会飞过去,打开一个宽银幕比例的详情视图,显示完整标题、作者、日期、工艺、收藏和授权,并附上来源记录链接。单独的灯箱以完整尺寸显示图像,支持点击缩放和键盘翻页,索引面板可直接跳转到任意作品。默认案例是一个十九世纪摄影的小型档案,每张图片都是来自博物馆开放获取馆藏的 CC0 真实照片,已下载到项目中并在 ASSETS.md 中署名。它适合有完整系列的摄影师、小型博物馆和档案馆、版画店,以及任何希望让收藏感觉像一个地方而非一个网格的人。设计细节:近乎黑色的雾气、暖米白色字体、标题使用 Cormorant Garamond 斜体、标签使用 IBM Plex Mono、胶片颗粒、暗角、飘浮的尘埃、随速度轻微弯曲的平面,以及自定义环形光标。在减少动态效果设置下,动画会完全平静下来;不支持 WebGL 的浏览器会看到一个干净的目录页。要改编它,先更改名称、展览标题、展厅名称和参观信息行,然后在一个内容文件中替换 24 张照片及其说明文字;走廊、展厅和详情视图会根据这些数据重建。
模板提示词
在线演示就是用这份提示词原样做出来的,没有额外补充。其他案例只是改了 [VARIABLES] 变量的值。 提示词保持英文原版,国内常用的 AI 编程工具都能直接理解;下面附中文参考译文。
# 3D Photo Gallery
Build this website exactly as described below. Replace the [VARIABLES] with your own values; keep everything else.
## Brief
An immersive online exhibition for [BRAND]: twenty-four real public-domain photographs hang as framed planes along an endless dark corridor in WebGL. Visitors scroll, drag or swipe to walk forward and back; the corridor wraps around so the walk never ends. The works are grouped into four named rooms ([ROOMS]), each announced by a huge italic room title floating in the dark. Clicking a photograph flies the camera up to it and opens a letterboxed detail view with full caption, credit and license; from there a 2D lightbox shows the full image with zoom. A thin HUD frames the screen: brand, current room, rolling work counter, progress track, Index and About panels. One page, no backend, every image downloaded into the project and credited.
- Audience: Visitors of a small photography archive or museum who want to browse a collection slowly, plus photographers, curators and archives looking for a memorable way to show a set of 15–40 images.
- Goal: Make browsing a collection feel like walking through a quiet gallery, while every image stays properly captioned and credited: title, maker, date, process, collection and license one click away.
- Tone: Quiet, exact and curatorial. Short factual captions, no exclamation marks, no marketing language. Labels read like museum wall text.
## Stack
- Framework: Vite 5 + TypeScript + three.js
- Styling: Plain CSS, custom properties
- Libraries: three (MIT), @types/three (dev) (MIT), vite (MIT), typescript (Apache-2.0), @fontsource/cormorant-garamond (OFL-1.1), @fontsource-variable/hanken-grotesk (OFL-1.1), @fontsource/ibm-plex-mono (OFL-1.1)
- Build: `npm run build` → static files in `dist/`. No backend, no server code, no external APIs.
- Setup:
- Scaffold with npm create vite@latest using the vanilla-ts template. No UI framework. One page: index.html plus src/main.ts.
- vite.config.ts: base './', build { outDir: 'dist', sourcemap: false, assetsInlineLimit: 0 }. Do not copy src/ into dist/.
- File layout: src/content.ts (brand strings, rooms, the 24 works with every caption field, About copy), src/scene/ (Renderer.ts, CameraRig.ts, Corridor.ts, WorkPlane.ts, RoomTitle.ts, Dust.ts, shaders.ts), src/ui/ (Loader.ts, Hud.ts, Panel.ts, Detail.ts, Lightbox.ts, Cursor.ts, Fallback.ts), src/styles.css.
- Fonts: import '@fontsource/cormorant-garamond/400-italic.css', '@fontsource/cormorant-garamond/500-italic.css', '@fontsource/cormorant-garamond/500.css', '@fontsource-variable/hanken-grotesk' and '@fontsource/ibm-plex-mono/400.css', '@fontsource/ibm-plex-mono/500.css' in src/main.ts. Before drawing any canvas text, await document.fonts.load for 'italic 400 64px "Cormorant Garamond"' and '400 32px "IBM Plex Mono"'.
- The 24 photographs live in public/photos/ under the exact file names in Assets and are referenced with relative paths ('./photos/01-effect-of-the-sun.jpg'). Write ASSETS.md at the project root before building.
- All colors as CSS custom properties on :root in src/styles.css; the same hex values are imported into the three.js code from src/content.ts or a small src/theme.ts.
- dist/ holds index.html, hashed JS/CSS, the woff2 fonts, favicon.svg and the 24 JPEGs (about 12 MB total). Keep it under 20 MB.
## Variables
- [BRAND] — Archive, museum or studio name (default: "Halvard Archive"). Shown as the italic wordmark top-left, in the loader, the <title> and the About panel.
- [EXHIBITION] — Exhibition or collection title (default: "First Light"). One to three words. Shown large in the loader and under the wordmark.
- [COLLECTION_NOTE] — One-line description of the collection (default: "Early photographs of water, stone, leaf and sky, 1841–1900")
- [ROOMS] — Four room names, in walking order (default: "Tide, Stone, Leaf, Sky"). Exactly four single words. Works 01–06 hang in the first room, 07–12 in the second, 13–18 in the third, 19–24 in the fourth.
- [VISIT_LINE] — Practical line: address, hours or price (default: "Reading room: 9 Cinder Wharf, Port Aldery · Thu–Sun 11:00–17:00 · Free entry")
- [CREDIT] — keep a small "Template by VibeFather" link to https://vibefather.ai/t/3d-photo-gallery in the footer (default: yes; delete this line to remove it)
The copy under Pages & Sections is written for the default values. If your values differ, rewrite every headline, paragraph, label and image for them — same length, tone and structure. Layout, colors, type and motion stay as described.
Keep all copy, image paths and links in one content file (for example `src/content.ts`), keyed by section, so the content can be swapped later without touching components.
## Design
### Colors
- Void `#0b0a09` — Page and scene background, fog color, loader background
- Soot `#15130f` — Index and About panels, mobile detail sheet, fallback page
- Frame `#2a241d` — Thin frame plane behind every photograph
- Bone `#ece4d6` — Primary text, room titles, cursor ring, dust particles
- Ash `#8f877a` — Secondary text, mono labels, dates, inactive controls
- Hairline `rgba(236,228,214,0.14)` — 1px dividers, progress track, panel borders
- Albumen `#c99a5b` — The only accent: progress fill, cursor dot, active index number, focus rings, the small dot in buttons. Never for large fills or body text.
- Letterbox `#000000` — Detail-view letterbox bars and the lightbox backdrop (at 96% opacity)
### Typography
- Display (wordmark, room titles, work titles): Cormorant Garamond (OFL), weights 400/500
- Text (captions, panels, buttons): Hanken Grotesk (OFL), weights 400/500
- Mono micro-labels (counters, room labels, hints, credits): IBM Plex Mono (OFL), weights 400/500
### Layout & motion
- Spacing: HUD sits on a fixed inset frame: 28px from each edge at ≥ 900px wide, 18px below. Panels use 40px padding (24px mobile). Mono labels are 11px uppercase with 0.16em letter-spacing. Detail text column starts at 6vw from the left, max-width 520px. Vertical rhythm in text blocks is 8px multiples (8, 16, 24, 40).
- Radius: 0 everywhere (frames, panels, images, lightbox). Only pill buttons use 999px, and the cursor ring is a circle.
- Motion: Easing: entrances cubic-bezier(.2,.8,.2,1); panels and letterbox cubic-bezier(.7,0,.2,1); camera flights easeInOutCubic. Damping helper damp(a, b, λ, dt) = a + (b − a)·(1 − e^(−λ·dt)) drives every continuous value.
- Motion: Inertial walk: wheel, drag and swipe write to a scroll target; the camera chases it with damp λ 5 and keeps momentum after release (velocity decays by e^(−3.5·dt)).
- Motion: Velocity bend: photograph planes curve slightly along their width while the camera moves (uBend = clamp(speed × 0.02, −0.35, 0.35)) and flatten when it stops.
- Motion: Pointer parallax: camera offsets up to 0.25 units in x and 0.15 in y and rotates up to 0.04 rad toward the pointer, damped λ 3.
- Motion: Camera flight to a photograph in 1.2 s with a FOV kick (+8° at the midpoint), other works dimming to 12% brightness in 0.6 s.
- Motion: Rolling digits: each digit is a masked vertical 0–9 strip that slides to the new value in 0.6 s; room names slide up out and in through a mask in 0.5 s.
- Motion: Loader shutter: the loader splits into a top and bottom half that slide off-screen in 0.9 s, then HUD items rise 12px and fade in with an 80ms stagger and the works reveal nearest-first.
- Motion: Film grain overlay steps through 8 offsets per second; dust drifts slowly. prefers-reduced-motion: no inertia (λ 14, no momentum), no bend, no FOV kick, no auto-walk, static grain and dust, camera jumps replaced by 0.35 s crossfades, rolling digits switch instantly.
- Imagery: Real nineteenth-century photographs only: 24 CC0 images from The Cleveland Museum of Art Open Access, kept in their original warm albumen, salted-paper, cyanotype and photochrom tones. No color grading, no filters, no crops: each plane uses the image's natural aspect ratio. Everything else (frames, labels, room titles, dust, grain, vignette, cursor, favicon) is drawn in code. No portraits and no logos.
## Pages & Sections
### Gallery (single page) (`index.html`)
1. **Document** — <title>[BRAND] — [EXHIBITION]</title>, lang 'en', theme-color #0b0a09, color-scheme dark. Favicon public/favicon.svg: a 32×32 square in #0b0a09 (rx 6) with a centered circle r 8 stroked #c99a5b at 2px and a filled #c99a5b dot r 2.5 in its center, like an aperture. body is overflow hidden, height 100dvh, background Void, user-select none on the stage.
Layout: DOM order inside <main>: #stage (canvas container, fixed inset 0), .vignette, .grain, header.hud, aside#index, aside#about, section#detail (role dialog), div#lightbox (role dialog), div#loader, div#cursor, section#fallback (hidden). One H1, visually hidden, containing '[BRAND] — [EXHIBITION]'.
2. **Loader** — Top-left: '[BRAND]' in Cormorant Garamond italic 500, 28px, Bone. Center: '[EXHIBITION]' in Cormorant Garamond italic 400, clamp(72px, 13vw, 210px), line-height 0.9, Bone, centered. Under it, mono 11px Ash: 'HANGING PLATES 014 / 024' where the first number counts textures actually loaded (zero-padded to three digits). Bottom-left mono 11px Ash: '[COLLECTION_NOTE]'. Bottom-right mono 11px Ash: 'Drag, scroll or swipe'.
Layout: Fixed full-screen, background Void, z-index above everything. A 1px Hairline line spans the full width at 50% height behind the title; an Albumen 1px line grows over it from left to right with load progress (width = loaded / 24).
Motion: The exhibition title enters letter by letter: each letter rises from 110% to 0 inside an overflow-hidden line, 40ms stagger, 0.8s. When all 24 textures are loaded and the progress line has reached 100%, hold 300ms, then the loader splits: its top half translates to −100% and its bottom half to +100% (two stacked divs that each contain half the content, clip-path not needed), 0.9s cubic-bezier(.7,0,.2,1). Remove the loader from the DOM after the transition. Reduced motion: no letter animation, plain 0.4s fade.
3. **3D corridor (scene)** — three.js WebGLRenderer (antialias true, alpha false), pixel ratio min(devicePixelRatio, 2) desktop and min(devicePixelRatio, 1.75) when the viewport is under 900px wide, outputColorSpace SRGBColorSpace, no tone mapping, clear color #0b0a09. PerspectiveCamera FOV 45 (55 when aspect < 0.8), near 0.1, far 80, starting at (0, 0, 0) looking down −z. Corridor layout constants: work spacing 3.2 units, room length 25.2, loop length L = 100.8. Room r (0–3) has offset O = r × 25.2; its room title sits at z = −(O + 3); its work k (0–5) sits at z = −(O + 7 + k × 3.2). Per-room offsets for work k: x = [−1.6, 1.45, −1.35, 1.7, −1.5, 1.4][k], y = [0.12, −0.18, 0.22, −0.08, 0.05, −0.2][k], rotation.y = −sign(x) × 0.12 (each work turns slightly toward the corridor center). When aspect < 0.8 multiply x by 0.42 and plane size by 0.8.
Layout: Infinite wrap: every work, room title and dust particle keeps a base z; each frame its rendered z = camZ + rel, where rel = ((baseZ − camZ − 4) mod L + L) mod L − L + 4, so objects stay between L − 4 units ahead and 4 units behind the camera. Each work is a THREE.Group with: a frame plane (Frame color, MeshBasicMaterial, size w + 0.08 by h + 0.08, z −0.01); the photo plane (PlaneGeometry w × h with 24×1 segments, 16×1 on mobile, custom ShaderMaterial); and a museum label plane 0.18 units below the frame's bottom edge, left-aligned with it: a 1024×128 canvas texture with mono 34px Ash '07' then, after 48px, Cormorant italic 52px Bone short title, drawn on transparency, plane width 1.4 units. Photo size: h = 1.7, w = 1.7 × imageAspect; if w > 2.3 then w = 2.3 and h = 2.3 / imageAspect. Photo shader uniforms: uTex, uReveal (0–1), uDim (1 = normal), uHover (0–1), uBend, uFogColor #0b0a09, uFogNear 6, uFogFar 34. Vertex: position.z += sin(uv.x × π) × uBend × w × 0.25; pass view depth. Fragment: color = texture × uDim × (1 + uHover × 0.08); mix toward uFogColor by smoothstep(uFogNear, uFogFar, depth); alpha = uReveal. Textures: TextureLoader, colorSpace SRGBColorSpace, anisotropy min(8, renderer max), mipmaps on. Raycast only against photo planes.
Motion: Camera rig: scroll target s (positive = forward), position p, velocity v. Wheel: s += deltaY × 0.01 (deltaMode 1 → × 16, deltaMode 2 → × innerHeight). Pointer drag on the stage: s += (clientY − lastY) × 0.018 (0.03 for touch), pan x target −= (clientX − lastX) × 0.003, clamped to ±1.1 (±0.5 when aspect < 0.8); on release, v = average drag speed over the last 100ms, and pan target eases back to 0 with λ 1.5. Each frame: s += v·dt, v *= e^(−3.5·dt), p = damp(p, s, 5, dt); camera z = −p, camera x = pan + pointerX × 0.25, camera y = pointerY × 0.15, rotation.y = −pointerX × 0.04, rotation.x = pointerY × 0.03. Keys: ArrowDown / PageDown / S = s + 3.2; ArrowUp / PageUp / W = s − 3.2; Enter opens the current work; I toggles Index; Esc closes the top-most overlay. Auto-walk: after 6s with no input and no overlay open, s += 0.25·dt until the next input. Hover: when the pointer is over a photo plane, its uHover eases to 1 and its group scales to 1.035 (damp λ 8). Entrance after the loader: works reveal nearest-first, uReveal 0→1 and y offset −0.3→0 over 0.8s with 90ms stagger. A pointerup counts as a click only if the pointer moved less than 6px since pointerdown.
4. **Room titles** — One floating title per room, in order: 'ROOM I' / 'Tide', 'ROOM II' / 'Stone', 'ROOM III' / 'Leaf', 'ROOM IV' / 'Sky' (names from [ROOMS]). Under each name, mono 30px Ash: 'SIX PHOTOGRAPHS'.
Layout: Each title is a plane 8 × 3 units at x 0, y 0.4, facing the camera, textured with a 2048 × 768 transparent canvas: mono 500 40px Bone with 0.3em tracking 'ROOM II' centered at y 150; Cormorant Garamond italic 400 360px Bone room name centered at y 520; mono 30px Ash 'SIX PHOTOGRAPHS' centered at y 690. MeshBasicMaterial transparent, depthWrite false. When aspect < 0.8 scale the plane to 0.55.
Motion: Opacity from the title's rel z: 0 beyond −22, rising to 0.92 at −12, holding, then falling to 0 between −3 and −0.5. While the detail view is open all room titles fade to 0 in 0.5s.
5. **HUD** — Top-left: '[BRAND]' (Cormorant italic 500, 30px, Bone) and under it, 8px gap, mono 11px uppercase Ash with 0.16em tracking: '[EXHIBITION]' on line one and '[COLLECTION_NOTE]' on line two (max-width 300px). Top-center: mono 11px Ash 'NOW IN ROOM' over a line with a rolling Roman numeral in mono 13px Bone, a '· ' separator and the room name in Cormorant italic 24px Bone (e.g. 'II · Stone'). Top-right: two text buttons in mono 12px uppercase Bone, 24px apart: 'Index (24)' and 'About'. Bottom-left: rolling counter in mono 13px Bone '07' plus Ash ' / 24', then the current short title in Cormorant italic 26px Bone, then maker and date in Hanken Grotesk 13px Ash ('Timothy H. O'Sullivan, c. 1871'). Bottom-center: a 32px Hairline rule followed by mono 11px Ash 'Scroll or drag to walk · Click a photograph to look closer' (touch devices: 'Swipe to walk · Tap a photograph to look closer'). Bottom-right: the progress track, and under it mono 10px Ash 'Images: The Cleveland Museum of Art · CC0' followed by the [CREDIT] link if kept; this bottom-right line is the page footer.
Layout: header.hud is fixed inset 0 with pointer-events none (its buttons and links re-enable them). Items are absolutely positioned on the 28px inset frame (18px under 900px). The current work is the one whose rendered z is closest to camZ − 4; the current room is that work's room. Progress track: 140px × 1px Hairline with an Albumen fill whose width = (p mod L) / L, four 1px × 6px Hairline ticks at the room starts (0%, 25%, 50%, 75%) and mono 10px Ash numerals I II III IV under the ticks. Under 900px: top-center room block is hidden and its content joins bottom-left as 'II · Stone — 07 / 24'; the hint moves above bottom-left; the track is 72px wide; top-left shows only the wordmark (24px) and the exhibition title.
Motion: Counter digits and the room numeral use rolling digits; title and maker lines crossfade with a 6px upward slide in 0.4s when the current work changes. Text buttons get a 1px Albumen underline that grows from the left on hover in 0.3s. The bottom-center hint fades out for good once the camera has travelled 6 units. While the detail view or lightbox is open, the HUD fades to opacity 0 in 0.4s.
6. **Index panel** — Header: 'Index' in Cormorant italic 400, 44px, Bone, with a mono 12px uppercase 'Close ×' button on the right. Then four groups, each headed by mono 11px Ash 'ROOM I — TIDE' (numeral and room name from [ROOMS]), listing that room's six works. Each row: zero-padded number in mono 12px Ash, short title in Hanken Grotesk 500 15px Bone, date in mono 12px Ash right-aligned.
Layout: aside#index fixed to the right, full height, width 440px (100vw under 900px), background Soot, 1px Hairline left border, 40px padding (24px mobile), its own vertical scroll. Rows are a 3-column grid (40px, 1fr, auto) with 12px vertical padding and a 1px Hairline bottom border. While open, the canvas dims: every photo's uDim eases to 0.4.
Motion: Slides in from translateX(100%) to 0 in 0.55s cubic-bezier(.7,0,.2,1); rows fade up 8px with 25ms stagger. Row hover: title shifts 6px right and the number turns Albumen (0.25s). Clicking a row closes the panel, sets the scroll target so that the work's rendered z ends up at camZ − 4.5 (taking the shorter way around the loop), and opens the detail view as soon as |p − s| < 0.05 or after 1.4s, whichever comes first.
7. **About panel** — Header: 'About' in Cormorant italic 44px with 'Close ×'. Paragraph 1 (Hanken 16px/1.6 Bone): '[BRAND] is a small independent archive of nineteenth-century photography. [EXHIBITION] hangs twenty-four photographs made between 1841 and 1900 along a corridor that never ends: walk it in either direction and the rooms come round again.' Paragraph 2 (Ash): 'Every image here comes from the Open Access collection of The Cleveland Museum of Art and is dedicated to the public domain under CC0. Captions give the maker, date, process and fund that acquired each print; follow "Source record" in any detail view for the full museum entry.' Then a 1px Hairline and a definition list in mono 11px Ash labels / Hanken 15px Bone values: 'Visit' → '[VISIT_LINE]'; 'Write' → '[email protected]' as a mailto link; 'Keys' → '↑ ↓ walk · Enter look closer · I index · Esc close'. Bottom: mono 10px Ash 'Images: The Cleveland Museum of Art · CC0' and the [CREDIT] link if kept.
Layout: Same shell, size and behavior as the Index panel (aside#about). Only one of Index and About can be open at a time.
Motion: Same as the Index panel.
8. **Detail view** — For the focused work: kicker in mono 11px Ash 'ROOM II — STONE · 07 / 24'; full title in Cormorant Garamond italic 400, clamp(40px, 4.6vw, 76px), line-height 0.95, Bone (long titles allowed to wrap; for titles over 70 characters use clamp(30px, 3vw, 48px)); maker in Hanken Grotesk 500 18px Bone; the caption in Hanken 400 16px/1.6 Ash, max 40ch; a definition list with four rows, labels in mono 11px uppercase Ash and values in Hanken 14px Bone: 'Date', 'Process', 'Collection' ('The Cleveland Museum of Art, ' + fund), 'License' ('CC0 1.0 — free to reuse'). Buttons: a pill 'View full image' (1px Bone border, mono 12px uppercase, a 6px Albumen dot before the label, 44px high, 20px horizontal padding) and a text link 'Source record ↗' to the work's museum record (target _blank, rel noopener noreferrer). Top-right 'Close ×'; bottom-left '← Previous', bottom-right 'Next →' (mono 12px uppercase Bone, inside the letterbox bars).
Layout: section#detail fixed inset 0, transparent, over the canvas. Two black Letterbox bars, top and bottom, each 8vh tall. Desktop: text column at left 6vw, vertically centered, max-width 520px, with a soft gradient from rgba(11,10,9,0.85) at the left edge to transparent at 50vw behind it for legibility. The camera frames the photograph to the right of center. Under 900px: no bottom bar; the text sits in a bottom sheet (52vh, Soot at 94% opacity, 1px Hairline top border, 24px padding, scrolls internally), and the photograph is framed in the upper half. Focus is trapped inside the dialog; Esc closes; ← / → go to previous / next.
Motion: Opening a work: snapshot the free camera pose, then fly in 1.2s (easeInOutCubic) to the point 2.2 × max(h / 1.7, w / 2.3) units in front of the photo along its facing normal (× 1.5 under 900px), looking at the photo center shifted 0.6 units to the left on desktop (photo appears right of center) or 0.45 units down on mobile (photo appears in the upper half). FOV = base + 8 × sin(π t) during the flight. Other works' uDim eases to 0.12 in 0.6s. At 65% of the flight, the letterbox bars scale in from the screen edges (scaleY 0→1, 0.6s), the kicker and meta fade in, and the title's words rise from 100% to 0 in masks with 60ms stagger. While open, wheel and vertical drag do not walk; a horizontal drag over 80px or ← / → flies to the neighbouring work (0.9s) and swaps the text with a 0.3s crossfade; a wheel total over 120px down or Close flies back to the saved free pose in 1.0s while the overlay fades out in 0.3s and uDim returns to 1. Reduced motion: no flight; the camera cuts to the framed pose behind a 0.35s crossfade of the overlay.
9. **Lightbox** — The full photograph from public/photos/ as an <img> with its alt text. Caption bar along the bottom in mono 11px Ash: '07 — Iceberg Canyon, Colorado River Looking Above · Timothy H. O'Sullivan · c. 1871 · The Cleveland Museum of Art · CC0'. Top-right mono 12px 'Close ×'; left and right edge buttons '←' and '→' (48px square hit areas). A mono 10px Ash hint top-left: 'Click to zoom'.
Layout: div#lightbox fixed inset 0, background rgba(0,0,0,0.96), image centered with max 92vw × 84vh and object-fit contain, no frame. Opened from 'View full image' in the detail view, and from any figure in the fallback catalogue. Focus trapped, Esc closes, ← / → change image across all 24 works.
Motion: Opens with the backdrop fading in over 0.3s and the image scaling from 0.94 to 1 with opacity 0→1 in 0.35s. Clicking the image toggles 2× zoom centered on the click point (transform transition 0.35s); while zoomed, dragging pans the image, clamped to its edges. Changing image crossfades in 0.25s. Reduced motion: fades only, zoom without transition.
10. **Cursor and atmosphere** — Custom cursor (pointer: fine devices only, the native cursor hidden over the stage): a 36px circle ring with a 1px rgba(236,228,214,0.5) border and a 4px Albumen dot at its center, plus a mono 10px uppercase Bone label inside the ring. Over a photograph the ring grows to 72px and reads 'Look'; while dragging it squashes to 44 × 28px and reads 'Walk'; over buttons and links it shrinks to 20px with no label. Atmosphere overlays: .vignette = radial-gradient(ellipse at center, transparent 55%, rgba(0,0,0,0.65) 100%); .grain = an inline SVG feTurbulence noise (baseFrequency 0.9, numOctaves 2) as a data URI, tiled at 180px, opacity 0.07, mix-blend-mode overlay. Dust: 600 THREE.Points in a box x ±6, y ±3, z from −30 to +2 relative to the camera (wrapped like the works), size 0.018 with size attenuation, Bone at opacity 0.35, depthWrite false.
Layout: Cursor, vignette and grain are fixed full-screen layers with pointer-events none; the cursor sits above all overlays except the loader. Hide the cursor element on touch devices and when the pointer leaves the window.
Motion: Ring follows the pointer with damp λ 12, the dot with λ 30; size changes take 0.3s. Grain jumps between 8 preset background offsets 8 times a second (steps). Dust particles bob in y by sin(time × 0.2 + index) × 0.04. Reduced motion: grain and dust static, ring follows instantly.
11. **Fallback catalogue** — Shown only when WebGL is unavailable or scene setup throws. Header: '[BRAND]' wordmark, '[EXHIBITION]' in Cormorant italic clamp(56px, 9vw, 140px), '[COLLECTION_NOTE]' in mono 11px Ash, and the line 'This browser cannot open the walk-through, so here is the catalogue.' in Hanken 15px Ash. Then the four rooms, each with its mono 'ROOM I — TIDE' heading and six figures: the photo, then a figcaption with number (mono), short title (Cormorant italic 24px), maker and date (Hanken 14px Ash), and 'The Cleveland Museum of Art · CC0' (mono 10px Ash).
Layout: section#fallback replaces the loader and stage; body scrolls. Max-width 1200px, centered, 40px side padding (20px mobile). Each room is a 3-column grid with 32px gaps (1 column under 700px); images keep their natural aspect, loading lazy. Clicking a figure opens the Lightbox. The [CREDIT] link sits at the bottom with the image credit.
Motion: Figures fade up 12px as they enter the viewport (IntersectionObserver, 0.6s). None under reduced motion.
## Assets
- font: Self-hosted through Fontsource: @fontsource/cormorant-garamond (400 italic, 500 italic, 500), @fontsource-variable/hanken-grotesk (variable, use 400 and 500), @fontsource/ibm-plex-mono (400, 500), imported in src/main.ts. CSS families: 'Cormorant Garamond', 'Hanken Grotesk Variable', 'IBM Plex Mono', each with a serif / sans-serif / monospace fallback. Vite bundles the woff2 files into dist/.
- icon: No icon library. Arrows and close marks are text glyphs (←, →, ↑, ↓, ↗, ×) in IBM Plex Mono. public/favicon.svg is hand-written as described in Document.
- image: Drawn in code, no files: frames, museum labels and room titles (canvas textures), dust (THREE.Points), film grain (inline SVG data URI), vignette (CSS gradient), cursor (CSS).
- image: The 24 photographs below are CC0 images from The Cleveland Museum of Art Open Access. Download each with curl into public/photos/ under the exact file name, check that all 24 exist before building, and never hotlink. Put every caption field (number, room, short title, full title, maker, date, process, collection, license, record URL, alt, caption) in src/content.ts exactly as written. Write ASSETS.md at the project root with one row per photo: path, source image URL, record URL, author (the maker), license 'CC0 1.0 — The Cleveland Museum of Art Open Access'. Also list the three Fontsource packages (OFL-1.1) and three.js (MIT).
- image: Work 01 (Room I, Tide). Download https://openaccess-cdn.clevelandart.org/1987.54/1987.54_web.jpg to public/photos/01-effect-of-the-sun.jpg (1165×893 JPEG, keep as is). Short title: "An Effect of the Sun". Full title: "An Effect of the Sun, Normandy". Maker: Gustave Le Gray. Date: c. 1856. Process: Albumen print from wet collodion negative. Collection: The Cleveland Museum of Art, Andrew R. and Martha Holden Jennings Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1987.54. Alt: "Sun breaking through heavy clouds above a flat, glittering seashore". Caption: "Sun breaks through heavy cloud over a flat, glittering shore. The horizon sits low, so the sky does most of the work." Used as: corridor plane 01, detail view, lightbox, Index row and fallback catalogue.
- image: Work 02 (Room I, Tide). Download https://openaccess-cdn.clevelandart.org/1991.292/1991.292_web.jpg to public/photos/02-great-upper-waterfall.jpg (703×893 JPEG, keep as is). Short title: "Great Upper Waterfall". Full title: "Great Upper Waterfall, High Alps". Maker: Louis-Alphonse Davanne. Date: c. 1862. Process: Albumen print from wet collodion negative. Collection: The Cleveland Museum of Art, Gift of Russ Anderson. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1991.292. Alt: "A tall waterfall dropping through dark pine trees, a wooden railing in the foreground". Caption: "A waterfall drops through dark pines in one long white ribbon; a wooden railing crosses the foreground." Used as: corridor plane 02, detail view, lightbox, Index row and fallback catalogue.
- image: Work 03 (Room I, Tide). Download https://openaccess-cdn.clevelandart.org/2006.4/2006.4_web.jpg to public/photos/03-winter-trees-pond.jpg (1034×893 JPEG, keep as is). Short title: "Winter Trees Reflected in a Pond". Full title: "Winter Trees Reflected in a Pond". Maker: William Henry Fox Talbot. Date: 1841–42. Process: Salted paper print from calotype negative. Collection: The Cleveland Museum of Art, Purchase from the J. H. Wade Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2006.4. Alt: "Bare winter trees on a bank, mirrored upside down in a still pond". Caption: "Bare winter trees stand on the far bank and again, upside down, in the still pond below." Used as: corridor plane 03, detail view, lightbox, Index row and fallback catalogue.
- image: Work 04 (Room I, Tide). Download https://openaccess-cdn.clevelandart.org/1997.44.a/1997.44.a_web.jpg to public/photos/04-river-landscape-scotland.jpg (1120×893 JPEG, keep as is). Short title: "River Landscape, Scotland". Full title: "River Landscape, Scotland". Maker: Captain Horatio Ross. Date: c. 1858. Process: Albumen print from wax paper negative. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1997.44.a. Alt: "A calm river bending between steep wooded banks and dark rocks". Caption: "A quiet river bends between steep wooded banks and dark rocks, its surface smoothed to a pale sheet." Used as: corridor plane 04, detail view, lightbox, Index row and fallback catalogue.
- image: Work 05 (Room I, Tide). Download https://openaccess-cdn.clevelandart.org/1990.33/1990.33_web.jpg to public/photos/05-miners-bridge.jpg (1048×893 JPEG, keep as is). Short title: "The Miners' Bridge". Full title: "The Miners' Bridge, on the Llugwy, North Wales". Maker: Roger Fenton. Date: 1857. Process: Albumen print from wet collodion negative. Collection: The Cleveland Museum of Art, Andrew R. and Martha Holden Jennings Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1990.33. Alt: "A slanting plank footbridge over a rocky stream below a wooded hillside". Caption: "A plank footbridge slants across a rocky stream under a wooded hillside." Used as: corridor plane 05, detail view, lightbox, Index row and fallback catalogue.
- image: Work 06 (Room I, Tide). Download https://openaccess-cdn.clevelandart.org/1997.47/1997.47_web.jpg to public/photos/06-city-island.jpg (1262×893 JPEG, keep as is). Short title: "City Island". Full title: "City Island, New York". Maker: Arthur Wesley Dow. Date: c. 1900. Process: Cyanotype. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1997.47. Alt: "A beached rowboat, a board fence and leafless trees, printed in deep blue". Caption: "A beached rowboat, a board fence and leafless trees, printed in the deep blue of a cyanotype." Used as: corridor plane 06, detail view, lightbox, Index row and fallback catalogue.
- image: Work 07 (Room II, Stone). Download https://openaccess-cdn.clevelandart.org/2002.46/2002.46_web.jpg to public/photos/07-iceberg-canyon.jpg (1111×893 JPEG, keep as is). Short title: "Iceberg Canyon". Full title: "Iceberg Canyon, Colorado River Looking Above". Maker: Timothy H. O'Sullivan. Date: c. 1871. Process: Albumen print from wet collodion negative. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2002.46. Alt: "Dark canyon walls sloping down to a calm river, a tiny seated figure on the rocks". Caption: "Dark canyon walls slope down to a calm stretch of river; a small seated figure on the rocks gives the scale." Used as: corridor plane 07, detail view, lightbox, Index row and fallback catalogue.
- image: Work 08 (Room II, Stone). Download https://openaccess-cdn.clevelandart.org/2024.6.gg/2024.6.gg_web.jpg to public/photos/08-river-gorge.jpg (900×599 JPEG, keep as is). Short title: "The River Gorge". Full title: "The River Gorge". Maker: John Burke. Date: 1878–80. Process: Albumen print. Collection: The Cleveland Museum of Art, Mr. and Mrs. Richard W. Whitehill Art Purchase Endowment Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2024.6.gg. Alt: "A wide braided river running out between bare hills under a pale sky". Caption: "A wide, braided river runs out between bare hills under a pale, empty sky." Used as: corridor plane 08, detail view, lightbox, Index row and fallback catalogue.
- image: Work 09 (Room II, Stone). Download https://openaccess-cdn.clevelandart.org/1987.130/1987.130_web.jpg to public/photos/09-bridge-of-palalda.jpg (900×658 JPEG, keep as is). Short title: "The Bridge of Palalda". Full title: "The Bridge of Palalda (near Amélie-les-Bains)". Maker: Gustave Le Gray. Date: 1851–52. Process: Salted paper print from waxed-paper negative. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1987.130. Alt: "An old stone arch bridge over a boulder-strewn stream below a dry hillside". Caption: "An old stone arch spans a boulder-strewn stream at the foot of a dry hillside." Used as: corridor plane 09, detail view, lightbox, Index row and fallback catalogue.
- image: Work 10 (Room II, Stone). Download https://openaccess-cdn.clevelandart.org/2004.32/2004.32_web.jpg to public/photos/10-troglodyte-farm.jpg (671×893 JPEG, keep as is). Short title: "Behind the Troglodyte Farm". Full title: "Behind the Troglodyte Farm". Maker: Henri Le Secq. Date: c. 1853. Process: Salted paper print from waxed paper negative. Collection: The Cleveland Museum of Art, Norman O. Stone and Ella A. Stone Memorial Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2004.32. Alt: "A narrow lane between stacked stone walls and an arched doorway cut into rock". Caption: "Doorways cut into rock and stacked stone walls close in around a narrow lane." Used as: corridor plane 10, detail view, lightbox, Index row and fallback catalogue.
- image: Work 11 (Room II, Stone). Download https://openaccess-cdn.clevelandart.org/1995.237/1995.237_web.jpg to public/photos/11-dolmen.jpg (1194×893 JPEG, keep as is). Short title: "Dolmen, Cap del Puetch". Full title: "Dolmen, Cap del Puetch, Ariège, France". Maker: Arthur A. Taylor. Date: c. 1865–69. Process: G. Arosa et Cie process print from waxed paper negative. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1995.237. Alt: "A flat capstone resting on low stones in open scrubland, a lone tree above". Caption: "A flat capstone rests on low stones in open scrub, a lone tree leaning over it." Used as: corridor plane 11, detail view, lightbox, Index row and fallback catalogue.
- image: Work 12 (Room II, Stone). Download https://openaccess-cdn.clevelandart.org/1992.237/1992.237_web.jpg to public/photos/12-upper-glacier.jpg (1111×893 JPEG, keep as is). Short title: "Upper Glacier, Grindelwald". Full title: "Switzerland. Grindelwald, Upper Glacier, Source of the Lutschine". Maker: Adolphe Braun. Date: 1875–77. Process: Carbon print, toned, from wet collodion negative. Collection: The Cleveland Museum of Art, The A. W. Ellenberger, Sr., Endowment Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1992.237. Alt: "The broken face of a glacier with a dark ice cave at its foot". Caption: "The broken face of a glacier fills the frame, with a dark ice cave at its foot." Used as: corridor plane 12, detail view, lightbox, Index row and fallback catalogue.
- image: Work 13 (Room III, Leaf). Download https://openaccess-cdn.clevelandart.org/1994.93/1994.93_web.jpg to public/photos/13-birch-tree.jpg (616×893 JPEG, keep as is). Short title: "Study of a Birch Tree". Full title: "Study of a Birch Tree, Barbizon". Maker: Constant Alexandre Famin. Date: 1860s–1870s. Process: Albumen print from wet collodion negative. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1994.93. Alt: "A single twisting birch tree, pale bark against a dark wood". Caption: "A single birch twists upward, its pale bark bright against a dark wood." Used as: corridor plane 13, detail view, lightbox, Index row and fallback catalogue.
- image: Work 14 (Room III, Leaf). Download https://openaccess-cdn.clevelandart.org/1988.64/1988.64_web.jpg to public/photos/14-forest-pathway.jpg (1236×893 JPEG, keep as is). Short title: "Pathway in the Forest". Full title: "Pathway in the Forest of Fontainebleau". Maker: Gustave Le Gray. Date: 1849–52. Process: Salted paper print from waxed paper negative. Collection: The Cleveland Museum of Art, Norman O. Stone and Ella A. Stone Memorial Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1988.64. Alt: "A sandy track leading into a tall, sunlit forest". Caption: "A sandy track runs into a tall, sunlit forest." Used as: corridor plane 14, detail view, lightbox, Index row and fallback catalogue.
- image: Work 15 (Room III, Leaf). Download https://openaccess-cdn.clevelandart.org/1988.239/1988.239_web.jpg to public/photos/15-scotch-firs.jpg (1198×893 JPEG, keep as is). Short title: "Scotch Firs, Hawkhurst". Full title: "Scotch Firs, Hawkhurst". Maker: Benjamin Brecknell Turner. Date: 1853. Process: Albumen print from calotype. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1988.239. Alt: "Tall Scots pines leaning over a stream and a wooden fence by a country road". Caption: "Tall Scots pines lean over a stream and a wooden fence beside a country road." Used as: corridor plane 15, detail view, lightbox, Index row and fallback catalogue.
- image: Work 16 (Room III, Leaf). Download https://openaccess-cdn.clevelandart.org/1995.26/1995.26_web.jpg to public/photos/16-fern-cyanotype.jpg (621×893 JPEG, keep as is). Short title: "Scolopendrium Vulgare". Full title: "Scolopendrium Vulgare". Maker: Anna Atkins. Date: 1852–54. Process: Cyanotype. Collection: The Cleveland Museum of Art, Norman O. Stone and Ella A. Stone Memorial Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1995.26. Alt: "Four pale fern fronds laid flat on deep blue cyanotype paper". Caption: "Four hart's-tongue fern fronds, laid flat on sensitised paper and printed blue without a camera." Used as: corridor plane 16, detail view, lightbox, Index row and fallback catalogue.
- image: Work 17 (Room III, Leaf). Download https://openaccess-cdn.clevelandart.org/1992.226/1992.226_web.jpg to public/photos/17-woods-in-snow.jpg (653×893 JPEG, keep as is). Short title: "Woods in Snow". Full title: "Untitled (Woods in Snow)". Maker: William James Stillman, with J. W. Black. Date: 1859. Process: Salted paper print, varnished, from wet collodion negative. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1992.226. Alt: "Snow-laden branches in a dense forest, framed in a soft oval". Caption: "Fresh snow weighs down the branches of a dense forest, framed in a soft oval." Used as: corridor plane 17, detail view, lightbox, Index row and fallback catalogue.
- image: Work 18 (Room III, Leaf). Download https://openaccess-cdn.clevelandart.org/2007.26/2007.26_web.jpg to public/photos/18-mullein-in-bloom.jpg (728×900 JPEG, keep as is). Short title: "Mullein in Bloom". Full title: "Mullein in Bloom". Maker: Eugène Atget. Date: c. 1897–1899. Process: Albumen print. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2007.26. Alt: "A tall flowering mullein plant in front of a white sheet hung on a hillside". Caption: "A tall mullein in flower, photographed against a white sheet hung behind it." Used as: corridor plane 18, detail view, lightbox, Index row and fallback catalogue.
- image: Work 19 (Room IV, Sky). Download https://openaccess-cdn.clevelandart.org/1988.191/1988.191_web.jpg to public/photos/19-sky-study-paris.jpg (1247×893 JPEG, keep as is). Short title: "Sky Study, Paris". Full title: "Sky Study, Paris". Maker: Charles Marville. Date: 1856–57. Process: Albumen print from wet collodion negative. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/1988.191. Alt: "Heavy clouds rolling over a dark band of city rooftops". Caption: "Heavy clouds roll over a dark band of rooftops and a single distant dome." Used as: corridor plane 19, detail view, lightbox, Index row and fallback catalogue.
- image: Work 20 (Room IV, Sky). Download https://openaccess-cdn.clevelandart.org/2011.172/2011.172_web.jpg to public/photos/20-lunar-photograph.jpg (674×900 JPEG, keep as is). Short title: "Photographie Lunaire". Full title: "Photographie Lunaire: Copernic-Képler-Aristarique". Maker: Maurice Loewy and Pierre Henri Puiseux. Date: 1896. Process: Photogravure (heliogravure). Collection: The Cleveland Museum of Art, Gift of Amy and Neil Viny. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2011.172. Alt: "A close view of the moon's surface with craters, ridges and bright rays". Caption: "The moon's surface in close view: craters, ridges and bright rays across a grey plain." Used as: corridor plane 20, detail view, lightbox, Index row and fallback catalogue.
- image: Work 21 (Room IV, Sky). Download https://openaccess-cdn.clevelandart.org/2002.43/2002.43_web.jpg to public/photos/21-mariposa-trail.jpg (1151×893 JPEG, keep as is). Short title: "From Mariposa Trail". Full title: "Yosemite Valley from Mariposa Trail". Maker: Charles Leander Weed. Date: c. 1865. Process: Mammoth albumen print from wet collodion negative. Collection: The Cleveland Museum of Art, John L. Severance Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2002.43. Alt: "A lone tall pine above a deep granite valley seen from a mountain trail". Caption: "A lone pine stands above a deep granite valley, seen from a mountain trail." Used as: corridor plane 21, detail view, lightbox, Index row and fallback catalogue.
- image: Work 22 (Room IV, Sky). Download https://openaccess-cdn.clevelandart.org/2022.36/2022.36_web.jpg to public/photos/22-view-from-chalais.jpg (900×699 JPEG, keep as is). Short title: "View from Chalais". Full title: "Vue prise du Couvent des Dominicains, Chalais (Isère), France". Maker: Félix Thiollier. Date: c. 1865. Process: Albumen print from collodion negative. Collection: The Cleveland Museum of Art, Gift of Michael Mattis and Judith Hochberg. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2022.36. Alt: "Cliffs above a valley filling with low cloud, seen from high ground". Caption: "Cliffs rise above a valley slowly filling with cloud, seen from high ground." Used as: corridor plane 22, detail view, lightbox, Index row and fallback catalogue.
- image: Work 23 (Room IV, Sky). Download https://openaccess-cdn.clevelandart.org/2018.216/2018.216_web.jpg to public/photos/23-kutcherry-hill.jpg (900×712 JPEG, keep as is). Short title: "Kinchinjunga from Kutcherry Hill". Full title: "Darjeeling. Kinchinjunga and the Snows from Kutcherry Hill". Maker: Photoglob Co., Zurich. Date: 1890. Process: Photochrom. Collection: The Cleveland Museum of Art, Purchase from the Karl B. Goldfield Trust. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2018.216. Alt: "Snow peaks floating above layered blue-grey ridges in soft colour". Caption: "Snow peaks float above layered blue-grey ridges, coloured by hand-prepared photochrom stones." Used as: corridor plane 23, detail view, lightbox, Index row and fallback catalogue.
- image: Work 24 (Room IV, Sky). Download https://openaccess-cdn.clevelandart.org/2024.5.24/2024.5.24_web.jpg to public/photos/24-upper-himalaya.jpg (900×711 JPEG, keep as is). Short title: "The Upper Himmalayahs". Full title: "The Upper Himmalayahs. View of the Mountain of Bunderpoonch with the Jumnootri Peak, 20,458 above the Level of the Sea". Maker: Samuel Bourne. Date: 1863–70. Process: Albumen print. Collection: The Cleveland Museum of Art, Severance and Greta Millikin Purchase Fund. License: CC0 1.0 (Open Access). Record: https://clevelandart.org/art/2024.5.24. Alt: "A pale mountain range fading into haze behind a screen of trees". Caption: "Through a screen of trees, a pale mountain range fades into the haze." Used as: corridor plane 24, detail view, lightbox, Index row and fallback catalogue.
## Don'ts
- No backend of any kind: no server code, API routes, databases, auth, analytics, forms that submit, or calls to the museum API at runtime. The only outbound links are the 'Source record ↗' links, the mailto link and the [CREDIT] link.
- Never hotlink images. All 24 photographs are downloaded into public/photos/ with the exact URLs and file names given, and listed in ASSETS.md with source, author and license.
- Do not swap in photos from Unsplash, Pexels, Pixabay, Google Images or any non-CC0 source. If you replace a photo, use another CC0 / public-domain open-access image and update content.ts and ASSETS.md.
- Do not crop, recolor, tint, desaturate or filter the photographs; show each at its natural aspect ratio. No portraits or recognizable faces as featured works, no logos.
- Do not load fonts from fonts.googleapis.com, fonts.gstatic.com, Adobe Fonts or any CDN. Self-host via Fontsource only. No CDN <script> or <link> tags and no import maps pointing to CDNs: three.js is installed from npm and bundled.
- No source maps in the production build (build.sourcemap: false) and no src/ in dist/. Relative asset paths only (Vite base './'). Every internal link points to ./index.html or an in-page element, never a bare directory.
- Do not change the stack (Vite + TypeScript + three.js + plain CSS + Fontsource) unless the user asks. No React, no Tailwind, no UI kits, no postprocessing libraries.
- No sound or audio of any kind, and no autoplaying media.
- Do not use the name 'Nocturne', the phrases 'An endless archive', 'Twenty works, four rooms', 'Lighting the rooms', 'Headphones optional' or 'Opening the doors', or any invented project titles, clients or procedurally painted artworks from other gallery demos. All titles here are the real titles of the 24 photographs.
- Do not use Instrument Serif, Inter Tight or JetBrains Mono. Use only Cormorant Garamond, Hanken Grotesk and IBM Plex Mono.
- Albumen (#c99a5b) is the only accent and only for small details. No gradients other than the vignette and the detail-view legibility gradient, no neon, no glassmorphism, no rounded cards, no emoji.
- No dependencies outside MIT, ISC, BSD, Apache-2.0, 0BSD, CC0 or Unlicense (OFL for fonts). No Aceternity UI, Tailwind Plus / Tailwind UI or purchased template code; write every effect from scratch.
- Respect prefers-reduced-motion exactly as described (no inertia, bend, FOV kick, auto-walk, animated grain or dust; crossfades instead of flights).
- Must work at 1440×900 and 390×844 with zero console errors, no page scrollbars on the gallery view, and every control reachable by keyboard with a visible 1px Albumen focus ring. Dispose nothing that is still in use; the render loop pauses while the tab is hidden.
- Keep dist/ under 20 MB. No extra bitmaps beyond the 24 photographs and the favicon.
- No mention of the template source inside the site except the optional [CREDIT] link. No lorem ipsum, no invented facts about the photographs beyond the captions given here.
---
Inspired by Nocturne — an endless 3D corridor gallery (Opus 5.5 showcase by @ohmiler) by @ohmiler — https://ohmiler.github.io/opus-5.5/infinite-gallery/
— Prompt by VibeFather · https://vibefather.ai/t/3d-photo-gallery · CC BY-NC 4.0 (non-commercial; commercial use needs a VibeFather Pro license) · Request removal: https://vibefather.ai/takedown
中文参考译文(帮助理解,复制给 AI 时请用上面的英文原版)
# 3D 照片画廊
完全按照以下描述构建此网站。将 [VARIABLES] 替换为你自己的值;其余内容保持不变。
## 简介
为 [BRAND] 打造的一场沉浸式在线展览:二十四张真实的公共领域照片以装裱平面的形式,悬挂在 WebGL 中一条无尽的黑暗走廊两侧。访客通过滚动、拖拽或滑动来前进和后退;走廊首尾相接,因此漫步永无止境。作品被分为四个具名展厅([ROOMS]),每个展厅由悬浮于黑暗中的巨大斜体展厅标题宣告。点击一张照片,相机会飞升至该照片处,并打开一个宽银幕画幅的详情视图,其中包含完整图注、来源、致谢与许可信息;由此再进入一个 2D 灯箱,可查看完整图像并缩放。一层纤薄的 HUD 框住屏幕:品牌、当前展厅、滚动作品计数器、进度轨道,以及 Index 与 About 面板。单页应用,无后端,每张图像都下载到项目中并注明出处。
- 受众:小型摄影档案馆或博物馆的访客,他们希望慢慢浏览一个收藏系列;此外还有摄影师、策展人和档案馆,他们正在寻找一种令人难忘的方式来展示一组 15–40 张图像。
- 目标:让浏览收藏系列的感觉如同漫步于一座安静的画廊,同时每张图像都始终配有恰当的图注和致谢信息:标题、创作者、日期、工艺、收藏与许可,一键即得。
- 基调:安静、精确、具策展气质。简短的事实性图注,不使用感叹号,不使用营销语言。标签读起来如同博物馆墙上的说明文字。
## 技术栈
- 框架:Vite 5 + TypeScript + three.js
- 样式:纯 CSS,自定义属性
- 库:three(MIT)、@types/three(dev)(MIT)、vite(MIT)、typescript(Apache-2.0)、@fontsource/cormorant-garamond(OFL-1.1)、@fontsource-variable/hanken-grotesk(OFL-1.1)、@fontsource/ibm-plex-mono(OFL-1.1)
- 构建:`npm run build` → 静态文件输出到 `dist/`。无后端、无服务端代码、无外部 API。
- 设置:
- 使用 vanilla-ts 模板通过 npm create vite@latest 搭建脚手架。不使用 UI 框架。单页面:index.html 加 src/main.ts。
- vite.config.ts:base './',build { outDir: 'dist', sourcemap: false, assetsInlineLimit: 0 }。不要将 src/ 复制到 dist/。
- 文件布局:src/content.ts(品牌字符串、房间、24 件作品及其所有说明字段、About 文案)、src/scene/(Renderer.ts、CameraRig.ts、Corridor.ts、WorkPlane.ts、RoomTitle.ts、Dust.ts、shaders.ts)、src/ui/(Loader.ts、Hud.ts、Panel.ts、Detail.ts、Lightbox.ts、Cursor.ts、Fallback.ts)、src/styles.css。
- 字体:在 src/main.ts 中导入 '@fontsource/cormorant-garamond/400-italic.css'、'@fontsource/cormorant-garamond/500-italic.css'、'@fontsource/cormorant-garamond/500.css'、'@fontsource-variable/hanken-grotesk' 以及 '@fontsource/ibm-plex-mono/400.css'、'@fontsource/ibm-plex-mono/500.css'。在绘制任何 canvas 文本之前,先 await document.fonts.load 加载 'italic 400 64px "Cormorant Garamond"' 和 '400 32px "IBM Plex Mono"'。
- 24 张照片存放在 public/photos/ 下,文件名与 Assets 中的完全一致,并使用相对路径引用('./photos/01-effect-of-the-sun.jpg')。在构建前于项目根目录编写 ASSETS.md。
- 所有颜色作为 CSS 自定义属性定义在 src/styles.css 的 :root 中;相同的十六进制值从 src/content.ts 或一个小的 src/theme.ts 导入到 three.js 代码中。
- dist/ 包含 index.html、带哈希的 JS/CSS、woff2 字体、favicon.svg 和 24 张 JPEG(总计约 12 MB)。保持在 20 MB 以下。
## 变量
- [BRAND] — 档案馆、博物馆或工作室名称(默认:"Halvard Archive")。以斜体字标形式显示在左上角、加载器、<title> 和关于面板中。
- [EXHIBITION] — 展览或收藏标题(默认:"First Light")。一到三个词。在加载器中以大字显示,并显示在字标下方。
- [COLLECTION_NOTE] — 收藏的一句话描述(默认:"Early photographs of water, stone, leaf and sky, 1841–1900")
- [ROOMS] — 四个展厅名称,按参观顺序排列(默认:"Tide, Stone, Leaf, Sky")。恰好四个单词。作品 01–06 挂在第一个展厅,07–12 挂在第二个,13–18 挂在第三个,19–24 挂在第四个。
- [VISIT_LINE] — 实用信息行:地址、开放时间或票价(默认:"Reading room: 9 Cinder Wharf, Port Aldery · Thu–Sun 11:00–17:00 · Free entry")
- [CREDIT] — 在页脚保留一个小型 "Template by VibeFather" 链接,指向 https://vibefather.ai/t/3d-photo-gallery(默认:是;删除此行即可移除)
页面与区块下的文案是为默认值编写的。如果你的值不同,请为它们重写每个标题、段落、标签和图片——保持相同的长度、语气和结构。布局、颜色、字体和动效保持所述不变。
将所有文案、图片路径和链接放在一个内容文件中(例如 `src/content.ts`),按区块作为键,以便之后无需改动组件即可替换内容。
## 设计
### 颜色
- Void(虚空)`#0b0a09` — 页面与场景背景、雾色、加载器背景
- Soot(煤烟)`#15130f` — 索引与关于面板、移动端详情页、回退页面
- Frame(画框)`#2a241d` — 每张照片背后的细框平面
- Bone(骨白)`#ece4d6` — 主文本、房间标题、光标环、尘埃粒子
- Ash(灰烬)`#8f877a` — 次要文本、等宽标签、日期、非活动控件
- Hairline(细线)`rgba(236,228,214,0.14)` — 1px 分隔线、进度轨道、面板边框
- Albumen(蛋清)`#c99a5b` — 唯一强调色:进度填充、光标点、活动索引数字、焦点环、按钮中的小圆点。绝不用于大面积填充或正文文本。
- Letterbox(黑边)`#000000` — 详情视图的黑边条与灯箱背景(96% 不透明度)
### 字体排印
- 展示字体(字标、房间标题、作品标题):Cormorant Garamond(OFL),字重 400/500
- 文本字体(说明文字、面板、按钮):Hanken Grotesk(OFL),字重 400/500
- 等宽微型标签(计数器、房间标签、提示、署名):IBM Plex Mono(OFL),字重 400/500
### 布局与动效
- 间距:HUD 位于固定的内嵌框架上:宽度 ≥ 900px 时距各边缘 28px,以下为 18px。面板使用 40px 内边距(移动端 24px)。等宽标签为 11px 大写,字距 0.16em。详情文本列从左侧 6vw 开始,最大宽度 520px。文本块中的垂直节奏为 8px 的倍数(8、16、24、40)。
- 圆角:所有地方均为 0(框架、面板、图像、灯箱)。仅胶囊按钮使用 999px,光标环为圆形。
- 动效:缓动:入场 cubic-bezier(.2,.8,.2,1);面板与黑边 cubic-bezier(.7,0,.2,1);相机飞行 easeInOutCubic。阻尼辅助函数 damp(a, b, λ, dt) = a + (b − a)·(1 − e^(−λ·dt)) 驱动每一个连续值。
- 动效:惯性行走:滚轮、拖拽和滑动写入滚动目标;相机以阻尼 λ 5 追随它,并在释放后保持动量(速度按 e^(−3.5·dt) 衰减)。
- 动效:速度弯曲:相机移动时,照片平面沿其宽度略微弯曲(uBend = clamp(speed × 0.02, −0.35, 0.35)),停止时变平。
- 动效:指针视差:相机在 x 方向偏移最多 0.25 单位、y 方向最多 0.15 单位,并朝指针方向旋转最多 0.04 rad,阻尼 λ 3。
- 动效:相机在 1.2 s 内飞向一张照片,并伴随 FOV 冲击(中点时 +8°),其他作品在 0.6 s 内变暗至 12% 亮度。
- 动效:滚动数字:每个数字是一条被遮罩的垂直 0–9 条带,在 0.6 s 内滑到新值;房间名称在 0.5 s 内通过遮罩向上滑出再滑入。
- 动效:加载器快门:加载器分成上下两半,在 0.9 s 内滑出屏幕,随后 HUD 元素上移 12px 并以 80ms 的错峰淡入,作品由近及远依次显现。
- 动效:胶片颗粒叠加层每秒步进 8 个偏移;尘埃缓慢飘移。prefers-reduced-motion:无惯性(λ 14,无动量)、无弯曲、无 FOV 冲击、无自动行走、静态颗粒与尘埃、相机跳转替换为 0.35 s 交叉淡入、滚动数字即时切换。
- 图像:仅使用真实的十九世纪照片:24 张来自 The Cleveland Museum of Art Open Access 的 CC0 图像,保留其原始的暖调蛋清、盐纸、蓝晒和彩色照片色调。无调色、无滤镜、无裁剪:每个平面使用图像的自然宽高比。其他一切(框架、标签、房间标题、尘埃、颗粒、暗角、光标、favicon)均由代码绘制。无肖像,无标志。
## 页面与区块
### 画廊(单页)(`index.html`)
1. **文档** — <title>[BRAND] — [EXHIBITION]</title>,lang 'en',theme-color #0b0a09,color-scheme dark。Favicon public/favicon.svg:一个 32×32 的方形,颜色 #0b0a09(rx 6),中心有一个 r 8 的圆,描边 #c99a5b、2px,圆心有一个填充的 #c99a5b 圆点 r 2.5,形如光圈。body 为 overflow hidden,高度 100dvh,背景 Void,舞台上的 user-select none。
布局:<main> 内的 DOM 顺序:#stage(canvas 容器,fixed inset 0)、.vignette、.grain、header.hud、aside#index、aside#about、section#detail(role dialog)、div#lightbox(role dialog)、div#loader、div#cursor、section#fallback(隐藏)。一个 H1,视觉隐藏,内容为 '[BRAND] — [EXHIBITION]'。
2. **加载器** — 左上角:'[BRAND]',Cormorant Garamond italic 500,28px,Bone。居中:'[EXHIBITION]',Cormorant Garamond italic 400,clamp(72px, 13vw, 210px),line-height 0.9,Bone,居中。其下,mono 11px Ash:'HANGING PLATES 014 / 024',其中第一个数字统计实际已加载的纹理数(零填充至三位)。左下角 mono 11px Ash:'[COLLECTION_NOTE]'。右下角 mono 11px Ash:'Drag, scroll or swipe'。
布局:固定全屏,背景 Void,z-index 高于一切。一条 1px Hairline 线在 50% 高度处横跨全宽,位于标题后方;一条 Albumen 1px 线在其上从左向右随加载进度增长(宽度 = loaded / 24)。
动效:展览标题逐字母进入:每个字母在一个 overflow-hidden 行内从 110% 升至 0,40ms 错峰,0.8s。当全部 24 个纹理加载完毕且进度线到达 100% 后,保持 300ms,然后加载器分裂:上半部分平移至 −100%,下半部分平移至 +100%(两个堆叠的 div,各自包含一半内容,无需 clip-path),0.9s cubic-bezier(.7,0,.2,1)。过渡结束后从 DOM 中移除加载器。减少动效:无字母动画,普通 0.4s 淡出。
3. **3D 走廊(场景)** — three.js WebGLRenderer(antialias true,alpha false),像素比桌面端 min(devicePixelRatio, 2),视口宽度小于 900px 时 min(devicePixelRatio, 1.75),outputColorSpace SRGBColorSpace,无色调映射,清除色 #0b0a09。PerspectiveCamera FOV 45(aspect < 0.8 时为 55),near 0.1,far 80,起始于 (0, 0, 0) 朝 −z 方向看。走廊布局常量:作品间距 3.2 单位,房间长度 25.2,循环长度 L = 100.8。房间 r(0–3)的偏移 O = r × 25.2;其房间标题位于 z = −(O + 3);其作品 k(0–5)位于 z = −(O + 7 + k × 3.2)。作品 k 的每房间偏移:x = [−1.6, 1.45, −1.35, 1.7, −1.5, 1.4][k],y = [0.12, −0.18, 0.22, −0.08, 0.05, −0.2][k],rotation.y = −sign(x) × 0.12(每件作品略微转向走廊中心)。当 aspect < 0.8 时,x 乘以 0.42,平面尺寸乘以 0.8。
布局:无限循环:每件作品、房间标题和尘埃粒子都保持一个基础 z;每帧其渲染 z = camZ + rel,其中 rel = ((baseZ − camZ − 4) mod L + L) mod L − L + 4,因此物体保持在相机前方 L − 4 单位到后方 4 单位之间。每件作品是一个 THREE.Group,包含:一个边框平面(Frame 颜色,MeshBasicMaterial,尺寸 w + 0.08 × h + 0.08,z −0.01);照片平面(PlaneGeometry w × h,24×1 分段,移动端 16×1,自定义 ShaderMaterial);以及一个博物馆标签平面,位于边框底边下方 0.18 单位,与其左对齐:一张 1024×128 的 canvas 纹理,mono 34px Ash '07',然后 48px 后,Cormorant italic 52px Bone 短标题,绘制在透明背景上,平面宽度 1.4 单位。照片尺寸:h = 1.7,w = 1.7 × imageAspect;若 w > 2.3 则 w = 2.3,h = 2.3 / imageAspect。照片着色器 uniforms:uTex、uReveal(0–1)、uDim(1 = 正常)、uHover(0–1)、uBend、uFogColor #0b0a09、uFogNear 6、uFogFar 34。顶点:position.z += sin(uv.x × π) × uBend × w × 0.25;传递视图深度。片元:color = texture × uDim × (1 + uHover × 0.08);按 smoothstep(uFogNear, uFogFar, depth) 向 uFogColor 混合;alpha = uReveal。纹理:TextureLoader,colorSpace SRGBColorSpace,anisotropy min(8, renderer max),开启 mipmaps。仅对照片平面进行 Raycast。
动效:相机装置:滚动目标 s(正值 = 前进),位置 p,速度 v。滚轮:s += deltaY × 0.01(deltaMode 1 → × 16,deltaMode 2 → × innerHeight)。舞台上的指针拖拽:s += (clientY − lastY) × 0.018(触摸为 0.03),平移 x 目标 −= (clientX − lastX) × 0.003,限制在 ±1.1(aspect < 0.8 时为 ±0.5);释放时,v = 最后 100ms 的平均拖拽速度,平移目标以 λ 1.5 缓动回 0。每帧:s += v·dt,v *= e^(−3.5·dt),p = damp(p, s, 5, dt);相机 z = −p,相机 x = pan + pointerX × 0.25,相机 y = pointerY × 0.15,rotation.y = −pointerX × 0.04,rotation.x = pointerY × 0.03。按键:ArrowDown / PageDown / S = s + 3.2;ArrowUp / PageUp / W = s − 3.2;Enter 打开当前作品;I 切换 Index;Esc 关闭最顶层覆盖层。自动行走:6s 无输入且无覆盖层打开后,s += 0.25·dt 直到下一次输入。悬停:当指针位于照片平面上方时,其 uHover 缓动至 1,其 group 缩放至 1.035(damp λ 8)。加载器之后的入场:作品由近及远显现,uReveal 0→1,y 偏移 −0.3→0,历时 0.8s,90ms 错峰。pointerup 仅在自 pointerdown 以来指针移动小于 6px 时才计为点击。
4. **房间标题** — 每个房间一个浮动标题,按顺序:'ROOM I' / 'Tide'、'ROOM II' / 'Stone'、'ROOM III' / 'Leaf'、'ROOM IV' / 'Sky'(名称来自 [ROOMS])。每个名称下方,mono 30px Ash:'SIX PHOTOGRAPHS'。
布局:每个标题是一个 8 × 3 单位的平面,位于 x 0、y 0.4,面向相机,纹理为 2048 × 768 透明 canvas:mono 500 40px Bone,0.3em 字距 'ROOM II' 居中于 y 150;Cormorant Garamond italic 400 360px Bone 房间名居中于 y 520;mono 30px Ash 'SIX PHOTOGRAPHS' 居中于 y 690。MeshBasicMaterial transparent,depthWrite false。当 aspect < 0.8 时,平面缩放至 0.55。
动效:不透明度来自标题的 rel z:超过 −22 为 0,在 −12 处升至 0.92,保持,然后在 −3 到 −0.5 之间降至 0。详情视图打开时,所有房间标题在 0.5s 内淡至 0。
5. **HUD** — 左上角:'[BRAND]'(Cormorant italic 500,30px,Bone),其下 8px 间距,mono 11px 大写 Ash,0.16em 字距:第一行 '[EXHIBITION]',第二行 '[COLLECTION_NOTE]'(max-width 300px)。顶部居中:mono 11px Ash 'NOW IN ROOM' 位于一行之上,该行包含一个滚动的罗马数字(mono 13px Bone)、一个 '· ' 分隔符和房间名(Cormorant italic 24px Bone,例如 'II · Stone')。右上角:两个文本按钮,mono 12px 大写 Bone,间距 24px:'Index (24)' 和 'About'。左下角:滚动计数器,mono 13px Bone '07' 加 Ash ' / 24',然后是当前短标题(Cormorant italic 26px Bone),然后是作者和日期(Hanken Grotesk 13px Ash,'Timothy H. O'Sullivan, c. 1871')。底部居中:一条 32px Hairline 线,后接 mono 11px Ash 'Scroll or drag to walk · Click a photograph to look closer'(触摸设备:'Swipe to walk · Tap a photograph to look closer')。右下角:进度轨道,其下 mono 10px Ash 'Images: The Cleveland Museum of Art · CC0',若保留则后接 [CREDIT] 链接;此右下角行为页面页脚。
布局:header.hud 为 fixed inset 0,pointer-events none(其按钮和链接重新启用)。各元素绝对定位于 28px 内缩边框上(900px 以下为 18px)。当前作品是其渲染 z 最接近 camZ − 4 的作品;当前房间是该作品所属房间。进度轨道:140px × 1px Hairline,带 Albumen 填充,宽度 = (p mod L) / L,四个 1px × 6px Hairline 刻度位于房间起点(0%、25%、50%、75%),刻度下方 mono 10px Ash 数字 I II III IV。900px 以下:顶部居中房间块隐藏,其内容并入左下角为 'II · Stone — 07 / 24';提示移至左下角上方;轨道宽 72px;左上角仅显示字标(24px)和展览标题。
动效:计数器数字和房间数字使用滚动数字;当前作品变化时,标题和作者行以 6px 上滑交叉淡入淡出,0.4s。文本按钮悬停时获得一条 1px Albumen 下划线,从左向右增长,0.3s。底部居中提示在相机行进 6 单位后永久淡出。详情视图或灯箱打开时,HUD 在 0.4s 内淡至不透明度 0。
6. **索引面板** — 头部:'Index',Cormorant italic 400,44px,Bone,右侧一个 mono 12px 大写 'Close ×' 按钮。然后四个分组,每组以 mono 11px Ash 'ROOM I — TIDE' 为标题(数字和房间名来自 [ROOMS]),列出该房间的六件作品。每行:零填充数字(mono 12px Ash)、短标题(Hanken Grotesk 500 15px Bone)、日期(mono 12px Ash 右对齐)。
布局:aside#index 固定在右侧,全高,宽度 440px(900px 以下为 100vw),背景 Soot,左侧 1px Hairline 边框,40px 内边距(移动端 24px),自身垂直滚动。行是 3 列网格(40px、1fr、auto),垂直内边距 12px,底部 1px Hairline 边框。打开时,画布变暗:每张照片的 uDim 缓动至 0.4。
动效:从 translateX(100%) 滑入到 0,时长 0.55s,cubic-bezier(.7,0,.2,1);行以 25ms 错峰淡入上移 8px。行悬停:标题右移 6px,编号变为 Albumen(0.25s)。点击一行关闭面板,设置滚动目标,使作品的渲染 z 最终位于 camZ − 4.5(沿环路取较短方向),并在 |p − s| < 0.05 或 1.4s 后(以先到者为准)打开详情视图。
7. **关于面板** — 页眉:'About' 使用 Cormorant 斜体 44px,带 'Close ×'。第 1 段(Hanken 16px/1.6 Bone):'[BRAND] is a small independent archive of nineteenth-century photography. [EXHIBITION] hangs twenty-four photographs made between 1841 and 1900 along a corridor that never ends: walk it in either direction and the rooms come round again.' 第 2 段(Ash):'Every image here comes from the Open Access collection of The Cleveland Museum of Art and is dedicated to the public domain under CC0. Captions give the maker, date, process and fund that acquired each print; follow "Source record" in any detail view for the full museum entry.' 然后是一条 1px Hairline 和一个定义列表,标签为 mono 11px Ash,值为 Hanken 15px Bone:'Visit' → '[VISIT_LINE]';'Write' → '[email protected]' 作为 mailto 链接;'Keys' → '↑ ↓ walk · Enter look closer · I index · Esc close'。底部:mono 10px Ash 'Images: The Cleveland Museum of Art · CC0' 以及保留时的 [CREDIT] 链接。
布局:与 Index 面板相同的壳、尺寸和行为(aside#about)。Index 和 About 同一时间只能打开一个。
动效:与 Index 面板相同。
8. **详情视图** — 对于聚焦的作品:kicker 使用 mono 11px Ash 'ROOM II — STONE · 07 / 24';完整标题使用 Cormorant Garamond 斜体 400,clamp(40px, 4.6vw, 76px),行高 0.95,Bone(允许长标题换行;超过 70 个字符的标题使用 clamp(30px, 3vw, 48px));制作者使用 Hanken Grotesk 500 18px Bone;说明文字使用 Hanken 400 16px/1.6 Ash,最大 40ch;一个四行的定义列表,标签为 mono 11px 大写 Ash,值为 Hanken 14px Bone:'Date'、'Process'、'Collection'('The Cleveland Museum of Art, ' + fund)、'License'('CC0 1.0 — free to reuse')。按钮:一个胶囊形 'View full image'(1px Bone 边框,mono 12px 大写,标签前有一个 6px Albumen 圆点,高 44px,水平内边距 20px)和一个文本链接 'Source record ↗' 指向作品的博物馆记录(target _blank,rel noopener noreferrer)。右上角 'Close ×';左下角 '← Previous',右下角 'Next →'(mono 12px 大写 Bone,位于 letterbox 条内)。
布局:section#detail 固定 inset 0,透明,覆盖在画布上。两条黑色 Letterbox 条,顶部和底部,各高 8vh。桌面端:文本列位于左侧 6vw,垂直居中,最大宽度 520px,其后方从左侧边缘的 rgba(11,10,9,0.85) 到 50vw 处透明的柔和渐变,以保证可读性。相机将照片取景在中心偏右。900px 以下:无底部条;文本位于底部抽屉(52vh,Soot 94% 不透明度,顶部 1px Hairline 边框,24px 内边距,内部滚动),照片取景在上半部分。焦点被限制在对话框内;Esc 关闭;← / → 前往上一个 / 下一个。
动效:打开作品时:快照自由相机姿态,然后在 1.2s 内(easeInOutCubic)飞到照片前方沿其朝向法线 2.2 × max(h / 1.7, w / 2.3) 单位处(900px 以下 × 1.5),桌面端看向照片中心左移 0.6 单位处(照片出现在中心偏右),移动端下移 0.45 单位处(照片出现在上半部分)。飞行期间 FOV = base + 8 × sin(π t)。其他作品的 uDim 在 0.6s 内缓动至 0.12。飞行到 65% 时,letterbox 条从屏幕边缘缩放进入(scaleY 0→1,0.6s),kicker 和元信息淡入,标题的单词在遮罩中从 100% 上升到 0,错峰 60ms。打开期间,滚轮和垂直拖拽不行走;水平拖拽超过 80px 或 ← / → 飞到相邻作品(0.9s),文本以 0.3s 交叉淡入淡出切换;向下滚轮总计超过 120px 或 Close 在 1.0s 内飞回保存的自由姿态,同时覆盖层在 0.3s 内淡出,uDim 恢复为 1。减少动效:无飞行;相机在覆盖层 0.35s 交叉淡入淡出后切换到取景姿态。
9. **灯箱** — 来自 public/photos/ 的完整照片作为带有其 alt 文本的 <img>。底部说明栏使用 mono 11px Ash:'07 — Iceberg Canyon, Colorado River Looking Above · Timothy H. O'Sullivan · c. 1871 · The Cleveland Museum of Art · CC0'。右上角 mono 12px 'Close ×';左右边缘按钮 '←' 和 '→'(48px 方形点击区域)。左上角 mono 10px Ash 提示:'Click to zoom'。
布局:div#lightbox 固定 inset 0,背景 rgba(0,0,0,0.96),图像居中,最大 92vw × 84vh,object-fit contain,无边框。从详情视图中的 'View full image' 以及回退目录中的任何 figure 打开。焦点被限制,Esc 关闭,← / → 在所有 24 个作品间切换图像。
动效:打开时背景在 0.3s 内淡入,图像在 0.35s 内从 0.94 缩放到 1,不透明度 0→1。点击图像以点击点为中心切换 2× 缩放(transform 过渡 0.35s);缩放时,拖拽平移图像,限制在其边缘。切换图像在 0.25s 内交叉淡入淡出。减少动效:仅淡入淡出,缩放无过渡。
10. **光标与氛围** — 自定义光标(仅 pointer: fine 设备,舞台上方隐藏原生光标):一个 36px 圆环,1px rgba(236,228,214,0.5) 边框,中心有一个 4px Albumen 圆点,环内有一个 mono 10px 大写 Bone 标签。在照片上方,圆环增大到 72px 并显示 'Look';拖拽时压缩为 44 × 28px 并显示 'Walk';在按钮和链接上方缩小到 20px,无标签。氛围覆盖层:.vignette = radial-gradient(ellipse at center, transparent 55%, rgba(0,0,0,0.65) 100%);.grain = 内联 SVG feTurbulence 噪声(baseFrequency 0.9,numOctaves 2)作为 data URI,以 180px 平铺,不透明度 0.07,mix-blend-mode overlay。尘埃:600 个 THREE.Points 位于相对于相机的盒子 x ±6、y ±3、z 从 −30 到 +2(像作品一样环绕),大小 0.018 带大小衰减,Bone 不透明度 0.35,depthWrite false。
布局:光标、vignette 和 grain 是固定的全屏层,pointer-events none;光标位于除加载器外的所有覆盖层之上。在触摸设备上以及指针离开窗口时隐藏光标元素。
动效:圆环以阻尼 λ 12 跟随指针,圆点以 λ 30;大小变化耗时 0.3s。Grain 每秒在 8 个预设背景偏移之间跳变 8 次(steps)。尘埃粒子在 y 方向以 sin(time × 0.2 + index) × 0.04 上下浮动。减少动效:grain 和尘埃静止,圆环即时跟随。
11. **回退目录** — 仅在 WebGL 不可用或场景设置抛出异常时显示。页眉:'[BRAND]' 字标,'[EXHIBITION]' 使用 Cormorant 斜体 clamp(56px, 9vw, 140px),'[COLLECTION_NOTE]' 使用 mono 11px Ash,以及一行 'This browser cannot open the walk-through, so here is the catalogue.' 使用 Hanken 15px Ash。然后是四个房间,每个都有其 mono 'ROOM I — TIDE' 标题和六个 figure:照片,然后是一个 figcaption,包含编号(mono)、短标题(Cormorant 斜体 24px)、制作者和日期(Hanken 14px Ash),以及 'The Cleveland Museum of Art · CC0'(mono 10px Ash)。
布局:section#fallback 替换加载器和舞台;body 滚动。最大宽度 1200px,居中,两侧内边距 40px(移动端 20px)。每个房间是 3 列网格,间距 32px(700px 以下 1 列);图像保持其自然宽高比,loading lazy。点击 figure 打开灯箱。[CREDIT] 链接位于底部,与图像署名一起。
动效:figure 进入视口时淡入上移 12px(IntersectionObserver,0.6s)。减少动效下无。
## 资产
- 字体:通过 Fontsource 自托管:@fontsource/cormorant-garamond(400 斜体、500 斜体、500)、@fontsource-variable/hanken-grotesk(可变字体,使用 400 和 500)、@fontsource/ibm-plex-mono(400、500),在 src/main.ts 中导入。CSS 字体族:'Cormorant Garamond'、'Hanken Grotesk Variable'、'IBM Plex Mono',各自带有 serif / sans-serif / monospace 回退。Vite 将 woff2 文件打包进 dist/。
- 图标:不使用图标库。箭头和关闭符号是 IBM Plex Mono 中的文本字形(←、→、↑、↓、↗、×)。public/favicon.svg 按文档中所述手写。
- 图像:在代码中绘制,不使用文件:画框、博物馆标签和展厅标题(canvas 纹理)、尘埃(THREE.Points)、胶片颗粒(内联 SVG data URI)、暗角(CSS 渐变)、光标(CSS)。
- 图像:以下 24 张照片是来自克利夫兰艺术博物馆开放获取的 CC0 图像。用 curl 将每张下载到 public/photos/ 下,使用确切的文件名,构建前检查全部 24 张是否存在,绝不热链。将每个说明字段(编号、展厅、短标题、完整标题、创作者、日期、工艺、收藏、许可、记录 URL、alt、说明)按原文原样放入 src/content.ts。在项目根目录写入 ASSETS.md,每张照片一行:路径、源图像 URL、记录 URL、作者(创作者)、许可 'CC0 1.0 — The Cleveland Museum of Art Open Access'。同时列出三个 Fontsource 包(OFL-1.1)和 three.js(MIT)。
- 图像:作品 01(展厅 I,潮汐)。下载 https://openaccess-cdn.clevelandart.org/1987.54/1987.54_web.jpg 到 public/photos/01-effect-of-the-sun.jpg(1165×893 JPEG,保持原样)。短标题:"An Effect of the Sun"。完整标题:"An Effect of the Sun, Normandy"。创作者:Gustave Le Gray。日期:c. 1856。工艺:Albumen print from wet collodion negative。收藏:The Cleveland Museum of Art, Andrew R. and Martha Holden Jennings Fund。许可:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/1987.54。Alt:"Sun breaking through heavy clouds above a flat, glittering seashore"。说明:"Sun breaks through heavy cloud over a flat, glittering shore. The horizon sits low, so the sky does most of the work." 用途:走廊平面 01、详情视图、灯箱、索引行和回退目录。
- 图像:作品 02(展厅 I,潮汐)。下载 https://openaccess-cdn.clevelandart.org/1991.292/1991.292_web.jpg 到 public/photos/02-great-upper-waterfall.jpg(703×893 JPEG,保持原样)。短标题:"Great Upper Waterfall"。完整标题:"Great Upper Waterfall, High Alps"。创作者:Louis-Alphonse Davanne。日期:c. 1862。工艺:Albumen print from wet collodion negative。收藏:The Cleveland Museum of Art, Gift of Russ Anderson。许可:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/1991.292。Alt:"A tall waterfall dropping through dark pine trees, a wooden railing in the foreground"。说明:"A waterfall drops through dark pines in one long white ribbon; a wooden railing crosses the foreground." 用途:走廊平面 02、详情视图、灯箱、索引行和回退目录。
- 图像:作品 03(展厅 I,潮汐)。下载 https://openaccess-cdn.clevelandart.org/2006.4/2006.4_web.jpg 到 public/photos/03-winter-trees-pond.jpg(1034×893 JPEG,保持原样)。短标题:"Winter Trees Reflected in a Pond"。完整标题:"Winter Trees Reflected in a Pond"。创作者:William Henry Fox Talbot。日期:1841–42。工艺:Salted paper print from calotype negative。收藏:The Cleveland Museum of Art, Purchase from the J. H. Wade Fund。许可:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/2006.4。Alt:"Bare winter trees on a bank, mirrored upside down in a still pond"。说明:"Bare winter trees stand on the far bank and again, upside down, in the still pond below." 用途:走廊平面 03、详情视图、灯箱、索引行和回退目录。
- 图像:作品 04(展厅 I,潮汐)。下载 https://openaccess-cdn.clevelandart.org/1997.44.a/1997.44.a_web.jpg 到 public/photos/04-river-landscape-scotland.jpg(1120×893 JPEG,保持原样)。短标题:"River Landscape, Scotland"。完整标题:"River Landscape, Scotland"。创作者:Captain Horatio Ross。日期:c. 1858。工艺:Albumen print from wax paper negative。收藏:The Cleveland Museum of Art, John L. Severance Fund。许可:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/1997.44.a。Alt:"A calm river bending between steep wooded banks and dark rocks"。说明:"A quiet river bends between steep wooded banks and dark rocks, its surface smoothed to a pale sheet." 用途:走廊平面 04、详情视图、灯箱、索引行和回退目录。
- 图像:作品 05(展厅 I,潮汐)。下载 https://openaccess-cdn.clevelandart.org/1990.33/1990.33_web.jpg 到 public/photos/05-miners-bridge.jpg(1048×893 JPEG,保持原样)。短标题:"The Miners' Bridge"。完整标题:"The Miners' Bridge, on the Llugwy, North Wales"。创作者:Roger Fenton。日期:1857。工艺:Albumen print from wet collodion negative。收藏:The Cleveland Museum of Art, Andrew R. and Martha Holden Jennings Fund。许可:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/1990.33。Alt:"A slanting plank footbridge over a rocky stream below a wooded hillside"。说明:"A plank footbridge slants across a rocky stream under a wooded hillside." 用途:走廊平面 05、详情视图、灯箱、索引行和回退目录。
- 图像:作品 06(展厅 I,潮汐)。下载 https://openaccess-cdn.clevelandart.org/1997.47/1997.47_web.jpg 到 public/photos/06-city-island.jpg(1262×893 JPEG,保持原样)。短标题:"City Island"。完整标题:"City Island, New York"。创作者:Arthur Wesley Dow。日期:c. 1900。工艺:Cyanotype。收藏:The Cleveland Museum of Art, John L. Severance Fund。许可:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/1997.47。Alt:"A beached rowboat, a board fence and leafless trees, printed in deep blue"。说明:"A beached rowboat, a board fence and leafless trees, printed in the deep blue of a cyanotype." 用途:走廊平面 06、详情视图、灯箱、索引行和回退目录。
- 图像:作品 07(展厅 II,石)。下载 https://openaccess-cdn.clevelandart.org/2002.46/2002.46_web.jpg 到 public/photos/07-iceberg-canyon.jpg(1111×893 JPEG,保持原样)。短标题:"Iceberg Canyon"。完整标题:"Iceberg Canyon, Colorado River Looking Above"。创作者:Timothy H. O'Sullivan。日期:c. 1871。工艺:Albumen print from wet collodion negative。收藏:The Cleveland Museum of Art, John L. Severance Fund。许可:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/2002.46。Alt:"Dark canyon walls sloping down to a calm river, a tiny seated figure on the rocks"。说明:"Dark canyon walls slope down to a calm stretch of river; a small seated figure on the rocks gives the scale." 用途:走廊平面 07、详情视图、灯箱、索引行和回退目录。
- 图像:作品 08(展厅 II,石)。下载 https://openaccess-cdn.clevelandart.org/2024.6.gg/2024.6.gg_web.jpg 到 public/photos/08-river-gorge.jpg(900×599 JPEG,保持原样)。短标题:"The River Gorge"。完整标题:"The River Gorge"。创作者:John Burke。日期:1878–80。工艺:Albumen print。收藏:The Cleveland Museum of Art, Mr. and Mrs. Richard W. Whitehill Art Purchase Endowment Fund。许可:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/2024.6.gg。Alt:"A wide braided river running out between bare hills under a pale sky"。说明:"A wide, braided river runs out between bare hills under a pale, empty sky." 用途:走廊平面 08、详情视图、灯箱、索引行和回退目录。
- 图像:作品 09(展厅 II,石)。下载 https://openaccess-cdn.clevelandart.org/1987.130/1987.130_web.jpg 到 public/photos/09-bridge-of-palalda.jpg(900×658 JPEG,保持原样)。短标题:"The Bridge of Palalda"。完整标题:"The Bridge of Palalda (near Amélie-les-Bains)"。创作者:Gustave Le Gray。日期:1851–52。工艺:Salted paper print from waxed-paper negative。收藏:The Cleveland Museum of Art, John L. Severance Fund。许可:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/1987.130。Alt:"An old stone arch bridge over a boulder-strewn stream below a dry hillside"。说明:"An old stone arch spans a boulder-strewn stream at the foot of a dry hillside." 用途:走廊平面 09、详情视图、灯箱、索引行和回退目录。
- image: Work 10(Room II,Stone)。将 https://openaccess-cdn.clevelandart.org/2004.32/2004.32_web.jpg 下载到 public/photos/10-troglodyte-farm.jpg(671×893 JPEG,保持原样)。短标题:"Behind the Troglodyte Farm"。完整标题:"Behind the Troglodyte Farm"。创作者:Henri Le Secq。日期:c. 1853。工艺:Salted paper print from waxed paper negative。收藏:The Cleveland Museum of Art, Norman O. Stone and Ella A. Stone Memorial Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/2004.32。替代文本:"A narrow lane between stacked stone walls and an arched doorway cut into rock"。说明文字:"Doorways cut into rock and stacked stone walls close in around a narrow lane."。用途:corridor plane 10、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 11(Room II,Stone)。将 https://openaccess-cdn.clevelandart.org/1995.237/1995.237_web.jpg 下载到 public/photos/11-dolmen.jpg(1194×893 JPEG,保持原样)。短标题:"Dolmen, Cap del Puetch"。完整标题:"Dolmen, Cap del Puetch, Ariège, France"。创作者:Arthur A. Taylor。日期:c. 1865–69。工艺:G. Arosa et Cie process print from waxed paper negative。收藏:The Cleveland Museum of Art, John L. Severance Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/1995.237。替代文本:"A flat capstone resting on low stones in open scrubland, a lone tree above"。说明文字:"A flat capstone rests on low stones in open scrub, a lone tree leaning over it."。用途:corridor plane 11、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 12(Room II,Stone)。将 https://openaccess-cdn.clevelandart.org/1992.237/1992.237_web.jpg 下载到 public/photos/12-upper-glacier.jpg(1111×893 JPEG,保持原样)。短标题:"Upper Glacier, Grindelwald"。完整标题:"Switzerland. Grindelwald, Upper Glacier, Source of the Lutschine"。创作者:Adolphe Braun。日期:1875–77。工艺:Carbon print, toned, from wet collodion negative。收藏:The Cleveland Museum of Art, The A. W. Ellenberger, Sr., Endowment Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/1992.237。替代文本:"The broken face of a glacier with a dark ice cave at its foot"。说明文字:"The broken face of a glacier fills the frame, with a dark ice cave at its foot."。用途:corridor plane 12、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 13(Room III,Leaf)。将 https://openaccess-cdn.clevelandart.org/1994.93/1994.93_web.jpg 下载到 public/photos/13-birch-tree.jpg(616×893 JPEG,保持原样)。短标题:"Study of a Birch Tree"。完整标题:"Study of a Birch Tree, Barbizon"。创作者:Constant Alexandre Famin。日期:1860s–1870s。工艺:Albumen print from wet collodion negative。收藏:The Cleveland Museum of Art, John L. Severance Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/1994.93。替代文本:"A single twisting birch tree, pale bark against a dark wood"。说明文字:"A single birch twists upward, its pale bark bright against a dark wood."。用途:corridor plane 13、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 14(Room III,Leaf)。将 https://openaccess-cdn.clevelandart.org/1988.64/1988.64_web.jpg 下载到 public/photos/14-forest-pathway.jpg(1236×893 JPEG,保持原样)。短标题:"Pathway in the Forest"。完整标题:"Pathway in the Forest of Fontainebleau"。创作者:Gustave Le Gray。日期:1849–52。工艺:Salted paper print from waxed paper negative。收藏:The Cleveland Museum of Art, Norman O. Stone and Ella A. Stone Memorial Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/1988.64。替代文本:"A sandy track leading into a tall, sunlit forest"。说明文字:"A sandy track runs into a tall, sunlit forest."。用途:corridor plane 14、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 15(Room III,Leaf)。将 https://openaccess-cdn.clevelandart.org/1988.239/1988.239_web.jpg 下载到 public/photos/15-scotch-firs.jpg(1198×893 JPEG,保持原样)。短标题:"Scotch Firs, Hawkhurst"。完整标题:"Scotch Firs, Hawkhurst"。创作者:Benjamin Brecknell Turner。日期:1853。工艺:Albumen print from calotype。收藏:The Cleveland Museum of Art, John L. Severance Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/1988.239。替代文本:"Tall Scots pines leaning over a stream and a wooden fence by a country road"。说明文字:"Tall Scots pines lean over a stream and a wooden fence beside a country road."。用途:corridor plane 15、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 16(Room III,Leaf)。将 https://openaccess-cdn.clevelandart.org/1995.26/1995.26_web.jpg 下载到 public/photos/16-fern-cyanotype.jpg(621×893 JPEG,保持原样)。短标题:"Scolopendrium Vulgare"。完整标题:"Scolopendrium Vulgare"。创作者:Anna Atkins。日期:1852–54。工艺:Cyanotype。收藏:The Cleveland Museum of Art, Norman O. Stone and Ella A. Stone Memorial Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/1995.26。替代文本:"Four pale fern fronds laid flat on deep blue cyanotype paper"。说明文字:"Four hart's-tongue fern fronds, laid flat on sensitised paper and printed blue without a camera."。用途:corridor plane 16、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 17(Room III,Leaf)。将 https://openaccess-cdn.clevelandart.org/1992.226/1992.226_web.jpg 下载到 public/photos/17-woods-in-snow.jpg(653×893 JPEG,保持原样)。短标题:"Woods in Snow"。完整标题:"Untitled (Woods in Snow)"。创作者:William James Stillman, with J. W. Black。日期:1859。工艺:Salted paper print, varnished, from wet collodion negative。收藏:The Cleveland Museum of Art, John L. Severance Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/1992.226。替代文本:"Snow-laden branches in a dense forest, framed in a soft oval"。说明文字:"Fresh snow weighs down the branches of a dense forest, framed in a soft oval."。用途:corridor plane 17、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 18(Room III,Leaf)。将 https://openaccess-cdn.clevelandart.org/2007.26/2007.26_web.jpg 下载到 public/photos/18-mullein-in-bloom.jpg(728×900 JPEG,保持原样)。短标题:"Mullein in Bloom"。完整标题:"Mullein in Bloom"。创作者:Eugène Atget。日期:c. 1897–1899。工艺:Albumen print。收藏:The Cleveland Museum of Art, John L. Severance Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/2007.26。替代文本:"A tall flowering mullein plant in front of a white sheet hung on a hillside"。说明文字:"A tall mullein in flower, photographed against a white sheet hung behind it."。用途:corridor plane 18、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 19(Room IV,Sky)。将 https://openaccess-cdn.clevelandart.org/1988.191/1988.191_web.jpg 下载到 public/photos/19-sky-study-paris.jpg(1247×893 JPEG,保持原样)。短标题:"Sky Study, Paris"。完整标题:"Sky Study, Paris"。创作者:Charles Marville。日期:1856–57。工艺:Albumen print from wet collodion negative。收藏:The Cleveland Museum of Art, John L. Severance Fund。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/1988.191。替代文本:"Heavy clouds rolling over a dark band of city rooftops"。说明文字:"Heavy clouds roll over a dark band of rooftops and a single distant dome."。用途:corridor plane 19、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 20(Room IV,Sky)。将 https://openaccess-cdn.clevelandart.org/2011.172/2011.172_web.jpg 下载到 public/photos/20-lunar-photograph.jpg(674×900 JPEG,保持原样)。短标题:"Photographie Lunaire"。完整标题:"Photographie Lunaire: Copernic-Képler-Aristarique"。创作者:Maurice Loewy and Pierre Henri Puiseux。日期:1896。工艺:Photogravure(heliogravure)。收藏:The Cleveland Museum of Art, Gift of Amy and Neil Viny。授权:CC0 1.0(Open Access)。记录:https://clevelandart.org/art/2011.172。替代文本:"A close view of the moon's surface with craters, ridges and bright rays"。说明文字:"The moon's surface in close view: craters, ridges and bright rays across a grey plain."。用途:corridor plane 20、detail view、lightbox、Index row 和 fallback catalogue。
- image: Work 21(Room IV, Sky)。下载 https://openaccess-cdn.clevelandart.org/2002.43/2002.43_web.jpg 到 public/photos/21-mariposa-trail.jpg(1151×893 JPEG,保持原样)。短标题:"From Mariposa Trail"。完整标题:"Yosemite Valley from Mariposa Trail"。创作者:Charles Leander Weed。日期:约 1865 年。工艺:湿版火棉胶负片制作的巨幅蛋白印相。收藏:The Cleveland Museum of Art,John L. Severance Fund。授权:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/2002.43。替代文本:"A lone tall pine above a deep granite valley seen from a mountain trail"。说明文字:"A lone pine stands above a deep granite valley, seen from a mountain trail." 用途:走廊平面 21、细节视图、灯箱、Index 行和后备目录。
- image: Work 22(Room IV, Sky)。下载 https://openaccess-cdn.clevelandart.org/2022.36/2022.36_web.jpg 到 public/photos/22-view-from-chalais.jpg(900×699 JPEG,保持原样)。短标题:"View from Chalais"。完整标题:"Vue prise du Couvent des Dominicains, Chalais (Isère), France"。创作者:Félix Thiollier。日期:约 1865 年。工艺:火棉胶负片制作的蛋白印相。收藏:The Cleveland Museum of Art,Gift of Michael Mattis and Judith Hochberg。授权:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/2022.36。替代文本:"Cliffs above a valley filling with low cloud, seen from high ground"。说明文字:"Cliffs rise above a valley slowly filling with cloud, seen from high ground." 用途:走廊平面 22、细节视图、灯箱、Index 行和后备目录。
- image: Work 23(Room IV, Sky)。下载 https://openaccess-cdn.clevelandart.org/2018.216/2018.216_web.jpg 到 public/photos/23-kutcherry-hill.jpg(900×712 JPEG,保持原样)。短标题:"Kinchinjunga from Kutcherry Hill"。完整标题:"Darjeeling. Kinchinjunga and the Snows from Kutcherry Hill"。创作者:Photoglob Co., Zurich。日期:1890 年。工艺:彩色照相石印(Photochrom)。收藏:The Cleveland Museum of Art,Purchase from the Karl B. Goldfield Trust。授权:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/2018.216。替代文本:"Snow peaks floating above layered blue-grey ridges in soft colour"。说明文字:"Snow peaks float above layered blue-grey ridges, coloured by hand-prepared photochrom stones." 用途:走廊平面 23、细节视图、灯箱、Index 行和后备目录。
- image: Work 24(Room IV, Sky)。下载 https://openaccess-cdn.clevelandart.org/2024.5.24/2024.5.24_web.jpg 到 public/photos/24-upper-himalaya.jpg(900×711 JPEG,保持原样)。短标题:"The Upper Himmalayahs"。完整标题:"The Upper Himmalayahs. View of the Mountain of Bunderpoonch with the Jumnootri Peak, 20,458 above the Level of the Sea"。创作者:Samuel Bourne。日期:1863–70 年。工艺:蛋白印相。收藏:The Cleveland Museum of Art,Severance and Greta Millikin Purchase Fund。授权:CC0 1.0(开放获取)。记录:https://clevelandart.org/art/2024.5.24。替代文本:"A pale mountain range fading into haze behind a screen of trees"。说明文字:"Through a screen of trees, a pale mountain range fades into the haze." 用途:走廊平面 24、细节视图、灯箱、Index 行和后备目录。
## 禁止事项
- 不得使用任何形式的后端:不得有服务器代码、API 路由、数据库、认证、分析、会提交的表单,也不得在运行时调用博物馆 API。唯一的外部链接是 'Source record ↗' 链接、mailto 链接和 [CREDIT] 链接。
- 绝不外链引用图片。全部 24 张照片都按给定的确切 URL 和文件名下载到 public/photos/ 中,并在 ASSETS.md 中列出其来源、作者和许可证。
- 不得替换为来自 Unsplash、Pexels、Pixabay、Google Images 或任何非 CC0 来源的照片。如果替换某张照片,请使用另一张 CC0 / 公有领域开放获取图片,并更新 content.ts 和 ASSETS.md。
- 不得对照片进行裁剪、重新着色、调色、去饱和或滤镜处理;每张照片都按其原始宽高比展示。不得将肖像或可识别的面孔作为精选作品,不得使用标志。
- 不得从 fonts.googleapis.com、fonts.gstatic.com、Adobe Fonts 或任何 CDN 加载字体。仅通过 Fontsource 自托管。不得使用 CDN 的 <script> 或 <link> 标签,也不得使用指向 CDN 的 import maps:three.js 从 npm 安装并打包。
- 生产构建中不得包含 source maps(build.sourcemap: false),dist/ 中不得包含 src/。仅使用相对资源路径(Vite base './')。每个内部链接都指向 ./index.html 或页内元素,绝不指向裸目录。
- 除非用户要求,否则不得更改技术栈(Vite + TypeScript + three.js + 纯 CSS + Fontsource)。不得使用 React、Tailwind、UI 套件或后处理库。
- 不得使用任何形式的声音或音频,也不得使用自动播放的媒体。
- 不得使用名称 'Nocturne'、短语 'An endless archive'、'Twenty works, four rooms'、'Lighting the rooms'、'Headphones optional' 或 'Opening the doors',也不得使用其他画廊演示中虚构的项目标题、客户或程序化绘制的艺术作品。此处所有标题均为这 24 张照片的真实标题。
- 不得使用 Instrument Serif、Inter Tight 或 JetBrains Mono。仅使用 Cormorant Garamond、Hanken Grotesk 和 IBM Plex Mono。
- Albumen(#c99a5b)是唯一的强调色,且仅用于小细节。除暗角(vignette)和详情视图可读性渐变外,不得使用渐变,不得使用霓虹、玻璃拟态、圆角卡片或 emoji。
- 不得使用 MIT、ISC、BSD、Apache-2.0、0BSD、CC0 或 Unlicense 之外的依赖(字体使用 OFL)。不得使用 Aceternity UI、Tailwind Plus / Tailwind UI 或购买的模板代码;每个效果都从零编写。
- 严格按照所述尊重 prefers-reduced-motion(无惯性、弯曲、FOV 冲击、自动行走、动画颗粒或尘埃;以交叉淡入淡出代替飞行动画)。
- 必须在 1440×900 和 390×844 下正常工作,控制台零错误,画廊视图无页面滚动条,且每个控件都可通过键盘访问,并带有可见的 1px Albumen 焦点环。不得释放仍在使用的任何内容;标签页隐藏时渲染循环暂停。
- 保持 dist/ 在 20 MB 以下。除 24 张照片和 favicon 外,不得使用额外的位图。
- 除可选的 [CREDIT] 链接外,网站内不得提及模板来源。不得使用 lorem ipsum,不得在此处给出的说明文字之外虚构关于照片的事实。
---
Inspired by Nocturne — an endless 3D corridor gallery (Opus 5.5 showcase by @ohmiler) by @ohmiler — https://ohmiler.github.io/opus-5.5/infinite-gallery/
— Prompt by VibeFather · https://vibefather.ai/t/3d-photo-gallery · CC BY-NC 4.0 (non-commercial; commercial use needs a VibeFather Pro license) · Request removal: https://vibefather.ai/takedown
个人项目可免费使用(CC BY-NC 4.0)。 商业用途需要 Pro.
DESIGN.md
单独的设计规范:配色、字体、间距和动效。可以把这套视觉用到你已有的项目上。
---
name: "3D Photo Gallery"
colors:
void: "#0b0a09"
soot: "#15130f"
frame: "#2a241d"
bone: "#ece4d6"
ash: "#8f877a"
hairline: "rgba(236,228,214,0.14)"
albumen: "#c99a5b"
letterbox: "#000000"
typography:
display_wordmark_room_titles_work_titles: { family: "Cormorant Garamond", weights: [400, 500] }
text_captions_panels_buttons: { family: "Hanken Grotesk", weights: [400, 500] }
mono_micro_labels_counters_room_labels_hints_credits: { family: "IBM Plex Mono", weights: [400, 500] }
spacing: "HUD sits on a fixed inset frame: 28px from each edge at ≥ 900px wide, 18px below. Panels use 40px padding (24px mobile). Mono labels are 11px uppercase with 0.16em letter-spacing. Detail text column starts at 6vw from the left, max-width 520px. Vertical rhythm in text blocks is 8px multiples (8, 16, 24, 40)."
radius: "0 everywhere (frames, panels, images, lightbox). Only pill buttons use 999px, and the cursor ring is a circle."
---
# 3D Photo Gallery — Design System
Apply this design system to an existing project. It describes the look and feel only; for the full site, use prompt.md.
## Colors
- **Void** `#0b0a09` — Page and scene background, fog color, loader background
- **Soot** `#15130f` — Index and About panels, mobile detail sheet, fallback page
- **Frame** `#2a241d` — Thin frame plane behind every photograph
- **Bone** `#ece4d6` — Primary text, room titles, cursor ring, dust particles
- **Ash** `#8f877a` — Secondary text, mono labels, dates, inactive controls
- **Hairline** `rgba(236,228,214,0.14)` — 1px dividers, progress track, panel borders
- **Albumen** `#c99a5b` — The only accent: progress fill, cursor dot, active index number, focus rings, the small dot in buttons. Never for large fills or body text.
- **Letterbox** `#000000` — Detail-view letterbox bars and the lightbox backdrop (at 96% opacity)
## Typography
- **Display (wordmark, room titles, work titles)** — Cormorant Garamond (OFL), weights 400/500. Self-host the font files.
- **Text (captions, panels, buttons)** — Hanken Grotesk (OFL), weights 400/500. Self-host the font files.
- **Mono micro-labels (counters, room labels, hints, credits)** — IBM Plex Mono (OFL), weights 400/500. Self-host the font files.
## Spacing & shape
- Spacing: HUD sits on a fixed inset frame: 28px from each edge at ≥ 900px wide, 18px below. Panels use 40px padding (24px mobile). Mono labels are 11px uppercase with 0.16em letter-spacing. Detail text column starts at 6vw from the left, max-width 520px. Vertical rhythm in text blocks is 8px multiples (8, 16, 24, 40).
- Radius: 0 everywhere (frames, panels, images, lightbox). Only pill buttons use 999px, and the cursor ring is a circle.
## Motion
- Easing: entrances cubic-bezier(.2,.8,.2,1); panels and letterbox cubic-bezier(.7,0,.2,1); camera flights easeInOutCubic. Damping helper damp(a, b, λ, dt) = a + (b − a)·(1 − e^(−λ·dt)) drives every continuous value.
- Inertial walk: wheel, drag and swipe write to a scroll target; the camera chases it with damp λ 5 and keeps momentum after release (velocity decays by e^(−3.5·dt)).
- Velocity bend: photograph planes curve slightly along their width while the camera moves (uBend = clamp(speed × 0.02, −0.35, 0.35)) and flatten when it stops.
- Pointer parallax: camera offsets up to 0.25 units in x and 0.15 in y and rotates up to 0.04 rad toward the pointer, damped λ 3.
- Camera flight to a photograph in 1.2 s with a FOV kick (+8° at the midpoint), other works dimming to 12% brightness in 0.6 s.
- Rolling digits: each digit is a masked vertical 0–9 strip that slides to the new value in 0.6 s; room names slide up out and in through a mask in 0.5 s.
- Loader shutter: the loader splits into a top and bottom half that slide off-screen in 0.9 s, then HUD items rise 12px and fade in with an 80ms stagger and the works reveal nearest-first.
- Film grain overlay steps through 8 offsets per second; dust drifts slowly. prefers-reduced-motion: no inertia (λ 14, no momentum), no bend, no FOV kick, no auto-walk, static grain and dust, camera jumps replaced by 0.35 s crossfades, rolling digits switch instantly.
## Imagery
Real nineteenth-century photographs only: 24 CC0 images from The Cleveland Museum of Art Open Access, kept in their original warm albumen, salted-paper, cyanotype and photochrom tones. No color grading, no filters, no crops: each plane uses the image's natural aspect ratio. Everything else (frames, labels, room titles, dust, grain, vignette, cursor, favicon) is drawn in code. No portraits and no logos.
## Tone
Quiet, exact and curatorial. Short factual captions, no exclamation marks, no marketing language. Labels read like museum wall text.
---
Inspired by Nocturne — an endless 3D corridor gallery (Opus 5.5 showcase by @ohmiler) by @ohmiler — https://ohmiler.github.io/opus-5.5/infinite-gallery/
— Prompt by VibeFather · https://vibefather.ai/t/3d-photo-gallery · CC BY-NC 4.0 (non-commercial; commercial use needs a VibeFather Pro license) · Request removal: https://vibefather.ai/takedown
改成你自己的
- 地区博物馆:将 BRAND 设为本机构,ROOMS 设为馆藏中的四个时期,VISIT_LINE 设为开放时间和票价,然后加载你自己的数字化作品。
- 风景版画店:用四个展厅分别展示海岸、森林、田野和山峦等系列,并在 VISIT_LINE 中写上工作室地址和订购电话。
- 有完整系列的摄影师:将 EXHIBITION 设为系列标题,在 ROOMS 中将 24 幅作品分成四个章节,并将 COLLECTION_NOTE 写成一句话陈述。
- 大学特藏:在 BRAND 中命名档案馆,用 ROOMS 按捐赠人或主题分组,并为每件数字化藏品填写授权字段。
3D 照片画廊:常见问题
如何替换 3D 照片画廊中的 24 张照片和说明文字?
3D 照片画廊模板将所有 24 张照片和每个说明文字字段放在一个内容文件中。把你的图片用相同的文件名放入 photos 文件夹,然后在该文件中编辑每件作品的标题、作者、日期、工艺、收藏和授权。走廊、四个展厅、详情视图和索引面板都会根据这些数据重建,所以你无需改动场景代码。
除了可漫步的走廊,3D 照片画廊还包含什么?
3D 照片画廊模板包含一条由 24 幅装裱照片组成的无尽走廊、四个带有大号斜体标题的有名展厅、一个显示当前展厅、作品编号和进度的抬头显示框、一个点击打开的详情视图(含完整说明、署名和授权)、一个支持缩放和键盘翻页的灯箱、一个索引面板、一个关于面板,以及为不支持 WebGL 的浏览器准备的目录回退页。每张图片都已下载到项目中并署名。
如何为我自己的收藏设置展厅和展览标题?
3D 照片画廊模板提供五个变量:BRAND、EXHIBITION、ROOMS、VISIT_LINE 和 COLLECTION_NOTE。将 ROOMS 设置为按参观顺序排列的恰好四个单词;作品 01 到 06 挂在第一个展厅,07 到 12 在第二个,13 到 18 在第三个,19 到 24 在第四个。VISIT_LINE 包含你的地址、开放时间或门票价格,COLLECTION_NOTE 用一行描述收藏。
如果访客的浏览器无法运行 WebGL 或开启了减少动态效果,会发生什么?
当 WebGL 不可用时,3D 照片画廊模板会提供一个干净的目录页,因此每件作品仍可作为静态列表浏览。当访客启用了减少动态效果时,走廊会去掉惯性和动量,平面停止弯曲,视野冲击被移除,颗粒和尘埃静止不动,镜头飞行变为短暂的交叉淡入淡出,而不是穿越空间的移动。
怎么用 AI 做一个3D 照片画廊?
复制本页的提示词,或者运行 npx vibefather add 3d-photo-gallery,把 [BRAND]、[ROOMS]、[EXHIBITION]、[VISIT_LINE] 换成你自己的内容,再粘贴到 Claude Code、Codex、Cursor 等 AI 编程工具里。在线演示就是用这份提示词原样做出来的。
3D 照片画廊模板的演示是哪个 AI 模型做的?
演示由 Claude Opus 5.5 在 Cursor 里完成;另一个案例由 Claude Sonnet 5.5 在 Cursor 里完成;另一个案例由 Gemini 4 Carbon 在 Cursor 里完成。每次都用公开的提示词原样生成,没有额外补充,可以并排比较不同模型的效果。