create-threenative 0.2.7 → 0.2.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -1
- package/agent-docs/references/assertion-reference.md +87 -35
- package/agent-docs/references/auto-exposure.md +57 -0
- package/agent-docs/references/capability-reference.md +1306 -62
- package/agent-docs/references/debug-surface.md +6 -0
- package/agent-docs/references/finding-assets.md +46 -10
- package/agent-docs/references/performance-basics.md +5 -4
- package/agent-docs/references/terrain-authoring.md +140 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
- package/capabilities.json +1505 -79
- package/dist/index.d.ts +28 -3
- package/dist/index.js +402 -167
- package/dist/threenative.js +989 -237
- package/dist/web-engine-buffer-geometry-utils.js +281 -0
- package/dist/web-engine-decal-geometry.js +184 -0
- package/dist/web-engine-gltf-loader.js +196 -0
- package/dist/web-engine-hdr-loader.js +190 -0
- package/dist/web-engine-lut-cube-loader.js +122 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
- package/dist/web-engine-mesh-bvh.js +32 -0
- package/dist/web-engine-post-effects.js +168 -0
- package/dist/web-engine-runtime.js +42506 -0
- package/package.json +11 -8
- package/template-assets/autoExposure.ts +225 -0
- package/template-assets/exposure.ts +111 -0
- package/template-assets/exposureGraph.ts +178 -0
- package/template-assets/exposureReadback.ts +79 -0
- package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
- package/template-assets/patches/three@0.185.1.patch +6594 -700
- package/template-assets/patches/vite@8.2.0.patch +422 -0
- package/template-assets/worldEnvironment.ts +433 -30
- package/templates/action-rpg/AGENTS.md +11 -10
- package/templates/action-rpg/CLAUDE.md +11 -10
- package/templates/action-rpg/package.json +11 -9
- package/templates/action-rpg/playtests/performance.playtest.json +7 -1
- package/templates/action-rpg/src/progress.ts +0 -4
- package/templates/action-rpg/src/render/autoExposure.ts +225 -0
- package/templates/action-rpg/src/render/backlightControls.ts +66 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
- package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
- package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
- package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
- package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
- package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
- package/templates/action-rpg/src/render/exposure.ts +111 -0
- package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
- package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
- package/templates/action-rpg/src/render/heightFog.ts +118 -0
- package/templates/action-rpg/src/render/lighting.ts +26 -1
- package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
- package/templates/action-rpg/src/render/materialLighting.ts +155 -0
- package/templates/action-rpg/src/render/postprocessing.ts +17 -2
- package/templates/action-rpg/src/render/quality.ts +61 -2
- package/templates/action-rpg/src/render/sky.ts +21 -1
- package/templates/action-rpg/src/render/vfx.ts +133 -58
- package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
- package/templates/action-rpg/src/scenes/Play.ts +81 -16
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/action-rpg/vite.config.ts +10 -2
- package/templates/minimal/AGENTS.md +9 -10
- package/templates/minimal/CLAUDE.md +9 -10
- package/templates/minimal/package.json +9 -8
- package/templates/minimal/playtests/play.playtest.json +7 -1
- package/templates/minimal/playtests/sky.playtest.json +10 -1
- package/templates/minimal/src/render/autoExposure.ts +225 -0
- package/templates/minimal/src/render/backlightControls.ts +66 -0
- package/templates/minimal/src/render/backlightMaterial.ts +147 -0
- package/templates/minimal/src/render/environmentContribution.ts +188 -0
- package/templates/minimal/src/render/environmentRadiance.ts +36 -0
- package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
- package/templates/minimal/src/render/environmentSampling.ts +193 -0
- package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
- package/templates/minimal/src/render/exposure.ts +111 -0
- package/templates/minimal/src/render/exposureGraph.ts +178 -0
- package/templates/minimal/src/render/exposureReadback.ts +79 -0
- package/templates/minimal/src/render/heightFog.ts +118 -0
- package/templates/minimal/src/render/lighting.ts +25 -1
- package/templates/minimal/src/render/materialAssignments.ts +102 -0
- package/templates/minimal/src/render/materialLighting.ts +146 -0
- package/templates/minimal/src/render/postprocessing.ts +16 -2
- package/templates/minimal/src/render/quality.ts +60 -2
- package/templates/minimal/src/render/sky.ts +21 -1
- package/templates/minimal/src/render/worldEnvironment.ts +433 -30
- package/templates/minimal/src/scenes/Play.ts +50 -1
- package/templates/minimal/vite.config.ts +10 -2
- package/templates/platformer/AGENTS.md +7 -5
- package/templates/platformer/CLAUDE.md +7 -5
- package/templates/platformer/package.json +11 -9
- package/templates/platformer/playtests/performance.playtest.json +7 -1
- package/templates/platformer/src/render/autoExposure.ts +225 -0
- package/templates/platformer/src/render/backlightControls.ts +66 -0
- package/templates/platformer/src/render/backlightMaterial.ts +147 -0
- package/templates/platformer/src/render/environmentContribution.ts +188 -0
- package/templates/platformer/src/render/environmentRadiance.ts +36 -0
- package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
- package/templates/platformer/src/render/environmentSampling.ts +193 -0
- package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
- package/templates/platformer/src/render/exposure.ts +111 -0
- package/templates/platformer/src/render/exposureGraph.ts +178 -0
- package/templates/platformer/src/render/exposureReadback.ts +79 -0
- package/templates/platformer/src/render/heightFog.ts +118 -0
- package/templates/platformer/src/render/lighting.ts +26 -1
- package/templates/platformer/src/render/materialAssignments.ts +160 -0
- package/templates/platformer/src/render/materialLighting.ts +155 -0
- package/templates/platformer/src/render/materials.ts +7 -2
- package/templates/platformer/src/render/palette.ts +3 -3
- package/templates/platformer/src/render/postprocessing.ts +17 -2
- package/templates/platformer/src/render/quality.ts +61 -2
- package/templates/platformer/src/render/sky.ts +72 -23
- package/templates/platformer/src/render/skyEnvironment.ts +50 -0
- package/templates/platformer/src/render/worldEnvironment.ts +433 -30
- package/templates/platformer/src/scenes/Play.ts +70 -6
- package/templates/platformer/vite.config.ts +10 -2
- package/templates/puzzle/AGENTS.md +10 -9
- package/templates/puzzle/CLAUDE.md +10 -9
- package/templates/puzzle/package.json +11 -9
- package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
- package/templates/puzzle/playtests/lit.playtest.json +7 -1
- package/templates/puzzle/playtests/performance.playtest.json +7 -1
- package/templates/puzzle/src/render/autoExposure.ts +225 -0
- package/templates/puzzle/src/render/backlightControls.ts +66 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
- package/templates/puzzle/src/render/environmentContribution.ts +188 -0
- package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
- package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
- package/templates/puzzle/src/render/environmentSampling.ts +193 -0
- package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
- package/templates/puzzle/src/render/exposure.ts +111 -0
- package/templates/puzzle/src/render/exposureGraph.ts +178 -0
- package/templates/puzzle/src/render/exposureReadback.ts +79 -0
- package/templates/puzzle/src/render/heightFog.ts +118 -0
- package/templates/puzzle/src/render/lighting.ts +33 -1
- package/templates/puzzle/src/render/materialAssignments.ts +160 -0
- package/templates/puzzle/src/render/materialLighting.ts +155 -0
- package/templates/puzzle/src/render/materials.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +8 -2
- package/templates/puzzle/src/render/quality.ts +62 -1
- package/templates/puzzle/src/render/sky.ts +20 -1
- package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
- package/templates/puzzle/src/scenes/Play.ts +51 -2
- package/templates/puzzle/vite.config.ts +10 -2
- package/templates/racing/AGENTS.md +8 -7
- package/templates/racing/CLAUDE.md +8 -7
- package/templates/racing/package.json +11 -9
- package/templates/racing/playtests/performance.playtest.json +7 -1
- package/templates/racing/playtests/survives.playtest.json +6 -0
- package/templates/racing/src/render/autoExposure.ts +225 -0
- package/templates/racing/src/render/backlightControls.ts +66 -0
- package/templates/racing/src/render/backlightMaterial.ts +147 -0
- package/templates/racing/src/render/environmentContribution.ts +188 -0
- package/templates/racing/src/render/environmentRadiance.ts +36 -0
- package/templates/racing/src/render/environmentSampleCache.ts +43 -0
- package/templates/racing/src/render/environmentSampling.ts +193 -0
- package/templates/racing/src/render/environmentSnapshot.ts +53 -0
- package/templates/racing/src/render/exposure.ts +111 -0
- package/templates/racing/src/render/exposureGraph.ts +178 -0
- package/templates/racing/src/render/exposureReadback.ts +79 -0
- package/templates/racing/src/render/heightFog.ts +118 -0
- package/templates/racing/src/render/lighting.ts +29 -1
- package/templates/racing/src/render/materialAssignments.ts +160 -0
- package/templates/racing/src/render/materialLighting.ts +155 -0
- package/templates/racing/src/render/palette.ts +1 -10
- package/templates/racing/src/render/postprocessing.ts +17 -2
- package/templates/racing/src/render/quality.ts +61 -2
- package/templates/racing/src/render/shapes.ts +0 -25
- package/templates/racing/src/render/sky.ts +21 -1
- package/templates/racing/src/render/worldEnvironment.ts +433 -30
- package/templates/racing/src/scenes/Race.ts +91 -3
- package/templates/racing/src/track/circuit.ts +0 -9
- package/templates/racing/vite.config.ts +10 -2
- package/templates/rain/.codex/config.toml +19 -0
- package/templates/rain/.cursor/mcp.json +32 -0
- package/templates/rain/.gemini/settings.json +32 -0
- package/templates/rain/.mcp.json +32 -0
- package/templates/rain/.vscode/mcp.json +36 -0
- package/templates/rain/.zed/settings.json +36 -0
- package/templates/rain/AGENTS.md +95 -0
- package/templates/rain/CLAUDE.md +97 -0
- package/templates/rain/assets/rain-loop.wav +0 -0
- package/templates/rain/assets/thunder.wav +0 -0
- package/templates/rain/assets/wind-loop.wav +0 -0
- package/templates/rain/index.html +18 -0
- package/templates/rain/kit.json +7 -0
- package/templates/rain/native-playtests/boot.playtest.json +23 -0
- package/templates/rain/native-playtests/lightning.playtest.json +173 -0
- package/templates/rain/opencode.json +41 -0
- package/templates/rain/package.json +59 -0
- package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
- package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
- package/templates/rain/playtests/automation.playtest.json +133 -0
- package/templates/rain/playtests/cinematic.playtest.json +59 -0
- package/templates/rain/playtests/flash.playtest.json +27 -0
- package/templates/rain/playtests/fly.playtest.json +54 -0
- package/templates/rain/playtests/lightning.playtest.json +220 -0
- package/templates/rain/playtests/loading.playtest.json +57 -0
- package/templates/rain/playtests/paused.playtest.json +59 -0
- package/templates/rain/playtests/performance.playtest.json +32 -0
- package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
- package/templates/rain/playtests/simulation.playtest.json +20 -0
- package/templates/rain/playtests/storm.playtest.json +150 -0
- package/templates/rain/playtests/survives.playtest.json +58 -0
- package/templates/rain/playtests/tiers.playtest.json +194 -0
- package/templates/rain/playtests/weather.playtest.json +77 -0
- package/templates/rain/public/favicon.svg +5 -0
- package/templates/rain/src/audio/storm.ts +314 -0
- package/templates/rain/src/game.ts +81 -0
- package/templates/rain/src/main.ts +15 -0
- package/templates/rain/src/render/autoExposure.ts +225 -0
- package/templates/rain/src/render/bloom-shader.ts +65 -0
- package/templates/rain/src/render/camera.ts +160 -0
- package/templates/rain/src/render/clouds-shader.ts +242 -0
- package/templates/rain/src/render/clouds.ts +142 -0
- package/templates/rain/src/render/exposure.ts +111 -0
- package/templates/rain/src/render/exposureGraph.ts +178 -0
- package/templates/rain/src/render/exposureReadback.ts +79 -0
- package/templates/rain/src/render/lighting.ts +39 -0
- package/templates/rain/src/render/lightning.ts +360 -0
- package/templates/rain/src/render/loading.ts +327 -0
- package/templates/rain/src/render/materials.ts +19 -0
- package/templates/rain/src/render/noise-volume.ts +159 -0
- package/templates/rain/src/render/palette.ts +18 -0
- package/templates/rain/src/render/post-shader.ts +178 -0
- package/templates/rain/src/render/postprocessing.ts +229 -0
- package/templates/rain/src/render/quality.ts +161 -0
- package/templates/rain/src/render/rain.ts +299 -0
- package/templates/rain/src/render/sky.ts +28 -0
- package/templates/rain/src/render/world-shader.ts +680 -0
- package/templates/rain/src/render/world.ts +146 -0
- package/templates/rain/src/render/worldEnvironment.ts +1212 -0
- package/templates/rain/src/scenes/Boot.ts +348 -0
- package/templates/rain/src/state.ts +261 -0
- package/templates/rain/src/style.css +1160 -0
- package/templates/rain/src/ui/App.tsx +29 -0
- package/templates/rain/src/ui/GameUi.tsx +187 -0
- package/templates/rain/src/ui/Hud.tsx +327 -0
- package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
- package/templates/rain/src/ui/Menu.tsx +370 -0
- package/templates/rain/src/ui/automation.ts +60 -0
- package/templates/rain/src/ui/main.tsx +7 -0
- package/templates/rain/src/ui/tempest.ts +149 -0
- package/templates/rain/tailwind.config.ts +2 -0
- package/templates/rain/threenative.config.ts +66 -0
- package/templates/rain/tools/generate-shaders.mjs +656 -0
- package/templates/rain/tools/make-storm-audio.mjs +387 -0
- package/templates/rain/tools/storm-dsp.mjs +177 -0
- package/templates/rain/tools/tempest-bloom.frag +10 -0
- package/templates/rain/tools/tempest-clouds.frag +86 -0
- package/templates/rain/tools/tempest-post.frag +47 -0
- package/templates/rain/tools/tempest-world.frag +210 -0
- package/templates/rain/tools/verify-noise-volume.mjs +61 -0
- package/templates/rain/tsconfig.json +17 -0
- package/templates/rain/vite.config.ts +45 -0
- package/templates/rts/AGENTS.md +10 -11
- package/templates/rts/CLAUDE.md +10 -11
- package/templates/rts/package.json +10 -8
- package/templates/rts/playtests/performance.playtest.json +7 -1
- package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-build.playtest.json +10 -1
- package/templates/rts/playtests/rts-orders.playtest.json +7 -1
- package/templates/rts/playtests/rts-train.playtest.json +10 -1
- package/templates/rts/src/render/army.ts +10 -2
- package/templates/rts/src/render/autoExposure.ts +225 -0
- package/templates/rts/src/render/backlightControls.ts +66 -0
- package/templates/rts/src/render/backlightMaterial.ts +147 -0
- package/templates/rts/src/render/environmentContribution.ts +188 -0
- package/templates/rts/src/render/environmentRadiance.ts +36 -0
- package/templates/rts/src/render/environmentSampleCache.ts +43 -0
- package/templates/rts/src/render/environmentSampling.ts +193 -0
- package/templates/rts/src/render/environmentSnapshot.ts +53 -0
- package/templates/rts/src/render/exposure.ts +111 -0
- package/templates/rts/src/render/exposureGraph.ts +178 -0
- package/templates/rts/src/render/exposureReadback.ts +79 -0
- package/templates/rts/src/render/heightFog.ts +118 -0
- package/templates/rts/src/render/lighting.ts +26 -1
- package/templates/rts/src/render/materialAssignments.ts +160 -0
- package/templates/rts/src/render/materialLighting.ts +155 -0
- package/templates/rts/src/render/postprocessing.ts +8 -2
- package/templates/rts/src/render/quality.ts +61 -2
- package/templates/rts/src/render/sky.ts +21 -1
- package/templates/rts/src/render/worldEnvironment.ts +433 -30
- package/templates/rts/src/scenes/Play.ts +54 -3
- package/templates/rts/src/sim/ai.ts +0 -1
- package/templates/rts/src/sim/terrain.ts +0 -4
- package/templates/rts/vite.config.ts +10 -2
- package/templates/runner/AGENTS.md +10 -8
- package/templates/runner/CLAUDE.md +10 -8
- package/templates/runner/package.json +11 -9
- package/templates/runner/playtests/performance.playtest.json +10 -1
- package/templates/runner/src/physics.ts +0 -1
- package/templates/runner/src/render/autoExposure.ts +225 -0
- package/templates/runner/src/render/backlightControls.ts +66 -0
- package/templates/runner/src/render/backlightMaterial.ts +147 -0
- package/templates/runner/src/render/environmentContribution.ts +188 -0
- package/templates/runner/src/render/environmentRadiance.ts +36 -0
- package/templates/runner/src/render/environmentSampleCache.ts +43 -0
- package/templates/runner/src/render/environmentSampling.ts +193 -0
- package/templates/runner/src/render/environmentSnapshot.ts +53 -0
- package/templates/runner/src/render/exposure.ts +111 -0
- package/templates/runner/src/render/exposureGraph.ts +178 -0
- package/templates/runner/src/render/exposureReadback.ts +79 -0
- package/templates/runner/src/render/heightFog.ts +118 -0
- package/templates/runner/src/render/lighting.ts +26 -1
- package/templates/runner/src/render/materialAssignments.ts +160 -0
- package/templates/runner/src/render/materialLighting.ts +155 -0
- package/templates/runner/src/render/postprocessing.ts +17 -2
- package/templates/runner/src/render/quality.ts +61 -2
- package/templates/runner/src/render/sky.ts +21 -1
- package/templates/runner/src/render/worldEnvironment.ts +433 -30
- package/templates/runner/src/scenes/Run.ts +67 -2
- package/templates/runner/threenative.config.ts +3 -0
- package/templates/runner/vite.config.ts +10 -2
- package/templates/sailing/AGENTS.md +14 -13
- package/templates/sailing/CLAUDE.md +14 -13
- package/templates/sailing/native-playtests/survives.playtest.json +7 -0
- package/templates/sailing/package.json +11 -9
- package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
- package/templates/sailing/src/entities/Ship.ts +38 -18
- package/templates/sailing/src/render/autoExposure.ts +225 -0
- package/templates/sailing/src/render/backlightControls.ts +66 -0
- package/templates/sailing/src/render/backlightMaterial.ts +147 -0
- package/templates/sailing/src/render/camera.ts +12 -4
- package/templates/sailing/src/render/environmentContribution.ts +188 -0
- package/templates/sailing/src/render/environmentRadiance.ts +36 -0
- package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
- package/templates/sailing/src/render/environmentSampling.ts +193 -0
- package/templates/sailing/src/render/environmentSetup.ts +24 -0
- package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
- package/templates/sailing/src/render/exposure.ts +111 -0
- package/templates/sailing/src/render/exposureGraph.ts +178 -0
- package/templates/sailing/src/render/exposureReadback.ts +79 -0
- package/templates/sailing/src/render/heightFog.ts +118 -0
- package/templates/sailing/src/render/lighting.ts +26 -1
- package/templates/sailing/src/render/materialAssignments.ts +160 -0
- package/templates/sailing/src/render/materialLighting.ts +155 -0
- package/templates/sailing/src/render/ocean.ts +71 -53
- package/templates/sailing/src/render/postprocessing.ts +16 -2
- package/templates/sailing/src/render/props.ts +0 -45
- package/templates/sailing/src/render/quality.ts +61 -1
- package/templates/sailing/src/render/sky.ts +21 -1
- package/templates/sailing/src/render/worldEnvironment.ts +433 -30
- package/templates/sailing/src/scenes/Boot.ts +12 -1
- package/templates/sailing/src/scenes/Sailing.ts +87 -2
- package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
- package/templates/sailing/threenative.config.ts +3 -0
- package/templates/sailing/vite.config.ts +10 -2
- package/templates/shooter/AGENTS.md +8 -6
- package/templates/shooter/CLAUDE.md +8 -6
- package/templates/shooter/package.json +11 -9
- package/templates/shooter/playtests/performance.playtest.json +7 -1
- package/templates/shooter/src/entities/Enemy.ts +0 -15
- package/templates/shooter/src/entities/Rifle.ts +38 -1
- package/templates/shooter/src/render/autoExposure.ts +225 -0
- package/templates/shooter/src/render/backlightControls.ts +66 -0
- package/templates/shooter/src/render/backlightMaterial.ts +147 -0
- package/templates/shooter/src/render/camera.ts +1 -12
- package/templates/shooter/src/render/decals.ts +299 -5
- package/templates/shooter/src/render/environmentContribution.ts +188 -0
- package/templates/shooter/src/render/environmentRadiance.ts +36 -0
- package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
- package/templates/shooter/src/render/environmentSampling.ts +193 -0
- package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
- package/templates/shooter/src/render/exposure.ts +111 -0
- package/templates/shooter/src/render/exposureGraph.ts +178 -0
- package/templates/shooter/src/render/exposureReadback.ts +79 -0
- package/templates/shooter/src/render/gunfx.ts +0 -1
- package/templates/shooter/src/render/heightFog.ts +118 -0
- package/templates/shooter/src/render/lighting.ts +26 -1
- package/templates/shooter/src/render/materialAssignments.ts +160 -0
- package/templates/shooter/src/render/materialLighting.ts +155 -0
- package/templates/shooter/src/render/postprocessing.ts +17 -2
- package/templates/shooter/src/render/quality.ts +61 -2
- package/templates/shooter/src/render/scale.ts +2 -93
- package/templates/shooter/src/render/sky.ts +21 -1
- package/templates/shooter/src/render/vehicles.ts +0 -17
- package/templates/shooter/src/render/worldEnvironment.ts +433 -30
- package/templates/shooter/src/scenes/Play.ts +64 -2
- package/templates/shooter/vite.config.ts +10 -2
- package/templates/snow/.codex/config.toml +19 -0
- package/templates/snow/.cursor/mcp.json +32 -0
- package/templates/snow/.gemini/settings.json +32 -0
- package/templates/snow/.mcp.json +32 -0
- package/templates/snow/.vscode/mcp.json +36 -0
- package/templates/snow/.zed/settings.json +36 -0
- package/templates/snow/AGENTS.md +90 -0
- package/templates/snow/CLAUDE.md +92 -0
- package/templates/snow/README.md +26 -0
- package/templates/snow/assets/crunch.wav +0 -0
- package/templates/snow/assets/wind.wav +0 -0
- package/templates/snow/index.html +12 -0
- package/templates/snow/kit.json +7 -0
- package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
- package/templates/snow/native-playtests/survives.playtest.json +47 -0
- package/templates/snow/opencode.json +41 -0
- package/templates/snow/package.json +60 -0
- package/templates/snow/playtests/footsteps.playtest.json +95 -0
- package/templates/snow/playtests/performance.playtest.json +36 -0
- package/templates/snow/playtests/snow-physics.playtest.json +154 -0
- package/templates/snow/playtests/survives.playtest.json +56 -0
- package/templates/snow/playtests/touch-controls.playtest.json +71 -0
- package/templates/snow/playtests/weather.playtest.json +119 -0
- package/templates/snow/public/favicon.svg +5 -0
- package/templates/snow/src/audio.ts +58 -0
- package/templates/snow/src/commands.ts +8 -0
- package/templates/snow/src/entities/Explorer.ts +279 -0
- package/templates/snow/src/game.ts +69 -0
- package/templates/snow/src/main.ts +15 -0
- package/templates/snow/src/render/autoExposure.ts +225 -0
- package/templates/snow/src/render/backlightControls.ts +66 -0
- package/templates/snow/src/render/backlightMaterial.ts +147 -0
- package/templates/snow/src/render/bootPrint.ts +50 -0
- package/templates/snow/src/render/camera.ts +84 -0
- package/templates/snow/src/render/environmentContribution.ts +188 -0
- package/templates/snow/src/render/environmentRadiance.ts +36 -0
- package/templates/snow/src/render/environmentSampleCache.ts +43 -0
- package/templates/snow/src/render/environmentSampling.ts +193 -0
- package/templates/snow/src/render/environmentSnapshot.ts +53 -0
- package/templates/snow/src/render/explorer.ts +321 -0
- package/templates/snow/src/render/exposure.ts +111 -0
- package/templates/snow/src/render/exposureGraph.ts +178 -0
- package/templates/snow/src/render/exposureReadback.ts +79 -0
- package/templates/snow/src/render/heightFog.ts +118 -0
- package/templates/snow/src/render/lighting.ts +82 -0
- package/templates/snow/src/render/loading.ts +325 -0
- package/templates/snow/src/render/materialAssignments.ts +160 -0
- package/templates/snow/src/render/materialLighting.ts +155 -0
- package/templates/snow/src/render/materials.ts +36 -0
- package/templates/snow/src/render/palette.ts +17 -0
- package/templates/snow/src/render/postprocessing.ts +58 -0
- package/templates/snow/src/render/props.ts +42 -0
- package/templates/snow/src/render/quality.ts +193 -0
- package/templates/snow/src/render/scenery.ts +244 -0
- package/templates/snow/src/render/sky.ts +76 -0
- package/templates/snow/src/render/snowSurface.ts +259 -0
- package/templates/snow/src/render/touch-controls.ts +143 -0
- package/templates/snow/src/render/weather.ts +279 -0
- package/templates/snow/src/render/worldEnvironment.ts +1212 -0
- package/templates/snow/src/scenes/Boot.ts +12 -0
- package/templates/snow/src/scenes/Snow.ts +663 -0
- package/templates/snow/src/state.ts +46 -0
- package/templates/snow/src/style.css +143 -0
- package/templates/snow/src/terrain.ts +64 -0
- package/templates/snow/src/ui/App.tsx +15 -0
- package/templates/snow/src/ui/Controls.tsx +322 -0
- package/templates/snow/src/ui/GameUi.tsx +354 -0
- package/templates/snow/src/ui/icons.tsx +54 -0
- package/templates/snow/src/ui/main.tsx +7 -0
- package/templates/snow/tailwind.config.ts +2 -0
- package/templates/snow/threenative.config.ts +54 -0
- package/templates/snow/tsconfig.json +17 -0
- package/templates/snow/vite.config.ts +45 -0
- package/templates/starter/AGENTS.md +11 -16
- package/templates/starter/CLAUDE.md +11 -16
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
- package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
- package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
- package/templates/starter/package.json +11 -9
- package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
- package/templates/starter/playtests/movement.playtest.json +192 -0
- package/templates/starter/playtests/play.playtest.json +18 -2
- package/templates/starter/playtests/production-readiness.playtest.json +1 -1
- package/templates/starter/public/grade.cube +735 -0
- package/templates/starter/src/entities/Crate.ts +4 -0
- package/templates/starter/src/entities/Player.ts +79 -18
- package/templates/starter/src/game.ts +1 -0
- package/templates/starter/src/render/adaptiveQuality.ts +28 -41
- package/templates/starter/src/render/autoExposure.ts +225 -0
- package/templates/starter/src/render/backlightControls.ts +66 -0
- package/templates/starter/src/render/backlightMaterial.ts +147 -0
- package/templates/starter/src/render/environmentContribution.ts +188 -0
- package/templates/starter/src/render/environmentRadiance.ts +36 -0
- package/templates/starter/src/render/environmentSampleCache.ts +43 -0
- package/templates/starter/src/render/environmentSampling.ts +193 -0
- package/templates/starter/src/render/environmentSnapshot.ts +53 -0
- package/templates/starter/src/render/exposure.ts +111 -0
- package/templates/starter/src/render/exposureGraph.ts +178 -0
- package/templates/starter/src/render/exposureReadback.ts +79 -0
- package/templates/starter/src/render/grade.ts +157 -0
- package/templates/starter/src/render/heightFog.ts +118 -0
- package/templates/starter/src/render/lighting.ts +26 -1
- package/templates/starter/src/render/materialAssignments.ts +160 -0
- package/templates/starter/src/render/materialLighting.ts +155 -0
- package/templates/starter/src/render/postprocessing.ts +84 -4
- package/templates/starter/src/render/quality.ts +80 -8
- package/templates/starter/src/render/qualityPolicy.ts +54 -0
- package/templates/starter/src/render/rendererGate.ts +36 -0
- package/templates/starter/src/render/sky.ts +23 -1
- package/templates/starter/src/render/temporalAA.ts +197 -0
- package/templates/starter/src/render/temporalAAFrame.ts +179 -0
- package/templates/starter/src/render/temporalAAHooks.ts +101 -0
- package/templates/starter/src/render/temporalAAInput.ts +56 -0
- package/templates/starter/src/render/temporalAAResolve.ts +65 -0
- package/templates/starter/src/render/temporalAAStage.ts +76 -0
- package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
- package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
- package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
- package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
- package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
- package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
- package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
- package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
- package/templates/starter/src/render/temporalResolve.ts +139 -0
- package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
- package/templates/starter/src/render/temporalResolveMath.ts +196 -0
- package/templates/starter/src/render/volumetricFog.ts +124 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
- package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
- package/templates/starter/src/render/worldEnvironment.ts +433 -30
- package/templates/starter/src/scenes/Play.ts +110 -1
- package/templates/starter/src/state.ts +1 -0
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/ui/Menu.tsx +1 -1
- package/templates/starter/tools/make-grade-lut.mjs +101 -0
- package/templates/starter/vite.config.ts +10 -2
- package/templates/tower-defense/AGENTS.md +10 -9
- package/templates/tower-defense/CLAUDE.md +10 -9
- package/templates/tower-defense/package.json +11 -9
- package/templates/tower-defense/playtests/performance.playtest.json +7 -1
- package/templates/tower-defense/src/render/autoExposure.ts +225 -0
- package/templates/tower-defense/src/render/backlightControls.ts +66 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
- package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
- package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
- package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
- package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
- package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
- package/templates/tower-defense/src/render/exposure.ts +111 -0
- package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
- package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
- package/templates/tower-defense/src/render/lighting.ts +33 -1
- package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
- package/templates/tower-defense/src/render/materialLighting.ts +155 -0
- package/templates/tower-defense/src/render/postprocessing.ts +8 -2
- package/templates/tower-defense/src/render/quality.ts +61 -2
- package/templates/tower-defense/src/render/shapes.ts +0 -3
- package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
- package/templates/tower-defense/src/scenes/Battle.ts +65 -2
- package/templates/tower-defense/vite.config.ts +10 -2
- package/templates/minimal/src/scenes/Boot.ts +0 -5
|
@@ -0,0 +1,387 @@
|
|
|
1
|
+
// Bakes the reference study's `StormAudio` into the committed clips `src/audio/storm.ts` plays.
|
|
2
|
+
//
|
|
3
|
+
// node tools/make-storm-audio.mjs # write assets/*.wav and self-check them
|
|
4
|
+
// node tools/make-storm-audio.mjs --verify <file> # also prove the constants match that source
|
|
5
|
+
//
|
|
6
|
+
// The bake is deterministic: one seeded generator, no clock, no environment, no arguments. Two
|
|
7
|
+
// runs produce byte-identical files, and the self-check below is what makes that a fact rather
|
|
8
|
+
// than a hope — it re-runs the whole bake and compares hashes.
|
|
9
|
+
//
|
|
10
|
+
// `--verify` takes a copy of the reference study. It re-reads the constants out of that file and
|
|
11
|
+
// refuses to run if any of them has drifted from the transcription in `storm-dsp.mjs`, so this
|
|
12
|
+
// file cannot quietly stop being the source. It is optional only because the reference is not
|
|
13
|
+
// vendored into this repository.
|
|
14
|
+
|
|
15
|
+
import { createHash } from "node:crypto";
|
|
16
|
+
import { readFileSync, writeFileSync } from "node:fs";
|
|
17
|
+
import path from "node:path";
|
|
18
|
+
import { fileURLToPath } from "node:url";
|
|
19
|
+
import {
|
|
20
|
+
LOOPS,
|
|
21
|
+
LOOP_SECONDS,
|
|
22
|
+
STORM_SEED,
|
|
23
|
+
THUNDER_SECONDS,
|
|
24
|
+
biquad,
|
|
25
|
+
filterLoop,
|
|
26
|
+
loopBody,
|
|
27
|
+
mulberry32,
|
|
28
|
+
thunderBody,
|
|
29
|
+
} from "./storm-dsp.mjs";
|
|
30
|
+
|
|
31
|
+
/** Committed at 44.1 kHz stereo, float32 — see `encodeWav` for why not 16-bit. */
|
|
32
|
+
const SAMPLE_RATE = 44100;
|
|
33
|
+
const CHANNELS = 2;
|
|
34
|
+
const BITS = 32;
|
|
35
|
+
const BYTES_PER_SAMPLE = BITS / 8;
|
|
36
|
+
const BLOCK_ALIGN = CHANNELS * BYTES_PER_SAMPLE;
|
|
37
|
+
const WAVE_FORMAT_IEEE_FLOAT = 3;
|
|
38
|
+
|
|
39
|
+
const ASSETS = {
|
|
40
|
+
rain: { file: "rain-loop.wav", label: "rain hiss" },
|
|
41
|
+
wind: { file: "wind-loop.wav", label: "wind bed" },
|
|
42
|
+
thunder: { file: "thunder.wav", label: "thunder" },
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
const here = path.dirname(fileURLToPath(import.meta.url));
|
|
46
|
+
const assetsDir = path.resolve(here, "..", "assets");
|
|
47
|
+
|
|
48
|
+
function usage() {
|
|
49
|
+
console.log("usage: node tools/make-storm-audio.mjs [--verify <tempest.html>]");
|
|
50
|
+
process.exit(2);
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* Minimal float32 RIFF/WAVE writer: `fmt ` then `data`, which is what `THREE.AudioLoader` parses
|
|
55
|
+
* and what the asset compiler re-conditions on cook. No LIST or timestamp chunk, so the bytes
|
|
56
|
+
* depend on the samples and nothing else.
|
|
57
|
+
*
|
|
58
|
+
* **Float32, not 16-bit PCM.** The source ran these bodies in a `Float32Array` AudioBuffer and
|
|
59
|
+
* mixed them through gain nodes afterwards, so a loop is allowed to peak above full scale: wind is
|
|
60
|
+
* `pink * 4`, and after its 35..350 Hz band the committed loop still peaks at 1.05, which the
|
|
61
|
+
* source's own `.02 + wind * .18 *` node then brought down to at most .2. A 16-bit file cannot hold
|
|
62
|
+
* that — 0.012% of its samples were pinned to ±1.0 and the loudest transient of the loop was
|
|
63
|
+
* flattened into a clipped plateau. Every consumer of these files reads the format rather than
|
|
64
|
+
* guessing it: `@threenative/assets`' decoder takes `format 3` at 32 bits as `readFloatLE`, the
|
|
65
|
+
* native host's `SDL_LoadWAV_IO` path takes the `SDL_AUDIO_F32` branch, and `decodeAudioData`
|
|
66
|
+
* scales only integer PCM.
|
|
67
|
+
*/
|
|
68
|
+
function encodeWav(channels) {
|
|
69
|
+
const frames = channels[0].length;
|
|
70
|
+
const dataBytes = frames * BLOCK_ALIGN;
|
|
71
|
+
const buffer = Buffer.alloc(44 + dataBytes);
|
|
72
|
+
buffer.write("RIFF", 0, "ascii");
|
|
73
|
+
buffer.writeUInt32LE(36 + dataBytes, 4);
|
|
74
|
+
buffer.write("WAVE", 8, "ascii");
|
|
75
|
+
buffer.write("fmt ", 12, "ascii");
|
|
76
|
+
buffer.writeUInt32LE(16, 16);
|
|
77
|
+
buffer.writeUInt16LE(WAVE_FORMAT_IEEE_FLOAT, 20);
|
|
78
|
+
buffer.writeUInt16LE(CHANNELS, 22);
|
|
79
|
+
buffer.writeUInt32LE(SAMPLE_RATE, 24);
|
|
80
|
+
buffer.writeUInt32LE(SAMPLE_RATE * BLOCK_ALIGN, 28);
|
|
81
|
+
buffer.writeUInt16LE(BLOCK_ALIGN, 32);
|
|
82
|
+
buffer.writeUInt16LE(BITS, 34);
|
|
83
|
+
buffer.write("data", 36, "ascii");
|
|
84
|
+
buffer.writeUInt32LE(dataBytes, 40);
|
|
85
|
+
let offset = 44;
|
|
86
|
+
for (let i = 0; i < frames; i += 1) {
|
|
87
|
+
for (let c = 0; c < CHANNELS; c += 1) {
|
|
88
|
+
buffer.writeFloatLE(channels[c][i], offset);
|
|
89
|
+
offset += 4;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
return buffer;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** One seeded draw, so the three clips come out of one stream exactly as the source did. */
|
|
96
|
+
function bake() {
|
|
97
|
+
const rng = mulberry32(STORM_SEED);
|
|
98
|
+
const rain = loopBody({ band: LOOPS.rain, sampleRate: SAMPLE_RATE, rng });
|
|
99
|
+
const wind = loopBody({ band: LOOPS.wind, sampleRate: SAMPLE_RATE, rng });
|
|
100
|
+
const thunder = thunderBody({ sampleRate: SAMPLE_RATE, rng });
|
|
101
|
+
// The source filtered live; the filter has to live in the file now. Same two biquads, same
|
|
102
|
+
// frequencies, same Q.
|
|
103
|
+
for (const [band, channels] of [
|
|
104
|
+
[LOOPS.rain, rain],
|
|
105
|
+
[LOOPS.wind, wind],
|
|
106
|
+
]) {
|
|
107
|
+
const highpass = biquad("highpass", band.highpassHz, SAMPLE_RATE);
|
|
108
|
+
const lowpass = biquad("lowpass", band.lowpassHz, SAMPLE_RATE);
|
|
109
|
+
for (let c = 0; c < CHANNELS; c += 1)
|
|
110
|
+
channels[c] = filterLoop(filterLoop(channels[c], highpass), lowpass);
|
|
111
|
+
}
|
|
112
|
+
return {
|
|
113
|
+
rain: { bytes: encodeWav(rain), samples: rain },
|
|
114
|
+
thunder: { bytes: encodeWav(thunder), samples: thunder },
|
|
115
|
+
wind: { bytes: encodeWav(wind), samples: wind },
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
// --- the checks -----------------------------------------------------------------------------
|
|
120
|
+
|
|
121
|
+
function fail(what) {
|
|
122
|
+
throw new Error(`TN_STORM_AUDIO_INVALID: ${what}`);
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
function assert(what, condition) {
|
|
126
|
+
if (!condition) fail(what);
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** Peak and RMS of one decoded channel, plus the NaN/infinity count. */
|
|
130
|
+
function measure(samples) {
|
|
131
|
+
let peak = 0;
|
|
132
|
+
let sum = 0;
|
|
133
|
+
let bad = 0;
|
|
134
|
+
for (const value of samples) {
|
|
135
|
+
if (!Number.isFinite(value)) bad += 1;
|
|
136
|
+
else if (Math.abs(value) > peak) peak = Math.abs(value);
|
|
137
|
+
sum += value * value;
|
|
138
|
+
}
|
|
139
|
+
return { bad, peak, rms: Math.sqrt(sum / samples.length) };
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/**
|
|
143
|
+
* Normalised autocorrelation at one lag — the check that the baked filters are the source's bands
|
|
144
|
+
* and not a name on a white-noise file.
|
|
145
|
+
*
|
|
146
|
+
* A signal with energy concentrated near `fs / lag` is correlated with itself there; white noise
|
|
147
|
+
* is not. Wind is band-limited to 35..350 Hz, so at the 350 Hz period it correlates hard. Rain is
|
|
148
|
+
* high-passed at 1800 Hz, so at the same lag it does not correlate at all.
|
|
149
|
+
*/
|
|
150
|
+
function autocorrelation(samples, lag) {
|
|
151
|
+
let mean = 0;
|
|
152
|
+
for (const value of samples) mean += value;
|
|
153
|
+
mean /= samples.length;
|
|
154
|
+
let num = 0;
|
|
155
|
+
let den = 0;
|
|
156
|
+
for (let i = 0; i + lag < samples.length; i += 1) {
|
|
157
|
+
const a = samples[i] - mean;
|
|
158
|
+
const b = samples[i + lag] - mean;
|
|
159
|
+
num += a * b;
|
|
160
|
+
den += a * a;
|
|
161
|
+
}
|
|
162
|
+
return num / den;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
/**
|
|
166
|
+
* The wrap step of a loop against the largest ordinary step in its own neighbourhood — the ratio
|
|
167
|
+
* `packages/assets/src/passes/audio.ts` fails a build on. `filterLoop` runs the steady-state
|
|
168
|
+
* response of a periodic input, so this has to come out clean; if it does not, the bake is not
|
|
169
|
+
* the source's filter and the loop clicks once per three seconds.
|
|
170
|
+
*/
|
|
171
|
+
function seamRatio(samples) {
|
|
172
|
+
const wrap = Math.abs(samples[0] - samples[samples.length - 1]);
|
|
173
|
+
const steps = [];
|
|
174
|
+
for (let i = 1; i < samples.length; i += 1) steps.push(Math.abs(samples[i] - samples[i - 1]));
|
|
175
|
+
steps.sort((a, b) => a - b);
|
|
176
|
+
const near = steps[Math.floor(steps.length * 0.99)];
|
|
177
|
+
return near <= 0 ? (wrap <= 0 ? 0 : Number.POSITIVE_INFINITY) : wrap / near;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* How much of the generated signal a float32 file is allowed to lose.
|
|
182
|
+
*
|
|
183
|
+
* Below half a ULP at 1.0, so a container that clamped or requantised the samples cannot pass it
|
|
184
|
+
* by rounding: 16-bit would move a sample by up to 1.5e-5, and it fails here by two orders of
|
|
185
|
+
* magnitude. It is a round-trip check, which is the strongest statement available about amplitude
|
|
186
|
+
* — "no sample was altered" rather than "few samples were altered".
|
|
187
|
+
*/
|
|
188
|
+
const FLOAT32_TOLERANCE = 1e-7;
|
|
189
|
+
|
|
190
|
+
/**
|
|
191
|
+
* The header the runtime's loader, the asset compiler and the native decoder all read, asserted
|
|
192
|
+
* before the samples. The format tag is the check that matters: it is what a 16-bit re-encode
|
|
193
|
+
* would silently change, and what the three decoders above branch on.
|
|
194
|
+
*/
|
|
195
|
+
function assertWavHeader(buffer) {
|
|
196
|
+
assert("RIFF header", buffer.toString("ascii", 0, 4) === "RIFF");
|
|
197
|
+
assert("WAVE header", buffer.toString("ascii", 8, 12) === "WAVE");
|
|
198
|
+
assert("IEEE float format tag", buffer.readUInt16LE(20) === WAVE_FORMAT_IEEE_FLOAT);
|
|
199
|
+
assert("channel count", buffer.readUInt16LE(22) === CHANNELS);
|
|
200
|
+
assert("sample rate", buffer.readUInt32LE(24) === SAMPLE_RATE);
|
|
201
|
+
assert("bit depth", buffer.readUInt16LE(34) === BITS);
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
/** One clip's own claims: right length, finite, unaltered, audible, and — for a loop — seamless. */
|
|
205
|
+
function checkClip(key, label, channels, source) {
|
|
206
|
+
const seconds = channels[0].length / SAMPLE_RATE;
|
|
207
|
+
const expected = key === "thunder" ? THUNDER_SECONDS : LOOP_SECONDS;
|
|
208
|
+
assert(
|
|
209
|
+
`${label}: duration is ${expected}s, got ${seconds.toFixed(4)}s`,
|
|
210
|
+
Math.abs(seconds - expected) < 1e-9,
|
|
211
|
+
);
|
|
212
|
+
const rows = [];
|
|
213
|
+
for (let c = 0; c < CHANNELS; c += 1) {
|
|
214
|
+
const m = measure(channels[c]);
|
|
215
|
+
assert(`${label} ch${c}: ${m.bad} non-finite samples`, m.bad === 0);
|
|
216
|
+
assert(
|
|
217
|
+
`${label} ch${c}: not silent (peak ${m.peak.toFixed(4)}, rms ${m.rms.toFixed(5)})`,
|
|
218
|
+
m.rms > 0.001 && m.peak > 0.05,
|
|
219
|
+
);
|
|
220
|
+
let moved = 0;
|
|
221
|
+
for (let i = 0; i < channels[c].length; i += 1)
|
|
222
|
+
moved = Math.max(moved, Math.abs(channels[c][i] - source[c][i]));
|
|
223
|
+
assert(
|
|
224
|
+
`${label} ch${c}: the file moved a sample by ${moved.toExponential(2)}`,
|
|
225
|
+
moved <= FLOAT32_TOLERANCE,
|
|
226
|
+
);
|
|
227
|
+
rows.push({ key, channel: c, peak: m.peak, rms: m.rms });
|
|
228
|
+
}
|
|
229
|
+
// The clip the 16-bit file could not hold. Wind's body is `pink * 4` and peaks above full scale,
|
|
230
|
+
// because the source's own gain node is what brought the loop down to at most .2 — so a peak over
|
|
231
|
+
// 1.0 in this file is the amplitude surviving, and a peak at or under it is a clip that lost the
|
|
232
|
+
// top of its transient to a container.
|
|
233
|
+
if (key === "wind") {
|
|
234
|
+
const peak = measure(channels[0]).peak;
|
|
235
|
+
assert(`${label}: the file holds its ${peak.toFixed(3)} peak, above full scale`, peak > 1);
|
|
236
|
+
}
|
|
237
|
+
if (key !== "thunder") {
|
|
238
|
+
const wrap = seamRatio(channels[0]);
|
|
239
|
+
assert(
|
|
240
|
+
`${label}: loop seam ${wrap.toFixed(3)}x exceeds 1.5x the neighbourhood step`,
|
|
241
|
+
wrap <= 1.5,
|
|
242
|
+
);
|
|
243
|
+
rows.push({ key, seam: wrap });
|
|
244
|
+
}
|
|
245
|
+
return rows;
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/** Reads the written bytes back and checks the claims the runtime will rest on. */
|
|
249
|
+
function selfCheck(baked) {
|
|
250
|
+
const decode = (bytes) => {
|
|
251
|
+
assertWavHeader(bytes);
|
|
252
|
+
const frames = bytes.readUInt32LE(40) / BLOCK_ALIGN;
|
|
253
|
+
const channels = [];
|
|
254
|
+
for (let c = 0; c < CHANNELS; c += 1) channels.push(new Float64Array(frames));
|
|
255
|
+
for (let i = 0; i < frames; i += 1)
|
|
256
|
+
for (let c = 0; c < CHANNELS; c += 1)
|
|
257
|
+
channels[c][i] = bytes.readFloatLE(44 + (i * CHANNELS + c) * BYTES_PER_SAMPLE);
|
|
258
|
+
return channels;
|
|
259
|
+
};
|
|
260
|
+
|
|
261
|
+
const results = [];
|
|
262
|
+
const decoded = {};
|
|
263
|
+
for (const [key, { label }] of Object.entries(ASSETS)) {
|
|
264
|
+
const channels = decode(baked[key].bytes);
|
|
265
|
+
decoded[key] = channels;
|
|
266
|
+
results.push(...checkClip(key, label, channels, baked[key].samples));
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
// The filters, as heard: wind is correlated over its own band, rain is not correlated below its
|
|
270
|
+
// high-pass corner. One lag, taken from a source constant — the period of rain's 1800 Hz corner.
|
|
271
|
+
const lag = Math.round(SAMPLE_RATE / LOOPS.rain.highpassHz);
|
|
272
|
+
const windAcf = autocorrelation(decoded.wind[0], lag);
|
|
273
|
+
const rainAcf = autocorrelation(decoded.rain[0], lag);
|
|
274
|
+
assert(
|
|
275
|
+
`wind correlates over its 35..350 Hz band at lag ${lag} (${windAcf.toFixed(3)})`,
|
|
276
|
+
windAcf > 0.5,
|
|
277
|
+
);
|
|
278
|
+
assert(
|
|
279
|
+
`rain does not correlate below its ${LOOPS.rain.highpassHz} Hz corner at lag ${lag} (${rainAcf.toFixed(3)})`,
|
|
280
|
+
Math.abs(rainAcf) < 0.1,
|
|
281
|
+
);
|
|
282
|
+
|
|
283
|
+
// The thunder envelope: a crack in the first tenth of a second and a decay of real dynamic range.
|
|
284
|
+
const strike = decoded.thunder[0];
|
|
285
|
+
const crackWindow = Math.floor(0.1 * SAMPLE_RATE);
|
|
286
|
+
const tailWindow = Math.floor(0.5 * SAMPLE_RATE);
|
|
287
|
+
let crackPeak = 0;
|
|
288
|
+
for (let i = 0; i < crackWindow; i += 1) crackPeak = Math.max(crackPeak, Math.abs(strike[i]));
|
|
289
|
+
let tail = 0;
|
|
290
|
+
for (let i = strike.length - tailWindow; i < strike.length; i += 1) tail += strike[i] * strike[i];
|
|
291
|
+
const tailRms = Math.sqrt(tail / tailWindow);
|
|
292
|
+
const decayDb = 20 * Math.log10(crackPeak / Math.max(tailRms, 1e-9));
|
|
293
|
+
assert(
|
|
294
|
+
`thunder attack is inside the first 100 ms (peak ${crackPeak.toFixed(3)})`,
|
|
295
|
+
crackPeak > 0.2,
|
|
296
|
+
);
|
|
297
|
+
assert(`thunder decays ${decayDb.toFixed(1)} dB into its tail`, decayDb > 20);
|
|
298
|
+
// The 9 Hz tremolo is the only term that decorrelates the channels, so a near-identical pair
|
|
299
|
+
// would mean it was dropped somewhere between the source and here.
|
|
300
|
+
let cross = 0;
|
|
301
|
+
let energy = 0;
|
|
302
|
+
for (let i = 0; i < strike.length; i += 1) {
|
|
303
|
+
cross += decoded.thunder[0][i] * decoded.thunder[1][i];
|
|
304
|
+
energy += decoded.thunder[0][i] * decoded.thunder[0][i];
|
|
305
|
+
}
|
|
306
|
+
const stereo = cross / energy;
|
|
307
|
+
assert(
|
|
308
|
+
`thunder channels are decorrelated by the tremolo phase (r=${stereo.toFixed(3)})`,
|
|
309
|
+
stereo < 0.2,
|
|
310
|
+
);
|
|
311
|
+
|
|
312
|
+
return { results, windAcf, rainAcf, decayDb, stereo, lag };
|
|
313
|
+
}
|
|
314
|
+
|
|
315
|
+
/**
|
|
316
|
+
* Re-reads the reference study and refuses to bake if the transcription has drifted. Every check
|
|
317
|
+
* is a literal that has to appear in the source; a missing file, an unreadable file or a renamed
|
|
318
|
+
* constant all throw rather than quietly passing.
|
|
319
|
+
*/
|
|
320
|
+
function verifySource(file) {
|
|
321
|
+
const source = readFileSync(file, "utf8");
|
|
322
|
+
const required = [
|
|
323
|
+
["STORM_SEED", `rng(${STORM_SEED})`],
|
|
324
|
+
["LOOPS.rain.highpassHz", `makeLoop(${LOOPS.rain.highpassHz},${LOOPS.rain.lowpassHz},.09)`],
|
|
325
|
+
["LOOPS.wind.highpassHz", `makeLoop(${LOOPS.wind.highpassHz},${LOOPS.wind.lowpassHz},.05)`],
|
|
326
|
+
["LOOP_SECONDS", `createBuffer(2,ctx.sampleRate*${LOOP_SECONDS},ctx.sampleRate)`],
|
|
327
|
+
["THUNDER_SECONDS", `duration=${THUNDER_SECONDS}`],
|
|
328
|
+
["pink", "pink=.96*pink+.04*w"],
|
|
329
|
+
["white scale", "d[i]=low<100?pink*4:w*.6"],
|
|
330
|
+
["brown", "low=.985*low+n*.015"],
|
|
331
|
+
["crack", "Math.exp(-t*22)*n*.8"],
|
|
332
|
+
["rumble", "low*7*(1.-Math.exp(-t*4))*Math.exp(-t*.66)"],
|
|
333
|
+
["tremolo", "( .68+.32*Math.sin(t*9+c))"],
|
|
334
|
+
["rain gain", "this.rainGain.gain.setTargetAtTime(weather.rain*.20"],
|
|
335
|
+
["wind gain", ".02+weather.wind*.18*(.78+.22*Math.sin(time*.37))"],
|
|
336
|
+
["master", "this.master.gain.setTargetAtTime(.42,this.ctx.currentTime,.12)"],
|
|
337
|
+
["distance lowpass", "filter.frequency.value=clamp(4500-distance*5,280,4500)"],
|
|
338
|
+
["distance gain", "gain.gain.value=clamp(1.05-distance*.0009,.18,.95)"],
|
|
339
|
+
];
|
|
340
|
+
for (const [name, literal] of required)
|
|
341
|
+
if (!source.includes(literal)) fail(`source '${file}' no longer contains ${name} (${literal})`);
|
|
342
|
+
return required.length;
|
|
343
|
+
}
|
|
344
|
+
|
|
345
|
+
// --- run -------------------------------------------------------------------------------------
|
|
346
|
+
|
|
347
|
+
const args = process.argv.slice(2);
|
|
348
|
+
if (args.some((a) => a === "--help" || a === "-h")) usage();
|
|
349
|
+
const verifyAt = args.indexOf("--verify");
|
|
350
|
+
if (verifyAt !== -1 && args[verifyAt + 1] === undefined) usage();
|
|
351
|
+
const verified = verifyAt === -1 ? null : verifySource(args[verifyAt + 1]);
|
|
352
|
+
|
|
353
|
+
const first = bake();
|
|
354
|
+
const second = bake();
|
|
355
|
+
for (const key of Object.keys(ASSETS)) {
|
|
356
|
+
const a = createHash("sha256").update(first[key].bytes).digest("hex");
|
|
357
|
+
const b = createHash("sha256").update(second[key].bytes).digest("hex");
|
|
358
|
+
assert(`${ASSETS[key].label} is not reproducible across two bakes (${a} vs ${b})`, a === b);
|
|
359
|
+
}
|
|
360
|
+
const check = selfCheck(first);
|
|
361
|
+
|
|
362
|
+
for (const [key, { file, label }] of Object.entries(ASSETS)) {
|
|
363
|
+
const bytes = first[key].bytes;
|
|
364
|
+
writeFileSync(path.join(assetsDir, file), bytes);
|
|
365
|
+
const hash = createHash("sha256").update(bytes).digest("hex").slice(0, 16);
|
|
366
|
+
console.log(
|
|
367
|
+
`${file} ${label} ${(bytes.length / 1024).toFixed(0)} KiB float32 sha256:${hash}`,
|
|
368
|
+
);
|
|
369
|
+
}
|
|
370
|
+
for (const row of check.results) {
|
|
371
|
+
if (row.seam !== undefined)
|
|
372
|
+
console.log(
|
|
373
|
+
` ${ASSETS[row.key].label}: loop seam ${row.seam.toFixed(3)}x the neighbourhood step`,
|
|
374
|
+
);
|
|
375
|
+
else
|
|
376
|
+
console.log(
|
|
377
|
+
` ${ASSETS[row.key].label} ch${row.channel}: peak ${row.peak.toFixed(3)} rms ${row.rms.toFixed(4)}`,
|
|
378
|
+
);
|
|
379
|
+
}
|
|
380
|
+
console.log(
|
|
381
|
+
`self-check ok: wind acf@${check.lag} ${check.windAcf.toFixed(3)} (correlated), rain ${check.rainAcf.toFixed(3)} (not), thunder ${check.decayDb.toFixed(1)} dB decay at r=${check.stereo.toFixed(3)}, two bakes byte-identical`,
|
|
382
|
+
);
|
|
383
|
+
console.log(
|
|
384
|
+
verified === null
|
|
385
|
+
? "note: constants unverified against the reference (pass --verify <tempest.html> to check)"
|
|
386
|
+
: `verified ${verified} source literals against the reference`,
|
|
387
|
+
);
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
// The reference study's audio maths, transcribed out of `/home/joao/Downloads/tempest.html`
|
|
2
|
+
// (`class StormAudio`, lines 551-583) so `make-storm-audio.mjs` can bake it offline.
|
|
3
|
+
//
|
|
4
|
+
// Every constant below is the source's, character for character, and every line of the two
|
|
5
|
+
// generators is the source's arithmetic rearranged to fill a typed array instead of an
|
|
6
|
+
// AudioBuffer. Nothing here is a redesign: the source runs this DSP on the audio thread against
|
|
7
|
+
// live Web Audio nodes, and the native host has no AudioContext at all, so the same numbers are
|
|
8
|
+
// computed once here and committed as PCM. The runtime constants that the source applied to *nodes*
|
|
9
|
+
// (the master gain, the biquads, the compressor, the distance delay) are named in
|
|
10
|
+
// `src/audio/storm.ts`, where the engine's own equivalents are applied instead.
|
|
11
|
+
|
|
12
|
+
/** `this.rng = rng(544)` — the same mulberry32 the rest of the study seeds with. */
|
|
13
|
+
export const STORM_SEED = 544;
|
|
14
|
+
|
|
15
|
+
/** `ctx.createBuffer(2, ctx.sampleRate * 3, ctx.sampleRate)` — both loops are three seconds. */
|
|
16
|
+
export const LOOP_SECONDS = 3;
|
|
17
|
+
|
|
18
|
+
/** `const duration = 7` — the thunder buffer. */
|
|
19
|
+
export const THUNDER_SECONDS = 7;
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* `makeLoop(low, high, volume)` as the source calls it:
|
|
23
|
+
* `this.rainGain = this.makeLoop(1800, 11000, .09)` and
|
|
24
|
+
* `this.windGain = this.makeLoop(35, 350, .05)`.
|
|
25
|
+
*
|
|
26
|
+
* `volume` is recorded because the source passes it to the gain node and then overwrites that
|
|
27
|
+
* node every frame in `update()`; the levels that are ever heard are the `update()` ones in
|
|
28
|
+
* `src/audio/storm.ts`, so this generator does not apply them.
|
|
29
|
+
*/
|
|
30
|
+
export const LOOPS = {
|
|
31
|
+
rain: { highpassHz: 1800, lowpassHz: 11000, nodeGain: 0.09 },
|
|
32
|
+
wind: { highpassHz: 35, lowpassHz: 350, nodeGain: 0.05 },
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
/** The pink integrator: `pink = .96 * pink + .04 * w`, and the `low < 100 ? pink * 4 : w * .6` pick. */
|
|
36
|
+
const PINK_POLE = 0.96;
|
|
37
|
+
const PINK_FEED = 0.04;
|
|
38
|
+
const PINK_SCALE = 4;
|
|
39
|
+
/** `w = rng() * 2 - 1`, used at full scale for the loop bodies. */
|
|
40
|
+
const WHITE_SCALE = 0.6;
|
|
41
|
+
|
|
42
|
+
/** Thunder's brown integrator: `low = .985 * low + n * .015`, and the `low * 7` it is scaled by. */
|
|
43
|
+
const BROWN_POLE = 0.985;
|
|
44
|
+
const BROWN_FEED = 0.015;
|
|
45
|
+
const BROWN_SCALE = 7;
|
|
46
|
+
|
|
47
|
+
/** `Math.exp(-t * 22) * n * .8` — the crack, and the only part of the buffer that is not brown. */
|
|
48
|
+
const CRACK_DECAY = 22;
|
|
49
|
+
const CRACK_LEVEL = 0.8;
|
|
50
|
+
/** `low * 7 * (1 - Math.exp(-t * 4)) * Math.exp(-t * .66)` — the rumble's attack and release. */
|
|
51
|
+
const RUMBLE_ATTACK = 4;
|
|
52
|
+
const RUMBLE_DECAY = 0.66;
|
|
53
|
+
/** `(.68 + .32 * Math.sin(t * 9 + c))` — the tremolo, and the one-radian offset between channels. */
|
|
54
|
+
const TREMOLO_RATE = 9;
|
|
55
|
+
const TREMOLO_DEPTH = 0.32;
|
|
56
|
+
const TREMOLO_FLOOR = 0.68;
|
|
57
|
+
|
|
58
|
+
/** `function rng(seed = 1)` verbatim, so a given seed is the same stream the source drew. */
|
|
59
|
+
export function mulberry32(seed) {
|
|
60
|
+
let a = seed | 0;
|
|
61
|
+
return () => {
|
|
62
|
+
a += 0x6d2b79f5;
|
|
63
|
+
let t = a;
|
|
64
|
+
t = Math.imul(t ^ (t >>> 15), t | 1);
|
|
65
|
+
t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
|
|
66
|
+
return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* The RBJ biquad `BiquadFilterNode` computes, for the two types the source uses and at Q = 1,
|
|
72
|
+
* which is the spec default: `highpass` and `lowpass` share the same denominator.
|
|
73
|
+
*
|
|
74
|
+
* Returns `[b0, b1, b2, a1, a2]` already divided by a0, so the recursion is
|
|
75
|
+
* `y = b0 x + b1 x1 + b2 x2 - a1 y1 - a2 y2`.
|
|
76
|
+
*/
|
|
77
|
+
export function biquad(type, hz, sampleRate, q = 1) {
|
|
78
|
+
const w0 = (2 * Math.PI * hz) / sampleRate;
|
|
79
|
+
const cos = Math.cos(w0);
|
|
80
|
+
const alpha = Math.sin(w0) / (2 * q);
|
|
81
|
+
const b =
|
|
82
|
+
type === "highpass"
|
|
83
|
+
? [(1 + cos) / 2, -(1 + cos), (1 + cos) / 2]
|
|
84
|
+
: [(1 - cos) / 2, 1 - cos, (1 - cos) / 2];
|
|
85
|
+
const a0 = 1 + alpha;
|
|
86
|
+
return [b[0] / a0, b[1] / a0, b[2] / a0, (-2 * cos) / a0, (1 - alpha) / a0];
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* Runs a biquad over `input` as a *periodic* signal and returns exactly one period.
|
|
91
|
+
*
|
|
92
|
+
* The source filtered a looping buffer with a live node, so the filter state was continuous
|
|
93
|
+
* across every wrap forever. Filtering a finite buffer instead leaves the filter's state at the
|
|
94
|
+
* end of the file, and the join back to the start is a step — an audible click on a loop that
|
|
95
|
+
* repeats forever, which is the defect `packages/assets/src/passes/audio.ts` is built to reject.
|
|
96
|
+
* Running the recursion over the input repeated twice and keeping the second period is the
|
|
97
|
+
* steady-state response of a periodic input, so the wrap lands exactly where the join is.
|
|
98
|
+
*/
|
|
99
|
+
export function filterLoop(input, coefficients) {
|
|
100
|
+
const [b0, b1, b2, a1, a2] = coefficients;
|
|
101
|
+
const n = input.length;
|
|
102
|
+
const out = new Float64Array(n);
|
|
103
|
+
let x1 = 0;
|
|
104
|
+
let x2 = 0;
|
|
105
|
+
let y1 = 0;
|
|
106
|
+
let y2 = 0;
|
|
107
|
+
for (let k = 0; k < n * 2; k += 1) {
|
|
108
|
+
const x = input[k % n];
|
|
109
|
+
const y = b0 * x + b1 * x1 + b2 * x2 - a1 * y1 - a2 * y2;
|
|
110
|
+
x2 = x1;
|
|
111
|
+
x1 = x;
|
|
112
|
+
y2 = y1;
|
|
113
|
+
y1 = y;
|
|
114
|
+
if (k >= n) out[k - n] = y;
|
|
115
|
+
}
|
|
116
|
+
return out;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* `makeLoop`'s buffer body, one channel at a time, before the source's filters.
|
|
121
|
+
*
|
|
122
|
+
* Channel-major, because that is the order the source drew from its one generator: it filled
|
|
123
|
+
* channel 0 from `length` draws and then channel 1 from the next `length`. The pink state is
|
|
124
|
+
* per channel — `let pink = 0` is inside the channel loop — so the two channels share no state.
|
|
125
|
+
*/
|
|
126
|
+
export function loopBody({ band, sampleRate, rng }) {
|
|
127
|
+
const n = Math.round(LOOP_SECONDS * sampleRate);
|
|
128
|
+
const channels = [];
|
|
129
|
+
const pink = band.highpassHz < 100;
|
|
130
|
+
for (let c = 0; c < 2; c += 1) {
|
|
131
|
+
const data = new Float64Array(n);
|
|
132
|
+
let state = 0;
|
|
133
|
+
for (let i = 0; i < n; i += 1) {
|
|
134
|
+
const w = rng() * 2 - 1;
|
|
135
|
+
if (!pink) {
|
|
136
|
+
data[i] = w * WHITE_SCALE;
|
|
137
|
+
continue;
|
|
138
|
+
}
|
|
139
|
+
state = PINK_POLE * state + PINK_FEED * w;
|
|
140
|
+
data[i] = state * PINK_SCALE;
|
|
141
|
+
}
|
|
142
|
+
channels.push(data);
|
|
143
|
+
}
|
|
144
|
+
return channels;
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* `thunder()`'s buffer body: `a[i] = clamp(crack + rumble, -1, 1)`, stereo, seven seconds.
|
|
149
|
+
*
|
|
150
|
+
* `let low = 0` resets per channel and the generator is shared across both, so the left channel
|
|
151
|
+
* ends its stream exactly where the right channel starts it. The tremolo's `+ c` term is what
|
|
152
|
+
* decorrelates the channels here; nothing else in the buffer does.
|
|
153
|
+
*/
|
|
154
|
+
export function thunderBody({ sampleRate, rng }) {
|
|
155
|
+
const n = Math.floor(THUNDER_SECONDS * sampleRate);
|
|
156
|
+
const channels = [];
|
|
157
|
+
for (let c = 0; c < 2; c += 1) {
|
|
158
|
+
const data = new Float64Array(n);
|
|
159
|
+
let low = 0;
|
|
160
|
+
for (let i = 0; i < n; i += 1) {
|
|
161
|
+
const t = i / sampleRate;
|
|
162
|
+
const white = rng() * 2 - 1;
|
|
163
|
+
low = BROWN_POLE * low + BROWN_FEED * white;
|
|
164
|
+
const crack = Math.exp(-t * CRACK_DECAY) * white * CRACK_LEVEL;
|
|
165
|
+
const rumble =
|
|
166
|
+
low *
|
|
167
|
+
BROWN_SCALE *
|
|
168
|
+
(1 - Math.exp(-t * RUMBLE_ATTACK)) *
|
|
169
|
+
Math.exp(-t * RUMBLE_DECAY) *
|
|
170
|
+
(TREMOLO_FLOOR + TREMOLO_DEPTH * Math.sin(t * TREMOLO_RATE + c));
|
|
171
|
+
const mixed = crack + rumble;
|
|
172
|
+
data[i] = mixed > 1 ? 1 : mixed < -1 ? -1 : mixed;
|
|
173
|
+
}
|
|
174
|
+
channels.push(data);
|
|
175
|
+
}
|
|
176
|
+
return channels;
|
|
177
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
// The source of truth for src/render/bloom-shader.ts, transcribed from the Tempest single-file
|
|
2
|
+
// demo's `BLOOM` constant (const BLOOM, just after the lightning bolt fragment shader).
|
|
3
|
+
//
|
|
4
|
+
// A 5x5 gaussian at twice the input texel size, masked by a soft-knee luminance threshold and
|
|
5
|
+
// normalised by the weight it actually accumulated — not by 25, so the corners of the frame, where
|
|
6
|
+
// the kernel hangs off the target, cannot dim. Rendered at quarter resolution; see
|
|
7
|
+
// src/render/postprocessing.ts.
|
|
8
|
+
precision highp float;
|
|
9
|
+
in vec2 vUv;out vec4 fragColor;uniform sampler2D uScene;uniform vec2 uRes;
|
|
10
|
+
void main(){vec3 c=vec3(0.);float w=0.;for(int y=-2;y<=2;y++)for(int x=-2;x<=2;x++){float wt=exp(-float(x*x+y*y)*.32);vec3 s=texture(uScene,vUv+vec2(float(x),float(y))/uRes*2.).rgb;float l=max(s.r,max(s.g,s.b));c+=s*smoothstep(.70,1.6,l)*wt;w+=wt;}fragColor=vec4(c/w,1.);}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
// The GLSL this template's cloud volume shader is generated from, copied out of the Tempest
|
|
2
|
+
// single-file demo (its COMMON + CLOUDS fragment shaders) so the generator is reproducible without
|
|
3
|
+
// the original file. Edits here change the generated
|
|
4
|
+
// templates/rain/src/render/clouds-shader.ts; edit the generator, not its output.
|
|
5
|
+
//
|
|
6
|
+
// Two things below are rewritten, both to keep the port mechanical rather than hand-written. The
|
|
7
|
+
// `density` early return becomes one value assigned under a guard, and `main`'s degenerate-slab
|
|
8
|
+
// return becomes the value it starts with — the reason is on `density`. The five-tap sunlight loop
|
|
9
|
+
// counts with `i` rather than `j` so the transpiler emits a loop whose counter it already names the
|
|
10
|
+
// way `LoopNode` expects; the counter's name is not part of what the loop computes.
|
|
11
|
+
precision highp float;
|
|
12
|
+
precision highp sampler3D;
|
|
13
|
+
uniform float uTime, uRain, uCloud, uWind, uFog, uWet, uFlash, uAspect, uTan;
|
|
14
|
+
uniform vec3 uCam, uForward, uRight, uUp, uStrike;
|
|
15
|
+
// The look, owned by src/render/{sky,lighting}.ts and set from there every run.
|
|
16
|
+
uniform vec3 uSunDir, uSkyLow, uSkyHigh;
|
|
17
|
+
uniform vec2 uRes;
|
|
18
|
+
in vec2 vUv;
|
|
19
|
+
out vec4 fragColor;
|
|
20
|
+
float hash12(vec2 p){vec3 p3=fract(vec3(p.xyx)*.1031);p3+=dot(p3,p3.yzx+33.33);return fract((p3.x+p3.y)*p3.z);}
|
|
21
|
+
float hash13(vec3 p){p=fract(p*.1031);p+=dot(p,p.zyx+31.32);return fract((p.x+p.y)*p.z);}
|
|
22
|
+
float noise2(vec2 p){vec2 i=floor(p),f=fract(p);f=f*f*(3.-2.*f);return mix(mix(hash12(i),hash12(i+vec2(1,0)),f.x),mix(hash12(i+vec2(0,1)),hash12(i+1.),f.x),f.y);}
|
|
23
|
+
float fbm2(vec2 p){float v=.5*noise2(p);p=mat2(.8,-.6,.6,.8)*p*2.03+19.1;v+=.25*noise2(p);p=p*2.02+9.3;v+=.125*noise2(p);return v+.0625*noise2(p*2.01+17.);}
|
|
24
|
+
vec3 ray(vec2 uv){vec2 q=uv*2.-1.;return normalize(uForward+uRight*q.x*uAspect*uTan+uUp*q.y*uTan);}
|
|
25
|
+
vec4 project(vec3 p){vec3 v=p-uCam;float d=dot(v,uForward);return vec4(dot(v,uRight)/(uAspect*uTan),dot(v,uUp)/uTan,1.00012*d-.300018,d);}
|
|
26
|
+
uniform sampler3D uNoise;
|
|
27
|
+
uniform int uSteps;
|
|
28
|
+
float density(vec3 p){
|
|
29
|
+
// One value, one return, for the reason given in the coast's `baseColor`: the transpiler turns a
|
|
30
|
+
// GLSL early return into a JavaScript return that only leaves the `If` callback the node graph is
|
|
31
|
+
// being built inside, so the branch would never be assigned. The guard is kept as a guard, so a
|
|
32
|
+
// clear sky still costs one comparison and no noise fetches.
|
|
33
|
+
float res=0.;
|
|
34
|
+
if(uCloud>=.005){
|
|
35
|
+
vec3 drift=vec3(uTime*(2.+uWind*13.),0.,uTime*1.2);
|
|
36
|
+
vec3 q=(p+drift)*.00105; q.y*=1.4;
|
|
37
|
+
vec4 n=texture(uNoise,q);
|
|
38
|
+
float broad=n.r*.76+texture(uNoise,q*2.07+vec3(.1,.3,.7)).r*.24;
|
|
39
|
+
// Flattened condensation base with turbulent billows above it.
|
|
40
|
+
float h=(p.y-145.)/670.;
|
|
41
|
+
float base=smoothstep(0.,.09,h)*(1.-smoothstep(.68,1.,h));
|
|
42
|
+
float shape=broad+uCloud*.30-.72;
|
|
43
|
+
float edge=(texture(uNoise,q*3.81).b-.5)*.12;
|
|
44
|
+
res=clamp((shape-edge)*5.1,0.,1.)*base;
|
|
45
|
+
}
|
|
46
|
+
return res;
|
|
47
|
+
}
|
|
48
|
+
float lightAt(vec3 p,vec3 l){float sum=0.,stepLen=28.;for(int i=0;i<5;i++){p+=l*stepLen;sum+=density(p)*stepLen;stepLen*=1.7;}return exp(-sum*.015);}
|
|
49
|
+
void main(){
|
|
50
|
+
vec3 rd=ray(vUv);rd.y=abs(rd.y);rd=normalize(rd);
|
|
51
|
+
vec3 sunDir=uSunDir;float mu=dot(rd,sunDir);
|
|
52
|
+
vec3 sky=mix(uSkyLow,uSkyHigh,pow(clamp(rd.y,0.,1.),.62));
|
|
53
|
+
sky+=vec3(.31,.27,.205)*pow(max(mu,0.),14.);
|
|
54
|
+
sky+=vec3(.7,.57,.37)*pow(max(mu,0.),140.);
|
|
55
|
+
sky+=uFlash*vec3(.14,.22,.36);
|
|
56
|
+
float t0=max(0.,(145.-uCam.y)/max(rd.y,.008));
|
|
57
|
+
float t1=min(10500.,(815.-uCam.y)/max(rd.y,.008));
|
|
58
|
+
vec4 col=vec4(sky,1.);
|
|
59
|
+
if(t0<t1){
|
|
60
|
+
float dt=(t1-t0)/float(uSteps);
|
|
61
|
+
float jitter=hash12(gl_FragCoord.xy)*.75+.12;
|
|
62
|
+
vec3 light=vec3(0.);float trans=1.;
|
|
63
|
+
float phase=.45+.65*pow(max(mu,0.),5.);
|
|
64
|
+
for(int i=0;i<96;i++){
|
|
65
|
+
if(i>=uSteps||trans<.008)break;
|
|
66
|
+
float t=t0+(float(i)+jitter)*dt;vec3 p=uCam+rd*t;
|
|
67
|
+
float d=density(p);
|
|
68
|
+
if(d>.002){
|
|
69
|
+
float sun=lightAt(p,sunDir);
|
|
70
|
+
float height=clamp((p.y-145.)/670.,0.,1.);
|
|
71
|
+
vec3 ambient=mix(vec3(.035,.061,.079),vec3(.19,.25,.28),height);
|
|
72
|
+
// A small multiple-scattering/powder approximation prevents crushed cloud cores.
|
|
73
|
+
vec3 c=ambient*(.7+.45*(1.-exp(-d*3.)))+vec3(.97,.94,.85)*sun*phase*.70;
|
|
74
|
+
float glow=exp(-length((p-uStrike)*vec3(1.,.5,1.))*.0022);
|
|
75
|
+
c+=vec3(.85,1.18,1.9)*uFlash*glow*1.2;
|
|
76
|
+
float absorb=1.-exp(-d*dt*.020);
|
|
77
|
+
light+=trans*absorb*c;trans*=1.-absorb;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
vec3 marched=light+trans*sky;
|
|
81
|
+
float atmospheric=1.-exp(-t0*.000075);
|
|
82
|
+
marched=mix(marched,sky,atmospheric*.66);
|
|
83
|
+
col=vec4(marched,1.-trans);
|
|
84
|
+
}
|
|
85
|
+
return col;
|
|
86
|
+
}
|