Skip to content

armgit / eve

Public Imported from GitHub
0

The Open Framework for Building Agents

Add interactive paint hover to Eve hero shader (#550)

Matias Gonzalezed59cb42f43d
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/fallback-image.tsx b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/fallback-image.tsx
new file mode 100644
index 000000000..b1fc6acd1
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/fallback-image.tsx
@@ -0,0 +1,63 @@
+import { getImageProps } from "next/image";
+import type { ComponentProps } from "react";
+import fallbackDarkImage from "../../../../../public/eve-5/fallback-dark-content.webp";
+import fallbackLightImage from "../../../../../public/eve-5/fallback-light-content.webp";
+import { BLOOM_RADIUS } from "./render";
+
+// Owns static fallback image sizing and rendering for the Eve hero logo.
+// INVARIANT: CSS padding mirrors the animated canvas bloom padding.
+// Imported only by index.tsx.
+
+export const FALLBACK_IMAGE_WIDTH = 1095;
+export const FALLBACK_IMAGE_HEIGHT = 348;
+export const FALLBACK_IMAGE_ASPECT_RATIO = `${FALLBACK_IMAGE_WIDTH} / ${FALLBACK_IMAGE_HEIGHT}`;
+export const FALLBACK_CONTAINER_ASPECT_RATIO = `${FALLBACK_IMAGE_WIDTH + BLOOM_RADIUS} / ${FALLBACK_IMAGE_HEIGHT + BLOOM_RADIUS}`;
+export const FALLBACK_IMAGE_SIZES = "(min-width: 768px) 1095px, calc(100vw - 16px)";
+export const FALLBACK_IMAGE_PADDING = BLOOM_RADIUS / 2;
+
+const fallbackImageOptions = {
+ alt: "",
+ width: FALLBACK_IMAGE_WIDTH,
+ height: FALLBACK_IMAGE_HEIGHT,
+ sizes: FALLBACK_IMAGE_SIZES,
+ priority: true,
+ quality: 95,
+} as const;
+
+export function getFallbackImageProps() {
+ const { props: fallbackLightImageProps } = getImageProps({
+ ...fallbackImageOptions,
+ src: fallbackLightImage,
+ });
+ const { props: fallbackDarkImageProps } = getImageProps({
+ ...fallbackImageOptions,
+ src: fallbackDarkImage,
+ });
+ return { fallbackLightImageProps, fallbackDarkImageProps };
+}
+
+export function FallbackImage({
+ imageProps,
+ visible,
+ className,
+}: {
+ imageProps: ComponentProps<"img">;
+ visible: boolean;
+ className: string;
+}) {
+ return (
+ <div
+ className={`${className} absolute transition-opacity duration-700 ease-linear ${visible ? "opacity-100" : "opacity-0"}`}
+ style={{ inset: FALLBACK_IMAGE_PADDING }}
+ >
+ <img
+ {...imageProps}
+ aria-hidden="true"
+ role="presentation"
+ decoding="async"
+ className="absolute left-1/2 top-1/2 h-full w-auto max-w-none -translate-x-1/2 -translate-y-1/2"
+ style={{ aspectRatio: FALLBACK_IMAGE_ASPECT_RATIO }}
+ />
+ </div>
+ );
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/hooks.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/hooks.ts
new file mode 100644
index 000000000..7e65508a3
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/hooks.ts
@@ -0,0 +1,53 @@
+import { useEffect, useState } from "react";
+
+// Owns browser theme and reduced-motion subscriptions for the Eve hero.
+// INVARIANT: resolution order matches the old index.tsx hooks exactly.
+// Imported only by index.tsx.
+
+export function getCurrentTheme(): "light" | "dark" {
+ if (typeof document === "undefined") return "light";
+ const root = document.documentElement;
+ if (root.classList.contains("dark") || root.dataset.theme === "dark") return "dark";
+ if (root.classList.contains("light") || root.dataset.theme === "light") return "light";
+ return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+
+export function useResolvedTheme() {
+ const [theme, setTheme] = useState<"light" | "dark">("light");
+
+ useEffect(() => {
+ const syncTheme = () => setTheme(getCurrentTheme());
+ const media = window.matchMedia("(prefers-color-scheme: dark)");
+ const observer = new MutationObserver(syncTheme);
+
+ syncTheme();
+ observer.observe(document.documentElement, {
+ attributes: true,
+ attributeFilter: ["class", "data-theme"],
+ });
+ media.addEventListener("change", syncTheme);
+
+ return () => {
+ observer.disconnect();
+ media.removeEventListener("change", syncTheme);
+ };
+ }, []);
+
+ return theme;
+}
+
+export function usePrefersReducedMotion() {
+ const [prefersReducedMotion, setPrefersReducedMotion] = useState<boolean | null>(null);
+
+ useEffect(() => {
+ const media = window.matchMedia("(prefers-reduced-motion: reduce)");
+ const syncPreference = () => setPrefersReducedMotion(media.matches);
+
+ syncPreference();
+ media.addEventListener("change", syncPreference);
+
+ return () => media.removeEventListener("change", syncPreference);
+ }, []);
+
+ return prefersReducedMotion;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/index.tsx b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/index.tsx
index 242488980..411c8c495 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/index.tsx
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/index.tsx
@@ -1,12 +1,38 @@
"use client";
import { App, Device, type VGPUAdapter } from "@vgpu/core";
-import { getImageProps } from "next/image";
-import fallbackDarkImage from "../../../../../public/eve-5/fallback-dark-content.webp";
-import fallbackLightImage from "../../../../../public/eve-5/fallback-light-content.webp";
-import { useEffect, useRef, useState, type ComponentProps, type CSSProperties } from "react";
-import { decodeGltfMesh, meshAspect } from "./mesh";
-import { BLOOM_RADIUS, DEFAULT_CAMERA_FOV, cameraRadiusForFov, createEve5Renderer, type RenderControls } from "./render";
+import { useEffect, useRef, useState, type CSSProperties } from "react";
+import { meshAspect } from "./mesh";
+import {
+ FallbackImage,
+ FALLBACK_CONTAINER_ASPECT_RATIO,
+ getFallbackImageProps,
+} from "./fallback-image";
+import { usePrefersReducedMotion, useResolvedTheme } from "./hooks";
+import { DEFAULT_LOGO_ASPECT, getLogicalRenderSize, resizeCanvas } from "./runtime/canvas-sizing";
+import { loadMesh } from "./runtime/load-mesh";
+import {
+ destroyTransitionDebugGui,
+ setupTransitionDebugGui,
+ type EveTransitionDebugGui,
+ type EveTransitionDebugState,
+} from "./runtime/debug-gui";
+import { createDrawLoop } from "./runtime/frame-loop";
+import { createPointerController } from "./runtime/pointer-input";
+import type { HeroRuntimeState } from "./runtime/state";
+import {
+ BLOOM_RADIUS,
+ DEFAULT_CAMERA_FOV,
+ DEFAULT_PAINT_BRUSH_RADIUS,
+ DEFAULT_PAINT_BRUSH_STRENGTH,
+ DEFAULT_PAINT_DECAY_PER_FRAME_120,
+ DEFAULT_PAINT_DIFFUSION_JITTER,
+ DEFAULT_PAINT_DIFFUSION_RATE,
+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ cameraRadiusForFov,
+ createEve5Renderer,
+ type RenderControls,
+} from "./render";
import type { InstallAudience } from "../install-switcher";
class BrowserAdapter implements VGPUAdapter {
@@ -17,13 +43,6 @@ class BrowserAdapter implements VGPUAdapter {
}
}
-const MODEL_URL = "/eve-5/eve-logo.gltf";
-const FALLBACK_IMAGE_WIDTH = 1095;
-const FALLBACK_IMAGE_HEIGHT = 348;
-const FALLBACK_IMAGE_ASPECT_RATIO = `${FALLBACK_IMAGE_WIDTH} / ${FALLBACK_IMAGE_HEIGHT}`;
-const FALLBACK_CONTAINER_ASPECT_RATIO = `${FALLBACK_IMAGE_WIDTH + BLOOM_RADIUS} / ${FALLBACK_IMAGE_HEIGHT + BLOOM_RADIUS}`;
-const FALLBACK_IMAGE_SIZES = "(min-width: 768px) 1095px, calc(100vw - 16px)";
-const DEFAULT_LOGO_ASPECT = 78 / 25;
const DEFAULT_CONTROLS: RenderControls = {
yaw: 0,
pitch: 0,
@@ -37,87 +56,9 @@ const DEFAULT_CONTROLS: RenderControls = {
wireframe: false,
showEnv: false,
};
-const LOGO_RENDER_HEIGHT = 500;
-const MAX_DEVICE_PIXEL_RATIO = 2;
-const FALLBACK_IMAGE_PADDING = BLOOM_RADIUS / MAX_DEVICE_PIXEL_RATIO;
-const MAX_ENV_YAW = 0.3;
-const MAX_ENV_PITCH = 0.2;
-const ENV_YAW_LERP_SPEED = 3;
-const AGENTS_ENV_YAW_OFFSET = -Math.PI * 0.1;
export const AGENTS_ENV_YAW_LERP_SPEED = 3;
const LOGO_MODE_TRANSITION_DURATION_SECONDS = 0.45;
const IMPRINT_GLYPH_SCALE = 1.35;
-const ASCII_MOUSE_LERP_SPEED = 6;
-
-const CANVAS_FADE_FALLBACK_MS = 800;
-const CANVAS_REVEAL_RENDER_COUNT = 3;
-
-type EveTransitionDebugGui = {
- destroy(): void;
-};
-
-type EveTransitionDebugState = {
- overrideEnabled: boolean;
- progress: number;
- gridScaleMultiplier: number;
- glyphScale: number;
- durationSeconds: number;
-};
-
-declare global {
- interface Window {
- __eveLogoTransitionDebugGui?: EveTransitionDebugGui;
- }
-}
-
-function getCurrentTheme(): "light" | "dark" {
- if (typeof document === "undefined") return "light";
- const root = document.documentElement;
- if (root.classList.contains("dark") || root.dataset.theme === "dark") return "dark";
- if (root.classList.contains("light") || root.dataset.theme === "light") return "light";
- return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
-}
-
-function useResolvedTheme() {
- const [theme, setTheme] = useState<"light" | "dark">("light");
-
- useEffect(() => {
- const syncTheme = () => setTheme(getCurrentTheme());
- const media = window.matchMedia("(prefers-color-scheme: dark)");
- const observer = new MutationObserver(syncTheme);
-
- syncTheme();
- observer.observe(document.documentElement, {
- attributes: true,
- attributeFilter: ["class", "data-theme"],
- });
- media.addEventListener("change", syncTheme);
-
- return () => {
- observer.disconnect();
- media.removeEventListener("change", syncTheme);
- };
- }, []);
-
- return theme;
-}
-
-function usePrefersReducedMotion() {
- const [prefersReducedMotion, setPrefersReducedMotion] = useState<boolean | null>(null);
-
- useEffect(() => {
- const media = window.matchMedia("(prefers-reduced-motion: reduce)");
- const syncPreference = () => setPrefersReducedMotion(media.matches);
-
- syncPreference();
- media.addEventListener("change", syncPreference);
-
- return () => media.removeEventListener("change", syncPreference);
- }, []);
-
- return prefersReducedMotion;
-}
-
export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudience }) {
const theme = useResolvedTheme();
const prefersReducedMotion = usePrefersReducedMotion();
@@ -133,25 +74,36 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie
targetLogoModeProgressRef.current = agentsSelected ? 1 : 0;
useEffect(() => {
- const agentsSelected = audience === "agents";
- targetAgentsEnvYawMixRef.current = agentsSelected ? 1 : 0;
- targetLogoModeProgressRef.current = agentsSelected ? 1 : 0;
- }, [audience]);
-
- useEffect(() => {
- let cancelled = false;
- let animationFrame = 0;
- let cleanup: (() => void) | undefined;
- let mouseEnvYaw = controlsRef.current.envYaw;
- let targetMouseEnvYaw = mouseEnvYaw;
- let mouseEnvPitch = controlsRef.current.envPitch;
- let targetMouseEnvPitch = mouseEnvPitch;
- let asciiMouseX = 0;
- let asciiMouseY = 0;
- let targetAsciiMouseX = 0;
- let targetAsciiMouseY = 0;
- let agentsEnvYawMix = targetAgentsEnvYawMixRef.current;
- let previousFrameTime = performance.now();
+ const state: HeroRuntimeState = {
+ cancelled: false,
+ animationFrame: 0,
+ cleanup: undefined,
+ mouseEnvYaw: controlsRef.current.envYaw,
+ targetMouseEnvYaw: controlsRef.current.envYaw,
+ mouseEnvPitch: controlsRef.current.envPitch,
+ targetMouseEnvPitch: controlsRef.current.envPitch,
+ asciiMouseX: 0,
+ asciiMouseY: 0,
+ targetAsciiMouseX: 0,
+ targetAsciiMouseY: 0,
+ brushCellX: 0,
+ brushCellY: 0,
+ previousRenderedBrushCellX: 0,
+ previousRenderedBrushCellY: 0,
+ hasBrushCell: false,
+ hasRenderedBrushCell: false,
+ brushActive: false,
+ paintGridScaleMultiplier: DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ targetBrushActive: false,
+ activeMesh: undefined,
+ agentsEnvYawMix: targetAgentsEnvYawMixRef.current,
+ previousFrameTime: performance.now(),
+ autoRotateStartTime: performance.now(),
+ lastBrushMoveTime: Number.NEGATIVE_INFINITY,
+ lastPointerClientX: undefined,
+ lastPointerClientY: undefined,
+ isCoarsePointer: window.matchMedia("(pointer: coarse)").matches,
+ };
const canvas = canvasRef.current;
resetCanvasVisibility(canvas);
@@ -167,20 +119,7 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie
}
setShowLightFallback(false);
- const updateEnvRotation = (clientX: number, clientY: number) => {
- const viewportWidth = Math.max(1, window.innerWidth || 1);
- const viewportHeight = Math.max(1, window.innerHeight || 1);
- const clampedX = Math.max(0, Math.min(viewportWidth, clientX));
- const clampedY = Math.max(0, Math.min(viewportHeight, clientY));
- const normalizedX = (clampedX / viewportWidth) * 2 - 1;
- const normalizedY = (clampedY / viewportHeight) * 2 - 1;
- targetMouseEnvYaw = normalizedX * MAX_ENV_YAW;
- targetMouseEnvPitch = normalizedY * MAX_ENV_PITCH;
- targetAsciiMouseX = normalizedX;
- targetAsciiMouseY = normalizedY;
- };
- const onPointerMove = (event: PointerEvent) => updateEnvRotation(event.clientX, event.clientY);
- window.addEventListener("pointermove", onPointerMove, { passive: true });
+ const pointerController = createPointerController({ state, controlsRef, canvasRef });
async function start() {
const renderTheme = theme;
@@ -192,13 +131,14 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie
}
const mesh = await loadMesh();
- if (cancelled) return;
+ if (state.cancelled) return;
+ state.activeMesh = mesh;
setLogoAspect(meshAspect(mesh));
await nextFrame();
resizeCanvas(canvas);
const app = await App.create({ adapter: new BrowserAdapter() });
- if (cancelled) {
+ if (state.cancelled) {
app.device.destroy();
return;
}
@@ -207,149 +147,88 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie
const alphaMode = renderTheme === "light" ? "premultiplied" : "opaque";
context.configure({ device: app.device.gpu, format, alphaMode });
const renderer = createEve5Renderer(app.device, format, mesh, { theme: renderTheme });
- let modeTransitionProgress = targetLogoModeProgressRef.current;
let disposed = false;
+ let drawLoopDispose: (() => void) | undefined;
let transitionDebugGui: EveTransitionDebugGui | undefined;
+ const modeTransitionProgressRef = { current: targetLogoModeProgressRef.current };
const transitionDebug: EveTransitionDebugState = {
overrideEnabled: false,
- progress: modeTransitionProgress,
- gridScaleMultiplier: 1.03,
+ progress: modeTransitionProgressRef.current,
+ gridScaleMultiplier: DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
glyphScale: IMPRINT_GLYPH_SCALE,
durationSeconds: LOGO_MODE_TRANSITION_DURATION_SECONDS,
+ paintDecayPerFrame120: DEFAULT_PAINT_DECAY_PER_FRAME_120,
+ diffusionAmount: DEFAULT_PAINT_DIFFUSION_RATE,
+ diffusionJitter: DEFAULT_PAINT_DIFFUSION_JITTER,
+ brushRadius: DEFAULT_PAINT_BRUSH_RADIUS,
+ brushStrength: DEFAULT_PAINT_BRUSH_STRENGTH,
+ visualizePaintBuffer: false,
};
- previousFrameTime = performance.now();
-
- const destroyTransitionDebugGui = () => {
- if (!transitionDebugGui) return;
- if (window.__eveLogoTransitionDebugGui === transitionDebugGui) {
- delete window.__eveLogoTransitionDebugGui;
- }
- transitionDebugGui.destroy();
- transitionDebugGui = undefined;
- };
- const setupTransitionDebugGui = async () => {
- if (!new URLSearchParams(window.location.search).has("debug")) return;
- const { GUI } = await import("lil-gui");
- if (cancelled || disposed) return;
- window.__eveLogoTransitionDebugGui?.destroy();
- const gui = new GUI({ title: "Eve logo imprint" });
- let guiDestroyed = false;
- const guiHandle: EveTransitionDebugGui = {
- destroy() {
- if (guiDestroyed) return;
- guiDestroyed = true;
- gui.destroy();
- },
- };
- transitionDebugGui = guiHandle;
- window.__eveLogoTransitionDebugGui = guiHandle;
- gui.add(transitionDebug, "overrideEnabled").name("Override imprint");
- gui.add(transitionDebug, "progress", 0, 1, 0.001).name("Imprint progress");
- const imprint = gui.addFolder("Imprint");
- imprint.add(transitionDebug, "gridScaleMultiplier", 0.5, 2, 0.01).name("Grid scale multiplier");
- imprint.add(transitionDebug, "glyphScale", 0.5, 2.5, 0.01).name("Glyph scale");
- imprint.open();
- gui.add(transitionDebug, "durationSeconds", 0.05, 2, 0.01).name("Transition duration (s)");
- };
- void setupTransitionDebugGui();
+ state.previousFrameTime = performance.now();
+ state.autoRotateStartTime = state.previousFrameTime;
+
+ void setupTransitionDebugGui({
+ transitionDebug,
+ isCancelled: () => state.cancelled,
+ isDisposed: () => disposed,
+ onReady: (gui) => {
+ transitionDebugGui = gui;
+ },
+ });
- let successfulRenderCount = 0;
- let finishCanvasFade: (() => void) | undefined;
const dispose = () => {
if (disposed) return;
disposed = true;
- cancelAnimationFrame(animationFrame);
- finishCanvasFade?.();
+ drawLoopDispose?.();
resetCanvasVisibility(canvas);
- if (!cancelled) setRevealed(false);
- destroyTransitionDebugGui();
+ if (!state.cancelled) setRevealed(false);
+ destroyTransitionDebugGui(transitionDebugGui);
+ transitionDebugGui = undefined;
renderer.dispose();
app.device.destroy();
};
app.device.gpu.lost
.then(() => {
- if (cancelled) return;
+ if (state.cancelled) return;
setRevealed(false);
setShowLightFallback(true);
- cancelled = true;
+ state.cancelled = true;
dispose();
})
.catch(() => {
// The landing page must degrade silently when the GPU process is unavailable.
});
- const draw = (frameTime = performance.now()) => {
- if (cancelled || disposed) return;
-
- const deltaSeconds = Math.max(0, (frameTime - previousFrameTime) / 1000);
- previousFrameTime = frameTime;
- mouseEnvYaw = safeLerp(mouseEnvYaw, targetMouseEnvYaw, deltaSeconds * ENV_YAW_LERP_SPEED);
- mouseEnvPitch = safeLerp(mouseEnvPitch, targetMouseEnvPitch, deltaSeconds * ENV_YAW_LERP_SPEED);
- asciiMouseX = safeLerp(asciiMouseX, targetAsciiMouseX, deltaSeconds * ASCII_MOUSE_LERP_SPEED);
- asciiMouseY = safeLerp(asciiMouseY, targetAsciiMouseY, deltaSeconds * ASCII_MOUSE_LERP_SPEED);
- const targetAgentsEnvYawMix = targetAgentsEnvYawMixRef.current;
- agentsEnvYawMix = safeLerp(agentsEnvYawMix, targetAgentsEnvYawMix, deltaSeconds * AGENTS_ENV_YAW_LERP_SPEED);
- controlsRef.current.envYaw = mouseEnvYaw + agentsEnvYawMix * AGENTS_ENV_YAW_OFFSET;
- controlsRef.current.envPitch = mouseEnvPitch;
-
- resizeCanvas(canvas);
- // The renderer pads the logical scene size by BLOOM_RADIUS on each side before allocating
- // its offscreen back/depth targets. The canvas itself is that padded physical render target,
- // so subtract the padding here. Passing CSS/logical logo dimensions would make the front
- // shader's @builtin(position) sample different pixels from the back-side targets on DPR > 1.
- const logicalWidth = Math.max(1, canvas.width - BLOOM_RADIUS * 2);
- const logicalHeight = Math.max(1, canvas.height - BLOOM_RADIUS * 2);
-
- try {
- const transitionDurationSeconds = clampRange(transitionDebug.durationSeconds, 0.05, 2);
- modeTransitionProgress = stepLogoModeProgress(
- modeTransitionProgress,
- targetLogoModeProgressRef.current,
- deltaSeconds,
- transitionDurationSeconds,
- );
- const animatedMixProgress = easeLogoModeProgress(modeTransitionProgress);
- const mixProgress = transitionDebug.overrideEnabled ? clampUnit(transitionDebug.progress) : animatedMixProgress;
- const timeSeconds = frameTime / 1000;
- renderer.render(context.getCurrentTexture().createView(), controlsRef.current, logicalWidth, logicalHeight, {
- progress: mixProgress,
- gridScaleMultiplier: clampRange(transitionDebug.gridScaleMultiplier, 0.5, 2),
- glyphScale: clampRange(transitionDebug.glyphScale, 0.5, 2.5),
- time: timeSeconds,
- mouse: [asciiMouseX, asciiMouseY],
- });
-
- canvas.dataset.eveRenderMode = mixProgress >= 0.5 ? "agents" : "humans";
- canvas.dataset.eveAsciiProgress = mixProgress.toFixed(3);
- canvas.dataset.eveAsciiMode = mixProgress > 0.001 ? "active" : "inactive";
- } catch {
- cancelled = true;
+ const drawLoop = createDrawLoop({
+ state,
+ canvas,
+ context,
+ renderer,
+ controlsRef,
+ transitionDebug,
+ modeTransitionProgressRef,
+ targetLogoModeProgressRef,
+ targetAgentsEnvYawMixRef,
+ defaultMaterial: DEFAULT_CONTROLS.material,
+ onCanvasRevealed: () => {
+ if (!state.cancelled) setRevealed(true);
+ },
+ onFallback: () => {
setRevealed(false);
setShowLightFallback(true);
- dispose();
- return;
- }
-
- successfulRenderCount += 1;
- if (successfulRenderCount === CANVAS_REVEAL_RENDER_COUNT) {
- canvas.style.opacity = "1";
- finishCanvasFade = onCanvasFullyOpaque(canvas, () => {
- if (!cancelled) setRevealed(true);
- });
- }
-
- animationFrame = requestAnimationFrame(draw);
- };
-
- draw();
+ },
+ onFatalError: dispose,
+ });
+ drawLoopDispose = drawLoop.dispose;
+ drawLoop.draw();
return dispose;
}
start()
.then((dispose) => {
- cleanup = dispose;
+ state.cleanup = dispose;
})
.catch(() => {
setShowLightFallback(true);
@@ -357,10 +236,10 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie
});
return () => {
- cancelled = true;
- cancelAnimationFrame(animationFrame);
- window.removeEventListener("pointermove", onPointerMove);
- cleanup?.();
+ state.cancelled = true;
+ cancelAnimationFrame(state.animationFrame);
+ pointerController.detach();
+ state.cleanup?.();
resetCanvasVisibility(canvasRef.current);
};
}, [theme, prefersReducedMotion]);
@@ -368,22 +247,7 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie
const logicalSize = getLogicalRenderSize(logoAspect);
const paddedWidth = logicalSize.width + BLOOM_RADIUS * 2;
const paddedHeight = logicalSize.height + BLOOM_RADIUS * 2;
- const fallbackImageOptions = {
- alt: "",
- width: FALLBACK_IMAGE_WIDTH,
- height: FALLBACK_IMAGE_HEIGHT,
- sizes: FALLBACK_IMAGE_SIZES,
- priority: true,
- quality: 95,
- } as const;
- const { props: fallbackLightImageProps } = getImageProps({
- ...fallbackImageOptions,
- src: fallbackLightImage,
- });
- const { props: fallbackDarkImageProps } = getImageProps({
- ...fallbackImageOptions,
- src: fallbackDarkImage,
- });
+ const { fallbackLightImageProps, fallbackDarkImageProps } = getFallbackImageProps();
return (
<div
@@ -417,117 +281,11 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie
);
}
-function FallbackImage({
- imageProps,
- visible,
- className,
-}: {
- imageProps: ComponentProps<"img">;
- visible: boolean;
- className: string;
-}) {
- return (
- <div
- className={`${className} absolute transition-opacity duration-700 ease-linear ${visible ? "opacity-100" : "opacity-0"}`}
- style={{ inset: FALLBACK_IMAGE_PADDING }}
- >
- <img
- {...imageProps}
- aria-hidden="true"
- role="presentation"
- decoding="async"
- className="absolute left-1/2 top-1/2 h-full w-auto max-w-none -translate-x-1/2 -translate-y-1/2"
- style={{ aspectRatio: FALLBACK_IMAGE_ASPECT_RATIO }}
- />
- </div>
- );
-}
-
-async function loadMesh() {
- const response = await fetch(MODEL_URL, { cache: "no-store" });
- if (!response.ok) throw new Error(`Failed to load ${MODEL_URL}: ${response.status}`);
- return decodeGltfMesh(await response.json(), (uri) => loadGltfBuffer(uri, MODEL_URL));
-}
-
-async function loadGltfBuffer(uri: string, modelUrl: string) {
- if (uri.startsWith("data:application/octet-stream;base64,")) {
- return Uint8Array.from(atob(uri.split(",")[1]!), (char) => char.charCodeAt(0)).buffer;
- }
- const url = new URL(uri, window.location.origin + modelUrl);
- const response = await fetch(url, { cache: "no-store" });
- if (!response.ok) throw new Error(`Failed to load glTF buffer ${url.pathname}: ${response.status}`);
- return response.arrayBuffer();
-}
-
-function getLogicalRenderSize(aspect: number) {
- return {
- width: Math.max(1, Math.round(LOGO_RENDER_HEIGHT * aspect)),
- height: LOGO_RENDER_HEIGHT,
- };
-}
-
-function resizeCanvas(canvas: HTMLCanvasElement | null) {
- if (!canvas) return;
- const dpr = Math.min(window.devicePixelRatio || 1, MAX_DEVICE_PIXEL_RATIO);
- const rect = canvas.getBoundingClientRect();
- const width = Math.max(1, Math.floor(rect.width * dpr));
- const height = Math.max(1, Math.floor(rect.height * dpr));
- if (canvas.width !== width || canvas.height !== height) {
- canvas.width = width;
- canvas.height = height;
- }
-}
-
-function safeLerp(from: number, to: number, amount: number) {
- const safeAmount = Math.max(0, Math.min(1, amount));
- return from + (to - from) * safeAmount;
-}
-
-function clampUnit(value: number) {
- return clampRange(value, 0, 1);
-}
-
-function clampRange(value: number, min: number, max: number) {
- return Math.max(min, Math.min(max, value));
-}
-
-function stepLogoModeProgress(current: number, target: number, deltaSeconds: number, durationSeconds: number) {
- const safeTarget = target >= 0.5 ? 1 : 0;
- const safeDuration = clampRange(durationSeconds, 0.05, 2);
- const step = Math.max(0, deltaSeconds) / safeDuration;
- if (Math.abs(safeTarget - current) <= step) return safeTarget;
- return current + Math.sign(safeTarget - current) * step;
-}
-
-function easeLogoModeProgress(progress: number) {
- const t = Math.max(0, Math.min(1, progress));
- return t * t * (3 - 2 * t);
-}
-
function resetCanvasVisibility(canvas: HTMLCanvasElement | null) {
if (!canvas) return;
canvas.style.opacity = "";
}
-function onCanvasFullyOpaque(canvas: HTMLCanvasElement, callback: () => void) {
- let done = false;
- let timeout = 0;
- const finish = () => {
- if (done) return;
- done = true;
- canvas.removeEventListener("transitionend", onTransitionEnd);
- window.clearTimeout(timeout);
- if (canvas.isConnected) callback();
- };
- const onTransitionEnd = (event: TransitionEvent) => {
- if (event.propertyName === "opacity") finish();
- };
-
- canvas.addEventListener("transitionend", onTransitionEnd);
- timeout = window.setTimeout(finish, CANVAS_FADE_FALLBACK_MS);
- return finish;
-}
-
function nextFrame() {
return new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));
}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/mobile-motion.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/mobile-motion.ts
new file mode 100644
index 000000000..92d1069b5
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/mobile-motion.ts
@@ -0,0 +1,17 @@
+export const MOBILE_AUTO_ROTATE_SPEED = 0.15;
+
+export type EvePointerInteractionMode = {
+ paintEnabled: boolean;
+ autoRotateEnvYaw: boolean;
+};
+
+export function evePointerInteractionMode(isCoarsePointer: boolean): EvePointerInteractionMode {
+ return {
+ paintEnabled: !isCoarsePointer,
+ autoRotateEnvYaw: isCoarsePointer,
+ };
+}
+
+export function mobileAutoEnvYaw(timeSeconds: number) {
+ return timeSeconds * MOBILE_AUTO_ROTATE_SPEED;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render.ts
index 9f23cd921..aba918e00 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render.ts
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render.ts
@@ -1,1211 +1,30 @@
-import { Device, type Buffer } from "@vgpu/core";
-import { createRenderPipeline, RenderPass } from "@vgpu/render";
-import { compile } from "@vgpu/wgsl";
-import glassBackWgsl from "./shaders/glass/back.wgsl";
-import glassFrontWgsl from "./shaders/glass/front.wgsl";
-import glassBackDepthWgsl from "./shaders/glass/back-depth.wgsl";
-import eveBloomBlurWgsl from "./shaders/bloom/blur.wgsl";
-import eveBloomCompositeWgsl from "./shaders/bloom/composite.wgsl";
-import eveLightCompositeWgsl from "./shaders/postprocess/light-composite.wgsl";
-import eveCubemapWgsl from "./shaders/cubemap/render.wgsl";
-import eveEnvBgWgsl from "./shaders/env/background.wgsl";
-import renderTargetPreviewWgsl from "./shaders/debug/render-target-preview.wgsl";
-
-export type Bounds = {
- min: [number, number, number];
- max: [number, number, number];
-};
-
-export type MeshData = {
- positions: Float32Array;
- normals: Float32Array;
- indices: Uint32Array;
- bounds: Bounds;
-};
-
-export type EveMaterial = "glass" | "normal" | "camera reflected normal" | "metallic" | "back-albedo" | "back-depth" | "thickness";
-
-export type ImprintRenderOptions = {
- progress?: number;
- gridScaleMultiplier?: number;
- glyphScale?: number;
- time?: number;
- mouse?: readonly [number, number];
-};
-
-export type RenderControls = {
- yaw: number;
- pitch: number;
- radius: number;
- fov: number;
- envYaw: number;
- envPitch: number;
- insideRendering: boolean;
- outsideRendering: boolean;
- material: EveMaterial;
- wireframe: boolean;
- showEnv: boolean;
-};
-
-type GpuMesh = {
- vertexBuffer: Buffer;
- indexBuffer: Buffer;
- lineIndexBuffer: Buffer;
- indexCount: number;
- lineIndexCount: number;
-};
-
-export type StudioCubemap = {
- texture: GPUTexture;
- view: GPUTextureView;
- sampler: GPUSampler;
- faceParams: Buffer;
-};
-
-const PARAMS_BYTE_SIZE = 176;
-const CUBE_MAX_LIGHTS = 16;
-const CUBE_LIGHT_FLOAT_COUNT = 12;
-const CUBE_PARAMS_FLOAT_COUNT = 4 + CUBE_MAX_LIGHTS * CUBE_LIGHT_FLOAT_COUNT;
-const CUBE_PARAMS_BYTE_SIZE = CUBE_PARAMS_FLOAT_COUNT * Float32Array.BYTES_PER_ELEMENT;
-export const CUBE_SIZE = 256;
-export const CUBE_FACE_COUNT = 6;
-export const CUBE_FORMAT: GPUTextureFormat = "rgba16float";
-export const BLOOM_RADIUS = 16;
-export const SCENE_FORMAT: GPUTextureFormat = "rgba16float";
-export const BLOOM_STRENGTH = 0.85;
-export const BLOOM_STRENGTH_OFF = BLOOM_STRENGTH;
-export const BLOOM_STRENGTH_ON = BLOOM_STRENGTH_OFF * 0.25;
-export const BLOOM_THRESHOLD = 0;
-const BACK_DEPTH_FORMAT: GPUTextureFormat = "depth32float";
-
-// The shader renders the back side first, then the front side. Keeping two passes
-// preserves the acrylic depth/overlap cues while avoiding a depth buffer.
-const PASS_INSIDE = 0;
-const PASS_OUTSIDE = 1;
-const PASS_WIREFRAME = 2;
-const MATERIAL_KIND: Record<EveMaterial, number> = {
- glass: 0,
- normal: 1,
- "camera reflected normal": 2,
- metallic: 3,
- "back-albedo": 0,
- "back-depth": 0,
- thickness: 4,
-};
-const CAMERA_CLIP_PADDING = 0.02;
-export const BASELINE_CAMERA_RADIUS = 1.9;
-export const BASELINE_CAMERA_FOV = 35;
-export const DEFAULT_CAMERA_FOV = BASELINE_CAMERA_FOV / 2;
-const EVE_THICKNESS_SCALE_MULTIPLIER = 1.3;
-const PREVIEW_BACK_ALBEDO = 0;
-const PREVIEW_BACK_DEPTH = 1;
-const DEFAULT_IMPRINT_CELL_SIZE = 16;
-const DEFAULT_IMPRINT_GLYPH_SCALE = 1.35;
-
-type Mat4 = Float32Array;
-type Vec3 = [number, number, number];
-
-type EnvLightConfig = {
- name: string;
- position: readonly [number, number, number];
- color: string;
- intensity: number;
- radius: number;
- softness: number;
- luminance: number;
-};
-
-// Editable environment-light knobs. Hex colors are sRGB and are converted to
-// linear values before the one-time cubemap bake. Light and dark intentionally
-// start as duplicated white studio setups so each theme can be tuned independently.
-export const EVE_LIGHT_ENV_LIGHTS = [
- { name: "top-left high", position: [-1.4, 2, -0.4], color: "#FFFFFF", intensity: 1, radius: 0.3, softness: 0.02, luminance: 10 },
- { name: "front high", position: [0, 0, 2], color: "#FFFFFF", intensity: 2, radius: 0.8, softness: 0.02, luminance: 1 },
- { name: "back high", position: [1, 0, -2], color: "#FFFFFF", intensity: 10, radius: 0.5, softness: 0.1, luminance: 0.2 },
- { name: "back-right", position: [0.4, -0.3, -1], color: "#FFFFFF", intensity: 1, radius: 0.1, softness: 1, luminance: 0.5 },
- { name: "front-bottom-right", position: [1, -2, -0.5], color: "#FFFFFF", intensity: 1, radius: 0.2, softness: 1, luminance: 5 },
- { name: "front-bottom-left", position: [-0.3, -0.2, -0.2], color: "#FFFFFF", intensity: 1, radius: 0.3, softness: 4, luminance: 3 },
-] as const satisfies readonly EnvLightConfig[];
-
-export const EVE_DARK_ENV_LIGHTS = [
- { name: "top-left high", position: [-1.3, 2, -0.3], color: "#FFFFFF", intensity: 2, radius: 0.3, softness: 0.02, luminance: 10 },
- { name: "front-left high", position: [-0.4, 1, 1], color: "#FFFFFF", intensity: 1, radius: 0.9, softness: 0.02, luminance: 1 },
- { name: "front-right", position: [5, 0, 10], color: "#FFFFFF", intensity: 1.5, radius: 0.5, softness: 0.1, luminance: 0.2 },
- { name: "back-right", position: [0.4, -0.3, -1], color: "#FFFFFF", intensity: 5, radius: 0.1, softness: 1, luminance: 0.5 },
- { name: "front-bottom-right", position: [1, -2, -0.5], color: "#FFFFFF", intensity: 1, radius: 0.2, softness: 1, luminance: 5 },
- { name: "front-bottom-left", position: [-0.3, -0.2, -0.2], color: "#FFFFFF", intensity: 1, radius: 0.3, softness: 4, luminance: 3 },
-] as const satisfies readonly EnvLightConfig[];
-
-export function createEve5Renderer(
- device: Device,
- format: GPUTextureFormat,
- mesh: MeshData,
- options: { thicknessScale?: number; theme?: "light" | "dark"; paddingRadius?: number; bloom?: boolean } = {},
-) {
- const studioCubemap = createStudioCubemap(device, "eve-5-studio-hdr-cubemap");
- const isLight = options.theme === "light";
- const envLights = isLight ? EVE_LIGHT_ENV_LIGHTS : EVE_DARK_ENV_LIGHTS;
- renderStudioCubemap(device, studioCubemap, envLights);
- const orbitTarget = meshOrbitTarget(mesh);
- const thicknessScale = options.thicknessScale ?? meshThicknessScale(mesh.bounds);
- const paddingRadius = options.paddingRadius ?? BLOOM_RADIUS;
- const bloomEnabled = options.bloom ?? true;
-
- const glassBackShader = device.createShader(compile(glassBackWgsl));
- const glassFrontShader = device.createShader(compile(glassFrontWgsl));
- const glassBackDepthShader = device.createShader(compile(glassBackDepthWgsl));
- const vertexLayout: GPUVertexBufferLayout = {
- arrayStride: 6 * 4,
- attributes: [
- { shaderLocation: 0, offset: 0, format: "float32x3" },
- { shaderLocation: 1, offset: 3 * 4, format: "float32x3" },
- ],
- };
-
- const backMaterialPipeline = createRenderPipeline(device, {
- label: "eve-5-glass-back-material-pipeline",
- shader: glassBackShader,
- vertex: { entry: "vs_main", buffers: [vertexLayout] },
- fragment: {
- entry: "fs_main",
- targets: [
- {
- format: SCENE_FORMAT,
- blend: {
- color: { srcFactor: "src-alpha", dstFactor: "one", operation: "add" },
- alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },
- },
- },
- ],
- },
- primitive: { topology: "triangle-list" },
- depthStencil: { format: BACK_DEPTH_FORMAT, depthWriteEnabled: true, depthCompare: "less" },
- });
-
- const backDepthPipeline = createRenderPipeline(device, {
- label: "eve-5-glass-back-depth-pipeline",
- shader: glassBackDepthShader,
- vertex: { entry: "vs_main", buffers: [vertexLayout] },
- fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },
- primitive: { topology: "triangle-list" },
- depthStencil: { format: BACK_DEPTH_FORMAT, depthWriteEnabled: false, depthCompare: "less-equal" },
- });
-
- const frontMaterialPipeline = createRenderPipeline(device, {
- label: "eve-5-glass-front-material-pipeline",
- shader: glassFrontShader,
- vertex: { entry: "vs_main", buffers: [vertexLayout] },
- fragment: {
- entry: "fs_main",
- targets: [
- {
- format: SCENE_FORMAT,
- blend: {
- color: { srcFactor: "src-alpha", dstFactor: "one", operation: "add" },
- alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },
- },
- },
- ],
- },
- primitive: { topology: "triangle-list" },
- });
-
- const frontDisplayPipeline = createRenderPipeline(device, {
- label: "eve-5-glass-front-display-pipeline",
- shader: glassFrontShader,
- vertex: { entry: "vs_main", buffers: [vertexLayout] },
- fragment: { entry: "fs_main", targets: [{ format }] },
- primitive: { topology: "triangle-list" },
- });
-
- const opaquePipeline = createRenderPipeline(device, {
- label: "eve-5-opaque-material-pipeline",
- shader: glassFrontShader,
- vertex: { entry: "vs_main", buffers: [vertexLayout] },
- fragment: {
- entry: "fs_main",
- targets: [
- {
- format: SCENE_FORMAT,
- blend: {
- color: { srcFactor: "one", dstFactor: "zero", operation: "add" },
- alpha: { srcFactor: "one", dstFactor: "zero", operation: "add" },
- },
- },
- ],
- },
- primitive: { topology: "triangle-list" },
- });
-
- const wirePipeline = createRenderPipeline(device, {
- label: "eve-5-wireframe-pipeline",
- shader: glassFrontShader,
- vertex: { entry: "vs_main", buffers: [vertexLayout] },
- fragment: {
- entry: "fs_main",
- targets: [
- {
- format: SCENE_FORMAT,
- blend: {
- color: { srcFactor: "src-alpha", dstFactor: "one-minus-src-alpha", operation: "add" },
- alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },
- },
- },
- ],
- },
- primitive: { topology: "line-list" },
- });
-
- const blurPipeline = createRenderPipeline(device, {
- label: "eve-5-bloom-blur-pipeline",
- shader: device.createShader(compile(eveBloomBlurWgsl)),
- vertex: { entry: "vs_main" },
- fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },
- primitive: { topology: "triangle-list" },
- });
-
- const compositePipeline = createRenderPipeline(device, {
- label: "eve-5-bloom-composite-pipeline",
- shader: device.createShader(compile(eveBloomCompositeWgsl)),
- vertex: { entry: "vs_main" },
- fragment: { entry: "fs_main", targets: [{ format }] },
- primitive: { topology: "triangle-list" },
- });
-
- const lightCompositePipeline = createRenderPipeline(device, {
- label: "eve-5-light-composite-pipeline",
- shader: device.createShader(compile(eveLightCompositeWgsl)),
- vertex: { entry: "vs_main" },
- fragment: { entry: "fs_main", targets: [{ format }] },
- primitive: { topology: "triangle-list" },
- });
-
- const envBgPipeline = createRenderPipeline(device, {
- label: "eve-5-env-bg-pipeline",
- shader: device.createShader(compile(eveEnvBgWgsl)),
- vertex: { entry: "vs_main" },
- fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },
- primitive: { topology: "triangle-list" },
- });
-
- const previewPipeline = createRenderPipeline(device, {
- label: "eve-5-render-target-preview-pipeline",
- shader: device.createShader(compile(renderTargetPreviewWgsl)),
- vertex: { entry: "vs_main" },
- fragment: { entry: "fs_main", targets: [{ format }] },
- primitive: { topology: "triangle-list" },
- });
-
- const gpuMesh = createGpuMesh(device, mesh);
- const insideParams = createBackParamsBinding(device, backMaterialPipeline, studioCubemap, "eve-5-inside-params");
- const backDepthParams = createUniformParamsBinding(device, backDepthPipeline, "eve-5-back-depth-params");
- const envBgParams = createEnvParamsBinding(device, envBgPipeline, studioCubemap, "eve-5-env-bg-params");
- const outsideParams = createParamsBinding(device, frontMaterialPipeline, studioCubemap, "eve-5-outside-params");
- const opaqueOutsideParams = createParamsBinding(device, opaquePipeline, studioCubemap, "eve-5-opaque-outside-params");
- const wireParams = createParamsBinding(device, wirePipeline, studioCubemap, "eve-5-wire-params");
- const blurParamsBuffer = device.createBuffer({
- label: "eve-5-bloom-blur-params",
- size: 16,
- usage: ["uniform", "copy_dst"],
- });
- const compositeParamsBuffer = device.createBuffer({
- label: "eve-5-bloom-composite-params",
- size: 16,
- usage: ["uniform", "copy_dst"],
- });
- const blurSampler = device.gpu.createSampler({
- label: "eve-5-bloom-sampler",
- magFilter: "linear",
- minFilter: "linear",
- addressModeU: "clamp-to-edge",
- addressModeV: "clamp-to-edge",
- });
- const previewSampler = device.gpu.createSampler({
- label: "eve-5-render-target-preview-sampler",
- magFilter: "linear",
- minFilter: "linear",
- addressModeU: "clamp-to-edge",
- addressModeV: "clamp-to-edge",
- });
- const previewMode = device.createBuffer({
- label: "eve-5-render-target-preview-mode",
- size: 16,
- usage: ["uniform", "copy_dst"],
- });
- let bloomTargets: BloomTargets | undefined;
-
- const writeParams = (
- target: { buffer: Buffer },
- controls: RenderControls,
- logicalWidth: number,
- logicalHeight: number,
- passKind: number,
- projectionPaddingRadius = paddingRadius,
- imprint: ImprintRenderOptions = {},
- ) => {
- const padded = getPaddedRenderSize(logicalWidth, logicalHeight, projectionPaddingRadius);
- const fovRad = degreesToRadians(controls.fov);
- const verticalScale = padded.height / logicalHeight;
- const fovEff = 2 * Math.atan(verticalScale * Math.tan(fovRad * 0.5));
- const aspect = padded.width / padded.height;
- const eye = orbitEye(orbitTarget, controls.radius, controls.yaw, controls.pitch);
- const basis = cameraBasis(eye, orbitTarget);
- const clip = cameraClipPlanes(mesh.bounds, eye, basis.forward);
- const proj = perspective(fovEff, aspect, clip.near, clip.far);
- const view = lookAt(eye, orbitTarget, [0, 1, 0]);
- const viewProj = multiply(proj, view);
- const data = new Float32Array(44);
- data.set(viewProj, 0);
- data[16] = eye[0];
- data[17] = eye[1];
- data[18] = eye[2];
- data[19] = passKind;
- data[20] = basis.right[0];
- data[21] = basis.right[1];
- data[22] = basis.right[2];
- data[23] = fovEff;
- data[24] = basis.up[0];
- data[25] = basis.up[1];
- data[26] = basis.up[2];
- data[27] = aspect;
- data[28] = basis.forward[0];
- data[29] = basis.forward[1];
- data[30] = basis.forward[2];
- data[31] = MATERIAL_KIND[controls.material];
- data[32] = thicknessScale;
- data[33] = controls.envYaw;
- data[34] = controls.envPitch;
- data[35] = isLight ? 0 : 1;
- const distToFrontPlane = Math.max(0.001, -dot(eye, basis.forward));
- const pxPerModelUnit = padded.height / (2 * distToFrontPlane * Math.tan(fovEff * 0.5));
- const gridScale = (pxPerModelUnit / DEFAULT_IMPRINT_CELL_SIZE) * Math.max(0.001, imprint.gridScaleMultiplier ?? 1);
- data[36] = Math.max(0, Math.min(1, imprint.progress ?? 0));
- data[37] = gridScale;
- data[38] = Math.max(0.1, imprint.glyphScale ?? DEFAULT_IMPRINT_GLYPH_SCALE);
- data[39] = imprint.time ?? 0;
- data[40] = imprint.mouse?.[0] ?? 0;
- data[41] = imprint.mouse?.[1] ?? 0;
- data[42] = 0;
- data[43] = 0;
- target.buffer.write(data);
- };
-
- const ensureBloomTargets = (logicalWidth: number, logicalHeight: number) => {
- const padded = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);
- if (bloomTargets?.width === padded.width && bloomTargets.height === padded.height) return bloomTargets;
- bloomTargets?.scene.destroy();
- bloomTargets?.backMaterial.destroy();
- bloomTargets?.backDepth.destroy();
- bloomTargets?.backSurfaceDepth.destroy();
- bloomTargets?.horizontal.destroy();
- bloomTargets?.vertical.destroy();
- bloomTargets = {
- width: padded.width,
- height: padded.height,
- scene: createBloomTexture(device, "eve-5-scene-linear-hdr", padded.width, padded.height),
- backMaterial: createBloomTexture(device, "eve-5-back-material-linear-hdr", padded.width, padded.height),
- backDepth: createBloomTexture(device, "eve-5-back-camera-axis-depth", padded.width, padded.height),
- backSurfaceDepth: createBackDepthTexture(device, "eve-5-back-surface-depth", padded.width, padded.height),
- horizontal: createBloomTexture(device, "eve-5-bloom-horizontal", padded.width, padded.height),
- vertical: createBloomTexture(device, "eve-5-bloom-vertical", padded.width, padded.height),
- };
- return bloomTargets;
- };
-
- const renderBackMaterial = (
- target: GPUTextureView,
- depth: GPUTextureView,
- controls: RenderControls,
- logicalWidth: number,
- logicalHeight: number,
- projectionPaddingRadius = paddingRadius,
- ) => {
- writeParams(insideParams, controls, logicalWidth, logicalHeight, PASS_INSIDE, projectionPaddingRadius);
- const pass = new RenderPass(device, {
- label: "eve-5-back-material-pass",
- colorAttachments: [{ view: target, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
- depthStencilAttachment: {
- view: depth,
- depthClearValue: 1,
- depthLoadOp: "clear",
- depthStoreOp: "store",
- },
- });
- if (controls.insideRendering) {
- pass.setPipeline(backMaterialPipeline);
- pass.setVertexBuffer(0, gpuMesh.vertexBuffer);
- pass.gpu.setIndexBuffer(gpuMesh.indexBuffer.gpu, "uint32");
- pass.setBindGroup(0, insideParams.bindGroup);
- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);
- }
- pass.end();
- };
-
- const renderBackDepth = (
- target: GPUTextureView,
- depth: GPUTextureView,
- controls: RenderControls,
- logicalWidth: number,
- logicalHeight: number,
- projectionPaddingRadius = paddingRadius,
- ) => {
- writeParams(backDepthParams, controls, logicalWidth, logicalHeight, PASS_INSIDE, projectionPaddingRadius);
- const pass = new RenderPass(device, {
- label: "eve-5-back-depth-pass",
- colorAttachments: [{ view: target, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
- depthStencilAttachment: {
- view: depth,
- depthLoadOp: "load",
- depthStoreOp: "store",
- },
- });
- if (controls.insideRendering) {
- pass.setPipeline(backDepthPipeline);
- pass.setVertexBuffer(0, gpuMesh.vertexBuffer);
- pass.gpu.setIndexBuffer(gpuMesh.indexBuffer.gpu, "uint32");
- pass.setBindGroup(0, backDepthParams.bindGroup);
- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);
- }
- pass.end();
- };
-
- const renderScene = (
- view: GPUTextureView,
- backMaterial: GPUTexture,
- backDepth: GPUTexture,
- controls: RenderControls,
- logicalWidth: number,
- logicalHeight: number,
- projectionPaddingRadius = paddingRadius,
- imprint: ImprintRenderOptions = {},
- ) => {
- writeParams(outsideParams, controls, logicalWidth, logicalHeight, PASS_OUTSIDE, projectionPaddingRadius, imprint);
- writeParams(wireParams, controls, logicalWidth, logicalHeight, PASS_WIREFRAME, projectionPaddingRadius);
- writeParams(envBgParams, controls, logicalWidth, logicalHeight, PASS_OUTSIDE, projectionPaddingRadius);
- writeParams(opaqueOutsideParams, controls, logicalWidth, logicalHeight, PASS_OUTSIDE, projectionPaddingRadius);
-
- const outsideBindGroup = createParamsBindGroup(
- device,
- frontMaterialPipeline,
- studioCubemap,
- outsideParams.buffer,
- backMaterial.createView(),
- backDepth.createView(),
- "eve-5-outside-params-bind-group",
- );
-
- const pass = new RenderPass(device, {
- label: "eve-5-scene-hdr-pass",
- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, isLight ? 0 : 1] }],
- });
-
- // Optional environment background: draw the studio cubemap behind the logo so the lighting
- // is visible. Fullscreen triangle, no vertex buffer, so do it before binding the mesh.
- if (controls.showEnv) {
- pass.setPipeline(envBgPipeline);
- pass.setBindGroup(0, envBgParams.bindGroup);
- pass.draw(3);
- }
-
- pass.setVertexBuffer(0, gpuMesh.vertexBuffer);
-
- const needsBackTargets = controls.material === "glass" || controls.material === "thickness";
- pass.gpu.setIndexBuffer(gpuMesh.indexBuffer.gpu, "uint32");
- if (needsBackTargets) {
- // The back/inside material and camera-axis depth have already been rendered into offscreen
- // targets. The main scene draws only the front/outside material; glass and thickness debug
- // both need the real back targets rather than the opaque/debug fallback bind group.
- if (controls.outsideRendering) {
- pass.setPipeline(frontMaterialPipeline);
- pass.setBindGroup(0, outsideBindGroup);
- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);
- }
- } else if (controls.outsideRendering) {
- // Opaque/debug materials are single-surface views. Drawing the inside pass too would
- // double-expose through the depthless transparent ordering used by glass.
- pass.setPipeline(opaquePipeline);
- pass.setBindGroup(0, opaqueOutsideParams.bindGroup);
- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);
- }
-
- if (controls.wireframe) {
- pass.setPipeline(wirePipeline);
- pass.gpu.setIndexBuffer(gpuMesh.lineIndexBuffer.gpu, "uint32");
- pass.setBindGroup(0, wireParams.bindGroup);
- pass.gpu.drawIndexed(gpuMesh.lineIndexCount, 1, 0, 0, 0);
- }
-
- pass.end();
- };
-
- const renderTargetPreview = (view: GPUTextureView, targets: BloomTargets, controls: RenderControls) => {
- const basis = cameraBasis(orbitEye(orbitTarget, controls.radius, controls.yaw, controls.pitch), orbitTarget);
- const depthRange = cameraAxisDepthRange(mesh.bounds, basis.forward);
- previewMode.write(
- new Float32Array([
- controls.material === "back-depth" ? PREVIEW_BACK_DEPTH : PREVIEW_BACK_ALBEDO,
- depthRange.min,
- depthRange.max,
- 0,
- ]),
- );
- const bindGroup = device.gpu.createBindGroup({
- label: "eve-5-render-target-preview-bind-group",
- layout: previewPipeline.getBindGroupLayout(0),
- entries: [
- { binding: 0, resource: targets.backMaterial.createView() },
- { binding: 1, resource: targets.backDepth.createView() },
- { binding: 2, resource: previewSampler },
- { binding: 3, resource: { buffer: previewMode.gpu } },
- ],
- });
- const pass = new RenderPass(device, {
- label: "eve-5-render-target-preview-pass",
- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
- });
- pass.setPipeline(previewPipeline);
- pass.setBindGroup(0, bindGroup);
- pass.draw(3);
- pass.end();
- };
-
- const renderThicknessDebug = (
- view: GPUTextureView,
- backMaterial: GPUTexture,
- backDepth: GPUTexture,
- controls: RenderControls,
- logicalWidth: number,
- logicalHeight: number,
- projectionPaddingRadius = paddingRadius,
- ) => {
- writeParams(outsideParams, controls, logicalWidth, logicalHeight, PASS_OUTSIDE, projectionPaddingRadius);
- const outsideBindGroup = createParamsBindGroup(
- device,
- frontDisplayPipeline,
- studioCubemap,
- outsideParams.buffer,
- backMaterial.createView(),
- backDepth.createView(),
- "eve-5-thickness-debug-params-bind-group",
- );
-
- const pass = new RenderPass(device, {
- label: "eve-5-thickness-debug-pass",
- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
- });
- pass.setVertexBuffer(0, gpuMesh.vertexBuffer);
- pass.gpu.setIndexBuffer(gpuMesh.indexBuffer.gpu, "uint32");
- if (controls.outsideRendering) {
- pass.setPipeline(frontDisplayPipeline);
- pass.setBindGroup(0, outsideBindGroup);
- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);
- }
- pass.end();
- };
-
- const renderBlur = (source: GPUTexture, target: GPUTexture, direction: [number, number], extract: boolean) => {
- blurParamsBuffer.write(new Float32Array([direction[0], direction[1], extract ? 1 : 0, BLOOM_THRESHOLD]));
- const bindGroup = device.gpu.createBindGroup({
- label: "eve-5-bloom-blur-bind-group",
- layout: blurPipeline.getBindGroupLayout(0),
- entries: [
- { binding: 0, resource: source.createView() },
- { binding: 1, resource: blurSampler },
- { binding: 2, resource: { buffer: blurParamsBuffer.gpu } },
- ],
- });
- const pass = new RenderPass(device, {
- label: `eve-5-bloom-${direction[0] > 0 ? "horizontal" : "vertical"}-pass`,
- colorAttachments: [{ view: target.createView(), loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
- });
- pass.setPipeline(blurPipeline);
- pass.setBindGroup(0, bindGroup);
- pass.draw(3);
- pass.end();
- };
-
- const renderComposite = (view: GPUTextureView, targets: BloomTargets, bloomTexture: GPUTexture = targets.vertical, strength = BLOOM_STRENGTH_OFF) => {
- compositeParamsBuffer.write(new Float32Array([strength, 0, 0, 0]));
- const bindGroup = device.gpu.createBindGroup({
- label: "eve-5-bloom-composite-bind-group",
- layout: compositePipeline.getBindGroupLayout(0),
- entries: [
- { binding: 0, resource: targets.scene.createView() },
- { binding: 1, resource: bloomTexture.createView() },
- { binding: 2, resource: blurSampler },
- { binding: 3, resource: { buffer: compositeParamsBuffer.gpu } },
- ],
- });
- const pass = new RenderPass(device, {
- label: "eve-5-composite-tonemap-pass",
- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
- });
- pass.setPipeline(compositePipeline);
- pass.setBindGroup(0, bindGroup);
- pass.draw(3);
- pass.end();
- };
-
- const renderLightComposite = (view: GPUTextureView, targets: BloomTargets) => {
- const bindGroup = device.gpu.createBindGroup({
- label: "eve-5-light-composite-bind-group",
- layout: lightCompositePipeline.getBindGroupLayout(0),
- entries: [
- { binding: 0, resource: targets.scene.createView() },
- { binding: 1, resource: blurSampler },
- ],
- });
- const pass = new RenderPass(device, {
- label: "eve-5-light-composite-premultiplied-pass",
- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 0] }],
- });
- pass.setPipeline(lightCompositePipeline);
- pass.setBindGroup(0, bindGroup);
- pass.draw(3);
- pass.end();
- };
-
- const renderGlassTarget = (target: GPUTextureView, controls: RenderControls, logicalWidth: number, logicalHeight: number, imprint: ImprintRenderOptions = {}) => {
- const safeWidth = Math.max(1, Math.round(logicalWidth));
- const safeHeight = Math.max(1, Math.round(logicalHeight));
- const targets = ensureBloomTargets(safeWidth, safeHeight);
- const backSurfaceDepthView = targets.backSurfaceDepth.createView();
- renderBackMaterial(targets.backMaterial.createView(), backSurfaceDepthView, controls, safeWidth, safeHeight);
- renderBackDepth(targets.backDepth.createView(), backSurfaceDepthView, controls, safeWidth, safeHeight);
- if (controls.material === "back-albedo" || controls.material === "back-depth") {
- renderTargetPreview(target, targets, controls);
- return;
- }
- if (controls.material === "thickness") {
- renderThicknessDebug(target, targets.backMaterial, targets.backDepth, controls, safeWidth, safeHeight);
- return;
- }
- renderScene(targets.scene.createView(), targets.backMaterial, targets.backDepth, controls, safeWidth, safeHeight, paddingRadius, imprint);
- if (isLight) {
- renderLightComposite(target, targets);
- return;
- }
- if (!bloomEnabled) {
- renderComposite(target, targets, targets.scene, 0);
- return;
- }
- const effectiveBloomStrength = mix(BLOOM_STRENGTH_OFF, BLOOM_STRENGTH_ON, clampUnit(imprint.progress ?? 0));
- renderBlur(targets.scene, targets.horizontal, [1, 0], true);
- renderBlur(targets.horizontal, targets.vertical, [0, 1], false);
- renderComposite(target, targets, targets.vertical, effectiveBloomStrength);
- };
-
- return {
- render(target: GPUTextureView, controls: RenderControls, logicalWidth: number, logicalHeight: number, imprint?: ImprintRenderOptions) {
- renderGlassTarget(target, controls, logicalWidth, logicalHeight, imprint);
- },
- dispose() {
- gpuMesh.vertexBuffer.destroy();
- gpuMesh.indexBuffer.destroy();
- gpuMesh.lineIndexBuffer.destroy();
- insideParams.buffer.destroy();
- backDepthParams.buffer.destroy();
- outsideParams.buffer.destroy();
- outsideParams.fallbackBackMaterial.destroy();
- outsideParams.fallbackBackDepth.destroy();
- opaqueOutsideParams.buffer.destroy();
- opaqueOutsideParams.fallbackBackMaterial.destroy();
- opaqueOutsideParams.fallbackBackDepth.destroy();
- wireParams.buffer.destroy();
- wireParams.fallbackBackMaterial.destroy();
- wireParams.fallbackBackDepth.destroy();
- envBgParams.buffer.destroy();
- blurParamsBuffer.destroy();
- compositeParamsBuffer.destroy();
- previewMode.destroy();
- bloomTargets?.scene.destroy();
- bloomTargets?.backMaterial.destroy();
- bloomTargets?.backDepth.destroy();
- bloomTargets?.backSurfaceDepth.destroy();
- bloomTargets?.horizontal.destroy();
- bloomTargets?.vertical.destroy();
- studioCubemap.faceParams.destroy();
- studioCubemap.texture.destroy();
- },
- };
-}
-
-type BloomTargets = {
- width: number;
- height: number;
- scene: GPUTexture;
- backMaterial: GPUTexture;
- backDepth: GPUTexture;
- backSurfaceDepth: GPUTexture;
- horizontal: GPUTexture;
- vertical: GPUTexture;
-};
-
-export function getPaddedRenderSize(width: number, height: number, paddingRadius = BLOOM_RADIUS) {
- const padding = Math.max(0, Math.round(paddingRadius)) * 2;
- return {
- width: Math.max(1, Math.round(width)) + padding,
- height: Math.max(1, Math.round(height)) + padding,
- };
-}
-
-function createBloomTexture(device: Device, label: string, width: number, height: number) {
- return device.gpu.createTexture({
- label,
- size: [width, height],
- format: SCENE_FORMAT,
- usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,
- });
-}
-
-function createBackDepthTexture(device: Device, label: string, width: number, height: number) {
- return device.gpu.createTexture({
- label,
- size: [width, height],
- format: BACK_DEPTH_FORMAT,
- usage: GPUTextureUsage.RENDER_ATTACHMENT,
- });
-}
-
-export function createStudioCubemap(device: Device, label = "eve-5-studio-hdr-cubemap"): StudioCubemap {
- const texture = device.gpu.createTexture({
- label,
- size: { width: CUBE_SIZE, height: CUBE_SIZE, depthOrArrayLayers: CUBE_FACE_COUNT },
- dimension: "2d",
- format: CUBE_FORMAT,
- usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,
- });
- // Dawn's node adapter runs in compatibility mode and validates cube views as 2D arrays.
- // Keep the asset semantically as a cubemap, but bind/sample it as six array layers.
- const view = texture.createView({ dimension: "2d-array", baseArrayLayer: 0, arrayLayerCount: CUBE_FACE_COUNT });
- const sampler = device.gpu.createSampler({
- label: "eve-5-studio-hdr-cubemap-sampler",
- magFilter: "linear",
- minFilter: "linear",
- });
- const faceParams = device.createBuffer({
- label: "eve-5-studio-cubemap-face-params",
- size: CUBE_PARAMS_BYTE_SIZE,
- usage: ["uniform", "copy_dst"],
- });
- return { texture, view, sampler, faceParams };
-}
-
-export function renderStudioCubemap(device: Device, cubemap: StudioCubemap, lights: readonly EnvLightConfig[], globalIntensity = 1) {
- const pipeline = createRenderPipeline(device, {
- label: "eve-5-studio-cubemap-bake-pipeline",
- shader: device.createShader(compile(eveCubemapWgsl)),
- vertex: { entry: "vs_main" },
- fragment: { entry: "fs_main", targets: [{ format: CUBE_FORMAT }] },
- primitive: { topology: "triangle-list" },
- });
-
- const bindGroup = device.gpu.createBindGroup({
- label: "eve-5-studio-cubemap-bake-bind-group",
- layout: pipeline.getBindGroupLayout(0),
- entries: [{ binding: 0, resource: { buffer: cubemap.faceParams.gpu } }],
- });
-
- for (let face = 0; face < CUBE_FACE_COUNT; face += 1) {
- cubemap.faceParams.write(cubeParamsData(face, lights, globalIntensity));
- const pass = new RenderPass(device, {
- label: `eve-5-studio-cubemap-face-${face}`,
- colorAttachments: [
- {
- view: cubemap.texture.createView({ dimension: "2d", baseArrayLayer: face, arrayLayerCount: 1 }),
- loadOp: "clear",
- storeOp: "store",
- clearValue: [0, 0, 0, 1],
- },
- ],
- });
- pass.setPipeline(pipeline);
- pass.setBindGroup(0, bindGroup);
- pass.draw(3);
- pass.end();
- }
-}
-
-function cubeParamsData(face: number, lights: readonly EnvLightConfig[], globalIntensity: number) {
- if (lights.length > CUBE_MAX_LIGHTS) {
- throw new Error(`Studio cubemap supports up to ${CUBE_MAX_LIGHTS} lights, received ${lights.length}`);
- }
-
- const data = new Float32Array(CUBE_PARAMS_FLOAT_COUNT);
- data[0] = face;
- data[1] = lights.length;
-
- lights.forEach((light, index) => {
- const [r, g, b] = lightColorLinear(light);
- const offset = 4 + index * CUBE_LIGHT_FLOAT_COUNT;
- data[offset] = light.position[0];
- data[offset + 1] = light.position[1];
- data[offset + 2] = light.position[2];
- data[offset + 3] = light.radius;
- data[offset + 4] = r;
- data[offset + 5] = g;
- data[offset + 6] = b;
- data[offset + 7] = light.intensity * globalIntensity;
- data[offset + 8] = light.softness;
- data[offset + 9] = light.luminance;
- });
-
- return data;
-}
-
-function lightColorLinear(light: EnvLightConfig): Vec3 {
- return srgbHexToLinear(light.color);
-}
-
-function srgbHexToLinear(hex: string): Vec3 {
- const normalized = hex.replace(/^#/, "");
- if (!/^[0-9a-fA-F]{6}$/.test(normalized)) {
- throw new Error(`Expected a 6-digit sRGB hex color, received ${hex}`);
- }
- return [0, 2, 4].map((offset) => {
- const channel = Number.parseInt(normalized.slice(offset, offset + 2), 16) / 255;
- return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;
- }) as Vec3;
-}
-
-function createEnvParamsBinding(device: Device, pipeline: GPURenderPipeline, cubemap: StudioCubemap, label: string) {
- const buffer = device.createBuffer({ size: PARAMS_BYTE_SIZE, usage: ["uniform", "copy_dst"], label });
- const bindGroup = device.gpu.createBindGroup({
- label: `${label}-bind-group`,
- layout: pipeline.getBindGroupLayout(0),
- entries: [
- { binding: 0, resource: { buffer: buffer.gpu } },
- { binding: 1, resource: cubemap.view },
- { binding: 2, resource: cubemap.sampler },
- ],
- });
- return { buffer, bindGroup };
-}
-
-function createBackParamsBinding(device: Device, pipeline: GPURenderPipeline, cubemap: StudioCubemap, label: string) {
- const buffer = device.createBuffer({ size: PARAMS_BYTE_SIZE, usage: ["uniform", "copy_dst"], label });
- const bindGroup = device.gpu.createBindGroup({
- label: `${label}-bind-group`,
- layout: pipeline.getBindGroupLayout(0),
- entries: [
- { binding: 0, resource: { buffer: buffer.gpu } },
- { binding: 1, resource: cubemap.view },
- { binding: 2, resource: cubemap.sampler },
- ],
- });
- return { buffer, bindGroup };
-}
-
-function createUniformParamsBinding(device: Device, pipeline: GPURenderPipeline, label: string) {
- const buffer = device.createBuffer({ size: PARAMS_BYTE_SIZE, usage: ["uniform", "copy_dst"], label });
- const bindGroup = device.gpu.createBindGroup({
- label: `${label}-bind-group`,
- layout: pipeline.getBindGroupLayout(0),
- entries: [{ binding: 0, resource: { buffer: buffer.gpu } }],
- });
- return { buffer, bindGroup };
-}
-
-function createParamsBinding(
- device: Device,
- pipeline: GPURenderPipeline,
- cubemap: StudioCubemap,
- label: string,
- backMaterialView?: GPUTextureView,
- backDepthView?: GPUTextureView,
-) {
- const buffer = device.createBuffer({ size: PARAMS_BYTE_SIZE, usage: ["uniform", "copy_dst"], label });
- const fallbackBackMaterial = device.gpu.createTexture({
- label: `${label}-empty-back-material`,
- size: [1, 1],
- format: SCENE_FORMAT,
- usage: GPUTextureUsage.TEXTURE_BINDING,
- });
- const fallbackBackDepth = device.gpu.createTexture({
- label: `${label}-empty-back-depth`,
- size: [1, 1],
- format: SCENE_FORMAT,
- usage: GPUTextureUsage.TEXTURE_BINDING,
- });
- const bindGroup = createParamsBindGroup(
- device,
- pipeline,
- cubemap,
- buffer,
- backMaterialView ?? fallbackBackMaterial.createView(),
- backDepthView ?? fallbackBackDepth.createView(),
- `${label}-bind-group`,
- );
- return { buffer, bindGroup, fallbackBackMaterial, fallbackBackDepth };
-}
-
-function createParamsBindGroup(
- device: Device,
- pipeline: GPURenderPipeline,
- cubemap: StudioCubemap,
- buffer: Buffer,
- backMaterialView: GPUTextureView,
- backDepthView: GPUTextureView,
- label: string,
-) {
- return device.gpu.createBindGroup({
- label,
- layout: pipeline.getBindGroupLayout(0),
- entries: [
- { binding: 0, resource: { buffer: buffer.gpu } },
- { binding: 1, resource: cubemap.view },
- { binding: 2, resource: cubemap.sampler },
- { binding: 3, resource: backMaterialView },
- { binding: 4, resource: backDepthView },
- ],
- });
-}
-
-function createGpuMesh(device: Device, mesh: MeshData): GpuMesh {
- const vertices = normalizeMeshForGpu(mesh);
- const lineIndices = triangleIndicesToLineIndices(mesh.indices);
-
- const vertexBuffer = device.createBuffer({
- label: "eve-5-logo-vertices",
- size: vertices.byteLength,
- usage: ["vertex", "copy_dst"],
- });
- vertexBuffer.write(vertices);
-
- const indexBuffer = device.createBuffer({
- label: "eve-5-logo-indices",
- size: mesh.indices.byteLength,
- usage: ["index", "copy_dst"],
- });
- indexBuffer.write(new Uint32Array(mesh.indices));
-
- const lineIndexBuffer = device.createBuffer({
- label: "eve-5-logo-line-indices",
- size: lineIndices.byteLength,
- usage: ["index", "copy_dst"],
- });
- lineIndexBuffer.write(lineIndices);
-
- return {
- vertexBuffer,
- indexBuffer,
- lineIndexBuffer,
- indexCount: mesh.indices.length,
- lineIndexCount: lineIndices.length,
- };
-}
-
-function normalizeMeshForGpu(mesh: MeshData) {
- const height = mesh.bounds.max[1] - mesh.bounds.min[1];
- const centerX = (mesh.bounds.min[0] + mesh.bounds.max[0]) * 0.5;
- const centerY = (mesh.bounds.min[1] + mesh.bounds.max[1]) * 0.5;
- const frontZ = mesh.bounds.max[2];
- const data = new Float32Array((mesh.positions.length / 3) * 6);
-
- for (let i = 0, j = 0; i < mesh.positions.length; i += 3, j += 6) {
- data[j] = (mesh.positions[i]! - centerX) / height;
- data[j + 1] = (mesh.positions[i + 1]! - centerY) / height;
- data[j + 2] = (mesh.positions[i + 2]! - frontZ) / height;
- data[j + 3] = mesh.normals[i]!;
- data[j + 4] = mesh.normals[i + 1]!;
- data[j + 5] = mesh.normals[i + 2]!;
- }
-
- return data;
-}
-
-function triangleIndicesToLineIndices(indices: Uint32Array) {
- const lines = new Uint32Array(indices.length * 2);
- for (let i = 0, j = 0; i < indices.length; i += 3, j += 6) {
- const a = indices[i]!;
- const b = indices[i + 1]!;
- const c = indices[i + 2]!;
- lines[j] = a;
- lines[j + 1] = b;
- lines[j + 2] = b;
- lines[j + 3] = c;
- lines[j + 4] = c;
- lines[j + 5] = a;
- }
- return lines;
-}
-
-function meshOrbitTarget(mesh: MeshData): Vec3 {
- const height = mesh.bounds.max[1] - mesh.bounds.min[1] || 1;
- const depth = mesh.bounds.max[2] - mesh.bounds.min[2];
- return [0, 0, -depth / (height * 2)];
-}
-
-export function meshThicknessScale(bounds: Bounds) {
- // The shader computes camera-axis depth from the normalized GPU mesh coordinates created in
- // normalizeMeshForGpu(...), not raw glTF/model units. Keep the real EVE logo normalization in the
- // same coordinate space; otherwise the tiny raw Z extent clamps the thickness debug to white.
- const height = bounds.max[1] - bounds.min[1] || 1;
- const normalizedZExtent = (bounds.max[2] - bounds.min[2]) / height;
- return Math.max(normalizedZExtent * EVE_THICKNESS_SCALE_MULTIPLIER, 0.000001);
-}
-
-function cameraClipPlanes(bounds: Bounds, eye: Vec3, forward: Vec3) {
- const corners: Vec3[] = [
- [bounds.min[0], bounds.min[1], bounds.min[2]],
- [bounds.min[0], bounds.min[1], bounds.max[2]],
- [bounds.min[0], bounds.max[1], bounds.min[2]],
- [bounds.min[0], bounds.max[1], bounds.max[2]],
- [bounds.max[0], bounds.min[1], bounds.min[2]],
- [bounds.max[0], bounds.min[1], bounds.max[2]],
- [bounds.max[0], bounds.max[1], bounds.min[2]],
- [bounds.max[0], bounds.max[1], bounds.max[2]],
- ];
- let near = Infinity;
- let far = -Infinity;
- for (const corner of corners) {
- const position = normalizePositionForGpu(corner, bounds);
- const depth = dot(sub(position, eye), forward);
- near = Math.min(near, depth);
- far = Math.max(far, depth);
- }
- return {
- near: Math.max(0.001, near - CAMERA_CLIP_PADDING),
- far: Math.max(0.002, far + CAMERA_CLIP_PADDING),
- };
-}
-
-function cameraAxisDepthRange(bounds: Bounds, forward: Vec3) {
- const corners: Vec3[] = [
- [bounds.min[0], bounds.min[1], bounds.min[2]],
- [bounds.min[0], bounds.min[1], bounds.max[2]],
- [bounds.min[0], bounds.max[1], bounds.min[2]],
- [bounds.min[0], bounds.max[1], bounds.max[2]],
- [bounds.max[0], bounds.min[1], bounds.min[2]],
- [bounds.max[0], bounds.min[1], bounds.max[2]],
- [bounds.max[0], bounds.max[1], bounds.min[2]],
- [bounds.max[0], bounds.max[1], bounds.max[2]],
- ];
- let minDepth = Infinity;
- let maxDepth = -Infinity;
- for (const corner of corners) {
- const depth = dot(normalizePositionForGpu(corner, bounds), forward);
- minDepth = Math.min(minDepth, depth);
- maxDepth = Math.max(maxDepth, depth);
- }
- return { min: minDepth, max: maxDepth };
-}
-
-function normalizePositionForGpu(position: Vec3, bounds: Bounds): Vec3 {
- const height = bounds.max[1] - bounds.min[1] || 1;
- const centerX = (bounds.min[0] + bounds.max[0]) * 0.5;
- const centerY = (bounds.min[1] + bounds.max[1]) * 0.5;
- const frontZ = bounds.max[2];
- return [(position[0] - centerX) / height, (position[1] - centerY) / height, (position[2] - frontZ) / height];
-}
-
-function orbitEye(target: Vec3, radius: number, yawRadians: number, pitchRadians: number): Vec3 {
- const cp = Math.cos(pitchRadians);
- return [
- target[0] + radius * cp * Math.sin(yawRadians),
- target[1] + radius * Math.sin(pitchRadians),
- target[2] + radius * cp * Math.cos(yawRadians),
- ];
-}
-
-function cameraBasis(eye: Vec3, target: Vec3) {
- const forward = normalize(sub(target, eye));
- const upRef: Vec3 = Math.abs(dot(forward, [0, 1, 0])) > 0.98 ? [0, 0, 1] : [0, 1, 0];
- const right = normalize(cross(forward, upRef));
- const up = cross(right, forward);
- return { forward, right, up };
-}
-
-function perspective(fovYRadians: number, aspect: number, near: number, far: number): Mat4 {
- const f = 1 / Math.tan(fovYRadians / 2);
- const m = new Float32Array(16);
- m[0] = f / aspect;
- m[5] = f;
- m[10] = far / (near - far);
- m[11] = -1;
- m[14] = (far * near) / (near - far);
- return m;
-}
-
-function lookAt(eye: Vec3, target: Vec3, up: Vec3): Mat4 {
- const z = normalize(sub(eye, target));
- let x = cross(up, z);
- if (length(x) < 1e-6) {
- x = cross([0, 0, 1], z);
- if (length(x) < 1e-6) x = cross([1, 0, 0], z);
- }
- x = normalize(x);
- const y = cross(z, x);
-
- const m = new Float32Array(16);
- m[0] = x[0];
- m[1] = y[0];
- m[2] = z[0];
- m[3] = 0;
- m[4] = x[1];
- m[5] = y[1];
- m[6] = z[1];
- m[7] = 0;
- m[8] = x[2];
- m[9] = y[2];
- m[10] = z[2];
- m[11] = 0;
- m[12] = -dot(x, eye);
- m[13] = -dot(y, eye);
- m[14] = -dot(z, eye);
- m[15] = 1;
- return m;
-}
-
-function multiply(a: Mat4, b: Mat4): Mat4 {
- const out = new Float32Array(16);
- for (let col = 0; col < 4; col += 1) {
- for (let row = 0; row < 4; row += 1) {
- let sum = 0;
- for (let k = 0; k < 4; k += 1) {
- sum += a[k * 4 + row]! * b[col * 4 + k]!;
- }
- out[col * 4 + row] = sum;
- }
- }
- return out;
-}
-
-function sub(a: Vec3, b: Vec3): Vec3 {
- return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
-}
-
-function cross(a: Vec3, b: Vec3): Vec3 {
- return [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
-}
-
-function dot(a: Vec3, b: Vec3): number {
- return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
-}
-
-function clampUnit(value: number) {
- return Math.max(0, Math.min(1, value));
-}
-
-function mix(from: number, to: number, amount: number) {
- return from + (to - from) * amount;
-}
-
-function length(a: Vec3): number {
- return Math.hypot(a[0], a[1], a[2]);
-}
-
-function normalize(a: Vec3): Vec3 {
- const l = length(a) || 1;
- return [a[0] / l, a[1] / l, a[2] / l];
-}
-
-export function cameraRadiusForFov(fovDegrees: number, baselineRadius = BASELINE_CAMERA_RADIUS, baselineFovDegrees = BASELINE_CAMERA_FOV) {
- const baselineHalfFov = degreesToRadians(baselineFovDegrees) * 0.5;
- const targetHalfFov = degreesToRadians(fovDegrees) * 0.5;
- return (baselineRadius * Math.tan(baselineHalfFov)) / Math.tan(targetHalfFov);
-}
-
-function degreesToRadians(degrees: number) {
- return (degrees * Math.PI) / 180;
-}
+// Pure facade for the Eve hero renderer.
+// INVARIANT: External imports continue to target this file; implementation lives under render/.
+// Re-export only stable renderer API names and types.
+
+export { createEve5Renderer } from "./render/renderer";
+export { mapClientPointToPaintCell } from "./render/pointer-mapping";
+export { getPaddedRenderSize } from "./render/textures";
+export { cameraRadiusForFov } from "./render/math";
+export { meshThicknessScale } from "./render/camera";
+export { createStudioCubemap, renderStudioCubemap } from "./render/cubemap";
+export { EVE_DARK_ENV_LIGHTS, EVE_LIGHT_ENV_LIGHTS } from "./render/env-lights";
+export {
+ BLOOM_RADIUS,
+ BLOOM_STRENGTH_OFF,
+ BLOOM_STRENGTH_ON,
+ BLOOM_THRESHOLD,
+ bloomRadiusForDevicePixelRatio,
+ DEFAULT_CAMERA_FOV,
+ DEFAULT_IMPRINT_CELL_SIZE,
+ DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,
+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ DEFAULT_PAINT_BRUSH_RADIUS,
+ DEFAULT_PAINT_BRUSH_STRENGTH,
+ DEFAULT_PAINT_DECAY_PER_FRAME_120,
+ DEFAULT_PAINT_DIFFUSION_JITTER,
+ DEFAULT_PAINT_DIFFUSION_RATE,
+ DEFAULT_PAINT_DT,
+ imprintCellSizeForDevicePixelRatio,
+} from "./render/constants";
+export type { Bounds, EnvLightConfig, EveMaterial, ImprintRenderOptions, MeshData, PaintPointerMapping, PaintPointerMappingInput, PaintPointerRect, PaintRenderOptions, PaintSeed, PaintStroke, RenderControls, StudioCubemap } from "./render/types";
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/bindings.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/bindings.ts
new file mode 100644
index 000000000..da4e68ede
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/bindings.ts
@@ -0,0 +1,193 @@
+// Bind-group creators; front bindings 0-7 remain ABI-stable.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import { Device, type Buffer } from "@vgpu/core";
+import { PAINT_FORMAT, PARAMS_BYTE_SIZE, SCENE_FORMAT, VORONOI_NOISE_FORMAT } from "./constants";
+import type { StudioCubemap } from "./types";
+
+export function createEnvParamsBinding(
+ device: Device,
+ pipeline: GPURenderPipeline,
+ cubemap: StudioCubemap,
+ label: string,
+) {
+ const buffer = device.createBuffer({
+ size: PARAMS_BYTE_SIZE,
+ usage: ["uniform", "copy_dst"],
+ label,
+ });
+ const bindGroup = device.gpu.createBindGroup({
+ label: `${label}-bind-group`,
+ layout: pipeline.getBindGroupLayout(0),
+ entries: [
+ { binding: 0, resource: { buffer: buffer.gpu } },
+ { binding: 1, resource: cubemap.view },
+ { binding: 2, resource: cubemap.sampler },
+ ],
+ });
+ return { buffer, bindGroup };
+}
+
+export function createBackParamsBinding(
+ device: Device,
+ pipeline: GPURenderPipeline,
+ cubemap: StudioCubemap,
+ label: string,
+) {
+ const buffer = device.createBuffer({
+ size: PARAMS_BYTE_SIZE,
+ usage: ["uniform", "copy_dst"],
+ label,
+ });
+ const bindGroup = device.gpu.createBindGroup({
+ label: `${label}-bind-group`,
+ layout: pipeline.getBindGroupLayout(0),
+ entries: [
+ { binding: 0, resource: { buffer: buffer.gpu } },
+ { binding: 1, resource: cubemap.view },
+ { binding: 2, resource: cubemap.sampler },
+ ],
+ });
+ return { buffer, bindGroup };
+}
+
+export function createUniformParamsBinding(device: Device, pipeline: GPURenderPipeline, label: string) {
+ const buffer = device.createBuffer({
+ size: PARAMS_BYTE_SIZE,
+ usage: ["uniform", "copy_dst"],
+ label,
+ });
+ const bindGroup = device.gpu.createBindGroup({
+ label: `${label}-bind-group`,
+ layout: pipeline.getBindGroupLayout(0),
+ entries: [{ binding: 0, resource: { buffer: buffer.gpu } }],
+ });
+ return { buffer, bindGroup };
+}
+
+export function createPaintDecayBindGroup(
+ device: Device,
+ pipeline: GPURenderPipeline,
+ paintView: GPUTextureView,
+ staticNoiseView: GPUTextureView,
+ paintParamsBuffer: Buffer,
+ label: string,
+) {
+ return device.gpu.createBindGroup({
+ label,
+ layout: pipeline.getBindGroupLayout(0),
+ entries: [
+ { binding: 0, resource: paintView },
+ { binding: 1, resource: { buffer: paintParamsBuffer.gpu } },
+ { binding: 2, resource: staticNoiseView },
+ ],
+ });
+}
+
+export function createPaintDebugBindGroup(
+ device: Device,
+ pipeline: GPURenderPipeline,
+ paintView: GPUTextureView,
+ label: string,
+) {
+ return device.gpu.createBindGroup({
+ label,
+ layout: pipeline.getBindGroupLayout(0),
+ entries: [{ binding: 0, resource: paintView }],
+ });
+}
+
+export function createParamsBinding(
+ device: Device,
+ pipeline: GPURenderPipeline,
+ cubemap: StudioCubemap,
+ label: string,
+ backMaterialView?: GPUTextureView,
+ backDepthView?: GPUTextureView,
+) {
+ const buffer = device.createBuffer({
+ size: PARAMS_BYTE_SIZE,
+ usage: ["uniform", "copy_dst"],
+ label,
+ });
+ const fallbackBackMaterial = device.gpu.createTexture({
+ label: `${label}-empty-back-material`,
+ size: [1, 1],
+ format: SCENE_FORMAT,
+ usage: GPUTextureUsage.TEXTURE_BINDING,
+ });
+ const fallbackBackDepth = device.gpu.createTexture({
+ label: `${label}-empty-back-depth`,
+ size: [1, 1],
+ format: SCENE_FORMAT,
+ usage: GPUTextureUsage.TEXTURE_BINDING,
+ });
+ const fallbackPaint = device.gpu.createTexture({
+ label: `${label}-empty-paint`,
+ size: [1, 1],
+ format: PAINT_FORMAT,
+ usage: GPUTextureUsage.TEXTURE_BINDING,
+ });
+ const fallbackVoronoiValue = device.gpu.createTexture({
+ label: `${label}-empty-voronoi-value`,
+ size: [1, 1],
+ format: VORONOI_NOISE_FORMAT,
+ usage: GPUTextureUsage.TEXTURE_BINDING,
+ });
+ const fallbackVoronoiEdge = device.gpu.createTexture({
+ label: `${label}-empty-voronoi-edge`,
+ size: [1, 1],
+ format: VORONOI_NOISE_FORMAT,
+ usage: GPUTextureUsage.TEXTURE_BINDING,
+ });
+ const bindGroup = createParamsBindGroup(
+ device,
+ pipeline,
+ cubemap,
+ buffer,
+ backMaterialView ?? fallbackBackMaterial.createView(),
+ backDepthView ?? fallbackBackDepth.createView(),
+ fallbackPaint.createView(),
+ fallbackVoronoiValue.createView(),
+ fallbackVoronoiEdge.createView(),
+ `${label}-bind-group`,
+ );
+ return {
+ buffer,
+ bindGroup,
+ fallbackBackMaterial,
+ fallbackBackDepth,
+ fallbackPaint,
+ fallbackVoronoiValue,
+ fallbackVoronoiEdge,
+ };
+}
+
+export function createParamsBindGroup(
+ device: Device,
+ pipeline: GPURenderPipeline,
+ cubemap: StudioCubemap,
+ buffer: Buffer,
+ backMaterialView: GPUTextureView,
+ backDepthView: GPUTextureView,
+ paintView: GPUTextureView,
+ voronoiValueView: GPUTextureView,
+ voronoiEdgeView: GPUTextureView,
+ label: string,
+) {
+ return device.gpu.createBindGroup({
+ label,
+ layout: pipeline.getBindGroupLayout(0),
+ entries: [
+ { binding: 0, resource: { buffer: buffer.gpu } },
+ { binding: 1, resource: cubemap.view },
+ { binding: 2, resource: cubemap.sampler },
+ { binding: 3, resource: backMaterialView },
+ { binding: 4, resource: backDepthView },
+ { binding: 5, resource: paintView },
+ { binding: 6, resource: voronoiValueView },
+ { binding: 7, resource: voronoiEdgeView },
+ ],
+ });
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/camera.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/camera.ts
new file mode 100644
index 000000000..d3ff405c0
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/camera.ts
@@ -0,0 +1,84 @@
+// Camera framing, clip planes, and mesh-normalized coordinate helpers.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import type { Bounds, MeshData, Vec3 } from "./types";
+import { CAMERA_CLIP_PADDING, EVE_THICKNESS_SCALE_MULTIPLIER } from "./constants";
+import { dot, sub } from "./math";
+
+export function meshOrbitTarget(mesh: MeshData): Vec3 {
+ return meshOrbitTargetFromBounds(mesh.bounds);
+}
+
+export function meshOrbitTargetFromBounds(bounds: Bounds): Vec3 {
+ const height = bounds.max[1] - bounds.min[1] || 1;
+ const depth = bounds.max[2] - bounds.min[2];
+ return [0, 0, -depth / (height * 2)];
+}
+
+export function meshThicknessScale(bounds: Bounds) {
+ // The shader computes camera-axis depth from the normalized GPU mesh coordinates created in
+ // normalizeMeshForGpu(...), not raw glTF/model units. Keep the real EVE logo normalization in the
+ // same coordinate space; otherwise the tiny raw Z extent clamps the thickness debug to white.
+ const height = bounds.max[1] - bounds.min[1] || 1;
+ const normalizedZExtent = (bounds.max[2] - bounds.min[2]) / height;
+ return Math.max(normalizedZExtent * EVE_THICKNESS_SCALE_MULTIPLIER, 0.000001);
+}
+
+export function cameraClipPlanes(bounds: Bounds, eye: Vec3, forward: Vec3) {
+ const corners: Vec3[] = [
+ [bounds.min[0], bounds.min[1], bounds.min[2]],
+ [bounds.min[0], bounds.min[1], bounds.max[2]],
+ [bounds.min[0], bounds.max[1], bounds.min[2]],
+ [bounds.min[0], bounds.max[1], bounds.max[2]],
+ [bounds.max[0], bounds.min[1], bounds.min[2]],
+ [bounds.max[0], bounds.min[1], bounds.max[2]],
+ [bounds.max[0], bounds.max[1], bounds.min[2]],
+ [bounds.max[0], bounds.max[1], bounds.max[2]],
+ ];
+ let near = Infinity;
+ let far = -Infinity;
+ for (const corner of corners) {
+ const position = normalizePositionForGpu(corner, bounds);
+ const depth = dot(sub(position, eye), forward);
+ near = Math.min(near, depth);
+ far = Math.max(far, depth);
+ }
+ return {
+ near: Math.max(0.001, near - CAMERA_CLIP_PADDING),
+ far: Math.max(0.002, far + CAMERA_CLIP_PADDING),
+ };
+}
+
+export function cameraAxisDepthRange(bounds: Bounds, forward: Vec3) {
+ const corners: Vec3[] = [
+ [bounds.min[0], bounds.min[1], bounds.min[2]],
+ [bounds.min[0], bounds.min[1], bounds.max[2]],
+ [bounds.min[0], bounds.max[1], bounds.min[2]],
+ [bounds.min[0], bounds.max[1], bounds.max[2]],
+ [bounds.max[0], bounds.min[1], bounds.min[2]],
+ [bounds.max[0], bounds.min[1], bounds.max[2]],
+ [bounds.max[0], bounds.max[1], bounds.min[2]],
+ [bounds.max[0], bounds.max[1], bounds.max[2]],
+ ];
+ let minDepth = Infinity;
+ let maxDepth = -Infinity;
+ for (const corner of corners) {
+ const depth = dot(normalizePositionForGpu(corner, bounds), forward);
+ minDepth = Math.min(minDepth, depth);
+ maxDepth = Math.max(maxDepth, depth);
+ }
+ return { min: minDepth, max: maxDepth };
+}
+
+export function normalizePositionForGpu(position: Vec3, bounds: Bounds): Vec3 {
+ const height = bounds.max[1] - bounds.min[1] || 1;
+ const centerX = (bounds.min[0] + bounds.max[0]) * 0.5;
+ const centerY = (bounds.min[1] + bounds.max[1]) * 0.5;
+ const frontZ = bounds.max[2];
+ return [
+ (position[0] - centerX) / height,
+ (position[1] - centerY) / height,
+ (position[2] - frontZ) / height,
+ ];
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/constants.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/constants.ts
new file mode 100644
index 000000000..027305d7c
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/constants.ts
@@ -0,0 +1,90 @@
+// Renderer numeric constants, GPU formats, and public defaults.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import type { EveMaterial } from "./types";
+
+export const PARAMS_BYTE_SIZE = 176;
+export const CUBE_MAX_LIGHTS = 16;
+export const CUBE_LIGHT_FLOAT_COUNT = 12;
+export const CUBE_PARAMS_FLOAT_COUNT = 4 + CUBE_MAX_LIGHTS * CUBE_LIGHT_FLOAT_COUNT;
+export const CUBE_PARAMS_BYTE_SIZE = CUBE_PARAMS_FLOAT_COUNT * Float32Array.BYTES_PER_ELEMENT;
+export const CUBE_SIZE = 256;
+export const CUBE_FACE_COUNT = 6;
+export const CUBE_FORMAT: GPUTextureFormat = "rgba16float";
+export const BLOOM_RADIUS = 16;
+export const SCENE_FORMAT: GPUTextureFormat = "rgba16float";
+export const BLOOM_STRENGTH = 0.85;
+export const BLOOM_STRENGTH_OFF = BLOOM_STRENGTH;
+export const BLOOM_STRENGTH_ON = BLOOM_STRENGTH_OFF * 0.25;
+export const BLOOM_THRESHOLD = 0;
+export const BACK_DEPTH_FORMAT: GPUTextureFormat = "depth32float";
+
+// The shader renders the back side first, then the front side. Keeping two passes
+// preserves the acrylic depth/overlap cues while avoiding a depth buffer.
+export const PASS_INSIDE = 0;
+export const PASS_OUTSIDE = 1;
+export const PASS_WIREFRAME = 2;
+export const MATERIAL_KIND: Record<EveMaterial, number> = {
+ glass: 0,
+ normal: 1,
+ "camera reflected normal": 2,
+ metallic: 3,
+ "back-albedo": 0,
+ "back-depth": 0,
+ thickness: 4,
+ "paint-debug": 0,
+};
+export const CAMERA_CLIP_PADDING = 0.02;
+export const BASELINE_CAMERA_RADIUS = 1.9;
+export const BASELINE_CAMERA_FOV = 35;
+export const DEFAULT_CAMERA_FOV = BASELINE_CAMERA_FOV / 2;
+export const EVE_THICKNESS_SCALE_MULTIPLIER = 1.3;
+export const PREVIEW_BACK_ALBEDO = 0;
+export const PREVIEW_BACK_DEPTH = 1;
+export const DEFAULT_IMPRINT_CELL_SIZE = 16;
+export const DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO = 2;
+export const DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER = 0.71;
+export const DEFAULT_IMPRINT_GLYPH_SCALE = 1.35;
+export const PAINT_FORMAT: GPUTextureFormat = "r32float";
+export const PAINT_STATIC_NOISE_FORMAT: GPUTextureFormat = "rgba32float";
+export const VORONOI_NOISE_FORMAT: GPUTextureFormat = "r32float";
+export const PAINT_PARAMS_BYTE_SIZE = 48;
+export const VORONOI_NOISE_PARAMS_BYTE_SIZE = 16;
+export const DEFAULT_PAINT_DECAY_PER_FRAME_120 = 0.032;
+export const DEFAULT_PAINT_DECAY_RATE = DEFAULT_PAINT_DECAY_PER_FRAME_120 * 120;
+export const DEFAULT_PAINT_DIFFUSION_RATE = 1.6;
+export const DEFAULT_PAINT_DIFFUSION_JITTER = 4.0;
+export const DEFAULT_PAINT_BRUSH_RADIUS = 8.0;
+export const DEFAULT_PAINT_BRUSH_STRENGTH = 32.0;
+export const DEFAULT_PAINT_DT = 1 / 60;
+export const PAINT_STROKE_MOVEMENT_EPSILON_CELLS = 0.05;
+
+function safeDevicePixelRatioOrDefault(devicePixelRatio: number | undefined) {
+ const ratio = typeof devicePixelRatio === "number" && Number.isFinite(devicePixelRatio)
+ ? devicePixelRatio
+ : DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO;
+
+ return Math.max(0.001, ratio);
+}
+
+export function imprintCellSizeForDevicePixelRatio(
+ devicePixelRatio = DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,
+) {
+ return (
+ DEFAULT_IMPRINT_CELL_SIZE *
+ (safeDevicePixelRatioOrDefault(devicePixelRatio) / DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO)
+ );
+}
+
+export function bloomRadiusForDevicePixelRatio(
+ devicePixelRatio = DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,
+) {
+ return Math.max(
+ 0,
+ Math.round(
+ BLOOM_RADIUS *
+ (safeDevicePixelRatioOrDefault(devicePixelRatio) / DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO),
+ ),
+ );
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/cubemap.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/cubemap.ts
new file mode 100644
index 000000000..09d10cbbb
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/cubemap.ts
@@ -0,0 +1,129 @@
+// Studio cubemap allocation and one-time bake pass.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import { Device } from "@vgpu/core";
+import { createRenderPipeline, RenderPass } from "@vgpu/render";
+import { compile } from "@vgpu/wgsl";
+import eveCubemapWgsl from "../shaders/cubemap/render.wgsl";
+import { CUBE_FACE_COUNT, CUBE_FORMAT, CUBE_LIGHT_FLOAT_COUNT, CUBE_MAX_LIGHTS, CUBE_PARAMS_BYTE_SIZE, CUBE_PARAMS_FLOAT_COUNT, CUBE_SIZE } from "./constants";
+import type { EnvLightConfig, StudioCubemap, Vec3 } from "./types";
+
+export function createStudioCubemap(
+ device: Device,
+ label = "eve-5-studio-hdr-cubemap",
+): StudioCubemap {
+ const texture = device.gpu.createTexture({
+ label,
+ size: { width: CUBE_SIZE, height: CUBE_SIZE, depthOrArrayLayers: CUBE_FACE_COUNT },
+ dimension: "2d",
+ format: CUBE_FORMAT,
+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,
+ });
+ // Dawn's node adapter runs in compatibility mode and validates cube views as 2D arrays.
+ // Keep the asset semantically as a cubemap, but bind/sample it as six array layers.
+ const view = texture.createView({
+ dimension: "2d-array",
+ baseArrayLayer: 0,
+ arrayLayerCount: CUBE_FACE_COUNT,
+ });
+ const sampler = device.gpu.createSampler({
+ label: "eve-5-studio-hdr-cubemap-sampler",
+ magFilter: "linear",
+ minFilter: "linear",
+ });
+ const faceParams = device.createBuffer({
+ label: "eve-5-studio-cubemap-face-params",
+ size: CUBE_PARAMS_BYTE_SIZE,
+ usage: ["uniform", "copy_dst"],
+ });
+ return { texture, view, sampler, faceParams };
+}
+
+export function renderStudioCubemap(
+ device: Device,
+ cubemap: StudioCubemap,
+ lights: readonly EnvLightConfig[],
+ globalIntensity = 1,
+) {
+ const pipeline = createRenderPipeline(device, {
+ label: "eve-5-studio-cubemap-bake-pipeline",
+ shader: device.createShader(compile(eveCubemapWgsl)),
+ vertex: { entry: "vs_main" },
+ fragment: { entry: "fs_main", targets: [{ format: CUBE_FORMAT }] },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const bindGroup = device.gpu.createBindGroup({
+ label: "eve-5-studio-cubemap-bake-bind-group",
+ layout: pipeline.getBindGroupLayout(0),
+ entries: [{ binding: 0, resource: { buffer: cubemap.faceParams.gpu } }],
+ });
+
+ for (let face = 0; face < CUBE_FACE_COUNT; face += 1) {
+ cubemap.faceParams.write(cubeParamsData(face, lights, globalIntensity));
+ const pass = new RenderPass(device, {
+ label: `eve-5-studio-cubemap-face-${face}`,
+ colorAttachments: [
+ {
+ view: cubemap.texture.createView({
+ dimension: "2d",
+ baseArrayLayer: face,
+ arrayLayerCount: 1,
+ }),
+ loadOp: "clear",
+ storeOp: "store",
+ clearValue: [0, 0, 0, 1],
+ },
+ ],
+ });
+ pass.setPipeline(pipeline);
+ pass.setBindGroup(0, bindGroup);
+ pass.draw(3);
+ pass.end();
+ }
+}
+
+export function cubeParamsData(face: number, lights: readonly EnvLightConfig[], globalIntensity: number) {
+ if (lights.length > CUBE_MAX_LIGHTS) {
+ throw new Error(
+ `Studio cubemap supports up to ${CUBE_MAX_LIGHTS} lights, received ${lights.length}`,
+ );
+ }
+
+ const data = new Float32Array(CUBE_PARAMS_FLOAT_COUNT);
+ data[0] = face;
+ data[1] = lights.length;
+
+ lights.forEach((light, index) => {
+ const [r, g, b] = lightColorLinear(light);
+ const offset = 4 + index * CUBE_LIGHT_FLOAT_COUNT;
+ data[offset] = light.position[0];
+ data[offset + 1] = light.position[1];
+ data[offset + 2] = light.position[2];
+ data[offset + 3] = light.radius;
+ data[offset + 4] = r;
+ data[offset + 5] = g;
+ data[offset + 6] = b;
+ data[offset + 7] = light.intensity * globalIntensity;
+ data[offset + 8] = light.softness;
+ data[offset + 9] = light.luminance;
+ });
+
+ return data;
+}
+
+export function lightColorLinear(light: EnvLightConfig): Vec3 {
+ return srgbHexToLinear(light.color);
+}
+
+export function srgbHexToLinear(hex: string): Vec3 {
+ const normalized = hex.replace(/^#/, "");
+ if (!/^[0-9a-fA-F]{6}$/.test(normalized)) {
+ throw new Error(`Expected a 6-digit sRGB hex color, received ${hex}`);
+ }
+ return [0, 2, 4].map((offset) => {
+ const channel = Number.parseInt(normalized.slice(offset, offset + 2), 16) / 255;
+ return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;
+ }) as Vec3;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/env-lights.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/env-lights.ts
new file mode 100644
index 000000000..52652539e
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/env-lights.ts
@@ -0,0 +1,122 @@
+// Theme-specific studio light data.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import type { EnvLightConfig } from "./types";
+
+// Editable environment-light knobs. Hex colors are sRGB and are converted to
+// linear values before the one-time cubemap bake. Light and dark intentionally
+// start as duplicated white studio setups so each theme can be tuned independently.
+export const EVE_LIGHT_ENV_LIGHTS = [
+ {
+ name: "top-left high",
+ position: [-1.4, 2, -0.4],
+ color: "#FFFFFF",
+ intensity: 1,
+ radius: 0.3,
+ softness: 0.02,
+ luminance: 10,
+ },
+ {
+ name: "front high",
+ position: [0, 0, 2],
+ color: "#FFFFFF",
+ intensity: 2,
+ radius: 0.8,
+ softness: 0.02,
+ luminance: 1,
+ },
+ {
+ name: "back high",
+ position: [1, 0, -2],
+ color: "#FFFFFF",
+ intensity: 10,
+ radius: 0.5,
+ softness: 0.1,
+ luminance: 0.2,
+ },
+ {
+ name: "back-right",
+ position: [0.4, -0.3, -1],
+ color: "#FFFFFF",
+ intensity: 1,
+ radius: 0.1,
+ softness: 1,
+ luminance: 0.5,
+ },
+ {
+ name: "front-bottom-right",
+ position: [1, -2, -0.5],
+ color: "#FFFFFF",
+ intensity: 1,
+ radius: 0.2,
+ softness: 1,
+ luminance: 5,
+ },
+ {
+ name: "front-bottom-left",
+ position: [-0.3, -0.2, -0.2],
+ color: "#FFFFFF",
+ intensity: 1,
+ radius: 0.3,
+ softness: 4,
+ luminance: 3,
+ },
+] as const satisfies readonly EnvLightConfig[];
+
+export const EVE_DARK_ENV_LIGHTS = [
+ {
+ name: "top-left high",
+ position: [-1.3, 2, -0.3],
+ color: "#FFFFFF",
+ intensity: 2,
+ radius: 0.3,
+ softness: 0.02,
+ luminance: 10,
+ },
+ {
+ name: "front-left high",
+ position: [-0.4, 1, 1],
+ color: "#FFFFFF",
+ intensity: 1,
+ radius: 0.9,
+ softness: 0.02,
+ luminance: 1,
+ },
+ {
+ name: "front-right",
+ position: [5, 0, 10],
+ color: "#FFFFFF",
+ intensity: 1.5,
+ radius: 0.5,
+ softness: 0.1,
+ luminance: 0.2,
+ },
+ {
+ name: "back-right",
+ position: [0.4, -0.3, -1],
+ color: "#FFFFFF",
+ intensity: 5,
+ radius: 0.1,
+ softness: 1,
+ luminance: 0.5,
+ },
+ {
+ name: "front-bottom-right",
+ position: [1, -2, -0.5],
+ color: "#FFFFFF",
+ intensity: 1,
+ radius: 0.2,
+ softness: 1,
+ luminance: 5,
+ },
+ {
+ name: "front-bottom-left",
+ position: [-0.3, -0.2, -0.2],
+ color: "#FFFFFF",
+ intensity: 1,
+ radius: 0.3,
+ softness: 4,
+ luminance: 3,
+ },
+] as const satisfies readonly EnvLightConfig[];
\ No newline at end of file
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/math.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/math.ts
new file mode 100644
index 000000000..9ac6f186e
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/math.ts
@@ -0,0 +1,121 @@
+// Small matrix/vector math helpers used by camera and params.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import type { Mat4, Vec3 } from "./types";
+import { BASELINE_CAMERA_FOV, BASELINE_CAMERA_RADIUS } from "./constants";
+
+export function orbitEye(target: Vec3, radius: number, yawRadians: number, pitchRadians: number): Vec3 {
+ const cp = Math.cos(pitchRadians);
+ return [
+ target[0] + radius * cp * Math.sin(yawRadians),
+ target[1] + radius * Math.sin(pitchRadians),
+ target[2] + radius * cp * Math.cos(yawRadians),
+ ];
+}
+
+export function cameraBasis(eye: Vec3, target: Vec3) {
+ const forward = normalize(sub(target, eye));
+ const upRef: Vec3 = Math.abs(dot(forward, [0, 1, 0])) > 0.98 ? [0, 0, 1] : [0, 1, 0];
+ const right = normalize(cross(forward, upRef));
+ const up = cross(right, forward);
+ return { forward, right, up };
+}
+
+export function perspective(fovYRadians: number, aspect: number, near: number, far: number): Mat4 {
+ const f = 1 / Math.tan(fovYRadians / 2);
+ const m = new Float32Array(16);
+ m[0] = f / aspect;
+ m[5] = f;
+ m[10] = far / (near - far);
+ m[11] = -1;
+ m[14] = (far * near) / (near - far);
+ return m;
+}
+
+export function lookAt(eye: Vec3, target: Vec3, up: Vec3): Mat4 {
+ const z = normalize(sub(eye, target));
+ let x = cross(up, z);
+ if (length(x) < 1e-6) {
+ x = cross([0, 0, 1], z);
+ if (length(x) < 1e-6) x = cross([1, 0, 0], z);
+ }
+ x = normalize(x);
+ const y = cross(z, x);
+
+ const m = new Float32Array(16);
+ m[0] = x[0];
+ m[1] = y[0];
+ m[2] = z[0];
+ m[3] = 0;
+ m[4] = x[1];
+ m[5] = y[1];
+ m[6] = z[1];
+ m[7] = 0;
+ m[8] = x[2];
+ m[9] = y[2];
+ m[10] = z[2];
+ m[11] = 0;
+ m[12] = -dot(x, eye);
+ m[13] = -dot(y, eye);
+ m[14] = -dot(z, eye);
+ m[15] = 1;
+ return m;
+}
+
+export function multiply(a: Mat4, b: Mat4): Mat4 {
+ const out = new Float32Array(16);
+ for (let col = 0; col < 4; col += 1) {
+ for (let row = 0; row < 4; row += 1) {
+ let sum = 0;
+ for (let k = 0; k < 4; k += 1) {
+ sum += a[k * 4 + row]! * b[col * 4 + k]!;
+ }
+ out[col * 4 + row] = sum;
+ }
+ }
+ return out;
+}
+
+export function sub(a: Vec3, b: Vec3): Vec3 {
+ return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+}
+
+export function cross(a: Vec3, b: Vec3): Vec3 {
+ return [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
+}
+
+export function dot(a: Vec3, b: Vec3): number {
+ return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+
+export function clampUnit(value: number) {
+ return Math.max(0, Math.min(1, value));
+}
+
+export function mix(from: number, to: number, amount: number) {
+ return from + (to - from) * amount;
+}
+
+export function length(a: Vec3): number {
+ return Math.hypot(a[0], a[1], a[2]);
+}
+
+export function normalize(a: Vec3): Vec3 {
+ const l = length(a) || 1;
+ return [a[0] / l, a[1] / l, a[2] / l];
+}
+
+export function cameraRadiusForFov(
+ fovDegrees: number,
+ baselineRadius = BASELINE_CAMERA_RADIUS,
+ baselineFovDegrees = BASELINE_CAMERA_FOV,
+) {
+ const baselineHalfFov = degreesToRadians(baselineFovDegrees) * 0.5;
+ const targetHalfFov = degreesToRadians(fovDegrees) * 0.5;
+ return (baselineRadius * Math.tan(baselineHalfFov)) / Math.tan(targetHalfFov);
+}
+
+export function degreesToRadians(degrees: number) {
+ return (degrees * Math.PI) / 180;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/mesh-gpu.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/mesh-gpu.ts
new file mode 100644
index 000000000..326d98604
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/mesh-gpu.ts
@@ -0,0 +1,94 @@
+// GPU mesh upload plus normalization and line-index generation.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import { Device } from "@vgpu/core";
+import type { Bounds, GpuMesh, MeshData } from "./types";
+
+export function createGpuMesh(device: Device, mesh: MeshData): GpuMesh {
+ const vertices = normalizeMeshForGpu(mesh);
+ const lineIndices = triangleIndicesToLineIndices(mesh.indices);
+
+ const vertexBuffer = device.createBuffer({
+ label: "eve-5-logo-vertices",
+ size: vertices.byteLength,
+ usage: ["vertex", "copy_dst"],
+ });
+ vertexBuffer.write(vertices);
+
+ const indexBuffer = device.createBuffer({
+ label: "eve-5-logo-indices",
+ size: mesh.indices.byteLength,
+ usage: ["index", "copy_dst"],
+ });
+ indexBuffer.write(new Uint32Array(mesh.indices));
+
+ const lineIndexBuffer = device.createBuffer({
+ label: "eve-5-logo-line-indices",
+ size: lineIndices.byteLength,
+ usage: ["index", "copy_dst"],
+ });
+ lineIndexBuffer.write(lineIndices);
+
+ return {
+ vertexBuffer,
+ indexBuffer,
+ lineIndexBuffer,
+ indexCount: mesh.indices.length,
+ lineIndexCount: lineIndices.length,
+ };
+}
+
+export function normalizedMeshBounds(bounds: Bounds): Bounds {
+ const height = bounds.max[1] - bounds.min[1] || 1;
+ const centerX = (bounds.min[0] + bounds.max[0]) * 0.5;
+ const centerY = (bounds.min[1] + bounds.max[1]) * 0.5;
+ const frontZ = bounds.max[2];
+ return {
+ min: [
+ (bounds.min[0] - centerX) / height,
+ (bounds.min[1] - centerY) / height,
+ (bounds.min[2] - frontZ) / height,
+ ],
+ max: [
+ (bounds.max[0] - centerX) / height,
+ (bounds.max[1] - centerY) / height,
+ (bounds.max[2] - frontZ) / height,
+ ],
+ };
+}
+
+function normalizeMeshForGpu(mesh: MeshData) {
+ const height = mesh.bounds.max[1] - mesh.bounds.min[1];
+ const centerX = (mesh.bounds.min[0] + mesh.bounds.max[0]) * 0.5;
+ const centerY = (mesh.bounds.min[1] + mesh.bounds.max[1]) * 0.5;
+ const frontZ = mesh.bounds.max[2];
+ const data = new Float32Array((mesh.positions.length / 3) * 6);
+
+ for (let i = 0, j = 0; i < mesh.positions.length; i += 3, j += 6) {
+ data[j] = (mesh.positions[i]! - centerX) / height;
+ data[j + 1] = (mesh.positions[i + 1]! - centerY) / height;
+ data[j + 2] = (mesh.positions[i + 2]! - frontZ) / height;
+ data[j + 3] = mesh.normals[i]!;
+ data[j + 4] = mesh.normals[i + 1]!;
+ data[j + 5] = mesh.normals[i + 2]!;
+ }
+
+ return data;
+}
+
+function triangleIndicesToLineIndices(indices: Uint32Array) {
+ const lines = new Uint32Array(indices.length * 2);
+ for (let i = 0, j = 0; i < indices.length; i += 3, j += 6) {
+ const a = indices[i]!;
+ const b = indices[i + 1]!;
+ const c = indices[i + 2]!;
+ lines[j] = a;
+ lines[j + 1] = b;
+ lines[j + 2] = b;
+ lines[j + 3] = c;
+ lines[j + 4] = c;
+ lines[j + 5] = a;
+ }
+ return lines;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/paint-system.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/paint-system.ts
new file mode 100644
index 000000000..5f54fb7b1
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/paint-system.ts
@@ -0,0 +1,287 @@
+// Owns paint target state as one unit, including ping-pong parity and decay/noise/debug passes.
+// INVARIANT: readIsPing flips only after encoding a decay pass; front rendering samples current read texture.
+// Imported only by render/renderer.ts.
+
+import { Device } from "@vgpu/core";
+import { RenderPass } from "@vgpu/render";
+import { createPaintDebugBindGroup, createPaintDecayBindGroup } from "./bindings";
+import {
+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ DEFAULT_PAINT_BRUSH_RADIUS,
+ DEFAULT_PAINT_BRUSH_STRENGTH,
+ DEFAULT_PAINT_DECAY_RATE,
+ DEFAULT_PAINT_DIFFUSION_JITTER,
+ DEFAULT_PAINT_DIFFUSION_RATE,
+ DEFAULT_PAINT_DT,
+ PAINT_STROKE_MOVEMENT_EPSILON_CELLS,
+ imprintCellSizeForDevicePixelRatio,
+} from "./constants";
+import { mix } from "./math";
+import { paintMappingMetrics } from "./pointer-mapping";
+import type { RendererResources } from "./resources";
+import {
+ createPaintStaticNoiseTexture,
+ createPaintTexture,
+ createVoronoiNoiseTexture,
+ uploadStaticNoiseTexture,
+} from "./textures";
+import type { ImprintRenderOptions, MeshData, PaintRenderOptions, PaintSeed, PaintTargets, RenderControls } from "./types";
+
+export function createPaintSystem(device: Device, resources: RendererResources, mesh: MeshData) {
+ let targets: PaintTargets | undefined;
+
+ const dispose = () => {
+ targets?.ping.destroy();
+ targets?.pong.destroy();
+ targets?.staticNoise.destroy();
+ targets?.voronoiValue.destroy();
+ targets?.voronoiEdge.destroy();
+ targets = undefined;
+ };
+
+ const ensure = (logicalWidth: number, logicalHeight: number, devicePixelRatio?: number) => {
+ const cellSize = imprintCellSizeForDevicePixelRatio(devicePixelRatio);
+ const cols = Math.max(1, Math.ceil(logicalWidth / cellSize));
+ const rows = Math.max(1, Math.ceil(logicalHeight / cellSize));
+ if (targets?.cols === cols && targets.rows === rows) return targets;
+ dispose();
+ const ping = createPaintTexture(device, "eve-5-paint-ping", cols, rows);
+ const pong = createPaintTexture(device, "eve-5-paint-pong", cols, rows);
+ const staticNoise = createPaintStaticNoiseTexture(device, "eve-5-paint-static-noise", cols, rows);
+ const voronoiValue = createVoronoiNoiseTexture(device, "eve-5-ascii-voronoi-value", cols, rows);
+ const voronoiEdge = createVoronoiNoiseTexture(device, "eve-5-ascii-voronoi-edge", cols, rows);
+ uploadStaticNoiseTexture(device, staticNoise, cols, rows);
+ targets = {
+ cols,
+ rows,
+ ping,
+ pong,
+ staticNoise,
+ voronoiValue,
+ voronoiEdge,
+ readIsPing: true,
+ pingReadBindGroup: createPaintDecayBindGroup(
+ device,
+ resources.pipelines.paintDecayPipeline,
+ ping.createView(),
+ staticNoise.createView(),
+ resources.buffers.paintParamsBuffer,
+ "eve-5-paint-decay-read-ping",
+ ),
+ pongReadBindGroup: createPaintDecayBindGroup(
+ device,
+ resources.pipelines.paintDecayPipeline,
+ pong.createView(),
+ staticNoise.createView(),
+ resources.buffers.paintParamsBuffer,
+ "eve-5-paint-decay-read-pong",
+ ),
+ pingDebugBindGroup: createPaintDebugBindGroup(
+ device,
+ resources.pipelines.paintDebugPipeline,
+ ping.createView(),
+ "eve-5-paint-debug-ping",
+ ),
+ pongDebugBindGroup: createPaintDebugBindGroup(
+ device,
+ resources.pipelines.paintDebugPipeline,
+ pong.createView(),
+ "eve-5-paint-debug-pong",
+ ),
+ };
+ return targets;
+ };
+
+ const uploadSeed = (paintTargets: PaintTargets, seed: PaintSeed) => {
+ if (seed.width !== paintTargets.cols || seed.height !== paintTargets.rows) {
+ throw new Error(
+ `Paint seed dimensions ${seed.width}×${seed.height} do not match paint grid ${paintTargets.cols}×${paintTargets.rows}.`,
+ );
+ }
+ if (seed.values.length !== paintTargets.cols * paintTargets.rows) {
+ throw new Error(
+ `Paint seed has ${seed.values.length} values, expected ${paintTargets.cols * paintTargets.rows}.`,
+ );
+ }
+ paintTargets.readIsPing = true;
+ device.gpu.queue.writeTexture(
+ { texture: paintTargets.ping },
+ seed.values as GPUAllowSharedBufferSource,
+ { bytesPerRow: paintTargets.cols * Float32Array.BYTES_PER_ELEMENT, rowsPerImage: paintTargets.rows },
+ { width: paintTargets.cols, height: paintTargets.rows },
+ );
+ };
+
+ const paintStepOptions = (
+ paint: PaintRenderOptions,
+ step: number,
+ steps: number,
+ ): PaintRenderOptions => {
+ const stroke = paint.stroke;
+ if (!stroke) {
+ return {
+ ...paint,
+ seed: undefined,
+ steps: undefined,
+ decaySteps: undefined,
+ brushActive: false,
+ };
+ }
+ const denominator = Math.max(1, steps - 1);
+ const t = steps <= 1 ? 1 : step / denominator;
+ const brushCell = [
+ mix(stroke.fromCell[0], stroke.toCell[0], t),
+ mix(stroke.fromCell[1], stroke.toCell[1], t),
+ ] as const;
+ const previousT = steps <= 1 ? t : Math.max(0, step - 1) / denominator;
+ const previousBrushCell = [
+ mix(stroke.fromCell[0], stroke.toCell[0], previousT),
+ mix(stroke.fromCell[1], stroke.toCell[1], previousT),
+ ] as const;
+ const dx = brushCell[0] - previousBrushCell[0];
+ const dy = brushCell[1] - previousBrushCell[1];
+ const moved = Math.hypot(dx, dy) >= PAINT_STROKE_MOVEMENT_EPSILON_CELLS;
+ return {
+ ...paint,
+ seed: undefined,
+ steps: undefined,
+ stroke: undefined,
+ decaySteps: undefined,
+ brushCell,
+ brushPreviousCell: previousBrushCell,
+ brushActive: stroke.movementGated === false || moved,
+ dt: stroke.duration !== undefined && steps > 0 ? stroke.duration / steps : paint.dt,
+ };
+ };
+
+ const renderDecay = (paintTargets: PaintTargets, paint: PaintRenderOptions = {}) => {
+ const dt = Math.min(Math.max(paint.dt ?? DEFAULT_PAINT_DT, 0), 0.1);
+ const brushCell = paint.brushCell ?? [-1000000, -1000000];
+ const brushPreviousCell = paint.brushPreviousCell ?? brushCell;
+ resources.buffers.paintParamsBuffer.write(
+ new Float32Array([
+ brushCell[0],
+ brushCell[1],
+ brushPreviousCell[0],
+ brushPreviousCell[1],
+ paint.brushRadius ?? DEFAULT_PAINT_BRUSH_RADIUS,
+ paint.brushStrength ?? DEFAULT_PAINT_BRUSH_STRENGTH,
+ paint.decayRate ?? DEFAULT_PAINT_DECAY_RATE,
+ paint.diffusionRate ?? DEFAULT_PAINT_DIFFUSION_RATE,
+ paint.diffusionJitter ?? DEFAULT_PAINT_DIFFUSION_JITTER,
+ dt,
+ paint.brushActive ? 1 : 0,
+ 0,
+ ]),
+ );
+ const readBindGroup = paintTargets.readIsPing
+ ? paintTargets.pingReadBindGroup
+ : paintTargets.pongReadBindGroup;
+ const writeTexture = paintTargets.readIsPing ? paintTargets.pong : paintTargets.ping;
+ const pass = new RenderPass(device, {
+ label: "eve-5-paint-decay-pass",
+ colorAttachments: [
+ {
+ view: writeTexture.createView(),
+ loadOp: "clear",
+ storeOp: "store",
+ clearValue: [0, 0, 0, 1],
+ },
+ ],
+ });
+ pass.setPipeline(resources.pipelines.paintDecayPipeline);
+ pass.setBindGroup(0, readBindGroup);
+ pass.draw(3);
+ pass.end();
+ paintTargets.readIsPing = !paintTargets.readIsPing;
+ };
+
+ const apply = (paintTargets: PaintTargets, paint: PaintRenderOptions | undefined) => {
+ if (paint?.seed) {
+ uploadSeed(paintTargets, paint.seed);
+ }
+ if (paint?.seed || paint?.stroke) {
+ const steps = Math.max(0, Math.floor(paint.steps ?? 0));
+ for (let step = 0; step < steps; step += 1) {
+ renderDecay(paintTargets, paintStepOptions(paint, step, steps));
+ }
+ const decaySteps = Math.max(0, Math.floor(paint.decaySteps ?? 0));
+ for (let step = 0; step < decaySteps; step += 1) {
+ renderDecay(paintTargets, {
+ ...paint,
+ seed: undefined,
+ steps: undefined,
+ stroke: undefined,
+ decaySteps: undefined,
+ brushActive: false,
+ });
+ }
+ } else {
+ renderDecay(paintTargets, paint);
+ }
+ };
+
+ const renderVoronoiNoise = (
+ paintTargets: PaintTargets,
+ controls: RenderControls,
+ logicalWidth: number,
+ logicalHeight: number,
+ projectionPaddingRadius: number,
+ imprint: ImprintRenderOptions = {},
+ ) => {
+ const metrics = paintMappingMetrics(
+ mesh.bounds,
+ controls,
+ logicalWidth,
+ logicalHeight,
+ imprint.gridScaleMultiplier ?? DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ projectionPaddingRadius,
+ imprint.devicePixelRatio,
+ );
+ resources.buffers.voronoiNoiseParamsBuffer.write(
+ new Float32Array([
+ metrics.gridScale,
+ imprint.time ?? 0,
+ metrics.originCell[0],
+ metrics.originCell[1],
+ ]),
+ );
+ const pass = new RenderPass(device, {
+ label: "eve-5-ascii-voronoi-noise-pass",
+ colorAttachments: [
+ {
+ view: paintTargets.voronoiValue.createView(),
+ loadOp: "clear",
+ storeOp: "store",
+ clearValue: [0, 0, 0, 1],
+ },
+ {
+ view: paintTargets.voronoiEdge.createView(),
+ loadOp: "clear",
+ storeOp: "store",
+ clearValue: [0, 0, 0, 1],
+ },
+ ],
+ });
+ pass.setPipeline(resources.pipelines.voronoiNoisePipeline);
+ pass.setBindGroup(0, resources.voronoiNoiseBindGroup);
+ pass.draw(3);
+ pass.end();
+ };
+
+ const renderDebug = (view: GPUTextureView, paintTargets: PaintTargets) => {
+ const pass = new RenderPass(device, {
+ label: "eve-5-paint-debug-pass",
+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
+ });
+ pass.setPipeline(resources.pipelines.paintDebugPipeline);
+ pass.setBindGroup(
+ 0,
+ paintTargets.readIsPing ? paintTargets.pingDebugBindGroup : paintTargets.pongDebugBindGroup,
+ );
+ pass.draw(3);
+ pass.end();
+ };
+
+ return { ensure, apply, renderVoronoiNoise, renderDebug, dispose };
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/params.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/params.ts
new file mode 100644
index 000000000..b444c40fc
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/params.ts
@@ -0,0 +1,68 @@
+// TS-side uniform ABI writer for shared scene params.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import type { Buffer } from "@vgpu/core";
+import { DEFAULT_IMPRINT_GLYPH_SCALE, DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER, MATERIAL_KIND } from "./constants";
+import { cameraClipPlanes } from "./camera";
+import { cameraBasis, degreesToRadians, lookAt, multiply, orbitEye, perspective } from "./math";
+import { getPaddedRenderSize } from "./textures";
+import { paintMappingMetrics } from "./pointer-mapping";
+import type { Bounds, ImprintRenderOptions, RenderControls, Vec3 } from "./types";
+
+// ABI: must match shaders/shared/scene-params.wgsl (176 B / 44 f32).
+export function writeParams(args: { target: { buffer: Buffer }; controls: RenderControls; logicalWidth: number; logicalHeight: number; passKind: number; projectionPaddingRadius: number; imprint?: ImprintRenderOptions; meshBounds: Bounds; orbitTarget: Vec3; thicknessScale: number; isLight: boolean }) {
+ const { target, controls, logicalWidth, logicalHeight, passKind, projectionPaddingRadius, imprint = {}, meshBounds, orbitTarget, thicknessScale, isLight } = args;
+ const padded = getPaddedRenderSize(logicalWidth, logicalHeight, projectionPaddingRadius);
+ const fovRad = degreesToRadians(controls.fov);
+ const verticalScale = padded.height / logicalHeight;
+ const fovEff = 2 * Math.atan(verticalScale * Math.tan(fovRad * 0.5));
+ const aspect = padded.width / padded.height;
+ const eye = orbitEye(orbitTarget, controls.radius, controls.yaw, controls.pitch);
+ const basis = cameraBasis(eye, orbitTarget);
+ const clip = cameraClipPlanes(meshBounds, eye, basis.forward);
+ const proj = perspective(fovEff, aspect, clip.near, clip.far);
+ const view = lookAt(eye, orbitTarget, [0, 1, 0]);
+ const viewProj = multiply(proj, view);
+ const data = new Float32Array(44);
+ data.set(viewProj, 0);
+ data[16] = eye[0];
+ data[17] = eye[1];
+ data[18] = eye[2];
+ data[19] = passKind;
+ data[20] = basis.right[0];
+ data[21] = basis.right[1];
+ data[22] = basis.right[2];
+ data[23] = fovEff;
+ data[24] = basis.up[0];
+ data[25] = basis.up[1];
+ data[26] = basis.up[2];
+ data[27] = aspect;
+ data[28] = basis.forward[0];
+ data[29] = basis.forward[1];
+ data[30] = basis.forward[2];
+ data[31] = MATERIAL_KIND[controls.material];
+ data[32] = thicknessScale;
+ data[33] = controls.envYaw;
+ data[34] = controls.envPitch;
+ data[35] = isLight ? 0 : 1;
+ const metrics = paintMappingMetrics(
+ meshBounds,
+ controls,
+ logicalWidth,
+ logicalHeight,
+ imprint.gridScaleMultiplier ?? DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ projectionPaddingRadius,
+ imprint.devicePixelRatio,
+ );
+ const gridScale = metrics.gridScale;
+ data[36] = Math.max(0, Math.min(1, imprint.progress ?? 0));
+ data[37] = gridScale;
+ data[38] = Math.max(0.1, imprint.glyphScale ?? DEFAULT_IMPRINT_GLYPH_SCALE);
+ data[39] = imprint.time ?? 0;
+ data[40] = imprint.mouse?.[0] ?? 0;
+ data[41] = imprint.mouse?.[1] ?? 0;
+ data[42] = metrics.originCell[0];
+ data[43] = metrics.originCell[1];
+ target.buffer.write(data);
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/back-pass.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/back-pass.ts
new file mode 100644
index 000000000..7c059eb7e
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/back-pass.ts
@@ -0,0 +1,95 @@
+// Encodes the back material and back camera-axis depth passes.
+// INVARIANT: Back material renders before front scene; pass kind and depth state are shader ABI inputs.
+// Imported only by render/renderer.ts.
+
+import { Device } from "@vgpu/core";
+import { RenderPass } from "@vgpu/render";
+import { PASS_INSIDE } from "../constants";
+import { writeParams } from "../params";
+import type { RendererResources } from "../resources";
+import type { MeshData, RenderControls } from "../types";
+
+export function renderBackMaterial(
+ device: Device,
+ resources: RendererResources,
+ mesh: MeshData,
+ target: GPUTextureView,
+ depth: GPUTextureView,
+ controls: RenderControls,
+ logicalWidth: number,
+ logicalHeight: number,
+ projectionPaddingRadius = resources.paddingRadius,
+) {
+ writeParams({
+ target: resources.params.insideParams,
+ controls,
+ logicalWidth,
+ logicalHeight,
+ passKind: PASS_INSIDE,
+ projectionPaddingRadius,
+ meshBounds: mesh.bounds,
+ orbitTarget: resources.orbitTarget,
+ thicknessScale: resources.thicknessScale,
+ isLight: resources.isLight,
+ });
+ const pass = new RenderPass(device, {
+ label: "eve-5-back-material-pass",
+ colorAttachments: [{ view: target, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
+ depthStencilAttachment: {
+ view: depth,
+ depthClearValue: 1,
+ depthLoadOp: "clear",
+ depthStoreOp: "store",
+ },
+ });
+ if (controls.insideRendering) {
+ pass.setPipeline(resources.pipelines.backMaterialPipeline);
+ pass.setVertexBuffer(0, resources.gpuMesh.vertexBuffer);
+ pass.gpu.setIndexBuffer(resources.gpuMesh.indexBuffer.gpu, "uint32");
+ pass.setBindGroup(0, resources.params.insideParams.bindGroup);
+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);
+ }
+ pass.end();
+}
+
+export function renderBackDepth(
+ device: Device,
+ resources: RendererResources,
+ mesh: MeshData,
+ target: GPUTextureView,
+ depth: GPUTextureView,
+ controls: RenderControls,
+ logicalWidth: number,
+ logicalHeight: number,
+ projectionPaddingRadius = resources.paddingRadius,
+) {
+ writeParams({
+ target: resources.params.backDepthParams,
+ controls,
+ logicalWidth,
+ logicalHeight,
+ passKind: PASS_INSIDE,
+ projectionPaddingRadius,
+ meshBounds: mesh.bounds,
+ orbitTarget: resources.orbitTarget,
+ thicknessScale: resources.thicknessScale,
+ isLight: resources.isLight,
+ });
+ const pass = new RenderPass(device, {
+ label: "eve-5-back-depth-pass",
+ colorAttachments: [{ view: target, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
+ depthStencilAttachment: {
+ view: depth,
+ depthLoadOp: "load",
+ depthStoreOp: "store",
+ },
+ });
+ if (controls.insideRendering) {
+ pass.setPipeline(resources.pipelines.backDepthPipeline);
+ pass.setVertexBuffer(0, resources.gpuMesh.vertexBuffer);
+ pass.gpu.setIndexBuffer(resources.gpuMesh.indexBuffer.gpu, "uint32");
+ pass.setBindGroup(0, resources.params.backDepthParams.bindGroup);
+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);
+ }
+ pass.end();
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/bloom-pass.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/bloom-pass.ts
new file mode 100644
index 000000000..06e02d6b0
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/bloom-pass.ts
@@ -0,0 +1,82 @@
+// Encodes bloom blur and dark-theme composite passes.
+// INVARIANT: Bloom extract/blur/composite order and blend strength math remain in renderer.ts.
+// Imported only by render/renderer.ts.
+
+import { Device } from "@vgpu/core";
+import { RenderPass } from "@vgpu/render";
+import { BLOOM_STRENGTH_OFF, BLOOM_THRESHOLD } from "../constants";
+import type { RendererResources } from "../resources";
+import type { BloomTargets } from "../types";
+
+export function renderBlur(
+ device: Device,
+ resources: RendererResources,
+ source: GPUTexture,
+ target: GPUTexture,
+ direction: [number, number],
+ extract: boolean,
+ radius: number,
+) {
+ const kernelRadius = Math.max(0, Math.round(radius));
+ const sigma = Math.max(0.001, kernelRadius / 3);
+ resources.buffers.blurParamsBuffer.write(
+ new Float32Array([
+ direction[0],
+ direction[1],
+ extract ? 1 : 0,
+ BLOOM_THRESHOLD,
+ kernelRadius,
+ sigma,
+ 0,
+ 0,
+ ]),
+ );
+ const bindGroup = device.gpu.createBindGroup({
+ label: "eve-5-bloom-blur-bind-group",
+ layout: resources.pipelines.blurPipeline.getBindGroupLayout(0),
+ entries: [
+ { binding: 0, resource: source.createView() },
+ { binding: 1, resource: resources.samplers.blurSampler },
+ { binding: 2, resource: { buffer: resources.buffers.blurParamsBuffer.gpu } },
+ ],
+ });
+ const pass = new RenderPass(device, {
+ label: `eve-5-bloom-${direction[0] > 0 ? "horizontal" : "vertical"}-pass`,
+ colorAttachments: [
+ { view: target.createView(), loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] },
+ ],
+ });
+ pass.setPipeline(resources.pipelines.blurPipeline);
+ pass.setBindGroup(0, bindGroup);
+ pass.draw(3);
+ pass.end();
+}
+
+export function renderComposite(
+ device: Device,
+ resources: RendererResources,
+ view: GPUTextureView,
+ targets: BloomTargets,
+ bloomTexture: GPUTexture = targets.vertical,
+ strength = BLOOM_STRENGTH_OFF,
+) {
+ resources.buffers.compositeParamsBuffer.write(new Float32Array([strength, 0, 0, 0]));
+ const bindGroup = device.gpu.createBindGroup({
+ label: "eve-5-bloom-composite-bind-group",
+ layout: resources.pipelines.compositePipeline.getBindGroupLayout(0),
+ entries: [
+ { binding: 0, resource: targets.scene.createView() },
+ { binding: 1, resource: bloomTexture.createView() },
+ { binding: 2, resource: resources.samplers.blurSampler },
+ { binding: 3, resource: { buffer: resources.buffers.compositeParamsBuffer.gpu } },
+ ],
+ });
+ const pass = new RenderPass(device, {
+ label: "eve-5-composite-tonemap-pass",
+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
+ });
+ pass.setPipeline(resources.pipelines.compositePipeline);
+ pass.setBindGroup(0, bindGroup);
+ pass.draw(3);
+ pass.end();
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/debug-passes.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/debug-passes.ts
new file mode 100644
index 000000000..a33c8cd59
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/debug-passes.ts
@@ -0,0 +1,106 @@
+// Encodes non-main debug display passes: target preview and thickness visualization.
+// INVARIANT: Debug passes use display-format front pipeline and do not change paint parity.
+// Imported only by render/renderer.ts.
+
+import { Device } from "@vgpu/core";
+import { RenderPass } from "@vgpu/render";
+import { cameraAxisDepthRange } from "../camera";
+import { createParamsBindGroup } from "../bindings";
+import { PASS_OUTSIDE, PREVIEW_BACK_ALBEDO, PREVIEW_BACK_DEPTH } from "../constants";
+import { cameraBasis, orbitEye } from "../math";
+import { writeParams } from "../params";
+import type { RendererResources } from "../resources";
+import type { BloomTargets, MeshData, RenderControls } from "../types";
+
+export function renderTargetPreview(
+ device: Device,
+ resources: RendererResources,
+ mesh: MeshData,
+ view: GPUTextureView,
+ targets: BloomTargets,
+ controls: RenderControls,
+) {
+ const basis = cameraBasis(
+ orbitEye(resources.orbitTarget, controls.radius, controls.yaw, controls.pitch),
+ resources.orbitTarget,
+ );
+ const depthRange = cameraAxisDepthRange(mesh.bounds, basis.forward);
+ resources.buffers.previewMode.write(
+ new Float32Array([
+ controls.material === "back-depth" ? PREVIEW_BACK_DEPTH : PREVIEW_BACK_ALBEDO,
+ depthRange.min,
+ depthRange.max,
+ 0,
+ ]),
+ );
+ const bindGroup = device.gpu.createBindGroup({
+ label: "eve-5-render-target-preview-bind-group",
+ layout: resources.pipelines.previewPipeline.getBindGroupLayout(0),
+ entries: [
+ { binding: 0, resource: targets.backMaterial.createView() },
+ { binding: 1, resource: targets.backDepth.createView() },
+ { binding: 2, resource: resources.samplers.previewSampler },
+ { binding: 3, resource: { buffer: resources.buffers.previewMode.gpu } },
+ ],
+ });
+ const pass = new RenderPass(device, {
+ label: "eve-5-render-target-preview-pass",
+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
+ });
+ pass.setPipeline(resources.pipelines.previewPipeline);
+ pass.setBindGroup(0, bindGroup);
+ pass.draw(3);
+ pass.end();
+}
+
+export function renderThicknessDebug(
+ device: Device,
+ resources: RendererResources,
+ mesh: MeshData,
+ view: GPUTextureView,
+ backMaterial: GPUTexture,
+ backDepth: GPUTexture,
+ paintTexture: GPUTexture,
+ controls: RenderControls,
+ logicalWidth: number,
+ logicalHeight: number,
+ projectionPaddingRadius = resources.paddingRadius,
+) {
+ writeParams({
+ target: resources.params.outsideParams,
+ controls,
+ logicalWidth,
+ logicalHeight,
+ passKind: PASS_OUTSIDE,
+ projectionPaddingRadius,
+ meshBounds: mesh.bounds,
+ orbitTarget: resources.orbitTarget,
+ thicknessScale: resources.thicknessScale,
+ isLight: resources.isLight,
+ });
+ const outsideBindGroup = createParamsBindGroup(
+ device,
+ resources.pipelines.frontDisplayPipeline,
+ resources.studioCubemap,
+ resources.params.outsideParams.buffer,
+ backMaterial.createView(),
+ backDepth.createView(),
+ paintTexture.createView(),
+ resources.params.outsideParams.fallbackVoronoiValue.createView(),
+ resources.params.outsideParams.fallbackVoronoiEdge.createView(),
+ "eve-5-thickness-debug-params-bind-group",
+ );
+
+ const pass = new RenderPass(device, {
+ label: "eve-5-thickness-debug-pass",
+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],
+ });
+ pass.setVertexBuffer(0, resources.gpuMesh.vertexBuffer);
+ pass.gpu.setIndexBuffer(resources.gpuMesh.indexBuffer.gpu, "uint32");
+ if (controls.outsideRendering) {
+ pass.setPipeline(resources.pipelines.frontDisplayPipeline);
+ pass.setBindGroup(0, outsideBindGroup);
+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);
+ }
+ pass.end();
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/light-composite-pass.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/light-composite-pass.ts
new file mode 100644
index 000000000..e4f74159d
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/light-composite-pass.ts
@@ -0,0 +1,32 @@
+// Encodes the light-theme premultiplied composite pass.
+// INVARIANT: Clear alpha remains 0 for light theme compositing.
+// Imported only by render/renderer.ts.
+
+import { Device } from "@vgpu/core";
+import { RenderPass } from "@vgpu/render";
+import type { RendererResources } from "../resources";
+import type { BloomTargets } from "../types";
+
+export function renderLightComposite(
+ device: Device,
+ resources: RendererResources,
+ view: GPUTextureView,
+ targets: BloomTargets,
+) {
+ const bindGroup = device.gpu.createBindGroup({
+ label: "eve-5-light-composite-bind-group",
+ layout: resources.pipelines.lightCompositePipeline.getBindGroupLayout(0),
+ entries: [
+ { binding: 0, resource: targets.scene.createView() },
+ { binding: 1, resource: resources.samplers.blurSampler },
+ ],
+ });
+ const pass = new RenderPass(device, {
+ label: "eve-5-light-composite-premultiplied-pass",
+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 0] }],
+ });
+ pass.setPipeline(resources.pipelines.lightCompositePipeline);
+ pass.setBindGroup(0, bindGroup);
+ pass.draw(3);
+ pass.end();
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/scene-pass.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/scene-pass.ts
new file mode 100644
index 000000000..8976eb896
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/scene-pass.ts
@@ -0,0 +1,106 @@
+// Encodes the main front scene pass and wireframe/environment overlays.
+// INVARIANT: Front binding indices 0-7 and back-before-front ordering are unchanged.
+// Imported only by render/renderer.ts.
+
+import { Device } from "@vgpu/core";
+import { RenderPass } from "@vgpu/render";
+import { createParamsBindGroup } from "../bindings";
+import { PASS_OUTSIDE, PASS_WIREFRAME } from "../constants";
+import { writeParams } from "../params";
+import type { RendererResources } from "../resources";
+import type { ImprintRenderOptions, MeshData, RenderControls } from "../types";
+
+export function renderScene(
+ device: Device,
+ resources: RendererResources,
+ mesh: MeshData,
+ view: GPUTextureView,
+ backMaterial: GPUTexture,
+ backDepth: GPUTexture,
+ paintTexture: GPUTexture,
+ voronoiValueTexture: GPUTexture,
+ voronoiEdgeTexture: GPUTexture,
+ controls: RenderControls,
+ logicalWidth: number,
+ logicalHeight: number,
+ projectionPaddingRadius = resources.paddingRadius,
+ imprint: ImprintRenderOptions = {},
+) {
+ const paramsBase = {
+ controls,
+ logicalWidth,
+ logicalHeight,
+ projectionPaddingRadius,
+ meshBounds: mesh.bounds,
+ orbitTarget: resources.orbitTarget,
+ thicknessScale: resources.thicknessScale,
+ isLight: resources.isLight,
+ };
+ writeParams({
+ ...paramsBase,
+ target: resources.params.outsideParams,
+ passKind: PASS_OUTSIDE,
+ imprint,
+ });
+ writeParams({ ...paramsBase, target: resources.params.wireParams, passKind: PASS_WIREFRAME });
+ writeParams({ ...paramsBase, target: resources.params.envBgParams, passKind: PASS_OUTSIDE });
+ writeParams({ ...paramsBase, target: resources.params.opaqueOutsideParams, passKind: PASS_OUTSIDE });
+
+ const outsideBindGroup = createParamsBindGroup(
+ device,
+ resources.pipelines.frontMaterialPipeline,
+ resources.studioCubemap,
+ resources.params.outsideParams.buffer,
+ backMaterial.createView(),
+ backDepth.createView(),
+ paintTexture.createView(),
+ voronoiValueTexture.createView(),
+ voronoiEdgeTexture.createView(),
+ "eve-5-outside-params-bind-group",
+ );
+
+ const pass = new RenderPass(device, {
+ label: "eve-5-scene-hdr-pass",
+ colorAttachments: [
+ { view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, resources.isLight ? 0 : 1] },
+ ],
+ });
+
+ // Optional environment background: draw the studio cubemap behind the logo so the lighting
+ // is visible. Fullscreen triangle, no vertex buffer, so do it before binding the mesh.
+ if (controls.showEnv) {
+ pass.setPipeline(resources.pipelines.envBgPipeline);
+ pass.setBindGroup(0, resources.params.envBgParams.bindGroup);
+ pass.draw(3);
+ }
+
+ pass.setVertexBuffer(0, resources.gpuMesh.vertexBuffer);
+
+ const needsBackTargets = controls.material === "glass" || controls.material === "thickness";
+ pass.gpu.setIndexBuffer(resources.gpuMesh.indexBuffer.gpu, "uint32");
+ if (needsBackTargets) {
+ // The back/inside material and camera-axis depth have already been rendered into offscreen
+ // targets. The main scene draws only the front/outside material; glass and thickness debug
+ // both need the real back targets rather than the opaque/debug fallback bind group.
+ if (controls.outsideRendering) {
+ pass.setPipeline(resources.pipelines.frontMaterialPipeline);
+ pass.setBindGroup(0, outsideBindGroup);
+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);
+ }
+ } else if (controls.outsideRendering) {
+ // Opaque/debug materials are single-surface views. Drawing the inside pass too would
+ // double-expose through the depthless transparent ordering used by glass.
+ pass.setPipeline(resources.pipelines.opaquePipeline);
+ pass.setBindGroup(0, resources.params.opaqueOutsideParams.bindGroup);
+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);
+ }
+
+ if (controls.wireframe) {
+ pass.setPipeline(resources.pipelines.wirePipeline);
+ pass.gpu.setIndexBuffer(resources.gpuMesh.lineIndexBuffer.gpu, "uint32");
+ pass.setBindGroup(0, resources.params.wireParams.bindGroup);
+ pass.gpu.drawIndexed(resources.gpuMesh.lineIndexCount, 1, 0, 0, 0);
+ }
+
+ pass.end();
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pipelines.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pipelines.ts
new file mode 100644
index 000000000..8548cdcda
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pipelines.ts
@@ -0,0 +1,185 @@
+// Declarative render pipeline creation with fixed vertex layout/bindings.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import { Device } from "@vgpu/core";
+import { createRenderPipeline } from "@vgpu/render";
+import { BACK_DEPTH_FORMAT, PAINT_FORMAT, SCENE_FORMAT, VORONOI_NOISE_FORMAT } from "./constants";
+import { createShaders } from "./shaders";
+
+export function createPipelines(device: Device, format: GPUTextureFormat) {
+ const shaders = createShaders(device);
+ const vertexLayout: GPUVertexBufferLayout = {
+ arrayStride: 6 * 4,
+ attributes: [
+ { shaderLocation: 0, offset: 0, format: "float32x3" },
+ { shaderLocation: 1, offset: 3 * 4, format: "float32x3" },
+ ],
+ };
+
+ const backMaterialPipeline = createRenderPipeline(device, {
+ label: "eve-5-glass-back-material-pipeline",
+ shader: shaders.glassBack,
+ vertex: { entry: "vs_main", buffers: [vertexLayout] },
+ fragment: {
+ entry: "fs_main",
+ targets: [
+ {
+ format: SCENE_FORMAT,
+ blend: {
+ color: { srcFactor: "src-alpha", dstFactor: "one", operation: "add" },
+ alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },
+ },
+ },
+ ],
+ },
+ primitive: { topology: "triangle-list" },
+ depthStencil: { format: BACK_DEPTH_FORMAT, depthWriteEnabled: true, depthCompare: "less" },
+ });
+
+ const backDepthPipeline = createRenderPipeline(device, {
+ label: "eve-5-glass-back-depth-pipeline",
+ shader: shaders.glassBackDepth,
+ vertex: { entry: "vs_main", buffers: [vertexLayout] },
+ fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },
+ primitive: { topology: "triangle-list" },
+ depthStencil: {
+ format: BACK_DEPTH_FORMAT,
+ depthWriteEnabled: false,
+ depthCompare: "less-equal",
+ },
+ });
+
+ const frontMaterialPipeline = createRenderPipeline(device, {
+ label: "eve-5-glass-front-material-pipeline",
+ shader: shaders.glassFront,
+ vertex: { entry: "vs_main", buffers: [vertexLayout] },
+ fragment: {
+ entry: "fs_main",
+ targets: [
+ {
+ format: SCENE_FORMAT,
+ blend: {
+ color: { srcFactor: "src-alpha", dstFactor: "one", operation: "add" },
+ alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },
+ },
+ },
+ ],
+ },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const frontDisplayPipeline = createRenderPipeline(device, {
+ label: "eve-5-glass-front-display-pipeline",
+ shader: shaders.glassFront,
+ vertex: { entry: "vs_main", buffers: [vertexLayout] },
+ fragment: { entry: "fs_main", targets: [{ format }] },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const opaquePipeline = createRenderPipeline(device, {
+ label: "eve-5-opaque-material-pipeline",
+ shader: shaders.glassFront,
+ vertex: { entry: "vs_main", buffers: [vertexLayout] },
+ fragment: {
+ entry: "fs_main",
+ targets: [
+ {
+ format: SCENE_FORMAT,
+ blend: {
+ color: { srcFactor: "one", dstFactor: "zero", operation: "add" },
+ alpha: { srcFactor: "one", dstFactor: "zero", operation: "add" },
+ },
+ },
+ ],
+ },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const wirePipeline = createRenderPipeline(device, {
+ label: "eve-5-wireframe-pipeline",
+ shader: shaders.glassFront,
+ vertex: { entry: "vs_main", buffers: [vertexLayout] },
+ fragment: {
+ entry: "fs_main",
+ targets: [
+ {
+ format: SCENE_FORMAT,
+ blend: {
+ color: { srcFactor: "src-alpha", dstFactor: "one-minus-src-alpha", operation: "add" },
+ alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },
+ },
+ },
+ ],
+ },
+ primitive: { topology: "line-list" },
+ });
+
+ const blurPipeline = createRenderPipeline(device, {
+ label: "eve-5-bloom-blur-pipeline",
+ shader: shaders.bloomBlur,
+ vertex: { entry: "vs_main" },
+ fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const compositePipeline = createRenderPipeline(device, {
+ label: "eve-5-bloom-composite-pipeline",
+ shader: shaders.bloomComposite,
+ vertex: { entry: "vs_main" },
+ fragment: { entry: "fs_main", targets: [{ format }] },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const lightCompositePipeline = createRenderPipeline(device, {
+ label: "eve-5-light-composite-pipeline",
+ shader: shaders.lightComposite,
+ vertex: { entry: "vs_main" },
+ fragment: { entry: "fs_main", targets: [{ format }] },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const envBgPipeline = createRenderPipeline(device, {
+ label: "eve-5-env-bg-pipeline",
+ shader: shaders.envBg,
+ vertex: { entry: "vs_main" },
+ fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const previewPipeline = createRenderPipeline(device, {
+ label: "eve-5-render-target-preview-pipeline",
+ shader: shaders.preview,
+ vertex: { entry: "vs_main" },
+ fragment: { entry: "fs_main", targets: [{ format }] },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const paintDecayPipeline = createRenderPipeline(device, {
+ label: "eve-5-paint-decay-pipeline",
+ shader: shaders.paintUpdate,
+ vertex: { entry: "vs_main" },
+ fragment: { entry: "fs_main", targets: [{ format: PAINT_FORMAT }] },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const paintDebugPipeline = createRenderPipeline(device, {
+ label: "eve-5-paint-debug-pipeline",
+ shader: shaders.paintDebug,
+ vertex: { entry: "vs_main" },
+ fragment: { entry: "fs_main", targets: [{ format }] },
+ primitive: { topology: "triangle-list" },
+ });
+
+ const voronoiNoisePipeline = createRenderPipeline(device, {
+ label: "eve-5-voronoi-noise-update-pipeline",
+ shader: shaders.voronoiNoiseUpdate,
+ vertex: { entry: "vs_main" },
+ fragment: {
+ entry: "fs_main",
+ targets: [{ format: VORONOI_NOISE_FORMAT }, { format: VORONOI_NOISE_FORMAT }],
+ },
+ primitive: { topology: "triangle-list" },
+ });
+ return { backMaterialPipeline, backDepthPipeline, frontMaterialPipeline, frontDisplayPipeline, opaquePipeline, wirePipeline, blurPipeline, compositePipeline, lightCompositePipeline, envBgPipeline, previewPipeline, paintDecayPipeline, paintDebugPipeline, voronoiNoisePipeline };
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pointer-mapping.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pointer-mapping.ts
new file mode 100644
index 000000000..41fcb1b00
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pointer-mapping.ts
@@ -0,0 +1,84 @@
+// Pointer-to-paint-cell mapping; mirrors params origin-cell math.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import type { Bounds, PaintPointerMapping, PaintPointerMappingInput, RenderControls } from "./types";
+import {
+ BLOOM_RADIUS,
+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ imprintCellSizeForDevicePixelRatio,
+} from "./constants";
+import { meshOrbitTargetFromBounds } from "./camera";
+import { degreesToRadians, dot } from "./math";
+import { getPaddedRenderSize } from "./textures";
+import { cameraBasis, orbitEye } from "./math";
+import { normalizedMeshBounds } from "./mesh-gpu";
+
+export function mapClientPointToPaintCell(
+ input: PaintPointerMappingInput,
+): PaintPointerMapping | undefined {
+ const rectWidth = Math.max(0, input.rect.width);
+ const rectHeight = Math.max(0, input.rect.height);
+ const canvasWidth = Math.max(1, input.canvasWidth);
+ const canvasHeight = Math.max(1, input.canvasHeight);
+ const logicalWidth = Math.max(1, Math.round(input.logicalWidth));
+ const logicalHeight = Math.max(1, Math.round(input.logicalHeight));
+ if (rectWidth <= 0 || rectHeight <= 0) return undefined;
+
+ const paddingRadius = input.paddingRadius ?? BLOOM_RADIUS;
+ const xPhys = (input.clientX - input.rect.left) * (canvasWidth / rectWidth);
+ const yPhys = (input.clientY - input.rect.top) * (canvasHeight / rectHeight);
+ const xLog = xPhys - paddingRadius;
+ const yLog = yPhys - paddingRadius;
+ const metrics = paintMappingMetrics(
+ input.meshBounds,
+ input.controls,
+ logicalWidth,
+ logicalHeight,
+ input.gridScaleMultiplier ?? DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ paddingRadius,
+ input.devicePixelRatio,
+ );
+ const modelX = (xLog - logicalWidth * 0.5) / metrics.pxPerModelUnit;
+ const modelY = (logicalHeight * 0.5 - yLog) / metrics.pxPerModelUnit;
+ const brushCellX = modelX * metrics.gridScale - metrics.originCell[0];
+ const brushCellY = modelY * metrics.gridScale - metrics.originCell[1];
+ return {
+ physical: [xPhys, yPhys],
+ logical: [xLog, yLog],
+ model: [modelX, modelY],
+ brushCell: [brushCellX, brushCellY],
+ originCell: metrics.originCell,
+ gridScale: metrics.gridScale,
+ pxPerModelUnit: metrics.pxPerModelUnit,
+ insideLogicalBounds: xLog >= 0 && xLog <= logicalWidth && yLog >= 0 && yLog <= logicalHeight,
+ };
+}
+
+export function paintMappingMetrics(
+ bounds: Bounds,
+ controls: Pick<RenderControls, "radius" | "yaw" | "pitch" | "fov">,
+ logicalWidth: number,
+ logicalHeight: number,
+ gridScaleMultiplier: number,
+ paddingRadius: number,
+ devicePixelRatio?: number,
+) {
+ const padded = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);
+ const fovRad = degreesToRadians(controls.fov);
+ const verticalScale = padded.height / Math.max(1, logicalHeight);
+ const fovEff = 2 * Math.atan(verticalScale * Math.tan(fovRad * 0.5));
+ const orbitTarget = meshOrbitTargetFromBounds(bounds);
+ const eye = orbitEye(orbitTarget, controls.radius, controls.yaw, controls.pitch);
+ const basis = cameraBasis(eye, orbitTarget);
+ const distToFrontPlane = Math.max(0.001, -dot(eye, basis.forward));
+ const pxPerModelUnit = padded.height / (2 * distToFrontPlane * Math.tan(fovEff * 0.5));
+ const cellSize = imprintCellSizeForDevicePixelRatio(devicePixelRatio);
+ const gridScale = (pxPerModelUnit / cellSize) * Math.max(0.001, gridScaleMultiplier);
+ const normalizedBounds = normalizedMeshBounds(bounds);
+ const originCell: [number, number] = [
+ Math.floor(normalizedBounds.min[0] * gridScale),
+ Math.floor(normalizedBounds.min[1] * gridScale),
+ ];
+ return { gridScale, originCell, pxPerModelUnit };
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/renderer.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/renderer.ts
new file mode 100644
index 000000000..6698cdb7d
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/renderer.ts
@@ -0,0 +1,156 @@
+// Composes Eve renderer resources and owns the frame graph behind the facade.
+// INVARIANT: This file orders passes only; subsystems own their resources and disposal.
+// Imported exclusively by render.ts.
+
+import { Device } from "@vgpu/core";
+import { BLOOM_STRENGTH_OFF, BLOOM_STRENGTH_ON, bloomRadiusForDevicePixelRatio } from "./constants";
+import { clampUnit, mix } from "./math";
+import { createPaintSystem } from "./paint-system";
+import { renderBackDepth, renderBackMaterial } from "./passes/back-pass";
+import { renderBlur, renderComposite } from "./passes/bloom-pass";
+import { renderTargetPreview, renderThicknessDebug } from "./passes/debug-passes";
+import { renderLightComposite } from "./passes/light-composite-pass";
+import { renderScene } from "./passes/scene-pass";
+import { createResources, disposeResources } from "./resources";
+import { createBloomTargetCache } from "./targets";
+import type { ImprintRenderOptions, MeshData, RenderControls } from "./types";
+
+export function createEve5Renderer(
+ device: Device,
+ format: GPUTextureFormat,
+ mesh: MeshData,
+ options: {
+ thicknessScale?: number;
+ theme?: "light" | "dark";
+ paddingRadius?: number;
+ bloom?: boolean;
+ } = {},
+) {
+ const resources = createResources(device, format, mesh, options);
+ const bloomTargets = createBloomTargetCache(device);
+ const paintSystem = createPaintSystem(device, resources, mesh);
+
+ const renderGlassTarget = (
+ target: GPUTextureView,
+ controls: RenderControls,
+ logicalWidth: number,
+ logicalHeight: number,
+ imprint: ImprintRenderOptions = {},
+ ) => {
+ const safeWidth = Math.max(1, Math.round(logicalWidth));
+ const safeHeight = Math.max(1, Math.round(logicalHeight));
+ const paddingRadius = options.paddingRadius ?? bloomRadiusForDevicePixelRatio(imprint.devicePixelRatio);
+ const targets = bloomTargets.ensure(safeWidth, safeHeight, paddingRadius);
+ const currentPaintTargets = paintSystem.ensure(safeWidth, safeHeight, imprint.devicePixelRatio);
+ const backSurfaceDepthView = targets.backSurfaceDepth.createView();
+
+ renderBackMaterial(
+ device,
+ resources,
+ mesh,
+ targets.backMaterial.createView(),
+ backSurfaceDepthView,
+ controls,
+ safeWidth,
+ safeHeight,
+ paddingRadius,
+ );
+ renderBackDepth(
+ device,
+ resources,
+ mesh,
+ targets.backDepth.createView(),
+ backSurfaceDepthView,
+ controls,
+ safeWidth,
+ safeHeight,
+ paddingRadius,
+ );
+
+ paintSystem.apply(currentPaintTargets, imprint.paint);
+
+ if (controls.material === "back-albedo" || controls.material === "back-depth") {
+ renderTargetPreview(device, resources, mesh, target, targets, controls);
+ return;
+ }
+ if (controls.material === "thickness") {
+ renderThicknessDebug(
+ device,
+ resources,
+ mesh,
+ target,
+ targets.backMaterial,
+ targets.backDepth,
+ currentPaintTargets.readIsPing ? currentPaintTargets.ping : currentPaintTargets.pong,
+ controls,
+ safeWidth,
+ safeHeight,
+ paddingRadius,
+ );
+ return;
+ }
+ if (controls.material === "paint-debug") {
+ paintSystem.renderDebug(target, currentPaintTargets);
+ return;
+ }
+
+ paintSystem.renderVoronoiNoise(
+ currentPaintTargets,
+ controls,
+ safeWidth,
+ safeHeight,
+ paddingRadius,
+ imprint,
+ );
+ renderScene(
+ device,
+ resources,
+ mesh,
+ targets.scene.createView(),
+ targets.backMaterial,
+ targets.backDepth,
+ currentPaintTargets.readIsPing ? currentPaintTargets.ping : currentPaintTargets.pong,
+ currentPaintTargets.voronoiValue,
+ currentPaintTargets.voronoiEdge,
+ controls,
+ safeWidth,
+ safeHeight,
+ paddingRadius,
+ imprint,
+ );
+
+ if (resources.isLight) {
+ renderLightComposite(device, resources, target, targets);
+ return;
+ }
+ if (!resources.bloomEnabled) {
+ renderComposite(device, resources, target, targets, targets.scene, 0);
+ return;
+ }
+ const effectiveBloomStrength = mix(
+ BLOOM_STRENGTH_OFF,
+ BLOOM_STRENGTH_ON,
+ clampUnit(imprint.progress ?? 0),
+ );
+ renderBlur(device, resources, targets.scene, targets.horizontal, [1, 0], true, paddingRadius);
+ renderBlur(device, resources, targets.horizontal, targets.vertical, [0, 1], false, paddingRadius);
+ renderComposite(device, resources, target, targets, targets.vertical, effectiveBloomStrength);
+ };
+
+ return {
+ render(
+ target: GPUTextureView,
+ controls: RenderControls,
+ logicalWidth: number,
+ logicalHeight: number,
+ imprint?: ImprintRenderOptions,
+ ) {
+ renderGlassTarget(target, controls, logicalWidth, logicalHeight, imprint);
+ },
+ dispose() {
+ paintSystem.dispose();
+ bloomTargets.dispose();
+ disposeResources(resources);
+ },
+ };
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/resources.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/resources.ts
new file mode 100644
index 000000000..9b115d4a1
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/resources.ts
@@ -0,0 +1,172 @@
+// Owns long-lived GPU resources for one Eve renderer instance.
+// INVARIANT: Creation/disposal mirrors the original render.ts resource list exactly.
+// Imported only by render/renderer.ts.
+
+import { Device } from "@vgpu/core";
+import { createBackParamsBinding, createEnvParamsBinding, createParamsBinding, createUniformParamsBinding } from "./bindings";
+import { BLOOM_RADIUS, PAINT_PARAMS_BYTE_SIZE, VORONOI_NOISE_PARAMS_BYTE_SIZE } from "./constants";
+import { createStudioCubemap, renderStudioCubemap } from "./cubemap";
+import { EVE_DARK_ENV_LIGHTS, EVE_LIGHT_ENV_LIGHTS } from "./env-lights";
+import { meshOrbitTarget, meshThicknessScale } from "./camera";
+import { createGpuMesh } from "./mesh-gpu";
+import { createPipelines } from "./pipelines";
+import type { MeshData } from "./types";
+
+export function createResources(
+ device: Device,
+ format: GPUTextureFormat,
+ mesh: MeshData,
+ options: {
+ thicknessScale?: number;
+ theme?: "light" | "dark";
+ paddingRadius?: number;
+ bloom?: boolean;
+ } = {},
+) {
+ const studioCubemap = createStudioCubemap(device, "eve-5-studio-hdr-cubemap");
+ const isLight = options.theme === "light";
+ const envLights = isLight ? EVE_LIGHT_ENV_LIGHTS : EVE_DARK_ENV_LIGHTS;
+ renderStudioCubemap(device, studioCubemap, envLights);
+ const orbitTarget = meshOrbitTarget(mesh);
+ const thicknessScale = options.thicknessScale ?? meshThicknessScale(mesh.bounds);
+ const paddingRadius = options.paddingRadius ?? BLOOM_RADIUS;
+ const bloomEnabled = options.bloom ?? true;
+ const pipelines = createPipelines(device, format);
+ const gpuMesh = createGpuMesh(device, mesh);
+
+ const insideParams = createBackParamsBinding(
+ device,
+ pipelines.backMaterialPipeline,
+ studioCubemap,
+ "eve-5-inside-params",
+ );
+ const backDepthParams = createUniformParamsBinding(
+ device,
+ pipelines.backDepthPipeline,
+ "eve-5-back-depth-params",
+ );
+ const envBgParams = createEnvParamsBinding(
+ device,
+ pipelines.envBgPipeline,
+ studioCubemap,
+ "eve-5-env-bg-params",
+ );
+ const outsideParams = createParamsBinding(
+ device,
+ pipelines.frontMaterialPipeline,
+ studioCubemap,
+ "eve-5-outside-params",
+ );
+ const opaqueOutsideParams = createParamsBinding(
+ device,
+ pipelines.opaquePipeline,
+ studioCubemap,
+ "eve-5-opaque-outside-params",
+ );
+ const wireParams = createParamsBinding(
+ device,
+ pipelines.wirePipeline,
+ studioCubemap,
+ "eve-5-wire-params",
+ );
+ const blurParamsBuffer = device.createBuffer({
+ label: "eve-5-bloom-blur-params",
+ size: 32,
+ usage: ["uniform", "copy_dst"],
+ });
+ const compositeParamsBuffer = device.createBuffer({
+ label: "eve-5-bloom-composite-params",
+ size: 16,
+ usage: ["uniform", "copy_dst"],
+ });
+ const paintParamsBuffer = device.createBuffer({
+ label: "eve-5-paint-params",
+ size: PAINT_PARAMS_BYTE_SIZE,
+ usage: ["uniform", "copy_dst"],
+ });
+ const voronoiNoiseParamsBuffer = device.createBuffer({
+ label: "eve-5-voronoi-noise-params",
+ size: VORONOI_NOISE_PARAMS_BYTE_SIZE,
+ usage: ["uniform", "copy_dst"],
+ });
+ const voronoiNoiseBindGroup = device.gpu.createBindGroup({
+ label: "eve-5-voronoi-noise-bind-group",
+ layout: pipelines.voronoiNoisePipeline.getBindGroupLayout(0),
+ entries: [{ binding: 0, resource: { buffer: voronoiNoiseParamsBuffer.gpu } }],
+ });
+ const blurSampler = device.gpu.createSampler({
+ label: "eve-5-bloom-sampler",
+ magFilter: "linear",
+ minFilter: "linear",
+ addressModeU: "clamp-to-edge",
+ addressModeV: "clamp-to-edge",
+ });
+ const previewSampler = device.gpu.createSampler({
+ label: "eve-5-render-target-preview-sampler",
+ magFilter: "linear",
+ minFilter: "linear",
+ addressModeU: "clamp-to-edge",
+ addressModeV: "clamp-to-edge",
+ });
+ const previewMode = device.createBuffer({
+ label: "eve-5-render-target-preview-mode",
+ size: 16,
+ usage: ["uniform", "copy_dst"],
+ });
+
+ const params = { insideParams, backDepthParams, envBgParams, outsideParams, opaqueOutsideParams, wireParams };
+ const buffers = { blurParamsBuffer, compositeParamsBuffer, paintParamsBuffer, voronoiNoiseParamsBuffer, previewMode };
+ const samplers = { blurSampler, previewSampler };
+
+ return {
+ studioCubemap,
+ isLight,
+ orbitTarget,
+ thicknessScale,
+ paddingRadius,
+ bloomEnabled,
+ pipelines,
+ gpuMesh,
+ params,
+ buffers,
+ samplers,
+ voronoiNoiseBindGroup,
+ };
+}
+
+export type RendererResources = ReturnType<typeof createResources>;
+
+function destroyParamsBinding(binding: {
+ buffer: { destroy(): void };
+ fallbackBackMaterial?: GPUTexture;
+ fallbackBackDepth?: GPUTexture;
+ fallbackPaint?: GPUTexture;
+ fallbackVoronoiValue?: GPUTexture;
+ fallbackVoronoiEdge?: GPUTexture;
+}) {
+ binding.buffer.destroy();
+ binding.fallbackBackMaterial?.destroy();
+ binding.fallbackBackDepth?.destroy();
+ binding.fallbackPaint?.destroy();
+ binding.fallbackVoronoiValue?.destroy();
+ binding.fallbackVoronoiEdge?.destroy();
+}
+
+export function disposeResources(resources: RendererResources) {
+ resources.gpuMesh.vertexBuffer.destroy();
+ resources.gpuMesh.indexBuffer.destroy();
+ resources.gpuMesh.lineIndexBuffer.destroy();
+ destroyParamsBinding(resources.params.insideParams);
+ destroyParamsBinding(resources.params.backDepthParams);
+ destroyParamsBinding(resources.params.outsideParams);
+ destroyParamsBinding(resources.params.opaqueOutsideParams);
+ destroyParamsBinding(resources.params.wireParams);
+ destroyParamsBinding(resources.params.envBgParams);
+ resources.buffers.blurParamsBuffer.destroy();
+ resources.buffers.compositeParamsBuffer.destroy();
+ resources.buffers.paintParamsBuffer.destroy();
+ resources.buffers.voronoiNoiseParamsBuffer.destroy();
+ resources.buffers.previewMode.destroy();
+ resources.studioCubemap.faceParams.destroy();
+ resources.studioCubemap.texture.destroy();
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/shaders.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/shaders.ts
new file mode 100644
index 000000000..cd1690cd9
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/shaders.ts
@@ -0,0 +1,33 @@
+// Single shader import/compile registry; WGSL entry paths stay unchanged.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import { Device } from "@vgpu/core";
+import { compile } from "@vgpu/wgsl";
+import glassBackWgsl from "../shaders/glass/back.wgsl";
+import glassFrontWgsl from "../shaders/glass/front.wgsl";
+import glassBackDepthWgsl from "../shaders/glass/back-depth.wgsl";
+import eveBloomBlurWgsl from "../shaders/bloom/blur.wgsl";
+import eveBloomCompositeWgsl from "../shaders/bloom/composite.wgsl";
+import eveLightCompositeWgsl from "../shaders/postprocess/light-composite.wgsl";
+import eveEnvBgWgsl from "../shaders/env/background.wgsl";
+import renderTargetPreviewWgsl from "../shaders/debug/render-target-preview.wgsl";
+import paintUpdateWgsl from "../shaders/paint/paint-update.wgsl";
+import paintDebugWgsl from "../shaders/paint/paint-debug.wgsl";
+import voronoiNoiseUpdateWgsl from "../shaders/paint/voronoi-noise-update.wgsl";
+
+export function createShaders(device: Device) {
+ return {
+ glassBack: device.createShader(compile(glassBackWgsl)),
+ glassFront: device.createShader(compile(glassFrontWgsl)),
+ glassBackDepth: device.createShader(compile(glassBackDepthWgsl)),
+ bloomBlur: device.createShader(compile(eveBloomBlurWgsl)),
+ bloomComposite: device.createShader(compile(eveBloomCompositeWgsl)),
+ lightComposite: device.createShader(compile(eveLightCompositeWgsl)),
+ envBg: device.createShader(compile(eveEnvBgWgsl)),
+ preview: device.createShader(compile(renderTargetPreviewWgsl)),
+ paintUpdate: device.createShader(compile(paintUpdateWgsl)),
+ paintDebug: device.createShader(compile(paintDebugWgsl)),
+ voronoiNoiseUpdate: device.createShader(compile(voronoiNoiseUpdateWgsl)),
+ };
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/targets.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/targets.ts
new file mode 100644
index 000000000..c71ed398b
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/targets.ts
@@ -0,0 +1,63 @@
+// Owns resize-sensitive bloom/back render targets.
+// INVARIANT: Target formats, labels, and destroy-before-recreate order match the original renderer.
+// Imported only by render/renderer.ts.
+
+import { Device } from "@vgpu/core";
+import { createBackDepthTexture, createBloomTexture, getPaddedRenderSize } from "./textures";
+import type { BloomTargets } from "./types";
+
+export function createBloomTargetCache(device: Device) {
+ let targets: (BloomTargets & { paddingRadius: number }) | undefined;
+
+ const dispose = () => {
+ targets?.scene.destroy();
+ targets?.backMaterial.destroy();
+ targets?.backDepth.destroy();
+ targets?.backSurfaceDepth.destroy();
+ targets?.horizontal.destroy();
+ targets?.vertical.destroy();
+ targets = undefined;
+ };
+
+ return {
+ ensure(logicalWidth: number, logicalHeight: number, paddingRadius: number) {
+ const padded = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);
+ if (
+ targets?.width === padded.width &&
+ targets.height === padded.height &&
+ targets.paddingRadius === paddingRadius
+ ) {
+ return targets;
+ }
+ dispose();
+ targets = {
+ width: padded.width,
+ height: padded.height,
+ paddingRadius,
+ scene: createBloomTexture(device, "eve-5-scene-linear-hdr", padded.width, padded.height),
+ backMaterial: createBloomTexture(
+ device,
+ "eve-5-back-material-linear-hdr",
+ padded.width,
+ padded.height,
+ ),
+ backDepth: createBloomTexture(
+ device,
+ "eve-5-back-camera-axis-depth",
+ padded.width,
+ padded.height,
+ ),
+ backSurfaceDepth: createBackDepthTexture(
+ device,
+ "eve-5-back-surface-depth",
+ padded.width,
+ padded.height,
+ ),
+ horizontal: createBloomTexture(device, "eve-5-bloom-horizontal", padded.width, padded.height),
+ vertical: createBloomTexture(device, "eve-5-bloom-vertical", padded.width, padded.height),
+ };
+ return targets;
+ },
+ dispose,
+ };
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/textures.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/textures.ts
new file mode 100644
index 000000000..a730cc31c
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/textures.ts
@@ -0,0 +1,95 @@
+// Render target sizing, texture factories, and static noise upload.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import { Device } from "@vgpu/core";
+import { BACK_DEPTH_FORMAT, BLOOM_RADIUS, PAINT_FORMAT, PAINT_STATIC_NOISE_FORMAT, SCENE_FORMAT, VORONOI_NOISE_FORMAT } from "./constants";
+
+export function getPaddedRenderSize(width: number, height: number, paddingRadius = BLOOM_RADIUS) {
+ const padding = Math.max(0, Math.round(paddingRadius)) * 2;
+ return {
+ width: Math.max(1, Math.round(width)) + padding,
+ height: Math.max(1, Math.round(height)) + padding,
+ };
+}
+
+export function createBloomTexture(device: Device, label: string, width: number, height: number) {
+ return device.gpu.createTexture({
+ label,
+ size: [width, height],
+ format: SCENE_FORMAT,
+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,
+ });
+}
+
+export function createBackDepthTexture(device: Device, label: string, width: number, height: number) {
+ return device.gpu.createTexture({
+ label,
+ size: [width, height],
+ format: BACK_DEPTH_FORMAT,
+ usage: GPUTextureUsage.RENDER_ATTACHMENT,
+ });
+}
+
+export function createPaintTexture(device: Device, label: string, width: number, height: number) {
+ return device.gpu.createTexture({
+ label,
+ size: [width, height],
+ format: PAINT_FORMAT,
+ usage:
+ GPUTextureUsage.RENDER_ATTACHMENT |
+ GPUTextureUsage.TEXTURE_BINDING |
+ GPUTextureUsage.COPY_DST |
+ GPUTextureUsage.COPY_SRC,
+ });
+}
+
+export function createPaintStaticNoiseTexture(
+ device: Device,
+ label: string,
+ width: number,
+ height: number,
+) {
+ return device.gpu.createTexture({
+ label,
+ size: [width, height],
+ format: PAINT_STATIC_NOISE_FORMAT,
+ usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST,
+ });
+}
+
+export function createVoronoiNoiseTexture(device: Device, label: string, width: number, height: number) {
+ return device.gpu.createTexture({
+ label,
+ size: [width, height],
+ format: VORONOI_NOISE_FORMAT,
+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,
+ });
+}
+
+export function uploadStaticNoiseTexture(device: Device, texture: GPUTexture, width: number, height: number) {
+ const values = new Float32Array(width * height * 4);
+ for (let y = 0; y < height; y += 1) {
+ for (let x = 0; x < width; x += 1) {
+ const offset = (y * width + x) * 4;
+ values[offset] = hashPaintCell(x, y, 0xa511e9b3);
+ values[offset + 1] = hashPaintCell(x, y, 0x63d83595);
+ values[offset + 2] = hashPaintCell(x, y, 0xf9bd1c5b);
+ values[offset + 3] = hashPaintCell(x, y, 0x1c4b256d);
+ }
+ }
+ device.gpu.queue.writeTexture(
+ { texture },
+ values,
+ { bytesPerRow: width * 4 * Float32Array.BYTES_PER_ELEMENT, rowsPerImage: height },
+ { width, height },
+ );
+}
+
+export function hashPaintCell(x: number, y: number, salt: number) {
+ let h = (Math.imul(x >>> 0, 0x8da6b343) ^ Math.imul(y >>> 0, 0xd8163841) ^ salt) >>> 0;
+ h = (h ^ (h >>> 13)) >>> 0;
+ h = Math.imul(h, 0x85ebca6b) >>> 0;
+ h = (h ^ (h >>> 16)) >>> 0;
+ return (h & 0x00ffffff) / 0x01000000;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/types.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/types.ts
new file mode 100644
index 000000000..092cde415
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/types.ts
@@ -0,0 +1,167 @@
+// Renderer domain types and GPU resource shapes.
+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.
+// Imported by render/renderer.ts and re-exported only through render.ts facade.
+
+import type { Buffer } from "@vgpu/core";
+
+export type Bounds = {
+ min: [number, number, number];
+ max: [number, number, number];
+};
+
+export type MeshData = {
+ positions: Float32Array;
+ normals: Float32Array;
+ indices: Uint32Array;
+ bounds: Bounds;
+};
+
+export type EveMaterial =
+ | "glass"
+ | "normal"
+ | "camera reflected normal"
+ | "metallic"
+ | "back-albedo"
+ | "back-depth"
+ | "thickness"
+ | "paint-debug";
+
+export type PaintSeed = {
+ width: number;
+ height: number;
+ values: Float32Array;
+};
+
+export type PaintStroke = {
+ fromCell: readonly [number, number];
+ toCell: readonly [number, number];
+ duration?: number;
+ movementGated?: boolean;
+};
+
+export type PaintRenderOptions = {
+ seed?: PaintSeed;
+ steps?: number;
+ dt?: number;
+ brushCell?: readonly [number, number];
+ brushPreviousCell?: readonly [number, number];
+ brushRadius?: number;
+ brushStrength?: number;
+ brushActive?: boolean;
+ decayRate?: number;
+ diffusionRate?: number;
+ diffusionJitter?: number;
+ stroke?: PaintStroke;
+ decaySteps?: number;
+};
+
+export type ImprintRenderOptions = {
+ progress?: number;
+ gridScaleMultiplier?: number;
+ glyphScale?: number;
+ time?: number;
+ mouse?: readonly [number, number];
+ paint?: PaintRenderOptions;
+ devicePixelRatio?: number;
+};
+
+export type RenderControls = {
+ yaw: number;
+ pitch: number;
+ radius: number;
+ fov: number;
+ envYaw: number;
+ envPitch: number;
+ insideRendering: boolean;
+ outsideRendering: boolean;
+ material: EveMaterial;
+ wireframe: boolean;
+ showEnv: boolean;
+};
+
+export type PaintPointerRect = {
+ left: number;
+ top: number;
+ width: number;
+ height: number;
+};
+
+export type PaintPointerMappingInput = {
+ clientX: number;
+ clientY: number;
+ rect: PaintPointerRect;
+ canvasWidth: number;
+ canvasHeight: number;
+ logicalWidth: number;
+ logicalHeight: number;
+ controls: Pick<RenderControls, "radius" | "yaw" | "pitch" | "fov">;
+ meshBounds: Bounds;
+ gridScaleMultiplier?: number;
+ paddingRadius?: number;
+ devicePixelRatio?: number;
+};
+
+export type PaintPointerMapping = {
+ physical: readonly [number, number];
+ logical: readonly [number, number];
+ model: readonly [number, number];
+ brushCell: readonly [number, number];
+ originCell: readonly [number, number];
+ gridScale: number;
+ pxPerModelUnit: number;
+ insideLogicalBounds: boolean;
+};
+
+export type GpuMesh = {
+ vertexBuffer: Buffer;
+ indexBuffer: Buffer;
+ lineIndexBuffer: Buffer;
+ indexCount: number;
+ lineIndexCount: number;
+};
+
+export type StudioCubemap = {
+ texture: GPUTexture;
+ view: GPUTextureView;
+ sampler: GPUSampler;
+ faceParams: Buffer;
+};
+
+export type Mat4 = Float32Array;
+export type Vec3 = [number, number, number];
+
+export type EnvLightConfig = {
+ name: string;
+ position: readonly [number, number, number];
+ color: string;
+ intensity: number;
+ radius: number;
+ softness: number;
+ luminance: number;
+};
+
+export type BloomTargets = {
+ width: number;
+ height: number;
+ scene: GPUTexture;
+ backMaterial: GPUTexture;
+ backDepth: GPUTexture;
+ backSurfaceDepth: GPUTexture;
+ horizontal: GPUTexture;
+ vertical: GPUTexture;
+};
+
+export type PaintTargets = {
+ cols: number;
+ rows: number;
+ ping: GPUTexture;
+ pong: GPUTexture;
+ staticNoise: GPUTexture;
+ voronoiValue: GPUTexture;
+ voronoiEdge: GPUTexture;
+ readIsPing: boolean;
+ pingReadBindGroup: GPUBindGroup;
+ pongReadBindGroup: GPUBindGroup;
+ pingDebugBindGroup: GPUBindGroup;
+ pongDebugBindGroup: GPUBindGroup;
+};
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/canvas-sizing.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/canvas-sizing.ts
new file mode 100644
index 000000000..b3533d30f
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/canvas-sizing.ts
@@ -0,0 +1,48 @@
+import { DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO, bloomRadiusForDevicePixelRatio } from "../render";
+
+// Owns canvas and hero-logo sizing math for the browser renderer.
+// INVARIANT: load-bearing DPR/back-target alignment; must match getPaddedRenderSize.
+// Imported by index.tsx and runtime frame orchestration only.
+
+export const DEFAULT_LOGO_ASPECT = 78 / 25;
+const LOGO_RENDER_HEIGHT = 500;
+const MAX_DEVICE_PIXEL_RATIO = DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO;
+
+export function getLogicalRenderSize(aspect: number) {
+ return {
+ width: Math.max(1, Math.round(LOGO_RENDER_HEIGHT * aspect)),
+ height: LOGO_RENDER_HEIGHT,
+ };
+}
+
+export function getBrowserDevicePixelRatio() {
+ return Math.min(window.devicePixelRatio || 1, MAX_DEVICE_PIXEL_RATIO);
+}
+
+export function resizeCanvas(canvas: HTMLCanvasElement | null) {
+ const dpr = getBrowserDevicePixelRatio();
+ if (!canvas) return dpr;
+ const rect = canvas.getBoundingClientRect();
+ const width = Math.max(1, Math.floor(rect.width * dpr));
+ const height = Math.max(1, Math.floor(rect.height * dpr));
+ if (canvas.width !== width || canvas.height !== height) {
+ canvas.width = width;
+ canvas.height = height;
+ }
+ return dpr;
+}
+
+export function getCanvasLogicalSize(
+ canvas: HTMLCanvasElement,
+ devicePixelRatio = getBrowserDevicePixelRatio(),
+) {
+ // The renderer pads the logical scene size by a DPR-scaled bloom radius on each side before
+ // allocating its offscreen back/depth targets. The canvas itself is that padded physical render
+ // target, so subtract the same physical padding here. Passing CSS/logical logo dimensions would
+ // make the front shader's @builtin(position) sample different pixels from the back-side targets.
+ const bloomRadius = bloomRadiusForDevicePixelRatio(devicePixelRatio);
+ return {
+ logicalWidth: Math.max(1, canvas.width - bloomRadius * 2),
+ logicalHeight: Math.max(1, canvas.height - bloomRadius * 2),
+ };
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/debug-gui.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/debug-gui.ts
new file mode 100644
index 000000000..af1875446
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/debug-gui.ts
@@ -0,0 +1,80 @@
+// Owns the optional lil-gui transition debugger for the Eve hero.
+// INVARIANT: ?debug gate and window.__eveLogoTransitionDebugGui lifecycle are preserved.
+// Imported only by index.tsx runtime startup.
+
+export type EveTransitionDebugGui = {
+ destroy(): void;
+};
+
+export type EveTransitionDebugState = {
+ overrideEnabled: boolean;
+ progress: number;
+ gridScaleMultiplier: number;
+ glyphScale: number;
+ durationSeconds: number;
+ paintDecayPerFrame120: number;
+ diffusionAmount: number;
+ diffusionJitter: number;
+ brushRadius: number;
+ brushStrength: number;
+ visualizePaintBuffer: boolean;
+};
+
+declare global {
+ interface Window {
+ __eveLogoTransitionDebugGui?: EveTransitionDebugGui;
+ }
+}
+
+export function destroyTransitionDebugGui(gui: EveTransitionDebugGui | undefined) {
+ if (!gui) return;
+ if (window.__eveLogoTransitionDebugGui === gui) {
+ delete window.__eveLogoTransitionDebugGui;
+ }
+ gui.destroy();
+}
+
+export async function setupTransitionDebugGui({
+ transitionDebug,
+ isCancelled,
+ isDisposed,
+ onReady,
+}: {
+ transitionDebug: EveTransitionDebugState;
+ isCancelled: () => boolean;
+ isDisposed: () => boolean;
+ onReady: (gui: EveTransitionDebugGui) => void;
+}) {
+ if (!new URLSearchParams(window.location.search).has("debug")) return;
+ const { GUI } = await import("lil-gui");
+ if (isCancelled() || isDisposed()) return;
+ window.__eveLogoTransitionDebugGui?.destroy();
+ const gui = new GUI({ title: "Eve logo imprint" });
+ let guiDestroyed = false;
+ const guiHandle: EveTransitionDebugGui = {
+ destroy() {
+ if (guiDestroyed) return;
+ guiDestroyed = true;
+ gui.destroy();
+ },
+ };
+ onReady(guiHandle);
+ window.__eveLogoTransitionDebugGui = guiHandle;
+ gui.add(transitionDebug, "overrideEnabled").name("Override imprint");
+ gui.add(transitionDebug, "progress", 0, 1, 0.001).name("Imprint progress");
+ const imprint = gui.addFolder("Imprint");
+ imprint.add(transitionDebug, "gridScaleMultiplier", 0.5, 2, 0.01).name("Grid scale multiplier");
+ imprint.add(transitionDebug, "glyphScale", 0.5, 2.5, 0.01).name("Glyph scale");
+ imprint.open();
+ const paint = gui.addFolder("Paint");
+ paint
+ .add(transitionDebug, "paintDecayPerFrame120", 0.002, 0.08, 0.001)
+ .name("Decay/frame @120fps");
+ paint.add(transitionDebug, "diffusionAmount", 0, 24, 0.1).name("Diffusion (1/s)");
+ paint.add(transitionDebug, "diffusionJitter", 0, 4, 0.01).name("Diffusion jitter");
+ paint.add(transitionDebug, "brushRadius", 1, 8, 0.1).name("Brush radius (cells)");
+ paint.add(transitionDebug, "brushStrength", 4, 32, 0.1).name("Brush strength (1/s)");
+ paint.add(transitionDebug, "visualizePaintBuffer").name("Visualize paint buffer");
+ paint.open();
+ gui.add(transitionDebug, "durationSeconds", 0.05, 2, 0.01).name("Transition duration (s)");
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/frame-loop.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/frame-loop.ts
new file mode 100644
index 000000000..e08dcf284
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/frame-loop.ts
@@ -0,0 +1,239 @@
+import type { MutableRefObject } from "react";
+import { evePointerInteractionMode, mobileAutoEnvYaw } from "../mobile-motion";
+import type { ImprintRenderOptions, RenderControls } from "../render";
+import { getCanvasLogicalSize, resizeCanvas } from "./canvas-sizing";
+import type { EveTransitionDebugState } from "./debug-gui";
+import type { ControlsRef, HeroRuntimeState } from "./state";
+
+// Owns the Eve hero rAF draw loop and canvas reveal sequencing.
+// INVARIANT: dataset markers, paint movement gating, and fallback-on-error behavior are preserved.
+// Imported only by index.tsx's single effect.
+
+const ENV_YAW_LERP_SPEED = 3;
+export const AGENTS_ENV_YAW_LERP_SPEED = 3;
+const AGENTS_ENV_YAW_OFFSET = -Math.PI * 0.1;
+const ASCII_MOUSE_LERP_SPEED = 6;
+const PAINT_MOVEMENT_GRACE_MS = 72;
+const CANVAS_FADE_FALLBACK_MS = 800;
+const CANVAS_REVEAL_RENDER_COUNT = 3;
+
+type Renderer = {
+ render: (
+ target: GPUTextureView,
+ controls: RenderControls,
+ logicalWidth: number,
+ logicalHeight: number,
+ imprint?: ImprintRenderOptions,
+ ) => void;
+};
+
+export function createDrawLoop({
+ state,
+ canvas,
+ context,
+ renderer,
+ controlsRef,
+ transitionDebug,
+ modeTransitionProgressRef,
+ targetLogoModeProgressRef,
+ targetAgentsEnvYawMixRef,
+ defaultMaterial,
+ onCanvasRevealed,
+ onFallback,
+ onFatalError,
+}: {
+ state: HeroRuntimeState;
+ canvas: HTMLCanvasElement;
+ context: GPUCanvasContext;
+ renderer: Renderer;
+ controlsRef: ControlsRef;
+ transitionDebug: EveTransitionDebugState;
+ modeTransitionProgressRef: MutableRefObject<number>;
+ targetLogoModeProgressRef: MutableRefObject<number>;
+ targetAgentsEnvYawMixRef: MutableRefObject<number>;
+ defaultMaterial: RenderControls["material"];
+ onCanvasRevealed: () => void;
+ onFallback: () => void;
+ onFatalError: () => void;
+}) {
+ let successfulRenderCount = 0;
+ let finishCanvasFade: (() => void) | undefined;
+
+ const draw = (frameTime = performance.now()) => {
+ if (state.cancelled) return;
+
+ const deltaSeconds = Math.max(0, (frameTime - state.previousFrameTime) / 1000);
+ state.previousFrameTime = frameTime;
+ if (evePointerInteractionMode(state.isCoarsePointer).autoRotateEnvYaw) {
+ state.targetMouseEnvYaw = mobileAutoEnvYaw((frameTime - state.autoRotateStartTime) / 1000);
+ state.targetMouseEnvPitch = 0;
+ state.targetBrushActive = false;
+ }
+ state.mouseEnvYaw = safeLerp(
+ state.mouseEnvYaw,
+ state.targetMouseEnvYaw,
+ deltaSeconds * ENV_YAW_LERP_SPEED,
+ );
+ state.mouseEnvPitch = safeLerp(
+ state.mouseEnvPitch,
+ state.targetMouseEnvPitch,
+ deltaSeconds * ENV_YAW_LERP_SPEED,
+ );
+ state.asciiMouseX = safeLerp(
+ state.asciiMouseX,
+ state.targetAsciiMouseX,
+ deltaSeconds * ASCII_MOUSE_LERP_SPEED,
+ );
+ state.asciiMouseY = safeLerp(
+ state.asciiMouseY,
+ state.targetAsciiMouseY,
+ deltaSeconds * ASCII_MOUSE_LERP_SPEED,
+ );
+ state.brushActive = state.targetBrushActive && state.hasBrushCell;
+ const targetAgentsEnvYawMix = targetAgentsEnvYawMixRef.current;
+ state.agentsEnvYawMix = safeLerp(
+ state.agentsEnvYawMix,
+ targetAgentsEnvYawMix,
+ deltaSeconds * AGENTS_ENV_YAW_LERP_SPEED,
+ );
+ controlsRef.current.envYaw = state.mouseEnvYaw + state.agentsEnvYawMix * AGENTS_ENV_YAW_OFFSET;
+ controlsRef.current.envPitch = state.mouseEnvPitch;
+
+ const devicePixelRatio = resizeCanvas(canvas);
+ const { logicalWidth, logicalHeight } = getCanvasLogicalSize(canvas, devicePixelRatio);
+
+ try {
+ const transitionDurationSeconds = clampRange(transitionDebug.durationSeconds, 0.05, 2);
+ modeTransitionProgressRef.current = stepLogoModeProgress(
+ modeTransitionProgressRef.current,
+ targetLogoModeProgressRef.current,
+ deltaSeconds,
+ transitionDurationSeconds,
+ );
+ const animatedMixProgress = easeLogoModeProgress(modeTransitionProgressRef.current);
+ const mixProgress = transitionDebug.overrideEnabled
+ ? clampUnit(transitionDebug.progress)
+ : animatedMixProgress;
+ const timeSeconds = frameTime / 1000;
+ const gridScaleMultiplier = clampRange(transitionDebug.gridScaleMultiplier, 0.5, 2);
+ state.paintGridScaleMultiplier = gridScaleMultiplier;
+ controlsRef.current.material = transitionDebug.visualizePaintBuffer
+ ? "paint-debug"
+ : defaultMaterial;
+ const brushPreviousCell: readonly [number, number] = state.hasRenderedBrushCell
+ ? [state.previousRenderedBrushCellX, state.previousRenderedBrushCellY]
+ : [state.brushCellX, state.brushCellY];
+ const brushCanWrite =
+ state.brushActive && frameTime - state.lastBrushMoveTime <= PAINT_MOVEMENT_GRACE_MS;
+ renderer.render(
+ context.getCurrentTexture().createView(),
+ controlsRef.current,
+ logicalWidth,
+ logicalHeight,
+ {
+ progress: mixProgress,
+ gridScaleMultiplier,
+ glyphScale: clampRange(transitionDebug.glyphScale, 0.5, 2.5),
+ time: timeSeconds,
+ mouse: [state.asciiMouseX, state.asciiMouseY],
+ devicePixelRatio,
+ paint: {
+ // rAF timestamps are ms; deltaSeconds is converted once above and all paint
+ // decay/diffusion/brush math expects seconds. Brush cells are raw pointer cells
+ // (no lerp); the shader stamps the segment from previous rendered cell to current.
+ dt: deltaSeconds,
+ brushCell: [state.brushCellX, state.brushCellY],
+ brushPreviousCell,
+ brushRadius: clampRange(transitionDebug.brushRadius, 1, 8),
+ brushStrength: clampRange(transitionDebug.brushStrength, 4, 32),
+ brushActive: brushCanWrite,
+ decayRate: clampRange(transitionDebug.paintDecayPerFrame120, 0.002, 0.08) * 120,
+ diffusionRate: clampRange(transitionDebug.diffusionAmount, 0, 24),
+ diffusionJitter: clampRange(transitionDebug.diffusionJitter, 0, 4),
+ },
+ },
+ );
+
+ if (state.hasBrushCell) {
+ state.previousRenderedBrushCellX = state.brushCellX;
+ state.previousRenderedBrushCellY = state.brushCellY;
+ state.hasRenderedBrushCell = true;
+ }
+
+ canvas.dataset.eveRenderMode = mixProgress >= 0.5 ? "agents" : "humans";
+ canvas.dataset.eveAsciiProgress = mixProgress.toFixed(3);
+ canvas.dataset.eveAsciiMode = mixProgress > 0.001 ? "active" : "inactive";
+ } catch {
+ state.cancelled = true;
+ onFallback();
+ onFatalError();
+ return;
+ }
+
+ successfulRenderCount += 1;
+ if (successfulRenderCount === CANVAS_REVEAL_RENDER_COUNT) {
+ canvas.style.opacity = "1";
+ finishCanvasFade = onCanvasFullyOpaque(canvas, onCanvasRevealed);
+ }
+
+ state.animationFrame = requestAnimationFrame(draw);
+ };
+
+ return {
+ draw,
+ dispose() {
+ cancelAnimationFrame(state.animationFrame);
+ finishCanvasFade?.();
+ },
+ };
+}
+
+function safeLerp(from: number, to: number, amount: number) {
+ const safeAmount = Math.max(0, Math.min(1, amount));
+ return from + (to - from) * safeAmount;
+}
+
+function clampUnit(value: number) {
+ return clampRange(value, 0, 1);
+}
+
+function clampRange(value: number, min: number, max: number) {
+ return Math.max(min, Math.min(max, value));
+}
+
+function stepLogoModeProgress(
+ current: number,
+ target: number,
+ deltaSeconds: number,
+ durationSeconds: number,
+) {
+ const safeTarget = target >= 0.5 ? 1 : 0;
+ const safeDuration = clampRange(durationSeconds, 0.05, 2);
+ const step = Math.max(0, deltaSeconds) / safeDuration;
+ if (Math.abs(safeTarget - current) <= step) return safeTarget;
+ return current + Math.sign(safeTarget - current) * step;
+}
+
+function easeLogoModeProgress(progress: number) {
+ const t = Math.max(0, Math.min(1, progress));
+ return t * t * (3 - 2 * t);
+}
+
+function onCanvasFullyOpaque(canvas: HTMLCanvasElement, callback: () => void) {
+ let done = false;
+ let timeout = 0;
+ const finish = () => {
+ if (done) return;
+ done = true;
+ canvas.removeEventListener("transitionend", onTransitionEnd);
+ window.clearTimeout(timeout);
+ if (canvas.isConnected) callback();
+ };
+ const onTransitionEnd = (event: TransitionEvent) => {
+ if (event.propertyName === "opacity") finish();
+ };
+
+ canvas.addEventListener("transitionend", onTransitionEnd);
+ timeout = window.setTimeout(finish, CANVAS_FADE_FALLBACK_MS);
+ return finish;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/load-mesh.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/load-mesh.ts
new file mode 100644
index 000000000..ae2210b9f
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/load-mesh.ts
@@ -0,0 +1,24 @@
+import { decodeGltfMesh } from "../mesh";
+
+// Owns browser glTF fetch/decode for the Eve logo mesh.
+// INVARIANT: no-store fetch behavior is preserved for HMR/content updates.
+// Imported only by index.tsx startup.
+
+export const MODEL_URL = "/eve-5/eve-logo.gltf";
+
+export async function loadMesh() {
+ const response = await fetch(MODEL_URL, { cache: "no-store" });
+ if (!response.ok) throw new Error(`Failed to load ${MODEL_URL}: ${response.status}`);
+ return decodeGltfMesh(await response.json(), (uri) => loadGltfBuffer(uri, MODEL_URL));
+}
+
+async function loadGltfBuffer(uri: string, modelUrl: string) {
+ if (uri.startsWith("data:application/octet-stream;base64,")) {
+ return Uint8Array.from(atob(uri.split(",")[1]!), (char) => char.charCodeAt(0)).buffer;
+ }
+ const url = new URL(uri, window.location.origin + modelUrl);
+ const response = await fetch(url, { cache: "no-store" });
+ if (!response.ok)
+ throw new Error(`Failed to load glTF buffer ${url.pathname}: ${response.status}`);
+ return response.arrayBuffer();
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/pointer-input.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/pointer-input.ts
new file mode 100644
index 000000000..25baf9d78
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/pointer-input.ts
@@ -0,0 +1,132 @@
+import type { RefObject } from "react";
+import { evePointerInteractionMode } from "../mobile-motion";
+import { bloomRadiusForDevicePixelRatio, mapClientPointToPaintCell } from "../render";
+import { getBrowserDevicePixelRatio } from "./canvas-sizing";
+import type { ControlsRef, HeroRuntimeState } from "./state";
+
+// Owns browser pointer input for env yaw and paint brush updates.
+// INVARIANT: coarse-pointer mode disables paint and switches to env auto-rotate.
+// Imported only by index.tsx's single effect.
+
+const MAX_ENV_YAW = 0.3;
+const MAX_ENV_PITCH = 0.2;
+const PAINT_POINTER_MOVE_EPSILON_PX = 0.5;
+
+export function createPointerController({
+ state,
+ controlsRef,
+ canvasRef,
+}: {
+ state: HeroRuntimeState;
+ controlsRef: ControlsRef;
+ canvasRef: RefObject<HTMLCanvasElement | null>;
+}) {
+ const coarsePointerQuery = window.matchMedia("(pointer: coarse)");
+ const syncPointerInteractionMode = () => {
+ state.isCoarsePointer = coarsePointerQuery.matches;
+ if (evePointerInteractionMode(state.isCoarsePointer).autoRotateEnvYaw) {
+ state.targetBrushActive = false;
+ state.targetMouseEnvPitch = 0;
+ state.targetAsciiMouseX = 0;
+ state.targetAsciiMouseY = 0;
+ state.autoRotateStartTime = performance.now();
+ }
+ };
+
+ const updateEnvRotation = (clientX: number, clientY: number) => {
+ if (evePointerInteractionMode(state.isCoarsePointer).autoRotateEnvYaw) return;
+ const viewportWidth = Math.max(1, window.innerWidth || 1);
+ const viewportHeight = Math.max(1, window.innerHeight || 1);
+ const clampedX = Math.max(0, Math.min(viewportWidth, clientX));
+ const clampedY = Math.max(0, Math.min(viewportHeight, clientY));
+ const normalizedX = (clampedX / viewportWidth) * 2 - 1;
+ const normalizedY = (clampedY / viewportHeight) * 2 - 1;
+ state.targetMouseEnvYaw = normalizedX * MAX_ENV_YAW;
+ state.targetMouseEnvPitch = normalizedY * MAX_ENV_PITCH;
+ state.targetAsciiMouseX = normalizedX;
+ state.targetAsciiMouseY = normalizedY;
+ };
+
+ const deactivateBrush = () => {
+ state.targetBrushActive = false;
+ state.hasBrushCell = false;
+ state.hasRenderedBrushCell = false;
+ state.lastPointerClientX = undefined;
+ state.lastPointerClientY = undefined;
+ state.lastBrushMoveTime = Number.NEGATIVE_INFINITY;
+ };
+
+ const updatePaintBrush = (event: PointerEvent) => {
+ const canvas = canvasRef.current;
+ const mesh = state.activeMesh;
+ if (
+ !canvas ||
+ !mesh ||
+ event.pointerType !== "mouse" ||
+ !evePointerInteractionMode(state.isCoarsePointer).paintEnabled
+ ) {
+ deactivateBrush();
+ return;
+ }
+ const devicePixelRatio = getBrowserDevicePixelRatio();
+ const paddingRadius = bloomRadiusForDevicePixelRatio(devicePixelRatio);
+ const logicalWidth = Math.max(1, canvas.width - paddingRadius * 2);
+ const logicalHeight = Math.max(1, canvas.height - paddingRadius * 2);
+ const mapping = mapClientPointToPaintCell({
+ clientX: event.clientX,
+ clientY: event.clientY,
+ rect: canvas.getBoundingClientRect(),
+ canvasWidth: canvas.width,
+ canvasHeight: canvas.height,
+ logicalWidth,
+ logicalHeight,
+ controls: controlsRef.current,
+ meshBounds: mesh.bounds,
+ gridScaleMultiplier: state.paintGridScaleMultiplier,
+ paddingRadius,
+ devicePixelRatio,
+ });
+ if (!mapping?.insideLogicalBounds) {
+ deactivateBrush();
+ return;
+ }
+ const nextBrushCellX = mapping.brushCell[0];
+ const nextBrushCellY = mapping.brushCell[1];
+ const pointerMoved =
+ state.lastPointerClientX === undefined ||
+ state.lastPointerClientY === undefined ||
+ Math.hypot(
+ event.clientX - state.lastPointerClientX,
+ event.clientY - state.lastPointerClientY,
+ ) >= PAINT_POINTER_MOVE_EPSILON_PX;
+ if (pointerMoved) {
+ state.lastBrushMoveTime = performance.now();
+ }
+ state.brushCellX = nextBrushCellX;
+ state.brushCellY = nextBrushCellY;
+ state.hasBrushCell = true;
+ state.lastPointerClientX = event.clientX;
+ state.lastPointerClientY = event.clientY;
+ state.targetBrushActive = true;
+ };
+
+ const onPointerMove = (event: PointerEvent) => {
+ updateEnvRotation(event.clientX, event.clientY);
+ updatePaintBrush(event);
+ };
+
+ syncPointerInteractionMode();
+ coarsePointerQuery.addEventListener("change", syncPointerInteractionMode);
+ window.addEventListener("pointermove", onPointerMove, { passive: true });
+ window.addEventListener("pointerout", deactivateBrush, { passive: true });
+ window.addEventListener("blur", deactivateBrush);
+
+ return {
+ detach() {
+ window.removeEventListener("pointermove", onPointerMove);
+ window.removeEventListener("pointerout", deactivateBrush);
+ window.removeEventListener("blur", deactivateBrush);
+ coarsePointerQuery.removeEventListener("change", syncPointerInteractionMode);
+ },
+ };
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/state.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/state.ts
new file mode 100644
index 000000000..49996c9eb
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/state.ts
@@ -0,0 +1,39 @@
+import type { MutableRefObject } from "react";
+import type { MeshData, RenderControls } from "../render";
+
+// Owns the mutable fields shared by pointer input and the draw loop.
+// INVARIANT: this remains one lifecycle state object owned by index.tsx's single effect.
+// Imported only by runtime modules and index.tsx.
+
+export type HeroRuntimeState = {
+ cancelled: boolean;
+ animationFrame: number;
+ cleanup: (() => void) | undefined;
+ mouseEnvYaw: number;
+ targetMouseEnvYaw: number;
+ mouseEnvPitch: number;
+ targetMouseEnvPitch: number;
+ asciiMouseX: number;
+ asciiMouseY: number;
+ targetAsciiMouseX: number;
+ targetAsciiMouseY: number;
+ brushCellX: number;
+ brushCellY: number;
+ previousRenderedBrushCellX: number;
+ previousRenderedBrushCellY: number;
+ hasBrushCell: boolean;
+ hasRenderedBrushCell: boolean;
+ brushActive: boolean;
+ paintGridScaleMultiplier: number;
+ targetBrushActive: boolean;
+ activeMesh: MeshData | undefined;
+ agentsEnvYawMix: number;
+ previousFrameTime: number;
+ autoRotateStartTime: number;
+ lastBrushMoveTime: number;
+ lastPointerClientX: number | undefined;
+ lastPointerClientY: number | undefined;
+ isCoarsePointer: boolean;
+};
+
+export type ControlsRef = MutableRefObject<RenderControls>;
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/blur.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/blur.wgsl
index 86835615f..03ffe2295 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/blur.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/blur.wgsl
@@ -1,5 +1,7 @@
+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";
+
// Bloom blur pass.
-// Separable finite Gaussian blur; samples every integer texel in [-BLOOM_RADIUS, BLOOM_RADIUS]
+// Separable finite Gaussian blur; samples every integer texel in the DPR-scaled radius
// with no skipped pixels. Pass 0 extracts bright pixels and blurs horizontally. Pass 1 blurs
// vertically from the horizontal result.
@@ -12,27 +14,21 @@ struct BloomParams {
direction: vec2f,
extract: f32,
threshold: f32,
+ radius: f32,
+ sigma: f32,
};
@group(0) @binding(0) var sourceTexture: texture_2d<f32>;
@group(0) @binding(1) var sourceSampler: sampler;
@group(0) @binding(2) var<uniform> params: BloomParams;
-const BLOOM_RADIUS: i32 = 16;
-const BLOOM_SIGMA: f32 = 5.3333335; // radius / 3.0; finite support reaches exactly 16px.
+const MAX_BLOOM_RADIUS: i32 = 64;
@vertex
fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
- var positions = array<vec2f, 3>(
- vec2f(-1.0, -3.0),
- vec2f(-1.0, 1.0),
- vec2f(3.0, 1.0),
- );
-
var output: VertexOutput;
- let position = positions[vertexIndex];
- output.position = vec4f(position, 0.0, 1.0);
- output.uv = position * vec2f(0.5, -0.5) + vec2f(0.5, 0.5);
+ output.position = fullscreen_clip_position(vertexIndex);
+ output.uv = fullscreen_uv(vertexIndex);
return output;
}
@@ -49,17 +45,21 @@ fn fs_main(input: VertexOutput) -> @location(0) vec4f {
var sum = vec3f(0.0);
var weightSum = 0.0;
- for (var i = -BLOOM_RADIUS; i <= BLOOM_RADIUS; i = i + 1) {
- let fi = f32(i);
- let offsetUv = input.uv + params.direction * texel * fi;
- let uv = clamp(offsetUv, vec2f(0.0), vec2f(1.0));
- var color = textureSample(sourceTexture, sourceSampler, uv).rgb;
- if (params.extract > 0.5) {
- color = bright_pass(color);
+ let radius = clamp(i32(round(params.radius)), 0, MAX_BLOOM_RADIUS);
+ let sigma = max(params.sigma, 0.001);
+ for (var i = -MAX_BLOOM_RADIUS; i <= MAX_BLOOM_RADIUS; i = i + 1) {
+ if (abs(i) <= radius) {
+ let fi = f32(i);
+ let offsetUv = input.uv + params.direction * texel * fi;
+ let uv = clamp(offsetUv, vec2f(0.0), vec2f(1.0));
+ var color = textureSample(sourceTexture, sourceSampler, uv).rgb;
+ if (params.extract > 0.5) {
+ color = bright_pass(color);
+ }
+ let weight = exp(-(fi * fi) / (2.0 * sigma * sigma));
+ sum += color * weight;
+ weightSum += weight;
}
- let weight = exp(-(fi * fi) / (2.0 * BLOOM_SIGMA * BLOOM_SIGMA));
- sum += color * weight;
- weightSum += weight;
}
return vec4f(sum / max(weightSum, 1e-5), 1.0);
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/composite.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/composite.wgsl
index bb0f6367e..71629ad90 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/composite.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/composite.wgsl
@@ -1,3 +1,6 @@
+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";
+import { aces_tonemap, linear_to_display } from "../shared/tonemap.wgsl";
+
// Bloom composite pass. Adds finite-radius blurred bloom in linear HDR, then tonemaps once.
struct VertexOutput {
@@ -17,37 +20,16 @@ struct CompositeParams {
@group(0) @binding(2) var texSampler: sampler;
@group(0) @binding(3) var<uniform> params: CompositeParams;
-const DISPLAY_GAMMA = 2.2;
const BLOOM_RADIAL_FULL_RADIUS = 0.55;
@vertex
fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
- var positions = array<vec2f, 3>(
- vec2f(-1.0, -3.0),
- vec2f(-1.0, 1.0),
- vec2f(3.0, 1.0),
- );
-
var output: VertexOutput;
- let position = positions[vertexIndex];
- output.position = vec4f(position, 0.0, 1.0);
- output.uv = position * vec2f(0.5, -0.5) + vec2f(0.5, 0.5);
+ output.position = fullscreen_clip_position(vertexIndex);
+ output.uv = fullscreen_uv(vertexIndex);
return output;
}
-fn aces_tonemap(color: vec3f) -> vec3f {
- let a = 2.51;
- let b = 0.03;
- let c = 2.43;
- let d = 0.59;
- let e = 0.14;
- return clamp((color * (a * color + vec3f(b))) / (color * (c * color + vec3f(d)) + vec3f(e)), vec3f(0.0), vec3f(1.0));
-}
-
-fn linear_to_display(color: vec3f) -> vec3f {
- return pow(max(color, vec3f(0.0)), vec3f(1.0 / DISPLAY_GAMMA));
-}
-
@fragment
fn fs_main(input: VertexOutput) -> @location(0) vec4f {
let scene = textureSample(sceneTexture, texSampler, input.uv).rgb;
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/cubemap/render.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/cubemap/render.wgsl
index 58640a28c..fc40e86eb 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/cubemap/render.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/cubemap/render.wgsl
@@ -1,3 +1,5 @@
+import { cube_dir } from "../shared/cube-face.wgsl";
+
const MAX_ENV_LIGHTS = 16u;
struct EnvLight {
@@ -39,27 +41,6 @@ fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
return output;
}
-fn cube_dir(face: f32, uv: vec2f) -> vec3f {
- let p = uv * 2.0 - vec2f(1.0);
- // WebGPU cube face order: +X, -X, +Y, -Y, +Z, -Z.
- if (face < 0.5) {
- return normalize(vec3f(1.0, -p.y, -p.x));
- }
- if (face < 1.5) {
- return normalize(vec3f(-1.0, -p.y, p.x));
- }
- if (face < 2.5) {
- return normalize(vec3f(p.x, 1.0, p.y));
- }
- if (face < 3.5) {
- return normalize(vec3f(p.x, -1.0, -p.y));
- }
- if (face < 4.5) {
- return normalize(vec3f(p.x, -p.y, 1.0));
- }
- return normalize(vec3f(-p.x, -p.y, -1.0));
-}
-
fn spot(dir: vec3f, center: vec3f, radius: f32, softness: f32, luminance: f32, color: vec3f, intensity: f32) -> vec3f {
let d = distance(normalize(dir), normalize(center));
let soft = clamp(softness, 0.0, 1.0);
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/env/background.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/env/background.wgsl
index d2f1be41d..7da044709 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/env/background.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/env/background.wgsl
@@ -1,27 +1,9 @@
-import { sample_env } from "../shared/cube-sample.wgsl";
+import { sample_env } from "../shared/env-sample.wgsl";
+import { Params } from "../shared/scene-params.wgsl";
// Environment background pass for eve-5.
// Draws the fixed-world studio HDR cubemap from the same true orbit camera as the logo.
-struct Params {
- viewProj: mat4x4f,
- cameraPos: vec3f,
- passKind: f32,
- cameraRight: vec3f,
- fov: f32,
- cameraUp: vec3f,
- aspect: f32,
- cameraForward: vec3f,
- materialKind: f32,
- thicknessScale: f32,
- envYaw: f32,
- envPitch: f32,
- glassAbsorption: f32,
- // Match the shared glass Params layout because this pass receives the same buffer.
- ascii0: vec4f,
- ascii1: vec4f,
-};
-
struct VertexOutput {
@builtin(position) clipPosition: vec4f,
@location(0) ndc: vec2f,
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/ascii-composite.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/ascii-composite.wgsl
new file mode 100644
index 000000000..b1e06868b
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/ascii-composite.wgsl
@@ -0,0 +1,66 @@
+import { HOVER_OVERLAY_SCALE } from "../shared/ascii-imprint.wgsl";
+
+// Scalar ASCII opacity and premultiplied composition helpers for front glass.
+// INVARIANT: fwidth/coverage construction stays in ascii-imprint/front entry flow, not here.
+// This module declares no bindings and performs no texture reads.
+
+const IMPRINT_EMISSIVE = vec3f(2.5);
+const PAINT_EMISSIVE_BOOST = 0.5;
+const PAINT_DARKEN_GAMMA = 1.2;
+const PAINT_FADE_BYPASS = 0.85;
+const GLASS_HOVER_ALPHA_GAIN = 2.75;
+const GLASS_HOVER_ALPHA_FLOOR = 0.25;
+const ASCII_OPACITY_BOTTOM_Y = 0.;
+const ASCII_OPACITY_TOP_Y = 0.3;
+const ASCII_OPACITY_BOTTOM_LIGHT = 0.3;
+const ASCII_OPACITY_BOTTOM_DARK = 0.1;
+const ASCII_OPACITY_TOP = 1.0;
+const ASCII_OPACITY_CURVE_POWER = 2.0;
+
+export fn ascii_vertical_opacity(modelY: f32, themeT: f32) -> f32 {
+ let verticalT = clamp(
+ (modelY - ASCII_OPACITY_BOTTOM_Y) / (ASCII_OPACITY_TOP_Y - ASCII_OPACITY_BOTTOM_Y),
+ 0.0,
+ 1.0,
+ );
+ let verticalCurve = pow(verticalT, ASCII_OPACITY_CURVE_POWER);
+ let asciiOpacityBottom = mix(ASCII_OPACITY_BOTTOM_LIGHT, ASCII_OPACITY_BOTTOM_DARK, themeT);
+ return mix(asciiOpacityBottom, ASCII_OPACITY_TOP, verticalCurve);
+}
+
+export fn ascii_theme_coverage(glyphCoverage: f32, paintValue: f32, themeT: f32) -> f32 {
+ let lightCoverage = pow(
+ clamp(glyphCoverage, 0.0, 1.0),
+ 1.0 / (1.0 + PAINT_DARKEN_GAMMA * paintValue),
+ );
+ return mix(lightCoverage, glyphCoverage, themeT);
+}
+
+export fn ascii_coverage_with_opacity(glyphCoverage: f32, asciiOpacity: f32, paintValue: f32, themeT: f32) -> f32 {
+ // Paint bypasses most of the vertical fade, boosts light-theme density by lowering
+ // coverage gamma. The coverage is still premultiplied-safe alpha coverage; the glass
+ // color itself is not paint-faded.
+ let scaledPaint = paintValue * HOVER_OVERLAY_SCALE;
+ let opacity = mix(asciiOpacity, 1.0, PAINT_FADE_BYPASS * scaledPaint);
+ return ascii_theme_coverage(glyphCoverage, scaledPaint, themeT) * opacity;
+}
+
+export fn ascii_final_composite(glass: vec4f, glassVisibility: f32, coverage: f32, themeT: f32, paintValue: f32) -> vec4f {
+ // Fade the normal front-glass/env/back-blur contribution out only as the regular imprint
+ // progresses. Paint overlays ASCII on top of intact glass at imprintProgress=0.
+ let fadedGlassAlpha = glass.a * glassVisibility;
+ let fadedGlassContribution = glass.rgb * fadedGlassAlpha;
+ let scaledPaint = paintValue * HOVER_OVERLAY_SCALE;
+ let imprintColor = IMPRINT_EMISSIVE * themeT * (1.0 + PAINT_EMISSIVE_BOOST * scaledPaint);
+ // Glass-only hover mode (imprintProgress=0) wants translucent white emission that follows
+ // the glass alpha and never exceeds 0.8. glassVisibility is 1 when the imprint is fully off.
+ let glassHoverStrength = max(fadedGlassAlpha * GLASS_HOVER_ALPHA_GAIN, GLASS_HOVER_ALPHA_FLOOR);
+ let glassHoverAlpha = clamp(glassHoverStrength * coverage, 0.0, 0.8);
+ let glassHoverColor = vec3f(1.0) * glassHoverAlpha;
+ let glassMode = step(0.999, glassVisibility);
+ let asciiAlpha = mix(coverage, glassHoverAlpha, glassMode);
+ let asciiColor = mix(imprintColor, glassHoverColor, glassMode);
+ let aNew = mix(fadedGlassAlpha, 1.0, asciiAlpha);
+ let desired = mix(fadedGlassContribution, asciiColor, asciiAlpha);
+ return vec4f(desired / max(aNew, 0.001), aNew);
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-depth.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-depth.wgsl
index d6e73e064..5d9d70b4b 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-depth.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-depth.wgsl
@@ -1,4 +1,5 @@
-import { Params, VertexInput, VertexOutput, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-common.wgsl";
+import { Params } from "../shared/scene-params.wgsl";
+import { VertexInput, VertexOutput, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-vertex.wgsl";
@group(0) @binding(0) var<uniform> params: Params;
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-refraction.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-refraction.wgsl
new file mode 100644
index 000000000..5fa99ecb1
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-refraction.wgsl
@@ -0,0 +1,85 @@
+// Back-surface refraction helpers for the front glass entry shader.
+// INVARIANT: texture/sampler resources are passed as parameters; this module declares no bindings.
+// INVARIANT: fallback 1x1 back-depth texture means zero thickness and disables blur.
+
+const VOGEL_SAMPLE_COUNT = 16u;
+const GOLDEN_ANGLE = 2.399963229728653;
+const MAX_BACK_BLUR_RADIUS_UV = 0.01;
+const BACK_BLUR_SIGMA = 0.4;
+const BACK_MIN_TRANSMISSION = 0.38;
+const BACK_ABSORPTION_TINT = vec3f(0.9);
+const TAU = 6.28318530718;
+
+export fn hash12(p: vec2f) -> f32 {
+ let h = dot(p, vec2f(127.1, 311.7));
+ return fract(sin(h) * 43758.5453123);
+}
+
+export fn normalized_thickness(
+ backDepthTexture: texture_2d<f32>,
+ cameraAxisDepth: f32,
+ thicknessScale: f32,
+ pixel: vec2i,
+ backSize: vec2i,
+) -> f32 {
+ // A 1x1 back-depth texture is the fallback used by renderers that have not produced a real
+ // back depth map. Treat it as zero thickness so the blur remains disabled there.
+ if (backSize.x <= 1 || backSize.y <= 1 || !all(pixel >= vec2i(0)) || !all(pixel < backSize)) {
+ return 0.0;
+ }
+
+ let backCameraAxisDepth = textureLoad(backDepthTexture, pixel, 0).r;
+ let thickness = max(backCameraAxisDepth - cameraAxisDepth, 0.0);
+ return clamp(thickness / max(thicknessScale, 0.000001), 0.0, 1.0);
+}
+
+fn vogel_gaussian_blur(
+ backMaterialTexture: texture_2d<f32>,
+ backSampler: sampler,
+ uv: vec2f,
+ blurRadius: f32,
+ baseRotation: f32,
+) -> vec3f {
+ var color = vec3f(0.0);
+ var totalWeight = 0.0;
+
+ for (var i = 0u; i < VOGEL_SAMPLE_COUNT; i = i + 1u) {
+ let fi = f32(i);
+ let vogelRadius = sqrt((fi + 0.5) / f32(VOGEL_SAMPLE_COUNT));
+ let theta = fi * GOLDEN_ANGLE + baseRotation;
+ let sampleUv = uv + vec2f(cos(theta), sin(theta)) * vogelRadius * blurRadius;
+ let sigma = max(BACK_BLUR_SIGMA, 0.0001);
+ let weight = exp(-(vogelRadius * vogelRadius) / (2.0 * sigma * sigma));
+ color += textureSampleLevel(backMaterialTexture, backSampler, sampleUv, 0.0).rgb * weight;
+ totalWeight += weight;
+ }
+
+ return color / max(totalWeight, 0.0001);
+}
+
+export fn blurred_back_contribution(
+ backMaterialTexture: texture_2d<f32>,
+ backDepthTexture: texture_2d<f32>,
+ backSampler: sampler,
+ uv: vec2f,
+ pixel: vec2i,
+ cameraAxisDepth: f32,
+ thicknessScale: f32,
+ glassAbsorption: f32,
+) -> vec3f {
+ let normalizedThickness = normalized_thickness(
+ backDepthTexture,
+ cameraAxisDepth,
+ thicknessScale,
+ pixel,
+ vec2i(textureDimensions(backDepthTexture)),
+ );
+ let blurRadius = normalizedThickness * MAX_BACK_BLUR_RADIUS_UV;
+ let baseVogelRotation = hash12(uv) * TAU;
+ let blurredBackContribution = vogel_gaussian_blur(backMaterialTexture, backSampler, uv, blurRadius, baseVogelRotation);
+ let thicknessFade = pow(clamp(normalizedThickness, 0.0, 1.0), 0.5);
+ let absorptionFade = thicknessFade * glassAbsorption;
+ let transmission = mix(1.0, BACK_MIN_TRANSMISSION, absorptionFade);
+ let absorptionTint = mix(vec3f(1.0), BACK_ABSORPTION_TINT, absorptionFade);
+ return blurredBackContribution * transmission * absorptionTint;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back.wgsl
index 466c7457b..b5fc0fd12 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back.wgsl
@@ -1,5 +1,6 @@
import { oriented_normal, env_reflect_dir, env_reflection_from_dir, encode_normal } from "../shared/material-core.wgsl";
-import { Params, VertexInput, VertexOutput, WIRE_PASS_THRESHOLD, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-common.wgsl";
+import { Params, WIRE_PASS_THRESHOLD } from "../shared/scene-params.wgsl";
+import { VertexInput, VertexOutput, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-vertex.wgsl";
import { shade_glass } from "../shared/glass-material.wgsl";
@group(0) @binding(0) var<uniform> params: Params;
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/front.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/front.wgsl
index 5e5eb13c8..026f8104e 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/front.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/front.wgsl
@@ -1,65 +1,23 @@
import { oriented_normal, env_reflect_dir, env_reflection_from_dir, encode_normal } from "../shared/material-core.wgsl";
-import { Params, VertexInput, VertexOutput, WIRE_PASS_THRESHOLD, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-common.wgsl";
+import { Params, WIRE_PASS_THRESHOLD } from "../shared/scene-params.wgsl";
+import { VertexInput, VertexOutput, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-vertex.wgsl";
import { shade_glass } from "../shared/glass-material.wgsl";
import { ascii_imprint_coverage } from "../shared/ascii-imprint.wgsl";
+import { normalized_thickness, blurred_back_contribution } from "./back-refraction.wgsl";
+import { sample_paint, sample_ascii_voronoi } from "./paint-read.wgsl";
+import { ascii_vertical_opacity, ascii_coverage_with_opacity, ascii_final_composite } from "./ascii-composite.wgsl";
@group(0) @binding(0) var<uniform> params: Params;
@group(0) @binding(1) var studioCube: texture_2d_array<f32>;
@group(0) @binding(2) var studioSampler: sampler;
@group(0) @binding(3) var backMaterial: texture_2d<f32>;
@group(0) @binding(4) var backDepth: texture_2d<f32>;
+@group(0) @binding(5) var paintTex: texture_2d<f32>;
+@group(0) @binding(6) var asciiVoronoiValueTex: texture_2d<f32>;
+@group(0) @binding(7) var asciiVoronoiEdgeTex: texture_2d<f32>;
-const VOGEL_SAMPLE_COUNT = 16u;
-const GOLDEN_ANGLE = 2.399963229728653;
-const MAX_BACK_BLUR_RADIUS_UV = 0.01;
-const BACK_BLUR_SIGMA = 0.4;
-const BACK_MIN_TRANSMISSION = 0.38;
-const BACK_ABSORPTION_TINT = vec3f(0.9);
-const TAU = 6.28318530718;
const FRONT_GATE_START = 0.55;
const FRONT_GATE_FULL = 0.80;
-const IMPRINT_EMISSIVE = vec3f(2.5);
-const ASCII_OPACITY_BOTTOM_Y = 0.;
-const ASCII_OPACITY_TOP_Y = 0.3;
-const ASCII_OPACITY_BOTTOM_LIGHT = 0.3;
-const ASCII_OPACITY_BOTTOM_DARK = 0.1;
-const ASCII_OPACITY_TOP = 1.0;
-const ASCII_OPACITY_CURVE_POWER = 2.0;
-
-fn hash12(p: vec2f) -> f32 {
- let h = dot(p, vec2f(127.1, 311.7));
- return fract(sin(h) * 43758.5453123);
-}
-
-fn normalized_thickness(input: VertexOutput, pixel: vec2i, backSize: vec2i) -> f32 {
- // A 1x1 back-depth texture is the fallback used by renderers that have not produced a real
- // back depth map. Treat it as zero thickness so the blur remains disabled there.
- if (backSize.x <= 1 || backSize.y <= 1 || !all(pixel >= vec2i(0)) || !all(pixel < backSize)) {
- return 0.0;
- }
-
- let backCameraAxisDepth = textureLoad(backDepth, pixel, 0).r;
- let thickness = max(backCameraAxisDepth - input.cameraAxisDepth, 0.0);
- return clamp(thickness / max(params.thicknessScale, 0.000001), 0.0, 1.0);
-}
-
-fn vogel_gaussian_blur(uv: vec2f, blurRadius: f32, baseRotation: f32) -> vec3f {
- var color = vec3f(0.0);
- var totalWeight = 0.0;
-
- for (var i = 0u; i < VOGEL_SAMPLE_COUNT; i = i + 1u) {
- let fi = f32(i);
- let vogelRadius = sqrt((fi + 0.5) / f32(VOGEL_SAMPLE_COUNT));
- let theta = fi * GOLDEN_ANGLE + baseRotation;
- let sampleUv = uv + vec2f(cos(theta), sin(theta)) * vogelRadius * blurRadius;
- let sigma = max(BACK_BLUR_SIGMA, 0.0001);
- let weight = exp(-(vogelRadius * vogelRadius) / (2.0 * sigma * sigma));
- color += textureSampleLevel(backMaterial, studioSampler, sampleUv, 0.0).rgb * weight;
- totalWeight += weight;
- }
-
- return color / max(totalWeight, 0.0001);
-}
@vertex
fn vs_main(input: VertexInput) -> VertexOutput {
@@ -89,7 +47,7 @@ fn fs_main(input: VertexOutput) -> @location(0) vec4f {
case 4u: {
let backSize = vec2i(textureDimensions(backDepth));
let pixel = vec2i(input.clipPosition.xy);
- let normalizedThickness = normalized_thickness(input, pixel, backSize);
+ let normalizedThickness = normalized_thickness(backDepth, input.cameraAxisDepth, params.thicknessScale, pixel, backSize);
return vec4f(vec3f(normalizedThickness), 1.0);
}
case 1u: {
@@ -107,53 +65,48 @@ fn fs_main(input: VertexOutput) -> @location(0) vec4f {
let pixel = vec2i(input.clipPosition.xy);
if (all(pixel >= vec2i(0)) && all(pixel < backSize)) {
let uv = (vec2f(pixel) + vec2f(0.5)) / vec2f(backSize);
- let normalizedThickness = normalized_thickness(input, pixel, vec2i(textureDimensions(backDepth)));
- let blurRadius = normalizedThickness * MAX_BACK_BLUR_RADIUS_UV;
- let baseVogelRotation = hash12(uv) * TAU;
- let blurredBackContribution = vogel_gaussian_blur(uv, blurRadius, baseVogelRotation);
- let thicknessFade = pow(clamp(normalizedThickness, 0.0, 1.0), 0.5);
- let absorptionFade = thicknessFade * params.glassAbsorption;
- let transmission = mix(1.0, BACK_MIN_TRANSMISSION, absorptionFade);
- let absorptionTint = mix(vec3f(1.0), BACK_ABSORPTION_TINT, absorptionFade);
- let backContribution = blurredBackContribution * transmission * absorptionTint;
+ let backContribution = blurred_back_contribution(
+ backMaterial,
+ backDepth,
+ studioSampler,
+ uv,
+ pixel,
+ input.cameraAxisDepth,
+ params.thicknessScale,
+ params.glassAbsorption,
+ );
// The main scene uses additive alpha blending (`src-alpha + one`). The offscreen back
// texture already contains the blended back-side contribution, so divide by the front
// alpha before returning to preserve the previous two-draw visual result.
glass = vec4f(glass.rgb + backContribution / max(glass.a, 0.001), glass.a);
}
- if (params.ascii0.x <= 0.0) {
- return glass;
- }
-
+ // Order: read paint -> build glyph coverage -> apply theme/fade/luminance -> composite.
+ // Paint never reveals the noisy base ASCII chain; ascii_imprint_coverage gates that by
+ // imprintProgress and adds a separate clean hover-station coverage for paint.
+ let paintValue = clamp(sample_paint(paintTex, input.modelPos.xy, params.ascii0.y, params.ascii1.zw), 0.0, 1.0);
let imprintProgress = clamp(params.ascii0.x, 0.0, 1.0);
let glassVisibility = 1.0 - imprintProgress;
let frontMask = smoothstep(FRONT_GATE_START, FRONT_GATE_FULL, ngeo.z);
- let verticalT = clamp(
- (input.modelPos.y - ASCII_OPACITY_BOTTOM_Y) / (ASCII_OPACITY_TOP_Y - ASCII_OPACITY_BOTTOM_Y),
- 0.0,
- 1.0,
- );
- let verticalCurve = pow(verticalT, ASCII_OPACITY_CURVE_POWER);
let themeT = clamp(params.glassAbsorption, 0.0, 1.0);
- let asciiOpacityBottom = mix(ASCII_OPACITY_BOTTOM_LIGHT, ASCII_OPACITY_BOTTOM_DARK, themeT);
- let asciiOpacity = mix(asciiOpacityBottom, ASCII_OPACITY_TOP, verticalCurve);
- let coverage = ascii_imprint_coverage(
+ let asciiOpacity = ascii_vertical_opacity(input.modelPos.y, themeT);
+ let glyphCoverage = ascii_imprint_coverage(
input.modelPos.xy,
params.ascii0.y,
params.ascii0.z,
params.ascii0.w,
params.ascii1.xy,
imprintProgress,
- ) * frontMask * asciiOpacity;
- // Fade the normal front-glass/env/back-blur contribution out as ASCII takes over.
- // ASCII coverage itself is not faded by this visibility term, so at p=1 only the
- // emissive imprint remains while non-ASCII glass becomes transparent.
- let fadedGlassAlpha = glass.a * glassVisibility;
- let fadedGlassContribution = glass.rgb * fadedGlassAlpha;
- let imprintColor = IMPRINT_EMISSIVE * clamp(params.glassAbsorption, 0.0, 1.0);
- let aNew = mix(fadedGlassAlpha, 1.0, coverage);
- let desired = mix(fadedGlassContribution, imprintColor, coverage);
- return vec4f(desired / max(aNew, 0.001), aNew);
+ paintValue,
+ sample_ascii_voronoi(asciiVoronoiValueTex, asciiVoronoiEdgeTex, input.modelPos.xy, params.ascii0.y, params.ascii0.w, params.ascii1.zw),
+ ) * frontMask;
+ // Paint bypasses most of the vertical fade, boosts light-theme density by lowering
+ // coverage gamma, and boosts dark-theme HDR emissive below. `coverage` is still
+ // premultiplied-safe alpha coverage; the glass color itself is not paint-faded.
+ let coverage = ascii_coverage_with_opacity(glyphCoverage, asciiOpacity, paintValue, themeT);
+ if (params.ascii0.x <= 0.0 && paintValue <= 0.0) {
+ return glass;
+ }
+ return ascii_final_composite(glass, glassVisibility, coverage, themeT, paintValue);
}
}
}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/paint-read.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/paint-read.wgsl
new file mode 100644
index 000000000..0a7cc5508
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/paint-read.wgsl
@@ -0,0 +1,49 @@
+import { ascii_voronoi_noise_for_cell } from "../shared/ascii-imprint.wgsl";
+
+// Paint and animated Voronoi texture readers for the front glass entry shader.
+// INVARIANT: r32float textures are sampled with textureLoad only; no filtering.
+// Texture resources are passed as parameters; this module declares no bindings.
+
+export fn model_cell_index(modelPosXY: vec2f, gridScale: f32, originCellValue: vec2f) -> vec2i {
+ let originCell = vec2i(i32(originCellValue.x), i32(originCellValue.y));
+ return vec2i(floor(modelPosXY * gridScale)) - originCell;
+}
+
+export fn sample_paint(
+ paintTexture: texture_2d<f32>,
+ modelPosXY: vec2f,
+ gridScale: f32,
+ originCellValue: vec2f,
+) -> f32 {
+ // Front pass reads the paint buffer by ASCII cell with textureLoad only.
+ // Renderer stores the negative-bound origin in ascii1.zw so writer/reader use
+ // identical model-space -> cell mapping, including cells left/below model zero.
+ let dims = vec2i(textureDimensions(paintTexture));
+ let cell = model_cell_index(modelPosXY, gridScale, originCellValue);
+ if (any(cell < vec2i(0)) || any(cell >= dims)) {
+ return 0.0;
+ }
+ return textureLoad(paintTexture, cell, 0).r;
+}
+
+export fn sample_ascii_voronoi(
+ asciiVoronoiValueTexture: texture_2d<f32>,
+ asciiVoronoiEdgeTexture: texture_2d<f32>,
+ modelPosXY: vec2f,
+ gridScale: f32,
+ time: f32,
+ originCellValue: vec2f,
+) -> vec2f {
+ // Voronoi noise is animated in z, so the renderer refreshes these two r32 textures once
+ // per frame at the ASCII-cell lattice resolution. The coverage code still computes
+ // derivatives for glyph edges procedurally; only the per-cell random value/edge mask moves.
+ let dims = vec2i(textureDimensions(asciiVoronoiValueTexture));
+ let cell = model_cell_index(modelPosXY, gridScale, originCellValue);
+ if (any(cell < vec2i(0)) || any(cell >= dims)) {
+ return ascii_voronoi_noise_for_cell(modelPosXY, gridScale, time);
+ }
+ return vec2f(
+ textureLoad(asciiVoronoiValueTexture, cell, 0).r,
+ textureLoad(asciiVoronoiEdgeTexture, cell, 0).r,
+ );
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-debug.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-debug.wgsl
new file mode 100644
index 000000000..3a39804b1
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-debug.wgsl
@@ -0,0 +1,26 @@
+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";
+
+struct VertexOutput {
+ @builtin(position) position: vec4f,
+ @location(0) uv: vec2f,
+};
+
+@group(0) @binding(0) var paintTex: texture_2d<f32>;
+
+@vertex
+fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
+ var output: VertexOutput;
+ output.position = fullscreen_clip_position(vertexIndex);
+ output.uv = fullscreen_uv(vertexIndex);
+ output.uv.y = 1. - output.uv.y;
+ return output;
+}
+
+@fragment
+fn fs_main(input: VertexOutput) -> @location(0) vec4f {
+ let dims = vec2i(textureDimensions(paintTex));
+ let uv = clamp(input.uv, vec2f(0.0), vec2f(0.999999));
+ let coord = clamp(vec2i(floor(uv * vec2f(dims))), vec2i(0), dims - vec2i(1));
+ let paint = textureLoad(paintTex, coord, 0).r;
+ return vec4f(vec3f(clamp(paint, 0.0, 1.0)), 1.0);
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-update.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-update.wgsl
new file mode 100644
index 000000000..dabb35345
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-update.wgsl
@@ -0,0 +1,106 @@
+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";
+
+struct VertexOutput {
+ @builtin(position) position: vec4f,
+ @location(0) uv: vec2f,
+};
+
+struct PaintParams {
+ brushCell: vec2f,
+ brushPreviousCell: vec2f,
+ brushRadius: f32,
+ brushStrength: f32,
+ decayRate: f32,
+ diffusionRate: f32,
+ diffusionJitter: f32,
+ dt: f32,
+ brushActive: f32,
+ _pad: f32,
+};
+
+@group(0) @binding(0) var readTex: texture_2d<f32>;
+@group(0) @binding(1) var<uniform> params: PaintParams;
+@group(0) @binding(2) var staticNoiseTex: texture_2d<f32>;
+
+const TAU = 6.28318530718;
+const BRUSH_EDGE_NOISE = 1.5;
+const PAINT_VALUE_MAX = 2.0; // Stored paint max; values >1 give a hidden decay buffer while display clamps at 1.0.
+
+@vertex
+fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
+ var output: VertexOutput;
+ output.position = fullscreen_clip_position(vertexIndex);
+ output.uv = fullscreen_uv(vertexIndex);
+ return output;
+}
+
+fn load_cell(coord: vec2i, dims: vec2i) -> f32 {
+ return textureLoad(readTex, clamp(coord, vec2i(0), dims - vec2i(1)), 0).r;
+}
+
+fn jittered_offset(axis: vec2f, angle: f32, scale: f32) -> vec2i {
+ let c = cos(angle);
+ let s = sin(angle);
+ let rotated = vec2f(c * axis.x - s * axis.y, s * axis.x + c * axis.y) * scale;
+ var offset = vec2i(round(rotated));
+ if (all(offset == vec2i(0))) {
+ offset = vec2i(select(-1, 1, axis.x + axis.y >= 0.0), 0);
+ }
+ return offset;
+}
+
+fn segment_distance(p: vec2f, a: vec2f, b: vec2f) -> f32 {
+ let ab = b - a;
+ let denom = max(dot(ab, ab), 0.000001);
+ let t = clamp(dot(p - a, ab) / denom, 0.0, 1.0);
+ return distance(p, a + ab * t);
+}
+
+@fragment
+fn fs_main(input: VertexOutput) -> @location(0) f32 {
+ let dims = vec2i(textureDimensions(readTex));
+ let q = clamp(vec2i(input.position.xy), vec2i(0), dims - vec2i(1));
+
+ let c = load_cell(q, dims);
+ // Static per-cell hash rotates/scales the four taps, then snaps them to texels.
+ // r32float is unfilterable here, so this stays textureLoad-only and preserves the
+ // convex 5-tap update while making diffusion grow organically instead of as a disc.
+ // Channel usage: r=angle hash, g=diffusion scale hash, b=brush-edge hash, a=decay multiplier.
+ let staticNoise = textureLoad(staticNoiseTex, q, 0);
+ let jitter = clamp(params.diffusionJitter, 0.0, 4.0);
+ let angle = staticNoise.r * TAU;
+ let scale = mix(1.0, 1.0 + jitter * 1., staticNoise.g);
+ let o0 = jittered_offset(vec2f(1.0, 0.0), angle, scale);
+ let o1 = jittered_offset(vec2f(-1.0, 0.0), angle, scale);
+ let o2 = jittered_offset(vec2f(0.0, 1.0), angle, scale);
+ let o3 = jittered_offset(vec2f(0.0, -1.0), angle, scale);
+ let n0 = load_cell(q + o0, dims);
+ let n1 = load_cell(q + o1, dims);
+ let n2 = load_cell(q + o2, dims);
+ let n3 = load_cell(q + o3, dims);
+ // `dt` is seconds from rAF/renderer code, clamped to avoid giant hidden-tab steps.
+ // TS exposes decay as "paint removed per frame at 120fps", then uploads
+ // decayRate = decayPerFrame120 * 120, so the shader applies the equivalent
+ // frame-rate-independent subtraction: decayThisFrame = decayRate * dt.
+ let dt = min(max(params.dt, 0.0), 0.1);
+ let diffusionWeight = min(max(params.diffusionRate, 0.0) * dt, 0.24);
+ let diffused = (1.0 - 4.0 * diffusionWeight) * c + diffusionWeight * (n0 + n1 + n2 + n3);
+
+ let cellCenter = vec2f(q) + vec2f(0.5);
+ let radius = max(params.brushRadius, 0.0001);
+ let segmentDistance = segment_distance(cellCenter, params.brushPreviousCell, params.brushCell);
+ // Per-cell hash perturbs the capsule edge to keep brush stamps organic. The noise is static
+ // per cell (free) so strokes stay stable frame-to-frame but lose the perfect capsule.
+ let brushNoise = (staticNoise.b - 0.5) * BRUSH_EDGE_NOISE;
+ let noisyDistance = clamp(segmentDistance + brushNoise, 0.0, radius + BRUSH_EDGE_NOISE);
+ let brushFalloff = 1.0 - smoothstep(0.0, radius, noisyDistance);
+ let brush = step(0.5, params.brushActive) * max(params.brushStrength, 0.0) * dt * brushFalloff;
+
+ let decayMultiplier = mix(1.0, 2.0, staticNoise.a);
+ let decayRate = max(params.decayRate, 0.0) * decayMultiplier;
+ var outValue = clamp(diffused - decayRate * 0.2 * dt + brush, 0.0, PAINT_VALUE_MAX);
+ if (outValue < 0.001) {
+ outValue = 0.0;
+ }
+ return outValue;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/voronoi-noise-update.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/voronoi-noise-update.wgsl
new file mode 100644
index 000000000..ab1e4bb6a
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/voronoi-noise-update.wgsl
@@ -0,0 +1,52 @@
+import { voronoi_cell_value_and_edge_3d } from "../shared/voronoi.wgsl";
+
+struct VertexOutput {
+ @builtin(position) position: vec4f,
+};
+
+struct VoronoiNoiseParams {
+ gridScale: f32,
+ time: f32,
+ originCell: vec2f,
+};
+
+struct VoronoiNoiseOutput {
+ @location(0) value: f32,
+ @location(1) edge: f32,
+};
+
+@group(0) @binding(0) var<uniform> params: VoronoiNoiseParams;
+
+const IMPRINT_VORONOI_FREQUENCY = 4.8;
+const ASCII_VORONOI_Z_SPEED = 0.35;
+
+@vertex
+fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
+ var positions = array<vec2f, 3>(
+ vec2f(-1.0, -3.0),
+ vec2f(-1.0, 1.0),
+ vec2f(3.0, 1.0),
+ );
+
+ var output: VertexOutput;
+ output.position = vec4f(positions[vertexIndex], 0.0, 1.0);
+ return output;
+}
+
+@fragment
+fn fs_main(input: VertexOutput) -> VoronoiNoiseOutput {
+ let localCell = vec2i(input.position.xy);
+ let globalCell = vec2f(localCell) + params.originCell;
+ let safeGridScale = max(params.gridScale, 0.001);
+ let cellCenter = (globalCell + vec2f(0.5)) / safeGridScale;
+ let samplePosition = vec3f(
+ cellCenter * IMPRINT_VORONOI_FREQUENCY,
+ params.time * ASCII_VORONOI_Z_SPEED,
+ );
+ let voronoi = voronoi_cell_value_and_edge_3d(samplePosition);
+
+ var output: VoronoiNoiseOutput;
+ output.value = voronoi.x;
+ output.edge = voronoi.y;
+ return output;
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/postprocess/light-composite.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/postprocess/light-composite.wgsl
index 89b84ac93..f05b8da83 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/postprocess/light-composite.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/postprocess/light-composite.wgsl
@@ -1,3 +1,6 @@
+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";
+import { aces_tonemap, linear_to_display } from "../shared/tonemap.wgsl";
+
// Light-mode composite pass. Tonemaps scene color and writes premultiplied alpha for a transparent canvas.
struct VertexOutput {
@@ -8,36 +11,15 @@ struct VertexOutput {
@group(0) @binding(0) var sceneTexture: texture_2d<f32>;
@group(0) @binding(1) var texSampler: sampler;
-const DISPLAY_GAMMA = 2.2;
@vertex
fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
- var positions = array<vec2f, 3>(
- vec2f(-1.0, -3.0),
- vec2f(-1.0, 1.0),
- vec2f(3.0, 1.0),
- );
-
var output: VertexOutput;
- let position = positions[vertexIndex];
- output.position = vec4f(position, 0.0, 1.0);
- output.uv = position * vec2f(0.5, -0.5) + vec2f(0.5, 0.5);
+ output.position = fullscreen_clip_position(vertexIndex);
+ output.uv = fullscreen_uv(vertexIndex);
return output;
}
-fn aces_tonemap(color: vec3f) -> vec3f {
- let a = 2.51;
- let b = 0.03;
- let c = 2.43;
- let d = 0.59;
- let e = 0.14;
- return clamp((color * (a * color + vec3f(b))) / (color * (c * color + vec3f(d)) + vec3f(e)), vec3f(0.0), vec3f(1.0));
-}
-
-fn linear_to_display(color: vec3f) -> vec3f {
- return pow(max(color, vec3f(0.0)), vec3f(1.0 / DISPLAY_GAMMA));
-}
-
@fragment
fn fs_main(input: VertexOutput) -> @location(0) vec4f {
let scene = textureSample(sceneTexture, texSampler, input.uv);
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-glyphs.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-glyphs.wgsl
new file mode 100644
index 000000000..7f7a766b2
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-glyphs.wgsl
@@ -0,0 +1,66 @@
+import { sd_box, sd_equilateral_triangle, sd_rotated_box } from "./sdf.wgsl";
+
+// Shared ASCII glyph selection and hover-station distances.
+// INVARIANT: true SDF-value interpolation in hover_shape_distance is preserved.
+// The caller owns fwidth/coverage so derivatives stay in uniform control flow.
+
+export const ASCII_BASE_DOT_RADIUS = 0.075;
+export const ASCII_EDGE_SQUARE_HALF_SIZE = 0.22;
+export const HOVER_ENTRY_START = 0.1;
+export const HOVER_ENTRY_FULL = 0.5;
+
+export fn shape_distance(p: vec2f, value: f32) -> f32 {
+ if (value < 0.002) {
+ return 1.0;
+ }
+ // Voronoi luminance now selects the spinner glyph ramp (| / \ – — ▲). Keep glyph dimensions
+ // fixed so size is controlled by grid geometry and glyphScale, not value. After the tiny
+ // empty band the remaining range is divided into six equal hard-switch stations.
+ let normalizedValue = clamp((value - 0.002) / (1.0 - 0.002), 0.0, 1.0);
+ let station = clamp(i32(floor(normalizedValue * 6.0)), 0, 5);
+ return spinner_station_distance(p, station);
+}
+
+fn spinner_station_distance(p: vec2f, station: i32) -> f32 {
+ if (station <= 0) {
+ return sd_rotated_box(p, vec2f(0.28, 0.05), 1.57079632679);
+ }
+ if (station == 1) {
+ return sd_rotated_box(p, vec2f(0.28, 0.05), 0.78539816339);
+ }
+ if (station == 2) {
+ return sd_rotated_box(p, vec2f(0.28, 0.05), -0.78539816339);
+ }
+ if (station == 3) {
+ return sd_box(p, vec2f(0.20, 0.045));
+ }
+ if (station == 4) {
+ return sd_box(p, vec2f(0.31, 0.055));
+ }
+ let scale = 0.66;
+ return sd_equilateral_triangle(p / scale) * scale;
+}
+
+fn imprint_station_distance(p: vec2f, station: i32) -> f32 {
+ if (station <= 0) {
+ return length(p) - ASCII_BASE_DOT_RADIUS;
+ }
+ if (station == 1) {
+ return length(p) - 0.145;
+ }
+ if (station == 2) {
+ return sd_box(p, vec2f(0.27, 0.055));
+ }
+ if (station == 3) {
+ return length(p) - 0.235;
+ }
+ return sd_box(p, vec2f(0.255, 0.255));
+}
+
+export fn hover_shape_distance(p: vec2f, hover: f32) -> f32 {
+ // Paint drives only this clean station ramp: dot -> circle -> dash -> circle -> square.
+ // Hard switch: each station covers an equal-length range; no blending between glyphs.
+ let t = clamp((hover - HOVER_ENTRY_START) / (1.0 - HOVER_ENTRY_START), 0.0, 1.0);
+ let station = clamp(i32(floor(t * 5.0)), 0, 4);
+ return imprint_station_distance(p, station);
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-imprint.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-imprint.wgsl
index f9f77b02a..54f6961dc 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-imprint.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-imprint.wgsl
@@ -1,158 +1,75 @@
-export fn sd_box(p: vec2f, halfSize: vec2f) -> f32 {
- let q = abs(p) - halfSize;
- return length(max(q, vec2f(0.0))) + min(max(q.x, q.y), 0.0);
-}
-
-export fn sd_equilateral_triangle(p0: vec2f) -> f32 {
- let k = sqrt(3.0);
- var p = p0;
- p.x = abs(p.x) - 0.42;
- p.y = p.y + 0.24;
- if (p.x + k * p.y > 0.0) {
- p = vec2f(p.x - k * p.y, -k * p.x - p.y) / 2.0;
- }
- p.x = p.x - clamp(p.x, -0.84, 0.0);
- return -length(p) * sign(p.y);
-}
-
-export fn hash_u32(value: u32) -> u32 {
- var x = value;
- x ^= x >> 16u;
- x *= 0x7feb352du;
- x ^= x >> 15u;
- x *= 0x846ca68bu;
- x ^= x >> 16u;
- return x;
-}
-
-export fn hash3(cell: vec3i) -> f32 {
- let ux = bitcast<u32>(cell.x);
- let uy = bitcast<u32>(cell.y);
- let uz = bitcast<u32>(cell.z);
- let mixed = (ux * 0x8da6b343u) ^ (uy * 0xd8163841u) ^ (uz * 0xcb1ab31fu);
- return f32(hash_u32(mixed) & 0x00ffffffu) / 16777215.0;
-}
+import { sd_box } from "./sdf.wgsl";
+import { hash3, voronoi_cell_value_and_edge_3d } from "./voronoi.wgsl";
+import { ASCII_BASE_DOT_RADIUS, ASCII_EDGE_SQUARE_HALF_SIZE, HOVER_ENTRY_START, HOVER_ENTRY_FULL, shape_distance, hover_shape_distance } from "./ascii-glyphs.wgsl";
-fn hash3_feature_point(cell: vec3i) -> vec3f {
- return vec3f(
- hash3(cell + vec3i(17, 59, 113)),
- hash3(cell + vec3i(101, 191, 53)),
- hash3(cell + vec3i(47, 223, 149)),
- );
-}
-
-const VORONOI_EDGE_WIDTH = 0.08;
-const VORONOI_EDGE_SOFTNESS = 0.04;
-
-export fn voronoi_cell_value_and_edge_3d(p: vec3f) -> vec2f {
- let baseCell = vec3i(floor(p));
- let localPosition = fract(p);
- var nearestDistanceSquared = 1000.0;
- var secondNearestDistanceSquared = 1000.0;
- var winningCell = baseCell;
-
- for (var z = -1; z <= 1; z = z + 1) {
- for (var y = -1; y <= 1; y = y + 1) {
- for (var x = -1; x <= 1; x = x + 1) {
- let neighborOffset = vec3i(x, y, z);
- let neighborCell = baseCell + neighborOffset;
- let featurePoint = vec3f(neighborOffset) + hash3_feature_point(neighborCell);
- let delta = featurePoint - localPosition;
- let distanceSquared = dot(delta, delta);
- if (distanceSquared < nearestDistanceSquared) {
- secondNearestDistanceSquared = nearestDistanceSquared;
- nearestDistanceSquared = distanceSquared;
- winningCell = neighborCell;
- } else if (distanceSquared < secondNearestDistanceSquared) {
- secondNearestDistanceSquared = distanceSquared;
- }
- }
- }
- }
-
- // Hard-cell Voronoi: the nearest feature cell gets one random value for glyph type.
- // The F2-F1 gap controls a pure-white edge overlay, while interiors keep the full
- // random-selected glyph instead of being masked away.
- let cellValue = hash3(winningCell + vec3i(211, 37, 173));
- let edgeGap = sqrt(secondNearestDistanceSquared) - sqrt(nearestDistanceSquared);
- let edgeMask = 1.0 - smoothstep(VORONOI_EDGE_WIDTH, VORONOI_EDGE_WIDTH + VORONOI_EDGE_SOFTNESS, edgeGap);
- return vec2f(cellValue, edgeMask);
-}
+// ASCII imprint combiner for front-glass coverage.
+// INVARIANT: fwidth calls stay in this function's uniform control flow; do not move them behind non-uniform branches.
+// Entry shaders provide textures/bindings and material masks; this module declares none.
-const ASCII_BASE_DOT_RADIUS = 0.075;
-const ASCII_EDGE_SQUARE_HALF_SIZE = 0.22;
-
-export fn shape_distance(p: vec2f, value: f32) -> f32 {
- if (value < 0.002) {
- return 1.0;
- }
- // Luminance/noise selects the glyph only. Keep each glyph's dimensions fixed so
- // glyph size is controlled by grid geometry and the glyphScale uniform, not value.
- if (value < 0.18) {
- return length(p) - ASCII_BASE_DOT_RADIUS;
- }
- if (value < 0.36) {
- return length(p) - 0.145;
- }
- if (value < 0.58) {
- return sd_box(p, vec2f(0.27, 0.055));
- }
- if (value < 0.78) {
- return length(p) - 0.235;
- }
- if (value < 0.93) {
- let scale = 0.66;
- return sd_equilateral_triangle(p / scale) * scale;
- }
- return sd_box(p, vec2f(0.255, 0.255));
-}
-
-const IMPRINT_VORONOI_FREQUENCY = 2.4;
+const IMPRINT_VORONOI_FREQUENCY = 4.8;
const ASCII_VORONOI_Z_SPEED = 0.35;
const REVEAL_STAGGER_WINDOW = 0.25;
+export const HOVER_OVERLAY_SCALE = 0.5; // scales hover spinner-glyph opacity only
+
+export fn ascii_voronoi_noise_for_cell(modelPosXY: vec2f, gridScale: f32, time: f32) -> vec2f {
+ let safeGridScale = max(gridScale, 0.001);
+ let gridPosition = modelPosXY * safeGridScale;
+ let cellCoord = floor(gridPosition);
+ let cellCenter = (cellCoord + vec2f(0.5)) / safeGridScale;
+ let samplePosition = vec3f(cellCenter * IMPRINT_VORONOI_FREQUENCY, time * ASCII_VORONOI_Z_SPEED);
+ return voronoi_cell_value_and_edge_3d(samplePosition);
+}
// Returns glyph coverage 0..1 for a model-space X/Y position. The caller applies the
// geometric front-face mask so this module stays independent of material normals.
-export fn ascii_imprint_coverage(modelPosXY: vec2f, gridScale: f32, glyphScale: f32, time: f32, mouse: vec2f, prog: f32) -> f32 {
+export fn ascii_imprint_coverage(modelPosXY: vec2f, gridScale: f32, glyphScale: f32, time: f32, mouse: vec2f, prog: f32, hover: f32, voronoi: vec2f) -> f32 {
let safeProgress = clamp(prog, 0.0, 1.0);
- if (safeProgress <= 0.0) {
- return 0.0;
- }
+ let safeHover = clamp(hover, 0.0, 1.0);
let safeGridScale = max(gridScale, 0.001);
let safeGlyphScale = max(glyphScale, 0.1);
let gridPosition = modelPosXY * safeGridScale;
let cellCoord = floor(gridPosition);
- let cellCenter = (cellCoord + vec2f(0.5)) / safeGridScale;
let glyphUv = fract(gridPosition);
let p = (glyphUv - vec2f(0.5)) * 2.0;
- let samplePosition = vec3f(cellCenter * IMPRINT_VORONOI_FREQUENCY, time * ASCII_VORONOI_Z_SPEED);
- let voronoi = voronoi_cell_value_and_edge_3d(samplePosition);
let cellValue = voronoi.x;
let edgeMask = voronoi.y;
let scaledP = p / safeGlyphScale;
let baseDotDistance = (length(scaledP) - ASCII_BASE_DOT_RADIUS) * safeGlyphScale;
let selectedGlyphDistance = shape_distance(scaledP, cellValue) * safeGlyphScale;
+ let hoverGlyphDistance = hover_shape_distance(scaledP, safeHover) * safeGlyphScale;
let baseDotAa = max(fwidth(baseDotDistance), 0.01);
let selectedGlyphAa = max(fwidth(selectedGlyphDistance), 0.01);
+ let hoverGlyphAa = max(fwidth(hoverGlyphDistance), 0.01);
let baseDotCoverage = 1.0 - smoothstep(0.0, baseDotAa, baseDotDistance);
let selectedGlyphCoverage = 1.0 - smoothstep(0.0, selectedGlyphAa, selectedGlyphDistance);
- let interiorGlyph = max(selectedGlyphCoverage, baseDotCoverage);
+ let hoverGlyphCoverage = 1.0 - smoothstep(0.0, hoverGlyphAa, hoverGlyphDistance);
+ let hoverEntry = smoothstep(HOVER_ENTRY_START, HOVER_ENTRY_FULL, safeHover);
+ let selectedCoverage = selectedGlyphCoverage;
+ let interiorGlyph = max(selectedCoverage, baseDotCoverage);
let edgeGlyphDistance = sd_box(scaledP, vec2f(ASCII_EDGE_SQUARE_HALF_SIZE)) * safeGlyphScale;
let edgeGlyphAa = max(fwidth(edgeGlyphDistance), 0.01);
let edgeGlyphCoverage = (1.0 - smoothstep(0.0, edgeGlyphAa, edgeGlyphDistance)) * edgeMask;
- // Draw the full random-selected glyph throughout each Voronoi region; the minimum dot only
- // prevents empty branches. F2-F1 edge proximity boosts a small SDF-shaped square at
- // boundaries instead of bypassing the SDF and filling the whole ASCII quad.
- let glyph = max(interiorGlyph, edgeGlyphCoverage);
+ // The noisy ASCII chain is controlled only by imprint progress: random selected glyph,
+ // minimum dot, Voronoi edge square, then per-cell stagger reveal.
+ let imprintGlyph = max(interiorGlyph, edgeGlyphCoverage);
let cellRand = hash3(vec3i(vec2i(cellCoord), 0));
// Spread each cell's 0.25-wide reveal window across the full transition instead of scaling
// progress by the stagger range. This keeps p=0.5 as a true mid-state while preserving exact
// endpoints: p=0 reveals no cells, p=1 reveals every cell fully.
let revealStart = cellRand * (1.0 - REVEAL_STAGGER_WINDOW);
- let reveal = smoothstep(revealStart, revealStart + REVEAL_STAGGER_WINDOW, safeProgress);
- return glyph * reveal;
+ let staggerReveal = smoothstep(revealStart, revealStart + REVEAL_STAGGER_WINDOW, safeProgress);
+ let imprintCoverage = imprintGlyph * staggerReveal;
+
+ // Paint reveal is independent from the noise chain. On glass (progress=0) this contributes
+ // only the clean station ramp; in ASCII mode it cleanly overrides the selected glyph while
+ // the base dots/edge squares remain part of the imprint chain.
+ let hoverCoverage = hoverGlyphCoverage * hoverEntry * HOVER_OVERLAY_SCALE;
+ // Hard per-cell switchover: once hover passes the entry threshold, the entire cell shows
+ // only the spinner glyph; otherwise only the imprint glyph contributes.
+ let hoverGate = step(HOVER_ENTRY_START, safeHover);
+ return mix(imprintCoverage, hoverCoverage, hoverGate);
}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-face.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-face.wgsl
new file mode 100644
index 000000000..d80b7b57a
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-face.wgsl
@@ -0,0 +1,62 @@
+// Shared cubemap face mapping helpers for eve logo environment shaders.
+// INVARIANT: face order is +X, -X, +Y, -Y, +Z, -Z for all bake/sample paths.
+// INVARIANT: lookup UVs keep a small inset and the established Y conventions.
+
+const CUBEMAP_UV_INSET = 0.001;
+
+export fn cube_dir(face: f32, uv: vec2f) -> vec3f {
+ let p = uv * 2.0 - vec2f(1.0);
+ // WebGPU cube face order: +X, -X, +Y, -Y, +Z, -Z.
+ if (face < 0.5) {
+ return normalize(vec3f(1.0, -p.y, -p.x));
+ }
+ if (face < 1.5) {
+ return normalize(vec3f(-1.0, -p.y, p.x));
+ }
+ if (face < 2.5) {
+ return normalize(vec3f(p.x, 1.0, p.y));
+ }
+ if (face < 3.5) {
+ return normalize(vec3f(p.x, -1.0, -p.y));
+ }
+ if (face < 4.5) {
+ return normalize(vec3f(p.x, -p.y, 1.0));
+ }
+ return normalize(vec3f(-p.x, -p.y, -1.0));
+}
+
+export fn cube_lookup_uv_face(direction: vec3f) -> vec3f {
+ let dir = normalize(direction);
+ let ad = abs(dir);
+ var face = 0.0;
+ var p = vec2f(0.0);
+
+ if (ad.x >= ad.y && ad.x >= ad.z) {
+ if (dir.x > 0.0) {
+ face = 0.0;
+ p = vec2f(-dir.z / ad.x, -dir.y / ad.x);
+ } else {
+ face = 1.0;
+ p = vec2f(dir.z / ad.x, -dir.y / ad.x);
+ }
+ } else if (ad.y >= ad.x && ad.y >= ad.z) {
+ if (dir.y > 0.0) {
+ face = 2.0;
+ p = vec2f(dir.x / ad.y, dir.z / ad.y);
+ } else {
+ face = 3.0;
+ p = vec2f(dir.x / ad.y, -dir.z / ad.y);
+ }
+ } else {
+ if (dir.z > 0.0) {
+ face = 4.0;
+ p = vec2f(dir.x / ad.z, -dir.y / ad.z);
+ } else {
+ face = 5.0;
+ p = vec2f(-dir.x / ad.z, -dir.y / ad.z);
+ }
+ }
+
+ let uv = clamp(p * 0.5 + vec2f(0.5), vec2f(CUBEMAP_UV_INSET), vec2f(1.0 - CUBEMAP_UV_INSET));
+ return vec3f(uv, face);
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-sample.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-sample.wgsl
deleted file mode 100644
index 1984f667b..000000000
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-sample.wgsl
+++ /dev/null
@@ -1,113 +0,0 @@
-// Shared cubemap utilities for eve-5 shaders.
-// Face order is the repo convention used throughout eve-5: +X, -X, +Y, -Y, +Z, -Z.
-
-const CUBEMAP_UV_INSET = 0.001;
-
-export fn cube_dir(face: f32, uv: vec2f) -> vec3f {
- let p = uv * 2.0 - vec2f(1.0);
- if (face < 0.5) {
- return normalize(vec3f(1.0, -p.y, -p.x));
- }
- if (face < 1.5) {
- return normalize(vec3f(-1.0, -p.y, p.x));
- }
- if (face < 2.5) {
- return normalize(vec3f(p.x, 1.0, p.y));
- }
- if (face < 3.5) {
- return normalize(vec3f(p.x, -1.0, -p.y));
- }
- if (face < 4.5) {
- return normalize(vec3f(p.x, -p.y, 1.0));
- }
- return normalize(vec3f(-p.x, -p.y, -1.0));
-}
-
-export fn cube_lookup_uv_face(direction: vec3f) -> vec3f {
- let dir = normalize(direction);
- let ad = abs(dir);
- var face = 0.0;
- var p = vec2f(0.0);
-
- if (ad.x >= ad.y && ad.x >= ad.z) {
- if (dir.x > 0.0) {
- face = 0.0;
- p = vec2f(-dir.z / ad.x, -dir.y / ad.x);
- } else {
- face = 1.0;
- p = vec2f(dir.z / ad.x, -dir.y / ad.x);
- }
- } else if (ad.y >= ad.x && ad.y >= ad.z) {
- if (dir.y > 0.0) {
- face = 2.0;
- p = vec2f(dir.x / ad.y, dir.z / ad.y);
- } else {
- face = 3.0;
- p = vec2f(dir.x / ad.y, -dir.z / ad.y);
- }
- } else {
- if (dir.z > 0.0) {
- face = 4.0;
- p = vec2f(dir.x / ad.z, -dir.y / ad.z);
- } else {
- face = 5.0;
- p = vec2f(-dir.x / ad.z, -dir.y / ad.z);
- }
- }
-
- let uv = clamp(p * 0.5 + vec2f(0.5), vec2f(CUBEMAP_UV_INSET), vec2f(1.0 - CUBEMAP_UV_INSET));
- return vec3f(uv, face);
-}
-
-export fn rotate_y(direction: vec3f, yaw: f32) -> vec3f {
- let s = sin(yaw);
- let c = cos(yaw);
- return normalize(vec3f(direction.x * c - direction.z * s, direction.y, direction.x * s + direction.z * c));
-}
-
-export fn rotate_x(direction: vec3f, pitch: f32) -> vec3f {
- let s = sin(pitch);
- let c = cos(pitch);
- return normalize(vec3f(direction.x, direction.y * c - direction.z * s, direction.y * s + direction.z * c));
-}
-
-export fn rotate_env(direction: vec3f, yaw: f32, pitch: f32) -> vec3f {
- return rotate_x(rotate_y(direction, yaw), pitch);
-}
-
-export fn sample_cubemap_array(envCube: texture_2d_array<f32>, envSampler: sampler, direction: vec3f) -> vec3f {
- let lookup = cube_lookup_uv_face(direction);
- return textureSample(envCube, envSampler, lookup.xy, i32(lookup.z)).rgb;
-}
-
-export fn sample_cubemap_array_yaw(envCube: texture_2d_array<f32>, envSampler: sampler, direction: vec3f, yaw: f32) -> vec3f {
- return sample_cubemap_array(envCube, envSampler, rotate_y(direction, yaw));
-}
-
-export fn sample_env(
- envCube: texture_2d_array<f32>,
- envSampler: sampler,
- direction: vec3f,
- yaw: f32,
- pitch: f32,
-) -> vec3f {
- return sample_cubemap_array(envCube, envSampler, rotate_env(direction, yaw, pitch));
-}
-
-export fn sample_cubemap_array_level(envCube: texture_2d_array<f32>, envSampler: sampler, direction: vec3f) -> vec3f {
- let lookup = cube_lookup_uv_face(direction);
- return textureSampleLevel(envCube, envSampler, lookup.xy, i32(lookup.z), 0.0).rgb;
-}
-
-export fn aces_tonemap(color: vec3f) -> vec3f {
- let a = 2.51;
- let b = 0.03;
- let c = 2.43;
- let d = 0.59;
- let e = 0.14;
- return clamp((color * (a * color + vec3f(b))) / (color * (c * color + vec3f(d)) + vec3f(e)), vec3f(0.0), vec3f(1.0));
-}
-
-export fn linear_to_display(color: vec3f) -> vec3f {
- return pow(max(color, vec3f(0.0)), vec3f(1.0 / 2.2));
-}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/env-sample.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/env-sample.wgsl
new file mode 100644
index 000000000..0a1347927
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/env-sample.wgsl
@@ -0,0 +1,36 @@
+import { cube_lookup_uv_face } from "./cube-face.wgsl";
+
+// Shared environment sampling helpers for eve logo material/background shaders.
+// INVARIANT: yaw then pitch rotation order matches the pre-split cube-sample module.
+// Textures and sampler are always supplied by entry shaders; this file declares no bindings.
+
+export fn rotate_y(direction: vec3f, yaw: f32) -> vec3f {
+ let s = sin(yaw);
+ let c = cos(yaw);
+ return normalize(vec3f(direction.x * c - direction.z * s, direction.y, direction.x * s + direction.z * c));
+}
+
+export fn rotate_x(direction: vec3f, pitch: f32) -> vec3f {
+ let s = sin(pitch);
+ let c = cos(pitch);
+ return normalize(vec3f(direction.x, direction.y * c - direction.z * s, direction.y * s + direction.z * c));
+}
+
+export fn rotate_env(direction: vec3f, yaw: f32, pitch: f32) -> vec3f {
+ return rotate_x(rotate_y(direction, yaw), pitch);
+}
+
+export fn sample_cubemap_array(envCube: texture_2d_array<f32>, envSampler: sampler, direction: vec3f) -> vec3f {
+ let lookup = cube_lookup_uv_face(direction);
+ return textureSample(envCube, envSampler, lookup.xy, i32(lookup.z)).rgb;
+}
+
+export fn sample_env(
+ envCube: texture_2d_array<f32>,
+ envSampler: sampler,
+ direction: vec3f,
+ yaw: f32,
+ pitch: f32,
+) -> vec3f {
+ return sample_cubemap_array(envCube, envSampler, rotate_env(direction, yaw, pitch));
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/fullscreen.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/fullscreen.wgsl
new file mode 100644
index 000000000..c4e97be60
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/fullscreen.wgsl
@@ -0,0 +1,22 @@
+// Shared non-entry fullscreen triangle helpers.
+// INVARIANT: entry shaders keep their own vertex-stage wrappers to avoid duplicate entrypoints.
+// The returned UV orientation matches the pre-split fullscreen triangle convention.
+
+export fn fullscreen_clip_position(vertexIndex: u32) -> vec4f {
+ let positions = array<vec2f, 3>(
+ vec2f(-1.0, -3.0),
+ vec2f(-1.0, 1.0),
+ vec2f(3.0, 1.0),
+ );
+ return vec4f(positions[vertexIndex], 0.0, 1.0);
+}
+
+export fn fullscreen_uv(vertexIndex: u32) -> vec2f {
+ let positions = array<vec2f, 3>(
+ vec2f(-1.0, -3.0),
+ vec2f(-1.0, 1.0),
+ vec2f(3.0, 1.0),
+ );
+ let position = positions[vertexIndex];
+ return position * vec2f(0.5, -0.5) + vec2f(0.5, 0.5);
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-common.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-vertex.wgsl
similarity index 65%
rename from apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-common.wgsl
rename to apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-vertex.wgsl
index 4ebd34c93..3b3dc0556 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-common.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-vertex.wgsl
@@ -1,22 +1,8 @@
-export struct Params {
- viewProj: mat4x4f,
- cameraPos: vec3f,
- passKind: f32,
- cameraRight: vec3f,
- fov: f32,
- cameraUp: vec3f,
- aspect: f32,
- cameraForward: vec3f,
- materialKind: f32,
- thicknessScale: f32,
- envYaw: f32,
- envPitch: f32,
- glassAbsorption: f32,
- // x = imprint progress, y = grid scale (cells/model unit), z = glyph scale, w = time seconds.
- ascii0: vec4f,
- // x/y = normalized mouse offset; z/w reserved.
- ascii1: vec4f,
-};
+import { Params } from "./scene-params.wgsl";
+
+// Shared mesh vertex IO and vertex helper for glass mesh entry shaders.
+// INVARIANT: vertex locations and output locations match the pipeline vertex layout.
+// This module contains no shader entrypoints; entry files keep their vs_main wrappers.
export struct VertexInput {
@location(0) position: vec3f,
@@ -31,9 +17,6 @@ export struct VertexOutput {
@location(3) modelPos: vec3f,
};
-export const OUTSIDE_PASS_THRESHOLD = 0.5;
-export const WIRE_PASS_THRESHOLD = 1.5;
-
export fn glass_vs_main(input: VertexInput, params: Params) -> VertexOutput {
var output: VertexOutput;
output.clipPosition = params.viewProj * vec4f(input.position, 1.0);
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/material-core.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/material-core.wgsl
index 67164a411..2117c5aa6 100644
--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/material-core.wgsl
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/material-core.wgsl
@@ -1,4 +1,4 @@
-import { sample_env } from "./cube-sample.wgsl";
+import { sample_env } from "./env-sample.wgsl";
// Shared material/reflection primitives for eve-5 mesh materials.
// Keep camera-facing normal orientation and reflection direction here so glass,
@@ -23,17 +23,6 @@ export fn env_reflection_from_dir(
return sample_env(envCube, envSampler, reflected, envYaw, envPitch);
}
-export fn env_reflection(
- envCube: texture_2d_array<f32>,
- envSampler: sampler,
- n: vec3f,
- v: vec3f,
- envYaw: f32,
- envPitch: f32,
-) -> vec3f {
- return env_reflection_from_dir(envCube, envSampler, env_reflect_dir(n, v), envYaw, envPitch);
-}
-
export fn encode_normal(n: vec3f) -> vec3f {
return normalize(n) * 0.5 + vec3f(0.5);
}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/scene-params.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/scene-params.wgsl
new file mode 100644
index 000000000..63c597d09
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/scene-params.wgsl
@@ -0,0 +1,29 @@
+// Shared scene uniform ABI for glass and environment entry shaders.
+// INVARIANT: 176 bytes / 44 f32; field order must match render/params.ts writeParams.
+// 0-15 viewProj, 16-18 cameraPos, 19 passKind, 20-22 cameraRight, 23 fov,
+// 24-26 cameraUp, 27 aspect, 28-30 cameraForward, 31 materialKind,
+// 32 thicknessScale, 33 envYaw, 34 envPitch, 35 glassAbsorption,
+// 36 imprintProgress, 37 gridScale, 38 glyphScale, 39 time,
+// 40-41 mouse, 42-43 originCell.
+
+export struct Params {
+ viewProj: mat4x4f,
+ cameraPos: vec3f,
+ passKind: f32,
+ cameraRight: vec3f,
+ fov: f32,
+ cameraUp: vec3f,
+ aspect: f32,
+ cameraForward: vec3f,
+ materialKind: f32,
+ thicknessScale: f32,
+ envYaw: f32,
+ envPitch: f32,
+ glassAbsorption: f32,
+ // x = imprint progress, y = grid scale (cells/model unit), z = glyph scale, w = time seconds.
+ ascii0: vec4f,
+ // x/y = normalized mouse offset; z/w = origin cell.
+ ascii1: vec4f,
+};
+
+export const WIRE_PASS_THRESHOLD = 1.5;
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/sdf.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/sdf.wgsl
new file mode 100644
index 000000000..569ec9429
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/sdf.wgsl
@@ -0,0 +1,27 @@
+// Shared 2D signed-distance primitives for ASCII glyph shaders.
+// INVARIANT: formulas are the pre-split ascii-imprint SDFs; glyph scale is applied by callers.
+// No entrypoints or bindings are declared here.
+
+export fn sd_box(p: vec2f, halfSize: vec2f) -> f32 {
+ let q = abs(p) - halfSize;
+ return length(max(q, vec2f(0.0))) + min(max(q.x, q.y), 0.0);
+}
+
+export fn sd_equilateral_triangle(p0: vec2f) -> f32 {
+ let k = sqrt(3.0);
+ var p = p0;
+ p.x = abs(p.x) - 0.42;
+ p.y = p.y + 0.24;
+ if (p.x + k * p.y > 0.0) {
+ p = vec2f(p.x - k * p.y, -k * p.x - p.y) / 2.0;
+ }
+ p.x = p.x - clamp(p.x, -0.84, 0.0);
+ return -length(p) * sign(p.y);
+}
+
+export fn sd_rotated_box(p: vec2f, halfSize: vec2f, angle: f32) -> f32 {
+ let s = sin(angle);
+ let c = cos(angle);
+ let rotated = vec2f(c * p.x + s * p.y, -s * p.x + c * p.y);
+ return sd_box(rotated, halfSize);
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/tonemap.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/tonemap.wgsl
new file mode 100644
index 000000000..877937c8a
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/tonemap.wgsl
@@ -0,0 +1,18 @@
+// Shared display transform helpers for eve logo postprocess passes.
+// INVARIANT: tonemap is applied once, after HDR scene/bloom accumulation.
+// Imported only by fullscreen composite entry shaders.
+
+export const DISPLAY_GAMMA = 2.2;
+
+export fn aces_tonemap(color: vec3f) -> vec3f {
+ let a = 2.51;
+ let b = 0.03;
+ let c = 2.43;
+ let d = 0.59;
+ let e = 0.14;
+ return clamp((color * (a * color + vec3f(b))) / (color * (c * color + vec3f(d)) + vec3f(e)), vec3f(0.0), vec3f(1.0));
+}
+
+export fn linear_to_display(color: vec3f) -> vec3f {
+ return pow(max(color, vec3f(0.0)), vec3f(1.0 / DISPLAY_GAMMA));
+}
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/voronoi.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/voronoi.wgsl
new file mode 100644
index 000000000..8e95286b4
--- /dev/null
+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/voronoi.wgsl
@@ -0,0 +1,67 @@
+// Shared hash and animated 3D Voronoi core for ASCII imprint noise.
+// INVARIANT: constants match 7.10 visuals: frequency 4.8, edge 0.04/0.02 at call sites.
+// Hash salts and F2-F1 edge math are unchanged from the duplicated implementations.
+
+export fn hash_u32(value: u32) -> u32 {
+ var x = value;
+ x ^= x >> 16u;
+ x *= 0x7feb352du;
+ x ^= x >> 15u;
+ x *= 0x846ca68bu;
+ x ^= x >> 16u;
+ return x;
+}
+
+export fn hash3(cell: vec3i) -> f32 {
+ let ux = bitcast<u32>(cell.x);
+ let uy = bitcast<u32>(cell.y);
+ let uz = bitcast<u32>(cell.z);
+ let mixed = (ux * 0x8da6b343u) ^ (uy * 0xd8163841u) ^ (uz * 0xcb1ab31fu);
+ return f32(hash_u32(mixed) & 0x00ffffffu) / 16777215.0;
+}
+
+fn hash3_feature_point(cell: vec3i) -> vec3f {
+ return vec3f(
+ hash3(cell + vec3i(17, 59, 113)),
+ hash3(cell + vec3i(101, 191, 53)),
+ hash3(cell + vec3i(47, 223, 149)),
+ );
+}
+
+const VORONOI_EDGE_WIDTH = 0.04;
+const VORONOI_EDGE_SOFTNESS = 0.02;
+
+export fn voronoi_cell_value_and_edge_3d(p: vec3f) -> vec2f {
+ let baseCell = vec3i(floor(p));
+ let localPosition = fract(p);
+ var nearestDistanceSquared = 1000.0;
+ var secondNearestDistanceSquared = 1000.0;
+ var winningCell = baseCell;
+
+ for (var z = -1; z <= 1; z = z + 1) {
+ for (var y = -1; y <= 1; y = y + 1) {
+ for (var x = -1; x <= 1; x = x + 1) {
+ let neighborOffset = vec3i(x, y, z);
+ let neighborCell = baseCell + neighborOffset;
+ let featurePoint = vec3f(neighborOffset) + hash3_feature_point(neighborCell);
+ let delta = featurePoint - localPosition;
+ let distanceSquared = dot(delta, delta);
+ if (distanceSquared < nearestDistanceSquared) {
+ secondNearestDistanceSquared = nearestDistanceSquared;
+ nearestDistanceSquared = distanceSquared;
+ winningCell = neighborCell;
+ } else if (distanceSquared < secondNearestDistanceSquared) {
+ secondNearestDistanceSquared = distanceSquared;
+ }
+ }
+ }
+ }
+
+ // Hard-cell Voronoi: the nearest feature cell gets one random value for glyph type.
+ // The F2-F1 gap controls a pure-white edge overlay, while interiors keep the full
+ // random-selected glyph instead of being masked away.
+ let cellValue = hash3(winningCell + vec3i(211, 37, 173));
+ let edgeGap = sqrt(secondNearestDistanceSquared) - sqrt(nearestDistanceSquared);
+ let edgeMask = 1.0 - smoothstep(VORONOI_EDGE_WIDTH, VORONOI_EDGE_WIDTH + VORONOI_EDGE_SOFTNESS, edgeGap);
+ return vec2f(cellValue, edgeMask);
+}
diff --git a/apps/docs/next-env.d.ts b/apps/docs/next-env.d.ts
index 9edff1c7c..c4b7818fb 100644
--- a/apps/docs/next-env.d.ts
+++ b/apps/docs/next-env.d.ts
@@ -1,6 +1,6 @@
/// <reference types="next" />
/// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";
// NOTE: This file should not be edited
// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
diff --git a/apps/docs/scripts/check-eve-mobile-motion.ts b/apps/docs/scripts/check-eve-mobile-motion.ts
new file mode 100644
index 000000000..c2b533d0b
--- /dev/null
+++ b/apps/docs/scripts/check-eve-mobile-motion.ts
@@ -0,0 +1,51 @@
+import { strict as assert } from "node:assert";
+import {
+ MOBILE_AUTO_ROTATE_SPEED,
+ evePointerInteractionMode,
+ mobileAutoEnvYaw,
+} from "../app/[lang]/(home)/components/eve-logo-shader/mobile-motion";
+
+const coarse = evePointerInteractionMode(true);
+assert.equal(coarse.paintEnabled, false, "coarse pointer must disable paint");
+assert.equal(coarse.autoRotateEnvYaw, true, "coarse pointer must enable auto env yaw");
+
+const fine = evePointerInteractionMode(false);
+assert.equal(fine.paintEnabled, true, "fine pointer must keep paint enabled");
+assert.equal(fine.autoRotateEnvYaw, false, "fine pointer must keep pointer-driven env yaw");
+
+assertAlmost(mobileAutoEnvYaw(0), 0, "yaw at t=0");
+assertAlmost(mobileAutoEnvYaw(10), 1.5, "yaw at t=10s");
+assertAlmost(mobileAutoEnvYaw(21), 3.15, "yaw at t=21s");
+assertAlmost(
+ mobileAutoEnvYaw(3600),
+ MOBILE_AUTO_ROTATE_SPEED * 3600,
+ "yaw after 1h remains unwrapped",
+);
+assert(mobileAutoEnvYaw(3600) > Math.PI * 2, "auto yaw must be monotonic and unwrapped");
+
+console.log(
+ JSON.stringify(
+ {
+ ok: true,
+ speedRadPerSecond: MOBILE_AUTO_ROTATE_SPEED,
+ coarse,
+ fine,
+ yawSamples: {
+ t0: round(mobileAutoEnvYaw(0)),
+ t10: round(mobileAutoEnvYaw(10)),
+ t21: round(mobileAutoEnvYaw(21)),
+ t3600: round(mobileAutoEnvYaw(3600)),
+ },
+ },
+ null,
+ 2,
+ ),
+);
+
+function assertAlmost(actual: number, expected: number, label: string) {
+ assert(Math.abs(actual - expected) < 1e-9, `${label}: expected ${expected}, received ${actual}`);
+}
+
+function round(value: number) {
+ return Number(value.toFixed(6));
+}
diff --git a/apps/docs/scripts/check-eve-paint-mapping.ts b/apps/docs/scripts/check-eve-paint-mapping.ts
new file mode 100644
index 000000000..e639ec89b
--- /dev/null
+++ b/apps/docs/scripts/check-eve-paint-mapping.ts
@@ -0,0 +1,141 @@
+import { strict as assert } from "node:assert";
+import {
+ DEFAULT_CAMERA_FOV,
+ BLOOM_RADIUS,
+ cameraRadiusForFov,
+ DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,
+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ mapClientPointToPaintCell,
+ type Bounds,
+ type RenderControls,
+} from "../app/[lang]/(home)/components/eve-logo-shader/render";
+
+const bounds: Bounds = {
+ min: [-0.039000000804662704, -0.01188180036842823, -0.0020000000949949026],
+ max: [0.03870119899511337, 0.012500000186264515, 0.0020000000949949026],
+};
+const controls: Pick<RenderControls, "radius" | "yaw" | "pitch" | "fov"> = {
+ yaw: 0,
+ pitch: 0,
+ radius: cameraRadiusForFov(DEFAULT_CAMERA_FOV),
+ fov: DEFAULT_CAMERA_FOV,
+};
+const rect = { left: 10, top: 20, width: 563.5, height: 190 };
+const devicePixelRatio = DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO;
+const canvasWidth = Math.floor(rect.width * devicePixelRatio);
+const canvasHeight = Math.floor(rect.height * devicePixelRatio);
+const logicalWidth = canvasWidth - BLOOM_RADIUS * 2;
+const logicalHeight = canvasHeight - BLOOM_RADIUS * 2;
+const gridScaleMultiplier = DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER;
+
+const center = mapClientPointToPaintCell({
+ clientX: rect.left + rect.width / 2,
+ clientY: rect.top + rect.height / 2,
+ rect,
+ canvasWidth,
+ canvasHeight,
+ logicalWidth,
+ logicalHeight,
+ controls,
+ meshBounds: bounds,
+ gridScaleMultiplier,
+ devicePixelRatio,
+});
+assert(center);
+assert.equal(center.insideLogicalBounds, true);
+assert.deepEqual(center.originCell, [-21, -7]);
+assertAlmost(center.physical[0], 563.5, "center physical x");
+assertAlmost(center.physical[1], 190, "center physical y");
+assertAlmost(center.logical[0], 547.5, "center logical x");
+assertAlmost(center.logical[1], 174, "center logical y");
+assertAlmost(center.model[0], 0, "center model x");
+assertAlmost(center.model[1], 0, "center model y");
+assertAlmost(center.brushCell[0], 21, "center cell x");
+assertAlmost(center.brushCell[1], 7, "center cell y");
+
+const dpr1SameBuffer = mapClientPointToPaintCell({
+ clientX: rect.left + rect.width / 2,
+ clientY: rect.top + rect.height / 2,
+ rect,
+ canvasWidth,
+ canvasHeight,
+ logicalWidth,
+ logicalHeight,
+ controls,
+ meshBounds: bounds,
+ gridScaleMultiplier,
+ devicePixelRatio: 1,
+});
+assert(dpr1SameBuffer);
+assert.equal(dpr1SameBuffer.insideLogicalBounds, true);
+assertAlmost(
+ dpr1SameBuffer.gridScale,
+ center.gridScale * 2,
+ "dpr1 same-buffer grid scale doubles",
+);
+assertAlmost(
+ dpr1SameBuffer.brushCell[0] - dpr1SameBuffer.originCell[0],
+ (center.brushCell[0] - center.originCell[0]) * 2,
+ "dpr1 same-buffer center lattice coordinate doubles",
+);
+
+const leftEdgeClientX = rect.left + (BLOOM_RADIUS * rect.width) / canvasWidth;
+const leftOfOrigin = mapClientPointToPaintCell({
+ clientX: leftEdgeClientX,
+ clientY: rect.top + rect.height / 2,
+ rect,
+ canvasWidth,
+ canvasHeight,
+ logicalWidth,
+ logicalHeight,
+ controls,
+ meshBounds: bounds,
+ gridScaleMultiplier,
+ devicePixelRatio,
+});
+assert(leftOfOrigin);
+assert.equal(leftOfOrigin.insideLogicalBounds, true);
+assert.deepEqual(leftOfOrigin.originCell, [-21, -7]);
+assert(leftOfOrigin.model[0] < 0, "left case is in negative model X");
+assert(leftOfOrigin.brushCell[0] < 0, "originCell offset preserves negative/out-of-grid cell X");
+assertAlmost(leftOfOrigin.logical[0], 0, "left logical x");
+assertAlmost(leftOfOrigin.brushCell[0], -3.2953125, "left cell x");
+assertAlmost(leftOfOrigin.brushCell[1], 7, "left cell y");
+
+console.log(
+ JSON.stringify(
+ {
+ ok: true,
+ center: summarize(center),
+ leftOfOrigin: summarize(leftOfOrigin),
+ dpr1SameBuffer: summarize(dpr1SameBuffer),
+ },
+ null,
+ 2,
+ ),
+);
+
+function summarize(mapping: NonNullable<ReturnType<typeof mapClientPointToPaintCell>>) {
+ return {
+ physical: roundPair(mapping.physical),
+ logical: roundPair(mapping.logical),
+ model: roundPair(mapping.model),
+ brushCell: roundPair(mapping.brushCell),
+ originCell: mapping.originCell,
+ gridScale: round(mapping.gridScale),
+ pxPerModelUnit: round(mapping.pxPerModelUnit),
+ insideLogicalBounds: mapping.insideLogicalBounds,
+ };
+}
+
+function roundPair(pair: readonly [number, number]) {
+ return [round(pair[0]), round(pair[1])] as const;
+}
+
+function round(value: number) {
+ return Number(value.toFixed(6));
+}
+
+function assertAlmost(actual: number, expected: number, label: string) {
+ assert(Math.abs(actual - expected) < 1e-6, `${label}: expected ${expected}, received ${actual}`);
+}
diff --git a/apps/docs/scripts/eve-render/config.ts b/apps/docs/scripts/eve-render/config.ts
new file mode 100644
index 000000000..f562dae43
--- /dev/null
+++ b/apps/docs/scripts/eve-render/config.ts
@@ -0,0 +1,161 @@
+import { resolve } from "node:path";
+import { mobileAutoEnvYaw } from "../../app/[lang]/(home)/components/eve-logo-shader/mobile-motion";
+import {
+ BLOOM_RADIUS,
+ BLOOM_STRENGTH_OFF,
+ BLOOM_STRENGTH_ON,
+ BLOOM_THRESHOLD,
+ DEFAULT_CAMERA_FOV,
+ DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,
+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ DEFAULT_PAINT_BRUSH_RADIUS,
+ DEFAULT_PAINT_BRUSH_STRENGTH,
+ DEFAULT_PAINT_DECAY_PER_FRAME_120,
+ DEFAULT_PAINT_DIFFUSION_JITTER,
+ DEFAULT_PAINT_DIFFUSION_RATE,
+ DEFAULT_PAINT_DT,
+ cameraRadiusForFov,
+ getPaddedRenderSize,
+ type EveMaterial,
+ type RenderControls,
+} from "../../app/[lang]/(home)/components/eve-logo-shader/render";
+import {
+ readBooleanEnv,
+ readFiniteNumberEnv,
+ readNonNegativeIntegerEnv,
+ readNonNegativeNumberEnv,
+ readOptionalFiniteNumberEnv,
+ readOptionalPositiveNumberEnv,
+ readPositiveIntegerEnv,
+ readPositiveNumberEnv,
+ readRangeEnv,
+ readRenderStageEnv,
+ readThemeEnv,
+ readUnitIntervalEnv,
+} from "./env";
+
+// Owns env-to-render-config assembly for the offline Eve renderer.
+// INVARIANT: defaults and eager CLI semantics match the original script.
+// Imported only by render-eve-5.ts and helper modules.
+
+export const FORMAT: GPUTextureFormat = "rgba8unorm";
+
+export type RenderConfig = ReturnType<typeof readRenderConfig>;
+
+export function readRenderConfig() {
+ const runId = new Date().toISOString().replaceAll(":", "-").replace(".", "-");
+ const outDir = resolve(process.cwd(), "tmp/eve-5-renders", runId);
+ const paddingRadius = readNonNegativeIntegerEnv("EVE_LOGO_RENDER_PADDING", 0);
+ const bloomEnabled = readBooleanEnv("EVE_LOGO_RENDER_BLOOM", false);
+ const outputWidth = readPositiveIntegerEnv("EVE_LOGO_RENDER_WIDTH", 1095, paddingRadius * 2);
+ const outputHeight = readPositiveIntegerEnv("EVE_LOGO_RENDER_HEIGHT", 348, paddingRadius * 2);
+ const logicalWidth = Math.max(1, outputWidth - paddingRadius * 2);
+ const logicalHeight = Math.max(1, outputHeight - paddingRadius * 2);
+ const paddedSize = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);
+ const width = paddedSize.width;
+ const height = paddedSize.height;
+ const theme = readThemeEnv();
+ const dpr = readPositiveNumberEnv("EVE_LOGO_RENDER_DPR", DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO);
+ const imprintProgress = readUnitIntervalEnv("EVE_LOGO_RENDER_IMPRINT_PROGRESS");
+ const imprintGridScaleMultiplier = readPositiveNumberEnv(
+ "EVE_LOGO_IMPRINT_GRID_SCALE_MULTIPLIER",
+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,
+ );
+ const imprintGlyphScale = readPositiveNumberEnv("EVE_LOGO_IMPRINT_GLYPH_SCALE", 1.35);
+ const requestedRenderStage = readRenderStageEnv();
+ const renderStage: EveMaterial = requestedRenderStage;
+ const paintSteps = readNonNegativeIntegerEnv("EVE_LOGO_PAINT_STEPS", 0);
+ const paintDecayPerFrame120 = readPositiveNumberEnv(
+ "EVE_LOGO_PAINT_DECAY_PER_FRAME_120",
+ DEFAULT_PAINT_DECAY_PER_FRAME_120,
+ );
+ const paintDecayRate =
+ readOptionalPositiveNumberEnv("EVE_LOGO_PAINT_DECAY_RATE") ?? paintDecayPerFrame120 * 120;
+ const paintDiffusionRate = readNonNegativeNumberEnv(
+ "EVE_LOGO_PAINT_DIFFUSION",
+ DEFAULT_PAINT_DIFFUSION_RATE,
+ );
+ const paintDiffusionJitter = readRangeEnv(
+ "EVE_LOGO_PAINT_DIFFUSION_JITTER",
+ DEFAULT_PAINT_DIFFUSION_JITTER,
+ 0,
+ 4,
+ );
+ const paintBrushRadius = readPositiveNumberEnv(
+ "EVE_LOGO_PAINT_BRUSH_RADIUS",
+ DEFAULT_PAINT_BRUSH_RADIUS,
+ );
+ const paintBrushStrength = readNonNegativeNumberEnv(
+ "EVE_LOGO_PAINT_BRUSH_STRENGTH",
+ DEFAULT_PAINT_BRUSH_STRENGTH,
+ );
+ const paintDt = readPositiveNumberEnv("EVE_LOGO_PAINT_DT", DEFAULT_PAINT_DT);
+ const paintDecaySteps = readNonNegativeIntegerEnv("EVE_LOGO_PAINT_DECAY_STEPS", 0);
+ const renderYaw = readFiniteNumberEnv("EVE_LOGO_RENDER_YAW", 0);
+ const renderEnvYawTime = readOptionalFiniteNumberEnv("EVE_LOGO_ENV_YAW_TIME");
+ const renderEnvYaw =
+ readOptionalFiniteNumberEnv("EVE_LOGO_RENDER_ENV_YAW") ??
+ (renderEnvYawTime === undefined ? 0 : mobileAutoEnvYaw(renderEnvYawTime));
+ const modelPath = resolve(process.cwd(), "public/eve-5/eve-logo.gltf");
+ const defaultControls: RenderControls = {
+ yaw: renderYaw,
+ pitch: 0,
+ radius: cameraRadiusForFov(DEFAULT_CAMERA_FOV),
+ fov: DEFAULT_CAMERA_FOV,
+ envYaw: renderEnvYaw,
+ envPitch: 0,
+ insideRendering: true,
+ outsideRendering: true,
+ material: renderStage,
+ wireframe: false,
+ showEnv: false,
+ };
+
+ return {
+ runId,
+ outDir,
+ format: FORMAT,
+ paddingRadius,
+ bloomEnabled,
+ outputWidth,
+ outputHeight,
+ logicalWidth,
+ logicalHeight,
+ width,
+ height,
+ theme,
+ dpr,
+ imprintProgress,
+ imprintGridScaleMultiplier,
+ imprintGlyphScale,
+ requestedRenderStage,
+ renderStage,
+ paintSteps,
+ paintDecayPerFrame120,
+ paintDecayRate,
+ paintDiffusionRate,
+ paintDiffusionJitter,
+ paintBrushRadius,
+ paintBrushStrength,
+ paintDt,
+ paintDecaySteps,
+ renderYaw,
+ renderEnvYawTime,
+ renderEnvYaw,
+ modelPath,
+ defaultControls,
+ bloomConstants: {
+ radius: BLOOM_RADIUS,
+ strengthOff: BLOOM_STRENGTH_OFF,
+ strengthOn: BLOOM_STRENGTH_ON,
+ threshold: BLOOM_THRESHOLD,
+ },
+ };
+}
+
+export function effectiveBloomStrength(config: RenderConfig, imprintProgress: number) {
+ return (
+ config.bloomConstants.strengthOff +
+ (config.bloomConstants.strengthOn - config.bloomConstants.strengthOff) * imprintProgress
+ );
+}
diff --git a/apps/docs/scripts/eve-render/env.ts b/apps/docs/scripts/eve-render/env.ts
new file mode 100644
index 000000000..aa785b7c8
--- /dev/null
+++ b/apps/docs/scripts/eve-render/env.ts
@@ -0,0 +1,135 @@
+import type { EveMaterial } from "../../app/[lang]/(home)/components/eve-logo-shader/render";
+
+// Owns environment-variable parsing for the offline Eve renderer.
+// INVARIANT: EVE_LOGO_RENDER_* and EVE_LOGO_PAINT_* names/accepted values are unchanged.
+// Imported by config, paint-fixtures, and views.
+
+export function readFiniteNumberEnv(name: string, fallback: number) {
+ return readOptionalFiniteNumberEnv(name) ?? fallback;
+}
+
+export function readOptionalFiniteNumberEnv(name: string) {
+ const value = process.env[name];
+ if (!value) return undefined;
+ const parsed = Number.parseFloat(value);
+ if (!Number.isFinite(parsed)) {
+ throw new Error(`${name} must be a finite number.`);
+ }
+ return parsed;
+}
+
+export function readPositiveIntegerEnv(name: string, fallback: number, minimumExclusive = 0) {
+ const value = process.env[name];
+ if (!value) return fallback;
+ const parsed = Number.parseInt(value, 10);
+ if (!Number.isFinite(parsed) || parsed <= minimumExclusive) {
+ throw new Error(`${name} must be an integer greater than ${minimumExclusive}.`);
+ }
+ return parsed;
+}
+
+export function readPositiveNumberEnv(name: string, fallback: number) {
+ return readOptionalPositiveNumberEnv(name) ?? fallback;
+}
+
+export function readOptionalPositiveNumberEnv(name: string) {
+ const value = process.env[name];
+ if (!value) return undefined;
+ const parsed = Number.parseFloat(value);
+ if (!Number.isFinite(parsed) || parsed <= 0) {
+ throw new Error(`${name} must be a positive number.`);
+ }
+ return parsed;
+}
+
+export function readNonNegativeNumberEnv(name: string, fallback: number) {
+ const value = process.env[name];
+ if (!value) return fallback;
+ const parsed = Number.parseFloat(value);
+ if (!Number.isFinite(parsed) || parsed < 0) {
+ throw new Error(`${name} must be a non-negative number.`);
+ }
+ return parsed;
+}
+
+export function readUnitIntervalEnv(name: string) {
+ const value = process.env[name];
+ if (value === undefined || value === "") return undefined;
+ const parsed = Number.parseFloat(value);
+ if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+ throw new Error(`${name} must be a finite number between 0 and 1.`);
+ }
+ return parsed;
+}
+
+export function readRangeEnv(name: string, fallback: number, min: number, max: number) {
+ const value = process.env[name];
+ if (value === undefined || value === "") return fallback;
+ const parsed = Number.parseFloat(value);
+ if (!Number.isFinite(parsed) || parsed < min || parsed > max) {
+ throw new Error(`${name} must be a finite number between ${min} and ${max}.`);
+ }
+ return parsed;
+}
+
+export function readNonNegativeIntegerEnv(name: string, fallback: number) {
+ const value = process.env[name];
+ if (!value) return fallback;
+ const parsed = Number.parseInt(value, 10);
+ if (!Number.isFinite(parsed) || parsed < 0) {
+ throw new Error(`${name} must be a non-negative integer.`);
+ }
+ return parsed;
+}
+
+export function readBooleanEnv(name: string, fallback: boolean) {
+ const value = process.env[name];
+ if (!value) return fallback;
+ const normalized = value.toLowerCase();
+ if (["1", "true", "yes", "on"].includes(normalized)) return true;
+ if (["0", "false", "no", "off"].includes(normalized)) return false;
+ throw new Error(`${name} must be a boolean value.`);
+}
+
+export function readRenderStageEnv(): EveMaterial {
+ const values: Record<string, EveMaterial> = {
+ glass: "glass",
+ "back-albedo": "back-albedo",
+ "back-depth": "back-depth",
+ thickness: "thickness",
+ normal: "normal",
+ "camera-reflected-normal": "camera reflected normal",
+ metallic: "metallic",
+ "paint-debug": "paint-debug",
+ };
+ const value = process.env.EVE_LOGO_RENDER_STAGE ?? "glass";
+ const stage = values[value];
+ if (!stage) {
+ throw new Error(`EVE_LOGO_RENDER_STAGE must be one of: ${Object.keys(values).join(", ")}.`);
+ }
+ return stage;
+}
+
+export function stageFileName(stage: EveMaterial) {
+ return stage.replaceAll(" ", "-");
+}
+
+export function formatProgressForFile(progress: number) {
+ return progress.toFixed(3).replace(/0+$/, "").replace(/\.$/, "").replace(".", "p");
+}
+
+export function readNoiseTimeEnv() {
+ const value = process.env.EVE_LOGO_RENDER_NOISE_TIME;
+ if (!value) return 0;
+ const parsed = Number.parseFloat(value);
+ if (!Number.isFinite(parsed)) {
+ throw new Error("EVE_LOGO_RENDER_NOISE_TIME must be a finite number.");
+ }
+ return parsed;
+}
+
+export function readThemeEnv(): "light" | "dark" {
+ const value = process.env.EVE_LOGO_RENDER_THEME ?? "dark";
+ if (value === "light" || value === "dark") return value;
+ throw new Error('EVE_LOGO_RENDER_THEME must be "light" or "dark".');
+}
diff --git a/apps/docs/scripts/eve-render/load-mesh.ts b/apps/docs/scripts/eve-render/load-mesh.ts
new file mode 100644
index 000000000..d409f5f9c
--- /dev/null
+++ b/apps/docs/scripts/eve-render/load-mesh.ts
@@ -0,0 +1,23 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { decodeGltfMesh } from "../../app/[lang]/(home)/components/eve-logo-shader/mesh";
+
+// Owns disk glTF loading for the offline Eve renderer.
+// INVARIANT: data URI and relative-buffer decoding match the original script.
+// Imported only by render-eve-5.ts.
+
+export async function loadMeshFromDisk(path: string) {
+ const gltf = JSON.parse(await readFile(path, "utf8"));
+ return decodeGltfMesh(gltf, async (uri) => {
+ if (uri.startsWith("data:application/octet-stream;base64,")) {
+ const [, payload] = uri.split(",");
+ return exactArrayBuffer(Buffer.from(payload!, "base64"));
+ }
+ const bufferPath = resolve(path, "..", uri);
+ return exactArrayBuffer(await readFile(bufferPath));
+ });
+}
+
+function exactArrayBuffer(buffer: Buffer) {
+ return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+}
diff --git a/apps/docs/scripts/eve-render/paint-fixtures.ts b/apps/docs/scripts/eve-render/paint-fixtures.ts
new file mode 100644
index 000000000..d3098b5e2
--- /dev/null
+++ b/apps/docs/scripts/eve-render/paint-fixtures.ts
@@ -0,0 +1,118 @@
+import {
+ imprintCellSizeForDevicePixelRatio,
+ type PaintRenderOptions,
+ type PaintSeed,
+} from "../../app/[lang]/(home)/components/eve-logo-shader/render";
+import type { RenderConfig } from "./config";
+import { readBooleanEnv } from "./env";
+
+// Owns deterministic paint seed/stroke fixtures for offline renders.
+// INVARIANT: cell sizing and env grammar preserve legacy output pixels.
+// Imported by views and render-eve-5.ts reporting.
+
+export function paintRequested() {
+ return Boolean(
+ process.env.EVE_LOGO_PAINT_BLOB ||
+ process.env.EVE_LOGO_PAINT_PATTERN ||
+ process.env.EVE_LOGO_PAINT_STROKE,
+ );
+}
+
+export function buildPaintSeed(config: RenderConfig): PaintSeed | undefined {
+ if (!paintRequested()) return undefined;
+ const cellSize = imprintCellSizeForDevicePixelRatio(config.dpr);
+ const width = Math.max(1, Math.ceil(config.logicalWidth / cellSize));
+ const height = Math.max(1, Math.ceil(config.logicalHeight / cellSize));
+ const values = new Float32Array(width * height);
+ const pattern = process.env.EVE_LOGO_PAINT_PATTERN;
+ if (pattern) {
+ fillPaintPattern(values, width, height, pattern);
+ }
+ const blob = process.env.EVE_LOGO_PAINT_BLOB;
+ if (blob) {
+ for (const part of blob.split(/[;|]/)) {
+ if (part.trim()) addPaintBlob(values, width, height, part.trim());
+ }
+ }
+ return { width, height, values };
+}
+
+export function paintOptions(config: RenderConfig, seed: PaintSeed): PaintRenderOptions {
+ return {
+ seed,
+ steps: config.paintSteps,
+ decaySteps: config.paintDecaySteps,
+ dt: config.paintDt,
+ brushRadius: config.paintBrushRadius,
+ brushStrength: config.paintBrushStrength,
+ brushActive: false,
+ decayRate: config.paintDecayRate,
+ diffusionRate: config.paintDiffusionRate,
+ diffusionJitter: config.paintDiffusionJitter,
+ stroke: readPaintStroke(seed.width, seed.height),
+ };
+}
+
+export function readPaintStroke(width: number, height: number): PaintRenderOptions["stroke"] {
+ const spec = process.env.EVE_LOGO_PAINT_STROKE;
+ if (!spec) return undefined;
+ const parts = spec.split(",").map((value) => Number.parseFloat(value));
+ if (parts.length !== 5 || parts.some((value) => !Number.isFinite(value))) {
+ throw new Error('EVE_LOGO_PAINT_STROKE must be "x0,y0,x1,y1,duration".');
+ }
+ const [x0, y0, x1, y1, duration] = parts as [number, number, number, number, number];
+ if (duration <= 0) throw new Error("EVE_LOGO_PAINT_STROKE duration must be positive.");
+ return {
+ fromCell: [x0 * width, y0 * height],
+ toCell: [x1 * width, y1 * height],
+ duration,
+ movementGated: readBooleanEnv("EVE_LOGO_PAINT_STROKE_MOVEMENT_GATED", true),
+ };
+}
+
+function fillPaintPattern(values: Float32Array, width: number, height: number, pattern: string) {
+ if (pattern === "full") {
+ values.fill(1);
+ return;
+ }
+ if (pattern === "ramp") {
+ for (let y = 0; y < height; y += 1) {
+ for (let x = 0; x < width; x += 1) values[y * width + x] = width <= 1 ? 1 : x / (width - 1);
+ }
+ return;
+ }
+ if (pattern === "stripes") {
+ for (let y = 0; y < height; y += 1) {
+ for (let x = 0; x < width; x += 1) values[y * width + x] = x % 2 === 0 ? 1 : 0;
+ }
+ return;
+ }
+ throw new Error('EVE_LOGO_PAINT_PATTERN must be "stripes", "ramp", or "full".');
+}
+
+function addPaintBlob(values: Float32Array, width: number, height: number, spec: string) {
+ const parts = spec.split(",").map((value) => Number.parseFloat(value));
+ if (parts.length !== 4 || parts.some((value) => !Number.isFinite(value))) {
+ throw new Error('EVE_LOGO_PAINT_BLOB entries must be "x,y,radius,intensity".');
+ }
+ const [x, y, radius, intensity] = parts as [number, number, number, number];
+ if (radius <= 0) throw new Error("EVE_LOGO_PAINT_BLOB radius must be positive.");
+ const centerX = x * width;
+ const centerY = y * height;
+ const radiusCells = radius * Math.max(width, height);
+ for (let row = 0; row < height; row += 1) {
+ for (let col = 0; col < width; col += 1) {
+ const dx = col + 0.5 - centerX;
+ const dy = row + 0.5 - centerY;
+ const d = Math.hypot(dx, dy);
+ const falloff = 1 - smoothstep(0, radiusCells, d);
+ const index = row * width + col;
+ values[index] = Math.max(values[index] ?? 0, Math.max(0, Math.min(1, intensity * falloff)));
+ }
+ }
+}
+
+function smoothstep(edge0: number, edge1: number, x: number) {
+ const t = Math.max(0, Math.min(1, (x - edge0) / Math.max(edge1 - edge0, 0.000001)));
+ return t * t * (3 - 2 * t);
+}
diff --git a/apps/docs/scripts/eve-render/report.ts b/apps/docs/scripts/eve-render/report.ts
new file mode 100644
index 000000000..2d105b364
--- /dev/null
+++ b/apps/docs/scripts/eve-render/report.ts
@@ -0,0 +1,44 @@
+import { createHash } from "node:crypto";
+import { writeFile } from "node:fs/promises";
+import { PNG } from "pngjs";
+
+// Owns PNG writing and pixel-stat helpers for offline Eve renders.
+// INVARIANT: PNG bytes and pixelStats sha256 algorithm are unchanged.
+// Imported only by views and render-eve-5.ts.
+
+export async function writePng(path: string, width: number, height: number, pixels: Uint8Array) {
+ const png = new PNG({ width, height });
+ png.data.set(pixels);
+ await writeFile(path, PNG.sync.write(png));
+}
+
+export function pixelStats(width: number, height: number, pixels: Uint8Array) {
+ let nonBlack = 0;
+ let alpha = 0;
+ let colored = 0;
+
+ for (let index = 0; index < pixels.length; index += 4) {
+ const r = pixels[index] ?? 0;
+ const g = pixels[index + 1] ?? 0;
+ const b = pixels[index + 2] ?? 0;
+ const a = pixels[index + 3] ?? 0;
+ const max = Math.max(r, g, b);
+ const min = Math.min(r, g, b);
+ if (max > 8) nonBlack++;
+ if (a > 20) alpha++;
+ if (max - min > 8 && r + g + b > 24) colored++;
+ }
+
+ const header = Buffer.alloc(8);
+ header.writeUInt32LE(width, 0);
+ header.writeUInt32LE(height, 4);
+ const sha256 = createHash("sha256").update(header).update(pixels).digest("hex");
+
+ return { width, height, total: width * height, nonBlack, alpha, colored, sha256 };
+}
+
+export function maxFloat32(values: Float32Array) {
+ let max = 0;
+ for (const value of values) max = Math.max(max, value);
+ return max;
+}
diff --git a/apps/docs/scripts/eve-render/views.ts b/apps/docs/scripts/eve-render/views.ts
new file mode 100644
index 000000000..71200d031
--- /dev/null
+++ b/apps/docs/scripts/eve-render/views.ts
@@ -0,0 +1,121 @@
+import { resolve } from "node:path";
+import type { Device } from "@vgpu/core";
+import {
+ createEve5Renderer,
+ type ImprintRenderOptions,
+ type PaintSeed,
+ type RenderControls,
+} from "../../app/[lang]/(home)/components/eve-logo-shader/render";
+import type { RenderConfig } from "./config";
+import { formatProgressForFile, readNoiseTimeEnv, stageFileName } from "./env";
+import { paintOptions, paintRequested } from "./paint-fixtures";
+import { pixelStats, writePng } from "./report";
+
+// Owns offline view orchestration, filenames, and GPU readback.
+// INVARIANT: output filenames and manifest keys are byte-identical to the original script.
+// Imported only by render-eve-5.ts.
+
+export async function renderDefaultViews(
+ renderer: ReturnType<typeof createEve5Renderer>,
+ device: Device,
+ config: RenderConfig,
+ controls: RenderControls,
+ paintSeed: PaintSeed | undefined,
+) {
+ const output = await renderView(
+ renderer,
+ device,
+ config,
+ controls,
+ outputFileName(config),
+ paintSeed,
+ );
+ await renderView(
+ renderer,
+ device,
+ config,
+ {
+ ...controls,
+ yaw: config.renderYaw || -0.49,
+ pitch: config.renderYaw ? controls.pitch : 0.31,
+ },
+ "rotated.png",
+ paintSeed,
+ );
+ await renderView(
+ renderer,
+ device,
+ config,
+ { ...controls, wireframe: true },
+ "wireframe.png",
+ paintSeed,
+ );
+
+ return {
+ files: {
+ output: outputFileName(config),
+ rotated: "rotated.png",
+ wireframe: "wireframe.png",
+ log: "log.json",
+ },
+ output: pixelStats(config.width, config.height, output),
+ };
+}
+
+function outputFileName(config: RenderConfig) {
+ const stagePrefix = config.renderStage === "glass" ? "" : `${stageFileName(config.renderStage)}-`;
+ const imprintPart =
+ config.imprintProgress === undefined
+ ? "output"
+ : `imprint-${formatProgressForFile(config.imprintProgress)}`;
+ const paintPart = paintRequested() ? `-paint-steps-${config.paintSteps}` : "";
+ return `${stagePrefix}${imprintPart}${paintPart}.png`;
+}
+
+function imprintOptions(
+ config: RenderConfig,
+ paintSeed?: PaintSeed,
+): ImprintRenderOptions | undefined {
+ const paint = paintSeed ? paintOptions(config, paintSeed) : undefined;
+ if (config.imprintProgress === undefined && !paint) return undefined;
+ return {
+ progress: config.imprintProgress ?? 0,
+ gridScaleMultiplier: config.imprintGridScaleMultiplier,
+ glyphScale: config.imprintGlyphScale,
+ time: readNoiseTimeEnv(),
+ mouse: [0, 0] as const,
+ devicePixelRatio: config.dpr,
+ paint,
+ };
+}
+
+async function renderView(
+ renderer: ReturnType<typeof createEve5Renderer>,
+ device: Device,
+ config: RenderConfig,
+ controls: RenderControls,
+ file: string,
+ paintSeed?: PaintSeed,
+) {
+ const target = device.createTexture({
+ label: `eve-5-static-${file}`,
+ size: [config.width, config.height],
+ format: config.format,
+ usage: ["render_attachment", "copy_src"],
+ });
+ try {
+ renderer.render(
+ target.createView(),
+ controls,
+ config.logicalWidth,
+ config.logicalHeight,
+ imprintOptions(config, paintSeed),
+ );
+ await device.queue.flush();
+ const pixels = new Uint8Array(await target.read());
+ await writePng(resolve(config.outDir, file), config.width, config.height, pixels);
+ return pixels;
+ } finally {
+ target.destroy();
+ }
+}
diff --git a/apps/docs/scripts/render-eve-5.ts b/apps/docs/scripts/render-eve-5.ts
index 47914ed6c..c4ee4bdd1 100644
--- a/apps/docs/scripts/render-eve-5.ts
+++ b/apps/docs/scripts/render-eve-5.ts
@@ -3,7 +3,7 @@
// the static Eve logo fallback:
//
// docker run --rm \
-// -v /home/user/eve-worktrees/eve-migrate-shader:/work \
+// -v /home/user/eve-worktrees/eve-hero-updates:/work \
// -w /work/apps/docs \
// -e VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/lvp_icd.json \
// -e LIBGL_ALWAYS_SOFTWARE=1 \
@@ -22,110 +22,118 @@
// baking production fallbacks. Fallback images are content-only: render without
// bloom or padding, then place them inside the padded canvas box in CSS so the
// animated shader appears to "turn on" around the same logo geometry.
-
-import { createHash } from "node:crypto";
-import { readFile, mkdir, writeFile } from "node:fs/promises";
+//
+// QA / synthetic paint envs:
+// - EVE_LOGO_RENDER_STAGE=glass|paint-debug|ascii|imprint|ascii/imprint
+// - EVE_LOGO_RENDER_IMPRINT_PROGRESS=0..1 enables the front ASCII imprint path.
+// - EVE_LOGO_PAINT_BLOB="x,y,radius,intensity[;...]" seeds soft paint blobs in paint-UV.
+// - EVE_LOGO_PAINT_PATTERN=stripes|ramp|full seeds procedural paint.
+// - EVE_LOGO_PAINT_STROKE="x0,y0,x1,y1,duration" simulates a moving brush stroke.
+// - EVE_LOGO_PAINT_STROKE_MOVEMENT_GATED=false disables stroke movement gating for legacy sims.
+// - EVE_LOGO_PAINT_STEPS=N runs N paint update frames before rendering.
+// - EVE_LOGO_PAINT_DECAY_STEPS=N runs N additional inactive decay frames.
+// - EVE_LOGO_PAINT_DECAY_PER_FRAME_120 sets linear paint removed per 120fps frame;
+// EVE_LOGO_PAINT_DECAY_RATE still overrides the equivalent per-second rate directly.
+// - EVE_LOGO_PAINT_DIFFUSION, EVE_LOGO_PAINT_DIFFUSION_JITTER,
+// EVE_LOGO_PAINT_BRUSH_RADIUS, EVE_LOGO_PAINT_BRUSH_STRENGTH, and
+// EVE_LOGO_PAINT_DT override paint dynamics.
+// - EVE_LOGO_ENV_YAW_TIME=seconds drives env yaw as seconds*0.15 for mobile rotation QA.
+// - EVE_LOGO_RENDER_ENV_YAW=radians sets env yaw directly.
+// Example: EVE_LOGO_RENDER_STAGE=glass EVE_LOGO_RENDER_IMPRINT_PROGRESS=1 \
+// EVE_LOGO_PAINT_BLOB="0.5,0.48,0.16,1" pnpm --dir apps/docs render:eve-5
+
+import { mkdir, writeFile } from "node:fs/promises";
import { resolve } from "node:path";
-import { App } from "@vgpu/core";
import { createNodeAdapter } from "@vgpu/adapter-node";
-import { PNG } from "pngjs";
-import { decodeGltfMesh } from "../app/[lang]/(home)/components/eve-logo-shader/mesh";
-import {
- BLOOM_RADIUS,
- BLOOM_STRENGTH_OFF,
- BLOOM_STRENGTH_ON,
- BLOOM_THRESHOLD,
- DEFAULT_CAMERA_FOV,
- cameraRadiusForFov,
- createEve5Renderer,
- getPaddedRenderSize,
- type EveMaterial,
- type MeshData,
- type RenderControls,
-} from "../app/[lang]/(home)/components/eve-logo-shader/render";
-
-const RUN_ID = new Date().toISOString().replaceAll(":", "-").replace(".", "-");
-const OUT_DIR = resolve(process.cwd(), "tmp/eve-5-renders", RUN_ID);
-const FORMAT: GPUTextureFormat = "rgba8unorm";
-const PADDING_RADIUS = readNonNegativeIntegerEnv("EVE_LOGO_RENDER_PADDING", 0);
-const BLOOM_ENABLED = readBooleanEnv("EVE_LOGO_RENDER_BLOOM", false);
-const OUTPUT_WIDTH = readPositiveIntegerEnv("EVE_LOGO_RENDER_WIDTH", 1095, PADDING_RADIUS * 2);
-const OUTPUT_HEIGHT = readPositiveIntegerEnv("EVE_LOGO_RENDER_HEIGHT", 348, PADDING_RADIUS * 2);
-const LOGICAL_WIDTH = Math.max(1, OUTPUT_WIDTH - PADDING_RADIUS * 2);
-const LOGICAL_HEIGHT = Math.max(1, OUTPUT_HEIGHT - PADDING_RADIUS * 2);
-const PADDED_SIZE = getPaddedRenderSize(LOGICAL_WIDTH, LOGICAL_HEIGHT, PADDING_RADIUS);
-const WIDTH = PADDED_SIZE.width;
-const HEIGHT = PADDED_SIZE.height;
-const THEME = readThemeEnv();
-const IMPRINT_PROGRESS = readUnitIntervalEnv("EVE_LOGO_RENDER_IMPRINT_PROGRESS");
-const IMPRINT_GRID_SCALE_MULTIPLIER = readPositiveNumberEnv("EVE_LOGO_IMPRINT_GRID_SCALE_MULTIPLIER", 1);
-const IMPRINT_GLYPH_SCALE = readPositiveNumberEnv("EVE_LOGO_IMPRINT_GLYPH_SCALE", 1.35);
-const REQUESTED_RENDER_STAGE = readRenderStageEnv();
-const RENDER_STAGE: EveMaterial = REQUESTED_RENDER_STAGE;
-const RENDER_YAW = readFiniteNumberEnv("EVE_LOGO_RENDER_YAW", 0);
-const MODEL_PATH = resolve(process.cwd(), "public/eve-5/eve-logo.gltf");
-const DEFAULT_CONTROLS: RenderControls = {
- yaw: RENDER_YAW,
- pitch: 0,
- radius: cameraRadiusForFov(DEFAULT_CAMERA_FOV),
- fov: DEFAULT_CAMERA_FOV,
- envYaw: 0,
- envPitch: 0,
- insideRendering: true,
- outsideRendering: true,
- material: RENDER_STAGE,
- wireframe: false,
- showEnv: false,
-};
+import { App } from "@vgpu/core";
+import { createEve5Renderer } from "../app/[lang]/(home)/components/eve-logo-shader/render";
+import { effectiveBloomStrength, readRenderConfig } from "./eve-render/config";
+import { readNoiseTimeEnv } from "./eve-render/env";
+import { loadMeshFromDisk } from "./eve-render/load-mesh";
+import { buildPaintSeed } from "./eve-render/paint-fixtures";
+import { maxFloat32 } from "./eve-render/report";
+import { renderDefaultViews } from "./eve-render/views";
async function main() {
- await mkdir(OUT_DIR, { recursive: true });
- const mesh = await loadMeshFromDisk(MODEL_PATH);
+ const config = readRenderConfig();
+ await mkdir(config.outDir, { recursive: true });
+ const mesh = await loadMeshFromDisk(config.modelPath);
const app = await App.create({ adapter: createNodeAdapter() });
let renderer: ReturnType<typeof createEve5Renderer> | undefined;
try {
- renderer = createEve5Renderer(app.device, FORMAT, mesh, {
- theme: THEME,
- paddingRadius: PADDING_RADIUS,
- bloom: BLOOM_ENABLED,
+ renderer = createEve5Renderer(app.device, config.format, mesh, {
+ theme: config.theme,
+ paddingRadius: config.paddingRadius,
+ bloom: config.bloomEnabled,
});
- const renderResult = await renderDefaultViews(renderer, app.device, DEFAULT_CONTROLS);
+ const paintSeed = buildPaintSeed(config);
+ const renderResult = await renderDefaultViews(
+ renderer,
+ app.device,
+ config,
+ config.defaultControls,
+ paintSeed,
+ );
const log = {
- runId: RUN_ID,
- outDir: OUT_DIR,
+ runId: config.runId,
+ outDir: config.outDir,
dimensions: {
- width: WIDTH,
- height: HEIGHT,
- format: FORMAT,
- theme: THEME,
- stage: RENDER_STAGE,
- requestedStage: REQUESTED_RENDER_STAGE,
+ width: config.width,
+ height: config.height,
+ format: config.format,
+ theme: config.theme,
+ stage: config.renderStage,
+ requestedStage: config.requestedRenderStage,
+ dpr: config.dpr,
+ envYaw: config.renderEnvYaw,
+ envYawTime: config.renderEnvYawTime ?? null,
},
bloom: {
- enabled: BLOOM_ENABLED,
- runtimeRadius: BLOOM_RADIUS,
- radius: PADDING_RADIUS,
- strength: BLOOM_ENABLED ? effectiveBloomStrength(IMPRINT_PROGRESS ?? 0) : 0,
- strengthOff: BLOOM_STRENGTH_OFF,
- strengthOn: BLOOM_STRENGTH_ON,
- threshold: BLOOM_THRESHOLD,
- logical: { width: LOGICAL_WIDTH, height: LOGICAL_HEIGHT },
- padded: { width: WIDTH, height: HEIGHT },
+ enabled: config.bloomEnabled,
+ runtimeRadius: config.bloomConstants.radius,
+ radius: config.paddingRadius,
+ strength: config.bloomEnabled
+ ? effectiveBloomStrength(config, config.imprintProgress ?? 0)
+ : 0,
+ strengthOff: config.bloomConstants.strengthOff,
+ strengthOn: config.bloomConstants.strengthOn,
+ threshold: config.bloomConstants.threshold,
+ logical: { width: config.logicalWidth, height: config.logicalHeight },
+ padded: { width: config.width, height: config.height },
},
imprint:
- IMPRINT_PROGRESS !== undefined
+ config.imprintProgress !== undefined
? {
enabled: true,
- progress: IMPRINT_PROGRESS,
- gridScaleMultiplier: IMPRINT_GRID_SCALE_MULTIPLIER,
- glyphScale: IMPRINT_GLYPH_SCALE,
+ progress: config.imprintProgress,
+ gridScaleMultiplier: config.imprintGridScaleMultiplier,
+ glyphScale: config.imprintGlyphScale,
noise: { time: readNoiseTimeEnv(), mouse: [0, 0] },
stage: "front-glass-material-imprint",
}
: { enabled: false },
+ paint: paintSeed
+ ? {
+ enabled: true,
+ grid: { width: paintSeed.width, height: paintSeed.height },
+ blob: process.env.EVE_LOGO_PAINT_BLOB ?? null,
+ pattern: process.env.EVE_LOGO_PAINT_PATTERN ?? null,
+ stroke: process.env.EVE_LOGO_PAINT_STROKE ?? null,
+ steps: config.paintSteps,
+ decaySteps: config.paintDecaySteps,
+ dt: config.paintDt,
+ decayPerFrame120: config.paintDecayPerFrame120,
+ decayRate: config.paintDecayRate,
+ diffusionRate: config.paintDiffusionRate,
+ diffusionJitter: config.paintDiffusionJitter,
+ brushRadius: config.paintBrushRadius,
+ brushStrength: config.paintBrushStrength,
+ seedMax: maxFloat32(paintSeed.values),
+ }
+ : { enabled: false },
mesh: {
vertices: mesh.positions.length / 3,
triangles: mesh.indices.length / 3,
@@ -140,228 +148,22 @@ async function main() {
logWithOptionalBounds.bounds = renderResult.bounds;
}
- await writeFile(resolve(OUT_DIR, "log.json"), `${JSON.stringify(log, null, 2)}\n`);
+ await writeFile(resolve(config.outDir, "log.json"), `${JSON.stringify(log, null, 2)}\n`);
console.log(JSON.stringify(log, null, 2));
- if (log.output.nonBlack === 0) process.exitCode = 1;
+ if (
+ log.output.nonBlack === 0 &&
+ log.output.alpha === 0 &&
+ !(
+ config.renderStage === "paint-debug" &&
+ (config.paintSteps > 0 || config.paintDecaySteps > 0)
+ )
+ )
+ process.exitCode = 1;
} finally {
renderer?.dispose();
app.device.destroy();
}
}
-async function renderDefaultViews(
- renderer: ReturnType<typeof createEve5Renderer>,
- device: Awaited<ReturnType<typeof App.create>>["device"],
- controls: RenderControls,
-) {
- const output = await renderView(renderer, device, controls, outputFileName(), WIDTH, HEIGHT, LOGICAL_WIDTH, LOGICAL_HEIGHT);
- await renderView(renderer, device, { ...controls, yaw: RENDER_YAW || -0.49, pitch: RENDER_YAW ? controls.pitch : 0.31 }, "rotated.png", WIDTH, HEIGHT, LOGICAL_WIDTH, LOGICAL_HEIGHT);
- await renderView(renderer, device, { ...controls, wireframe: true }, "wireframe.png", WIDTH, HEIGHT, LOGICAL_WIDTH, LOGICAL_HEIGHT);
-
- return {
- files: {
- output: outputFileName(),
- rotated: "rotated.png",
- wireframe: "wireframe.png",
- log: "log.json",
- },
- output: pixelStats(WIDTH, HEIGHT, output),
- };
-}
-
-function outputFileName() {
- return IMPRINT_PROGRESS === undefined ? "output.png" : `imprint-${formatProgressForFile(IMPRINT_PROGRESS)}.png`;
-}
-
-function effectiveBloomStrength(imprintProgress: number) {
- return BLOOM_STRENGTH_OFF + (BLOOM_STRENGTH_ON - BLOOM_STRENGTH_OFF) * imprintProgress;
-}
-
-function imprintOptions() {
- if (IMPRINT_PROGRESS === undefined) return undefined;
- return {
- progress: IMPRINT_PROGRESS,
- gridScaleMultiplier: IMPRINT_GRID_SCALE_MULTIPLIER,
- glyphScale: IMPRINT_GLYPH_SCALE,
- time: readNoiseTimeEnv(),
- mouse: [0, 0] as const,
- };
-}
-
-async function renderView(
- renderer: ReturnType<typeof createEve5Renderer>,
- device: Awaited<ReturnType<typeof App.create>>["device"],
- controls: RenderControls,
- file: string,
- width: number,
- height: number,
- logicalWidth: number,
- logicalHeight: number,
-) {
- const target = device.createTexture({
- label: `eve-5-static-${file}`,
- size: [width, height],
- format: FORMAT,
- usage: ["render_attachment", "copy_src"],
- });
- try {
- renderer.render(target.createView(), controls, logicalWidth, logicalHeight, imprintOptions());
- await device.queue.flush();
- const pixels = new Uint8Array(await target.read());
- await writePng(resolve(OUT_DIR, file), width, height, pixels);
- return pixels;
- } finally {
- target.destroy();
- }
-}
-
-async function loadMeshFromDisk(path: string) {
- const gltf = JSON.parse(await readFile(path, "utf8"));
- return decodeGltfMesh(gltf, async (uri) => {
- if (uri.startsWith("data:application/octet-stream;base64,")) {
- const [, payload] = uri.split(",");
- return exactArrayBuffer(Buffer.from(payload!, "base64"));
- }
- const bufferPath = resolve(path, "..", uri);
- return exactArrayBuffer(await readFile(bufferPath));
- });
-}
-
-function readFiniteNumberEnv(name: string, fallback: number) {
- const value = process.env[name];
- if (!value) return fallback;
- const parsed = Number.parseFloat(value);
- if (!Number.isFinite(parsed)) {
- throw new Error(`${name} must be a finite number.`);
- }
- return parsed;
-}
-
-function readPositiveIntegerEnv(name: string, fallback: number, minimumExclusive = 0) {
- const value = process.env[name];
- if (!value) return fallback;
- const parsed = Number.parseInt(value, 10);
- if (!Number.isFinite(parsed) || parsed <= minimumExclusive) {
- throw new Error(`${name} must be an integer greater than ${minimumExclusive}.`);
- }
- return parsed;
-}
-
-function readPositiveNumberEnv(name: string, fallback: number) {
- const value = process.env[name];
- if (!value) return fallback;
- const parsed = Number.parseFloat(value);
- if (!Number.isFinite(parsed) || parsed <= 0) {
- throw new Error(`${name} must be a positive number.`);
- }
- return parsed;
-}
-
-function readUnitIntervalEnv(name: string) {
- const value = process.env[name];
- if (value === undefined || value === "") return undefined;
- const parsed = Number.parseFloat(value);
- if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
- throw new Error(`${name} must be a finite number between 0 and 1.`);
- }
- return parsed;
-}
-
-function readNonNegativeIntegerEnv(name: string, fallback: number) {
- const value = process.env[name];
- if (!value) return fallback;
- const parsed = Number.parseInt(value, 10);
- if (!Number.isFinite(parsed) || parsed < 0) {
- throw new Error(`${name} must be a non-negative integer.`);
- }
- return parsed;
-}
-
-function readBooleanEnv(name: string, fallback: boolean) {
- const value = process.env[name];
- if (!value) return fallback;
- const normalized = value.toLowerCase();
- if (["1", "true", "yes", "on"].includes(normalized)) return true;
- if (["0", "false", "no", "off"].includes(normalized)) return false;
- throw new Error(`${name} must be a boolean value.`);
-}
-
-function readRenderStageEnv(): EveMaterial {
- const values: Record<string, EveMaterial> = {
- glass: "glass",
- "back-albedo": "back-albedo",
- "back-depth": "back-depth",
- thickness: "thickness",
- normal: "normal",
- "camera-reflected-normal": "camera reflected normal",
- metallic: "metallic",
- };
- const value = process.env.EVE_LOGO_RENDER_STAGE ?? "glass";
- const stage = values[value];
- if (!stage) {
- throw new Error(`EVE_LOGO_RENDER_STAGE must be one of: ${Object.keys(values).join(", ")}.`);
- }
- return stage;
-}
-
-function stageFileName(stage: EveMaterial) {
- return stage.replaceAll(" ", "-");
-}
-
-function formatProgressForFile(progress: number) {
- return progress.toFixed(3).replace(/0+$/, "").replace(/\.$/, "").replace(".", "p");
-}
-
-function readNoiseTimeEnv() {
- const value = process.env.EVE_LOGO_RENDER_NOISE_TIME;
- if (!value) return 0;
- const parsed = Number.parseFloat(value);
- if (!Number.isFinite(parsed)) {
- throw new Error("EVE_LOGO_RENDER_NOISE_TIME must be a finite number.");
- }
- return parsed;
-}
-
-function readThemeEnv(): "light" | "dark" {
- const value = process.env.EVE_LOGO_RENDER_THEME ?? "dark";
- if (value === "light" || value === "dark") return value;
- throw new Error('EVE_LOGO_RENDER_THEME must be "light" or "dark".');
-}
-
-function exactArrayBuffer(buffer: Buffer) {
- return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
-}
-
-async function writePng(path: string, width: number, height: number, pixels: Uint8Array) {
- const png = new PNG({ width, height });
- png.data.set(pixels);
- await writeFile(path, PNG.sync.write(png));
-}
-
-function pixelStats(width: number, height: number, pixels: Uint8Array) {
- let nonBlack = 0;
- let alpha = 0;
- let colored = 0;
-
- for (let index = 0; index < pixels.length; index += 4) {
- const r = pixels[index] ?? 0;
- const g = pixels[index + 1] ?? 0;
- const b = pixels[index + 2] ?? 0;
- const a = pixels[index + 3] ?? 0;
- const max = Math.max(r, g, b);
- const min = Math.min(r, g, b);
- if (max > 8) nonBlack++;
- if (a > 20) alpha++;
- if (max - min > 8 && r + g + b > 24) colored++;
- }
-
- const header = Buffer.alloc(8);
- header.writeUInt32LE(width, 0);
- header.writeUInt32LE(height, 4);
- const sha256 = createHash("sha256").update(header).update(pixels).digest("hex");
-
- return { width, height, total: width * height, nonBlack, alpha, colored, sha256 };
-}
-
await main();