create-threenative 0.2.10 → 0.2.13
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/agent-docs/references/assertion-reference.md +109 -3
- package/agent-docs/references/auto-exposure.md +28 -45
- package/agent-docs/references/build-profiles.md +1 -1
- package/agent-docs/references/capability-reference.md +527 -44
- package/agent-docs/references/debug-surface.md +64 -0
- package/agent-docs/references/finding-assets.md +11 -12
- package/agent-docs/references/performance-basics.md +19 -0
- package/agent-docs/references/trace-a-slow-frame.md +21 -0
- package/agent-docs/references/visual-baseline.md +23 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/scripts/reference.mjs +9 -4
- package/capabilities.json +739 -50
- package/dist/index.d.ts +40 -6
- package/dist/index.js +227 -34
- package/dist/quality.d.ts +12 -0
- package/dist/quality.js +166747 -0
- package/dist/threenative.js +60 -44
- package/dist/web-engine-gltf-loader.js +2 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
- package/dist/web-engine-mesh-bvh.js +7 -0
- package/dist/web-engine-post-effects.js +645 -19
- package/dist/web-engine-runtime.js +3528 -343
- package/package.json +19 -9
- package/template-assets/assets/bay-PROVENANCE.md +21 -0
- package/template-assets/assets/bay-ground.webp +0 -0
- package/template-assets/assets/bay-metal.webp +0 -0
- package/template-assets/assets/bay-pavement-normal.webp +0 -0
- package/template-assets/assets/bay-pavement.webp +0 -0
- package/template-assets/assets/bay-plaster-normal.webp +0 -0
- package/template-assets/assets/bay-plaster.webp +0 -0
- package/template-assets/assets/bay-wood-normal.webp +0 -0
- package/template-assets/assets/bay-wood.webp +0 -0
- package/template-assets/assets/tex-PROVENANCE.md +25 -0
- package/template-assets/assets/tex-bark-normal.webp +0 -0
- package/template-assets/assets/tex-bark.webp +0 -0
- package/template-assets/assets/tex-birch-bark.webp +0 -0
- package/template-assets/assets/tex-grass.webp +0 -0
- package/template-assets/assets/tex-planks-normal.webp +0 -0
- package/template-assets/assets/tex-planks.webp +0 -0
- package/template-assets/assets/tex-rock-normal.webp +0 -0
- package/template-assets/assets/tex-rock.webp +0 -0
- package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
- package/template-assets/assets/tex-roof-tiles.webp +0 -0
- package/template-assets/assets/tex-sand-normal.webp +0 -0
- package/template-assets/assets/tex-sand.webp +0 -0
- package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
- package/template-assets/assets/tex-stone-wall.webp +0 -0
- package/template-assets/kitExposure.ts +20 -0
- package/template-assets/patches/three@0.185.1.patch +481 -272
- package/template-assets/quality/biome.json +7 -0
- package/template-assets/quality/eslint.config.js +3 -0
- package/template-assets/realistic-ocean/README.md +113 -0
- package/template-assets/realistic-ocean/install.mjs +56 -0
- package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
- package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
- package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
- package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
- package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
- package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
- package/templates/AGENTS.md +21 -0
- package/templates/CLAUDE.md +23 -0
- package/templates/action-rpg/.codex/config.toml +6 -2
- package/templates/action-rpg/.cursor/mcp.json +8 -2
- package/templates/action-rpg/.gemini/settings.json +8 -2
- package/templates/action-rpg/.mcp.json +8 -2
- package/templates/action-rpg/.vscode/mcp.json +9 -2
- package/templates/action-rpg/.zed/settings.json +9 -2
- package/templates/action-rpg/AGENTS.md +11 -11
- package/templates/action-rpg/CLAUDE.md +11 -11
- package/templates/action-rpg/opencode.json +10 -2
- package/templates/action-rpg/package.json +15 -10
- package/templates/action-rpg/playtests/combat.playtest.json +6 -0
- package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
- package/templates/action-rpg/playtests/performance.playtest.json +1 -1
- package/templates/action-rpg/playtests/roll.playtest.json +112 -0
- package/templates/action-rpg/playtests/swing.playtest.json +55 -0
- package/templates/action-rpg/playtests/win.playtest.json +4 -4
- package/templates/action-rpg/src/entities/Fighter.ts +44 -4
- package/templates/action-rpg/src/entities/Player.ts +64 -12
- package/templates/action-rpg/src/render/atmosphere.ts +444 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
- package/templates/action-rpg/src/render/clouds.ts +605 -0
- package/templates/action-rpg/src/render/dungeon.ts +8 -6
- package/templates/action-rpg/src/render/exposure.ts +11 -109
- package/templates/action-rpg/src/render/gpuSky.ts +752 -0
- package/templates/action-rpg/src/render/lighting.ts +27 -4
- package/templates/action-rpg/src/render/materialLighting.ts +2 -11
- package/templates/action-rpg/src/render/palette.ts +1 -0
- package/templates/action-rpg/src/render/postprocessing.ts +4 -4
- package/templates/action-rpg/src/render/props.ts +10 -8
- package/templates/action-rpg/src/render/quality.ts +56 -108
- package/templates/action-rpg/src/render/sky.ts +74 -1
- package/templates/action-rpg/src/scenes/Play.ts +16 -12
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
- package/templates/action-rpg/src/ui/Hud.tsx +5 -7
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/adventure/.codex/config.toml +23 -0
- package/templates/adventure/.cursor/mcp.json +38 -0
- package/templates/adventure/.gemini/settings.json +38 -0
- package/templates/adventure/.mcp.json +38 -0
- package/templates/adventure/.vscode/mcp.json +43 -0
- package/templates/adventure/.zed/settings.json +43 -0
- package/templates/adventure/AGENTS.md +60 -0
- package/templates/adventure/CLAUDE.md +62 -0
- package/templates/adventure/index.html +14 -0
- package/templates/adventure/kit.json +8 -0
- package/templates/adventure/native-playtests/survives.playtest.json +52 -0
- package/templates/adventure/opencode.json +49 -0
- package/templates/adventure/package.json +65 -0
- package/templates/adventure/playtests/boss.playtest.json +406 -0
- package/templates/adventure/playtests/combat.playtest.json +342 -0
- package/templates/adventure/playtests/controls.playtest.json +142 -0
- package/templates/adventure/playtests/explore.playtest.json +45 -0
- package/templates/adventure/playtests/flicker.playtest.json +206 -0
- package/templates/adventure/playtests/hearts.playtest.json +171 -0
- package/templates/adventure/playtests/lockon.playtest.json +256 -0
- package/templates/adventure/playtests/look.playtest.json +72 -0
- package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
- package/templates/adventure/playtests/move.playtest.json +84 -0
- package/templates/adventure/playtests/performance.playtest.json +55 -0
- package/templates/adventure/playtests/puzzle.playtest.json +250 -0
- package/templates/adventure/playtests/stride.playtest.json +67 -0
- package/templates/adventure/playtests/survives.playtest.json +171 -0
- package/templates/adventure/playtests/thornback.playtest.json +267 -0
- package/templates/adventure/public/favicon.svg +4 -0
- package/templates/adventure/src/entities/Block.ts +114 -0
- package/templates/adventure/src/entities/Chest.ts +69 -0
- package/templates/adventure/src/entities/Door.ts +81 -0
- package/templates/adventure/src/entities/Dummy.ts +69 -0
- package/templates/adventure/src/entities/Flicker.ts +239 -0
- package/templates/adventure/src/entities/Hero.ts +561 -0
- package/templates/adventure/src/entities/LockOn.ts +180 -0
- package/templates/adventure/src/entities/Mossling.ts +249 -0
- package/templates/adventure/src/entities/Switch.ts +49 -0
- package/templates/adventure/src/entities/Thornback.ts +238 -0
- package/templates/adventure/src/entities/Warden.ts +196 -0
- package/templates/adventure/src/game.ts +65 -0
- package/templates/adventure/src/interact.ts +63 -0
- package/templates/adventure/src/level/Hollow.ts +240 -0
- package/templates/adventure/src/level/Vale.ts +383 -0
- package/templates/adventure/src/main.ts +18 -0
- package/templates/adventure/src/render/camera.ts +416 -0
- package/templates/adventure/src/render/creatures.ts +405 -0
- package/templates/adventure/src/render/effects.ts +333 -0
- package/templates/adventure/src/render/foliage.ts +1072 -0
- package/templates/adventure/src/render/hero.ts +1447 -0
- package/templates/adventure/src/render/kitExposure.ts +20 -0
- package/templates/adventure/src/render/lighting.ts +74 -0
- package/templates/adventure/src/render/loading.ts +332 -0
- package/templates/adventure/src/render/materials.ts +179 -0
- package/templates/adventure/src/render/palette.ts +137 -0
- package/templates/adventure/src/render/postprocessing.ts +70 -0
- package/templates/adventure/src/render/props.ts +383 -0
- package/templates/adventure/src/render/quality.ts +46 -0
- package/templates/adventure/src/render/sky.ts +271 -0
- package/templates/adventure/src/render/surface.ts +259 -0
- package/templates/adventure/src/render/touch-controls.ts +137 -0
- package/templates/adventure/src/scenes/Play.ts +959 -0
- package/templates/adventure/src/state.ts +113 -0
- package/templates/adventure/src/style.css +98 -0
- package/templates/adventure/src/ui/App.tsx +22 -0
- package/templates/adventure/src/ui/GameUi.tsx +20 -0
- package/templates/adventure/src/ui/Hud.tsx +70 -0
- package/templates/adventure/src/ui/Menu.tsx +15 -0
- package/templates/adventure/src/ui/main.tsx +14 -0
- package/templates/adventure/tailwind.config.ts +2 -0
- package/templates/adventure/threenative.config.ts +62 -0
- package/templates/adventure/tsconfig.json +17 -0
- package/templates/adventure/vite.config.ts +49 -0
- package/templates/collectathon/.codex/config.toml +23 -0
- package/templates/collectathon/.cursor/mcp.json +38 -0
- package/templates/collectathon/.gemini/settings.json +38 -0
- package/templates/collectathon/.mcp.json +38 -0
- package/templates/collectathon/.vscode/mcp.json +43 -0
- package/templates/collectathon/.zed/settings.json +43 -0
- package/templates/collectathon/AGENTS.md +58 -0
- package/templates/collectathon/CLAUDE.md +60 -0
- package/templates/collectathon/index.html +14 -0
- package/templates/collectathon/kit.json +8 -0
- package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
- package/templates/collectathon/opencode.json +49 -0
- package/templates/collectathon/package.json +65 -0
- package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
- package/templates/collectathon/playtests/camera.playtest.json +80 -0
- package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
- package/templates/collectathon/playtests/collect.playtest.json +196 -0
- package/templates/collectathon/playtests/combat.playtest.json +246 -0
- package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
- package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
- package/templates/collectathon/playtests/effects.playtest.json +124 -0
- package/templates/collectathon/playtests/enemies.playtest.json +295 -0
- package/templates/collectathon/playtests/explore.playtest.json +45 -0
- package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
- package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
- package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
- package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
- package/templates/collectathon/playtests/ledge.playtest.json +100 -0
- package/templates/collectathon/playtests/look.playtest.json +64 -0
- package/templates/collectathon/playtests/performance.playtest.json +55 -0
- package/templates/collectathon/playtests/stride.playtest.json +111 -0
- package/templates/collectathon/playtests/survives.playtest.json +123 -0
- package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
- package/templates/collectathon/playtests/thornback.playtest.json +157 -0
- package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
- package/templates/collectathon/playtests/win.playtest.json +166 -0
- package/templates/collectathon/public/favicon.svg +4 -0
- package/templates/collectathon/src/entities/Hero.ts +915 -0
- package/templates/collectathon/src/entities/Pickup.ts +63 -0
- package/templates/collectathon/src/entities/Walker.ts +248 -0
- package/templates/collectathon/src/game.ts +51 -0
- package/templates/collectathon/src/level/Course.ts +590 -0
- package/templates/collectathon/src/level/terrain.ts +144 -0
- package/templates/collectathon/src/main.ts +14 -0
- package/templates/collectathon/src/playtest-events.ts +15 -0
- package/templates/collectathon/src/render/camera.ts +163 -0
- package/templates/collectathon/src/render/castle.ts +408 -0
- package/templates/collectathon/src/render/effects.ts +284 -0
- package/templates/collectathon/src/render/foliage.ts +744 -0
- package/templates/collectathon/src/render/ground.ts +139 -0
- package/templates/collectathon/src/render/hero.ts +452 -0
- package/templates/collectathon/src/render/kitExposure.ts +20 -0
- package/templates/collectathon/src/render/lighting.ts +65 -0
- package/templates/collectathon/src/render/loading.ts +332 -0
- package/templates/collectathon/src/render/materials.ts +196 -0
- package/templates/collectathon/src/render/palette.ts +82 -0
- package/templates/collectathon/src/render/postprocessing.ts +79 -0
- package/templates/collectathon/src/render/props.ts +218 -0
- package/templates/collectathon/src/render/quality.ts +54 -0
- package/templates/collectathon/src/render/sky.ts +262 -0
- package/templates/collectathon/src/render/surface.ts +269 -0
- package/templates/collectathon/src/render/touch-controls.ts +179 -0
- package/templates/collectathon/src/render/touch-layout.ts +48 -0
- package/templates/collectathon/src/render/water.ts +191 -0
- package/templates/collectathon/src/scenes/Play.ts +481 -0
- package/templates/collectathon/src/state.ts +38 -0
- package/templates/collectathon/src/style.css +106 -0
- package/templates/collectathon/src/ui/App.tsx +22 -0
- package/templates/collectathon/src/ui/GameUi.tsx +20 -0
- package/templates/collectathon/src/ui/Hud.tsx +77 -0
- package/templates/collectathon/src/ui/Menu.tsx +13 -0
- package/templates/collectathon/src/ui/main.tsx +14 -0
- package/templates/collectathon/tailwind.config.ts +2 -0
- package/templates/collectathon/threenative.config.ts +62 -0
- package/templates/collectathon/tsconfig.json +17 -0
- package/templates/collectathon/vite.config.ts +49 -0
- package/templates/kart/.codex/config.toml +23 -0
- package/templates/kart/.cursor/mcp.json +38 -0
- package/templates/kart/.gemini/settings.json +38 -0
- package/templates/kart/.mcp.json +38 -0
- package/templates/kart/.vscode/mcp.json +43 -0
- package/templates/kart/.zed/settings.json +43 -0
- package/templates/kart/AGENTS.md +58 -0
- package/templates/kart/CLAUDE.md +60 -0
- package/templates/kart/index.html +14 -0
- package/templates/kart/kit.json +8 -0
- package/templates/kart/native-playtests/survives.playtest.json +65 -0
- package/templates/kart/opencode.json +49 -0
- package/templates/kart/package.json +64 -0
- package/templates/kart/playtests/drift.playtest.json +226 -0
- package/templates/kart/playtests/explore.playtest.json +45 -0
- package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
- package/templates/kart/playtests/item-key.playtest.json +108 -0
- package/templates/kart/playtests/items.playtest.json +143 -0
- package/templates/kart/playtests/lap-times.playtest.json +138 -0
- package/templates/kart/playtests/laps.playtest.json +149 -0
- package/templates/kart/playtests/performance.playtest.json +57 -0
- package/templates/kart/playtests/race.playtest.json +294 -0
- package/templates/kart/playtests/restart.playtest.json +87 -0
- package/templates/kart/playtests/rocket-start.playtest.json +56 -0
- package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
- package/templates/kart/playtests/surfaces.playtest.json +113 -0
- package/templates/kart/playtests/survives.playtest.json +116 -0
- package/templates/kart/playtests/wall.playtest.json +118 -0
- package/templates/kart/public/favicon.svg +4 -0
- package/templates/kart/src/entities/Driver.ts +123 -0
- package/templates/kart/src/entities/Items.ts +194 -0
- package/templates/kart/src/entities/Kart.ts +517 -0
- package/templates/kart/src/game.ts +45 -0
- package/templates/kart/src/main.ts +14 -0
- package/templates/kart/src/playtest-events.ts +15 -0
- package/templates/kart/src/render/camera.ts +83 -0
- package/templates/kart/src/render/course.ts +579 -0
- package/templates/kart/src/render/effects.ts +266 -0
- package/templates/kart/src/render/items.ts +163 -0
- package/templates/kart/src/render/kart.ts +256 -0
- package/templates/kart/src/render/kitExposure.ts +20 -0
- package/templates/kart/src/render/lighting.ts +58 -0
- package/templates/kart/src/render/loading.ts +332 -0
- package/templates/kart/src/render/materials.ts +119 -0
- package/templates/kart/src/render/palette.ts +74 -0
- package/templates/kart/src/render/postprocessing.ts +79 -0
- package/templates/kart/src/render/quality.ts +54 -0
- package/templates/kart/src/render/skids.ts +86 -0
- package/templates/kart/src/render/sky.ts +105 -0
- package/templates/kart/src/render/touch-controls.ts +168 -0
- package/templates/kart/src/render/touch-layout.ts +48 -0
- package/templates/kart/src/scenes/Race.ts +850 -0
- package/templates/kart/src/state.ts +53 -0
- package/templates/kart/src/style.css +106 -0
- package/templates/kart/src/track/Course.ts +276 -0
- package/templates/kart/src/track/Race.ts +133 -0
- package/templates/kart/src/ui/App.tsx +21 -0
- package/templates/kart/src/ui/GameUi.tsx +20 -0
- package/templates/kart/src/ui/Hud.tsx +172 -0
- package/templates/kart/src/ui/Menu.tsx +13 -0
- package/templates/kart/src/ui/main.tsx +14 -0
- package/templates/kart/tailwind.config.ts +2 -0
- package/templates/kart/threenative.config.ts +62 -0
- package/templates/kart/tsconfig.json +17 -0
- package/templates/kart/vite.config.ts +49 -0
- package/templates/minimal/.codex/config.toml +6 -2
- package/templates/minimal/.cursor/mcp.json +8 -2
- package/templates/minimal/.gemini/settings.json +8 -2
- package/templates/minimal/.mcp.json +8 -2
- package/templates/minimal/.vscode/mcp.json +9 -2
- package/templates/minimal/.zed/settings.json +9 -2
- package/templates/minimal/AGENTS.md +11 -13
- package/templates/minimal/CLAUDE.md +11 -13
- package/templates/minimal/opencode.json +10 -2
- package/templates/minimal/package.json +14 -9
- package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
- package/templates/minimal/playtests/jump.playtest.json +45 -0
- package/templates/minimal/playtests/play.playtest.json +1 -1
- package/templates/minimal/src/game.ts +2 -0
- package/templates/minimal/src/render/atmosphere.ts +444 -0
- package/templates/minimal/src/render/backlightMaterial.ts +49 -18
- package/templates/minimal/src/render/camera.ts +35 -4
- package/templates/minimal/src/render/clouds.ts +605 -0
- package/templates/minimal/src/render/exposure.ts +7 -111
- package/templates/minimal/src/render/gpuSky.ts +752 -0
- package/templates/minimal/src/render/lighting.ts +26 -4
- package/templates/minimal/src/render/materialLighting.ts +2 -10
- package/templates/minimal/src/render/postprocessing.ts +4 -4
- package/templates/minimal/src/render/quality.ts +10 -116
- package/templates/minimal/src/render/sky.ts +73 -1
- package/templates/minimal/src/scenes/Play.ts +18 -7
- package/templates/platformer/.codex/config.toml +6 -2
- package/templates/platformer/.cursor/mcp.json +8 -2
- package/templates/platformer/.gemini/settings.json +8 -2
- package/templates/platformer/.mcp.json +8 -2
- package/templates/platformer/.vscode/mcp.json +9 -2
- package/templates/platformer/.zed/settings.json +9 -2
- package/templates/platformer/AGENTS.md +13 -9
- package/templates/platformer/CLAUDE.md +13 -9
- package/templates/platformer/opencode.json +10 -2
- package/templates/platformer/package.json +15 -10
- package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
- package/templates/platformer/playtests/finish.playtest.json +58 -0
- package/templates/platformer/playtests/idle.playtest.json +44 -0
- package/templates/platformer/playtests/performance.playtest.json +1 -1
- package/templates/platformer/src/entities/Fox.ts +19 -6
- package/templates/platformer/src/game.ts +1 -0
- package/templates/platformer/src/level/Stage.ts +4 -1
- package/templates/platformer/src/render/backlightMaterial.ts +49 -18
- package/templates/platformer/src/render/camera.ts +30 -1
- package/templates/platformer/src/render/exposure.ts +6 -111
- package/templates/platformer/src/render/fox.ts +5 -2
- package/templates/platformer/src/render/kitExposure.ts +20 -0
- package/templates/platformer/src/render/materialLighting.ts +2 -11
- package/templates/platformer/src/render/postprocessing.ts +4 -4
- package/templates/platformer/src/render/props.ts +1 -2
- package/templates/platformer/src/render/quality.ts +10 -118
- package/templates/platformer/src/scenes/Play.ts +31 -15
- package/templates/platformer/src/ui/Menu.tsx +1 -1
- package/templates/puzzle/.codex/config.toml +6 -2
- package/templates/puzzle/.cursor/mcp.json +8 -2
- package/templates/puzzle/.gemini/settings.json +8 -2
- package/templates/puzzle/.mcp.json +8 -2
- package/templates/puzzle/.vscode/mcp.json +9 -2
- package/templates/puzzle/.zed/settings.json +9 -2
- package/templates/puzzle/AGENTS.md +14 -17
- package/templates/puzzle/CLAUDE.md +14 -17
- package/templates/puzzle/opencode.json +10 -2
- package/templates/puzzle/package.json +15 -10
- package/templates/puzzle/playtests/performance.playtest.json +1 -1
- package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
- package/templates/puzzle/src/render/exposure.ts +11 -109
- package/templates/puzzle/src/render/lighting.ts +3 -3
- package/templates/puzzle/src/render/materialLighting.ts +2 -11
- package/templates/puzzle/src/render/palette.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +4 -4
- package/templates/puzzle/src/render/quality.ts +44 -153
- package/templates/puzzle/src/render/vault.ts +18 -6
- package/templates/puzzle/src/scenes/Play.ts +6 -1
- package/templates/puzzle/src/ui/Hud.tsx +8 -43
- package/templates/racing/.codex/config.toml +6 -2
- package/templates/racing/.cursor/mcp.json +8 -2
- package/templates/racing/.gemini/settings.json +8 -2
- package/templates/racing/.mcp.json +8 -2
- package/templates/racing/.vscode/mcp.json +9 -2
- package/templates/racing/.zed/settings.json +9 -2
- package/templates/racing/AGENTS.md +10 -12
- package/templates/racing/CLAUDE.md +10 -12
- package/templates/racing/opencode.json +10 -2
- package/templates/racing/package.json +15 -10
- package/templates/racing/playtests/brake.playtest.json +54 -0
- package/templates/racing/playtests/outcome.playtest.json +19 -0
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
- package/templates/racing/src/entities/RacingCar.ts +12 -3
- package/templates/racing/src/entities/Rival.ts +11 -2
- package/templates/racing/src/render/atmosphere.ts +444 -0
- package/templates/racing/src/render/backlightMaterial.ts +49 -18
- package/templates/racing/src/render/clouds.ts +605 -0
- package/templates/racing/src/render/exposure.ts +6 -111
- package/templates/racing/src/render/gpuSky.ts +752 -0
- package/templates/racing/src/render/kitExposure.ts +20 -0
- package/templates/racing/src/render/lighting.ts +26 -4
- package/templates/racing/src/render/materialLighting.ts +2 -11
- package/templates/racing/src/render/materials.ts +2 -1
- package/templates/racing/src/render/postprocessing.ts +4 -4
- package/templates/racing/src/render/quality.ts +27 -115
- package/templates/racing/src/render/sky.ts +72 -1
- package/templates/racing/src/scenes/Race.ts +9 -7
- package/templates/racing/src/track/TrackSector.ts +5 -2
- package/templates/racing/src/ui/Hud.tsx +12 -7
- package/templates/rain/.codex/config.toml +6 -2
- package/templates/rain/.cursor/mcp.json +8 -2
- package/templates/rain/.gemini/settings.json +8 -2
- package/templates/rain/.mcp.json +8 -2
- package/templates/rain/.vscode/mcp.json +9 -2
- package/templates/rain/.zed/settings.json +9 -2
- package/templates/rain/AGENTS.md +12 -12
- package/templates/rain/CLAUDE.md +12 -12
- package/templates/rain/opencode.json +10 -2
- package/templates/rain/package.json +14 -9
- package/templates/rain/playtests/performance.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/bloom-shader.ts +1 -1
- package/templates/rain/src/render/clouds-shader.ts +2 -2
- package/templates/rain/src/render/clouds.ts +2 -1
- package/templates/rain/src/render/exposure.ts +11 -109
- package/templates/rain/src/render/post-shader.ts +7 -11
- package/templates/rain/src/render/postprocessing.ts +8 -24
- package/templates/rain/src/render/quality.ts +44 -98
- package/templates/rain/src/render/world-shader.ts +281 -97
- package/templates/rain/src/render/world.ts +82 -2
- package/templates/rain/src/style.css +1 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -2
- package/templates/rain/src/ui/Hud.tsx +1 -1
- package/templates/rain/tools/generate-shaders.mjs +2 -2
- package/templates/rain/tools/tempest-post.frag +4 -6
- package/templates/rain/tools/tempest-world.frag +80 -12
- package/templates/rts/.codex/config.toml +6 -2
- package/templates/rts/.cursor/mcp.json +8 -2
- package/templates/rts/.gemini/settings.json +8 -2
- package/templates/rts/.mcp.json +8 -2
- package/templates/rts/.vscode/mcp.json +9 -2
- package/templates/rts/.zed/settings.json +9 -2
- package/templates/rts/AGENTS.md +15 -16
- package/templates/rts/CLAUDE.md +15 -16
- package/templates/rts/opencode.json +10 -2
- package/templates/rts/package.json +14 -9
- package/templates/rts/playtests/performance.playtest.json +1 -1
- package/templates/rts/playtests/rts-attack.playtest.json +5 -0
- package/templates/rts/playtests/rts-build.playtest.json +20 -1
- package/templates/rts/playtests/rts-orders.playtest.json +1 -1
- package/templates/rts/playtests/rts-pause.playtest.json +112 -0
- package/templates/rts/playtests/rts-train.playtest.json +1 -1
- package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
- package/templates/rts/src/game.ts +29 -7
- package/templates/rts/src/render/army.ts +181 -49
- package/templates/rts/src/render/backlightMaterial.ts +49 -18
- package/templates/rts/src/render/environment.ts +276 -0
- package/templates/rts/src/render/exposure.ts +3 -65
- package/templates/rts/src/render/ground.ts +478 -0
- package/templates/rts/src/render/lighting.ts +62 -11
- package/templates/rts/src/render/materialLighting.ts +2 -11
- package/templates/rts/src/render/materials.ts +47 -118
- package/templates/rts/src/render/palette.ts +30 -13
- package/templates/rts/src/render/picking.ts +18 -0
- package/templates/rts/src/render/postprocessing.ts +4 -4
- package/templates/rts/src/render/quality.ts +64 -85
- package/templates/rts/src/render/resources.ts +21 -22
- package/templates/rts/src/render/sky.ts +9 -12
- package/templates/rts/src/render/terrain.ts +36 -11
- package/templates/rts/src/scenes/Play.ts +373 -38
- package/templates/rts/src/sim/ai.ts +0 -11
- package/templates/rts/src/state.ts +46 -0
- package/templates/rts/src/style.css +1543 -0
- package/templates/rts/src/ui/Commands.tsx +204 -107
- package/templates/rts/src/ui/GameUi.tsx +12 -5
- package/templates/rts/src/ui/Hud.tsx +611 -116
- package/templates/rts/src/ui/Minimap.tsx +103 -37
- package/templates/rts/src/ui/icons.tsx +116 -0
- package/templates/rts/src/ui/labels.ts +73 -0
- package/templates/rts/src/ui/minimapPoint.ts +30 -0
- package/templates/rts/threenative.config.ts +1 -1
- package/templates/runner/.codex/config.toml +6 -2
- package/templates/runner/.cursor/mcp.json +8 -2
- package/templates/runner/.gemini/settings.json +8 -2
- package/templates/runner/.mcp.json +8 -2
- package/templates/runner/.vscode/mcp.json +9 -2
- package/templates/runner/.zed/settings.json +9 -2
- package/templates/runner/AGENTS.md +12 -12
- package/templates/runner/CLAUDE.md +12 -12
- package/templates/runner/opencode.json +10 -2
- package/templates/runner/package.json +15 -10
- package/templates/runner/playtests/near-miss.playtest.json +48 -0
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/playtests/stride.playtest.json +27 -0
- package/templates/runner/playtests/survives.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +3 -1
- package/templates/runner/src/entities/Runner.ts +11 -5
- package/templates/runner/src/render/atmosphere.ts +444 -0
- package/templates/runner/src/render/backlightMaterial.ts +49 -18
- package/templates/runner/src/render/clouds.ts +605 -0
- package/templates/runner/src/render/exposure.ts +6 -111
- package/templates/runner/src/render/gpuSky.ts +752 -0
- package/templates/runner/src/render/kitExposure.ts +20 -0
- package/templates/runner/src/render/lighting.ts +26 -4
- package/templates/runner/src/render/materialLighting.ts +2 -11
- package/templates/runner/src/render/postprocessing.ts +4 -4
- package/templates/runner/src/render/quality.ts +26 -114
- package/templates/runner/src/render/sky.ts +73 -1
- package/templates/runner/src/scenes/Run.ts +19 -15
- package/templates/runner/src/track.ts +12 -3
- package/templates/sailing/.codex/config.toml +6 -2
- package/templates/sailing/.cursor/mcp.json +8 -2
- package/templates/sailing/.gemini/settings.json +8 -2
- package/templates/sailing/.mcp.json +8 -2
- package/templates/sailing/.vscode/mcp.json +9 -2
- package/templates/sailing/.zed/settings.json +9 -2
- package/templates/sailing/AGENTS.md +10 -11
- package/templates/sailing/CLAUDE.md +10 -11
- package/templates/sailing/opencode.json +10 -2
- package/templates/sailing/package.json +15 -10
- package/templates/sailing/playtests/fail.playtest.json +46 -5
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
- package/templates/sailing/playtests/performance.playtest.json +1 -1
- package/templates/sailing/src/game.ts +1 -0
- package/templates/sailing/src/render/backlightMaterial.ts +49 -18
- package/templates/sailing/src/render/exposure.ts +6 -111
- package/templates/sailing/src/render/kitExposure.ts +20 -0
- package/templates/sailing/src/render/materialLighting.ts +2 -11
- package/templates/sailing/src/render/ocean.ts +0 -1
- package/templates/sailing/src/render/postprocessing.ts +4 -4
- package/templates/sailing/src/render/quality.ts +31 -138
- package/templates/sailing/src/scenes/Sailing.ts +12 -4
- package/templates/sailing/src/ui/Hud.tsx +6 -2
- package/templates/sailing/src/ui/Menu.tsx +1 -1
- package/templates/shooter/.codex/config.toml +6 -2
- package/templates/shooter/.cursor/mcp.json +8 -2
- package/templates/shooter/.gemini/settings.json +8 -2
- package/templates/shooter/.mcp.json +8 -2
- package/templates/shooter/.vscode/mcp.json +9 -2
- package/templates/shooter/.zed/settings.json +9 -2
- package/templates/shooter/AGENTS.md +13 -12
- package/templates/shooter/CLAUDE.md +13 -12
- package/templates/shooter/index.html +1 -1
- package/templates/shooter/main.html +13 -0
- package/templates/shooter/opencode.json +10 -2
- package/templates/shooter/package.json +15 -10
- package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
- package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
- package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
- package/templates/shooter/playtests/performance.playtest.json +3 -3
- package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
- package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
- package/templates/shooter/src/entities/Breakables.ts +34 -10
- package/templates/shooter/src/entities/Enemy.ts +176 -54
- package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
- package/templates/shooter/src/entities/Rifle.ts +83 -9
- package/templates/shooter/src/entities/movement.ts +96 -0
- package/templates/shooter/src/render/atmosphere.ts +444 -0
- package/templates/shooter/src/render/backlightMaterial.ts +49 -18
- package/templates/shooter/src/render/camera.ts +3 -1
- package/templates/shooter/src/render/clouds.ts +605 -0
- package/templates/shooter/src/render/exposure.ts +10 -109
- package/templates/shooter/src/render/facade.ts +26 -68
- package/templates/shooter/src/render/gpuSky.ts +752 -0
- package/templates/shooter/src/render/lighting.ts +27 -4
- package/templates/shooter/src/render/materialAssignments.ts +9 -1
- package/templates/shooter/src/render/materialLighting.ts +2 -11
- package/templates/shooter/src/render/occlusion.ts +13 -4
- package/templates/shooter/src/render/palette.ts +1 -0
- package/templates/shooter/src/render/postprocessing.ts +4 -4
- package/templates/shooter/src/render/quality.ts +50 -108
- package/templates/shooter/src/render/scale.ts +0 -11
- package/templates/shooter/src/render/sky.ts +103 -2
- package/templates/shooter/src/render/surface.ts +140 -0
- package/templates/shooter/src/render/town.ts +3 -6
- package/templates/shooter/src/render/townMaterials.ts +95 -42
- package/templates/shooter/src/render/vehicles.ts +2 -0
- package/templates/shooter/src/scenes/Play.ts +83 -23
- package/templates/shooter/src/ui/Hud.tsx +268 -193
- package/templates/shooter/src/worker-page.ts +29 -0
- package/templates/shooter/src/worker.ts +5 -0
- package/templates/shooter/threenative.config.ts +3 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/.codex/config.toml +6 -2
- package/templates/snow/.cursor/mcp.json +8 -2
- package/templates/snow/.gemini/settings.json +8 -2
- package/templates/snow/.mcp.json +8 -2
- package/templates/snow/.vscode/mcp.json +9 -2
- package/templates/snow/.zed/settings.json +9 -2
- package/templates/snow/AGENTS.md +12 -10
- package/templates/snow/CLAUDE.md +12 -10
- package/templates/snow/opencode.json +10 -2
- package/templates/snow/package.json +15 -10
- package/templates/snow/playtests/performance.playtest.json +1 -1
- package/templates/snow/src/render/backlightMaterial.ts +49 -18
- package/templates/snow/src/render/exposure.ts +17 -106
- package/templates/snow/src/render/materialLighting.ts +2 -11
- package/templates/snow/src/render/postprocessing.ts +11 -5
- package/templates/snow/src/render/quality.ts +46 -126
- package/templates/snow/src/render/snowSurface.ts +32 -15
- package/templates/snow/src/scenes/Snow.ts +2 -1
- package/templates/starter/.codex/config.toml +6 -2
- package/templates/starter/.cursor/mcp.json +8 -2
- package/templates/starter/.gemini/settings.json +8 -2
- package/templates/starter/.mcp.json +8 -2
- package/templates/starter/.vscode/mcp.json +9 -2
- package/templates/starter/.zed/settings.json +9 -2
- package/templates/starter/AGENTS.md +18 -14
- package/templates/starter/CLAUDE.md +18 -14
- package/templates/starter/index.html +1 -1
- package/templates/starter/main.html +12 -0
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
- package/templates/starter/opencode.json +10 -2
- package/templates/starter/package.json +15 -10
- package/templates/starter/playtests/play.playtest.json +22 -2
- package/templates/starter/playtests/production-readiness.playtest.json +14 -0
- package/templates/starter/src/entities/Crate.ts +19 -1
- package/templates/starter/src/render/arena.ts +2 -2
- package/templates/starter/src/render/atmosphere.ts +444 -0
- package/templates/starter/src/render/backlightMaterial.ts +49 -18
- package/templates/starter/src/render/camera.ts +28 -0
- package/templates/starter/src/render/clouds.ts +605 -0
- package/templates/starter/src/render/contactShadow.ts +50 -0
- package/templates/starter/src/render/exposure.ts +9 -111
- package/templates/starter/src/render/gpuSky.ts +752 -0
- package/templates/starter/src/render/grade.ts +1 -1
- package/templates/starter/src/render/lighting.ts +34 -6
- package/templates/starter/src/render/materialLighting.ts +2 -11
- package/templates/starter/src/render/postprocessing.ts +27 -14
- package/templates/starter/src/render/quality.ts +18 -147
- package/templates/starter/src/render/sky.ts +90 -40
- package/templates/starter/src/render/temporalAA.ts +1 -1
- package/templates/starter/src/render/temporalAAStage.ts +1 -1
- package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
- package/templates/starter/src/render/temporalDetailStage.ts +106 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
- package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
- package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
- package/templates/starter/src/scenes/Play.ts +11 -8
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/worker-page.ts +29 -0
- package/templates/starter/src/worker.ts +5 -0
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/.codex/config.toml +6 -2
- package/templates/tower-defense/.cursor/mcp.json +8 -2
- package/templates/tower-defense/.gemini/settings.json +8 -2
- package/templates/tower-defense/.mcp.json +8 -2
- package/templates/tower-defense/.vscode/mcp.json +9 -2
- package/templates/tower-defense/.zed/settings.json +9 -2
- package/templates/tower-defense/AGENTS.md +10 -12
- package/templates/tower-defense/CLAUDE.md +10 -12
- package/templates/tower-defense/opencode.json +10 -2
- package/templates/tower-defense/package.json +15 -10
- package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
- package/templates/tower-defense/playtests/performance.playtest.json +1 -1
- package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
- package/templates/tower-defense/src/render/exposure.ts +11 -109
- package/templates/tower-defense/src/render/lighting.ts +4 -2
- package/templates/tower-defense/src/render/materialLighting.ts +2 -11
- package/templates/tower-defense/src/render/postprocessing.ts +4 -4
- package/templates/tower-defense/src/render/quality.ts +10 -116
- package/templates/tower-defense/src/render/sky.ts +2 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -0
- package/template-assets/autoExposure.ts +0 -225
- package/template-assets/exposureGraph.ts +0 -178
- package/template-assets/exposureReadback.ts +0 -79
- package/template-assets/worldEnvironment.ts +0 -1212
- package/templates/action-rpg/src/render/autoExposure.ts +0 -225
- package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
- package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
- package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
- package/templates/minimal/src/render/autoExposure.ts +0 -225
- package/templates/minimal/src/render/exposureGraph.ts +0 -178
- package/templates/minimal/src/render/exposureReadback.ts +0 -79
- package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
- package/templates/platformer/src/render/autoExposure.ts +0 -225
- package/templates/platformer/src/render/exposureGraph.ts +0 -178
- package/templates/platformer/src/render/exposureReadback.ts +0 -79
- package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
- package/templates/puzzle/src/render/autoExposure.ts +0 -225
- package/templates/puzzle/src/render/exposureGraph.ts +0 -178
- package/templates/puzzle/src/render/exposureReadback.ts +0 -79
- package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
- package/templates/racing/src/render/autoExposure.ts +0 -225
- package/templates/racing/src/render/exposureGraph.ts +0 -178
- package/templates/racing/src/render/exposureReadback.ts +0 -79
- package/templates/racing/src/render/worldEnvironment.ts +0 -1212
- package/templates/rain/src/render/autoExposure.ts +0 -225
- package/templates/rain/src/render/exposureGraph.ts +0 -178
- package/templates/rain/src/render/exposureReadback.ts +0 -79
- package/templates/rain/src/render/worldEnvironment.ts +0 -1212
- package/templates/rts/src/render/autoExposure.ts +0 -225
- package/templates/rts/src/render/exposureGraph.ts +0 -178
- package/templates/rts/src/render/exposureReadback.ts +0 -79
- package/templates/rts/src/render/worldEnvironment.ts +0 -1212
- package/templates/runner/src/render/autoExposure.ts +0 -225
- package/templates/runner/src/render/exposureGraph.ts +0 -178
- package/templates/runner/src/render/exposureReadback.ts +0 -79
- package/templates/runner/src/render/worldEnvironment.ts +0 -1212
- package/templates/sailing/src/render/autoExposure.ts +0 -225
- package/templates/sailing/src/render/exposureGraph.ts +0 -178
- package/templates/sailing/src/render/exposureReadback.ts +0 -79
- package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
- package/templates/shooter/src/render/autoExposure.ts +0 -225
- package/templates/shooter/src/render/exposureGraph.ts +0 -178
- package/templates/shooter/src/render/exposureReadback.ts +0 -79
- package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
- package/templates/snow/src/render/autoExposure.ts +0 -225
- package/templates/snow/src/render/exposureGraph.ts +0 -178
- package/templates/snow/src/render/exposureReadback.ts +0 -79
- package/templates/snow/src/render/worldEnvironment.ts +0 -1212
- package/templates/starter/src/render/autoExposure.ts +0 -225
- package/templates/starter/src/render/exposureGraph.ts +0 -178
- package/templates/starter/src/render/exposureReadback.ts +0 -79
- package/templates/starter/src/render/worldEnvironment.ts +0 -1212
- package/templates/tower-defense/src/render/autoExposure.ts +0 -225
- package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
- package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
- package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { ChainStage } from "@threenative/core";
|
|
1
2
|
// Generated for you: ordinary Three.js; ThreeNative does not read this file.
|
|
2
3
|
//
|
|
3
4
|
// The last two stages of this game's frame: a colour grade, and the film grain over it. Both are
|
|
@@ -28,7 +29,6 @@ import { lut3D } from "three/addons/tsl/display/Lut3DNode.js";
|
|
|
28
29
|
import { float, renderOutput, texture3D, time, uv } from "three/tsl";
|
|
29
30
|
import type { Node } from "three/webgpu";
|
|
30
31
|
import type { QualityTier } from "./quality.js";
|
|
31
|
-
import type { ChainStage } from "./worldEnvironment.js";
|
|
32
32
|
|
|
33
33
|
/**
|
|
34
34
|
* What `TN_RENDER_CHAIN` prints when a stage is refused. Never blank, and never the same answer
|
|
@@ -1,10 +1,33 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
// ThreeNative does not read this file.
|
|
3
3
|
//
|
|
4
|
-
// One sun. The sky
|
|
5
|
-
//
|
|
4
|
+
// One sun. The sky in `sky.ts` is the fill light — its environment reaches every face the sun
|
|
5
|
+
// misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
|
|
6
6
|
import { Color, DirectionalLight, PCFSoftShadowMap, type Scene, Vector3 } from "three";
|
|
7
|
-
import {
|
|
7
|
+
import { ARENA, GROUND_Y } from "./arena.js";
|
|
8
|
+
import {
|
|
9
|
+
SUN_ILLUMINANCE,
|
|
10
|
+
SUN_KELVIN,
|
|
11
|
+
sunLight,
|
|
12
|
+
sunLightTransmittance,
|
|
13
|
+
temperatureColour,
|
|
14
|
+
} from "./atmosphere.js";
|
|
15
|
+
import { SKY_OPTIONS, SUN_DIRECTION } from "./sky.js";
|
|
16
|
+
|
|
17
|
+
/** The sun as Unreal's default level has it: 6 lux at 6500 K, tinted by the air it crosses. */
|
|
18
|
+
function atmosphereSun(): DirectionalLight {
|
|
19
|
+
const tint = temperatureColour(SUN_KELVIN);
|
|
20
|
+
const through = sunLightTransmittance(Math.asin(Math.min(1, Math.max(-1, SUN_DIRECTION.y))));
|
|
21
|
+
const colour = new Color().setRGB(
|
|
22
|
+
tint[0] * through[0],
|
|
23
|
+
tint[1] * through[1],
|
|
24
|
+
tint[2] * through[2],
|
|
25
|
+
);
|
|
26
|
+
const key = new DirectionalLight(colour, SUN_ILLUMINANCE);
|
|
27
|
+
// `gpuSky.ts` re-tints it when the sun moves.
|
|
28
|
+
sunLight.current = key;
|
|
29
|
+
return key;
|
|
30
|
+
}
|
|
8
31
|
|
|
9
32
|
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
10
33
|
|
|
@@ -16,8 +39,8 @@ export function setupLighting(
|
|
|
16
39
|
renderer.shadowMap.enabled = true;
|
|
17
40
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
18
41
|
|
|
19
|
-
//
|
|
20
|
-
const key = new DirectionalLight(0xfff1e0, 4.5);
|
|
42
|
+
// The photo sky keeps the warm white matched by eye to its photographed midday sun.
|
|
43
|
+
const key = SKY_OPTIONS.sky === "photo" ? new DirectionalLight(0xfff1e0, 4.5) : atmosphereSun();
|
|
21
44
|
key.position.copy(SUN_DIRECTION).multiplyScalar(30);
|
|
22
45
|
key.castShadow = true;
|
|
23
46
|
// One map fitted to the 28 m arena: 4096² is under a centimetre a texel, so every shadow has the
|
|
@@ -28,7 +51,12 @@ export function setupLighting(
|
|
|
28
51
|
key.shadow.radius = 2;
|
|
29
52
|
key.shadow.camera.near = 1;
|
|
30
53
|
key.shadow.camera.far = 80;
|
|
31
|
-
|
|
54
|
+
// Cover the arena's diagonal in light space, so a wall shadow cannot stop at the map edge.
|
|
55
|
+
const extent = Math.hypot(
|
|
56
|
+
ARENA.halfX + ARENA.thickness / 2,
|
|
57
|
+
ARENA.halfZ + ARENA.thickness / 2,
|
|
58
|
+
Math.max(Math.abs(GROUND_Y), Math.abs(ARENA.wallTop)),
|
|
59
|
+
);
|
|
32
60
|
key.shadow.camera.left = -extent;
|
|
33
61
|
key.shadow.camera.right = extent;
|
|
34
62
|
key.shadow.camera.top = extent;
|
|
@@ -1,15 +1,6 @@
|
|
|
1
1
|
// Generated for you. Scene-owned material assignments; no engine appearance hooks.
|
|
2
|
-
import {
|
|
3
|
-
|
|
4
|
-
type DirectionalLight,
|
|
5
|
-
Material,
|
|
6
|
-
Mesh,
|
|
7
|
-
MeshStandardMaterial,
|
|
8
|
-
type Object3D,
|
|
9
|
-
type Scene,
|
|
10
|
-
type Texture,
|
|
11
|
-
} from "three";
|
|
12
|
-
import { type IBacklightControls, backlightMaterial } from "./backlightMaterial.js";
|
|
2
|
+
import type { Camera, DirectionalLight, Object3D, Scene, Texture } from "three";
|
|
3
|
+
import type { IBacklightControls } from "./backlightMaterial.js";
|
|
13
4
|
import {
|
|
14
5
|
type IEnvironmentMeasurement,
|
|
15
6
|
measureEnvironment,
|
|
@@ -1,14 +1,12 @@
|
|
|
1
|
+
import { type OutputRenderer, WorldEnvironment } from "@threenative/core";
|
|
1
2
|
// Generated for you: ordinary Three.js; ThreeNative does not read this file.
|
|
2
3
|
//
|
|
3
|
-
// This file wires two things together and decides nothing itself. `quality.ts
|
|
4
|
-
//
|
|
5
|
-
//
|
|
6
|
-
// applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
|
|
7
|
-
// one you turned off.
|
|
4
|
+
// This file wires two things together and decides nothing itself. `quality.ts` owns which stages
|
|
5
|
+
// run at which tier and records what each one measured. Core's `WorldEnvironment` builds them and
|
|
6
|
+
// prints `TN_WORLD_ENVIRONMENT`, naming every stage as applied or refused **with a reason**.
|
|
8
7
|
//
|
|
9
|
-
// To make the game cheaper or prettier everywhere, edit `quality.ts`. To force one tier for one
|
|
10
|
-
//
|
|
11
|
-
// `setupPost(renderer, scene, camera, { tier: "low" })`. Overriding does not silence the report:
|
|
8
|
+
// To make the game cheaper or prettier everywhere, edit `quality.ts`. To force one tier for one run
|
|
9
|
+
// (a slow desktop, a capture to compare), pass `setupPost(renderer, scene, camera, { tier: "low" })`.
|
|
12
10
|
// `TN_QUALITY_TIER` names the tier that ran either way.
|
|
13
11
|
import { type Camera, type DirectionalLight, FloatType, type Scene } from "three";
|
|
14
12
|
import { LUTCubeLoader } from "three/addons/loaders/LUTCubeLoader.js";
|
|
@@ -21,8 +19,8 @@ import {
|
|
|
21
19
|
import { type IGradeTable, filterableTable, gradeStages } from "./grade.js";
|
|
22
20
|
import { type QualityTier, gradePreset, qualityPreset } from "./quality.js";
|
|
23
21
|
import { type TemporalAAProvider, temporalAAStages } from "./temporalAAStage.js";
|
|
22
|
+
import { temporalDetailRequested, temporalDetailStages } from "./temporalDetailStage.js";
|
|
24
23
|
import type { FogMedium } from "./volumetricFog.js";
|
|
25
|
-
import { type OutputRenderer, WorldEnvironment } from "./worldEnvironment.js";
|
|
26
24
|
|
|
27
25
|
interface IPostController {
|
|
28
26
|
readonly tier: QualityTier;
|
|
@@ -72,6 +70,8 @@ export function setupPost(
|
|
|
72
70
|
* rather than composed twice. Omit it and the chain starts from the beauty pass unchanged.
|
|
73
71
|
*/
|
|
74
72
|
fog?: () => FogMedium | undefined;
|
|
73
|
+
/** `new TracedReflections(root)` once static meshes exist: chrome reflects the scene, not only the screen. */
|
|
74
|
+
reflectionTrace?: NonNullable<Parameters<WorldEnvironment["apply"]>[3]>["reflectionTrace"];
|
|
75
75
|
} = {},
|
|
76
76
|
): IPostController {
|
|
77
77
|
const policy = createAdaptiveQuality(environment, environment);
|
|
@@ -83,6 +83,8 @@ export function setupPost(
|
|
|
83
83
|
// The opt-in `traa` stage publishes its provider here once the chain has built it, so `debug()`
|
|
84
84
|
// reports the live reconstruction state and a scene can reset history on a teleport.
|
|
85
85
|
let temporal: TemporalAAProvider | undefined;
|
|
86
|
+
// The chain's own temporal AA (`temporalAA` in `quality.ts`) reads the engine's live frame, history and jitter.
|
|
87
|
+
let engineTemporal: (() => Record<string, unknown>) | undefined;
|
|
86
88
|
let observation: Record<string, unknown> = {
|
|
87
89
|
tier: policy.tier,
|
|
88
90
|
source: policy.pinned ? "pinned" : "auto",
|
|
@@ -94,14 +96,20 @@ export function setupPost(
|
|
|
94
96
|
medium = environment.fog?.();
|
|
95
97
|
const composed = medium;
|
|
96
98
|
const settings = qualityPreset(policy.tier);
|
|
99
|
+
const detail = temporalDetailRequested(renderer, settings) ? temporalDetailStages() : [];
|
|
97
100
|
const world = new WorldEnvironment({
|
|
98
101
|
...settings,
|
|
99
|
-
//
|
|
100
|
-
//
|
|
101
|
-
|
|
102
|
-
|
|
102
|
+
// Game-owned grade/grain and authored TRAA follow quality.ts; WorldEnvironment orders them.
|
|
103
|
+
// Listing traa replaces the chain's temporalAA provider.
|
|
104
|
+
authoredStageNames: [
|
|
105
|
+
"grade",
|
|
106
|
+
"grain",
|
|
107
|
+
...(settings.authoredStageNames ?? []),
|
|
108
|
+
...detail.map(({ name }) => name),
|
|
109
|
+
],
|
|
103
110
|
authoredStages: (stage) => [
|
|
104
111
|
...gradeStages(gradePreset(policy.tier), table),
|
|
112
|
+
...detail,
|
|
105
113
|
...temporalAAStages(stage, {
|
|
106
114
|
onProvider: (provider) => {
|
|
107
115
|
temporal = provider;
|
|
@@ -111,10 +119,12 @@ export function setupPost(
|
|
|
111
119
|
});
|
|
112
120
|
const applied = world.apply(renderer, scene, camera, {
|
|
113
121
|
godraysLight: environment.godraysLight,
|
|
122
|
+
reflectionTrace: environment.reflectionTrace,
|
|
114
123
|
// Ahead of exposure and every stage, which is the only place a participating medium can go.
|
|
115
124
|
baseColour: composed === undefined ? undefined : (scenePass) => composed.compose(scenePass),
|
|
116
125
|
});
|
|
117
126
|
disposeGraph = applied.dispose;
|
|
127
|
+
engineTemporal = applied.temporalReport;
|
|
118
128
|
observation = { ...observation, stages: applied.stages, dropped: applied.dropped };
|
|
119
129
|
environment.onTierChanged?.(policy.tier);
|
|
120
130
|
}
|
|
@@ -153,7 +163,10 @@ export function setupPost(
|
|
|
153
163
|
get tier(): QualityTier {
|
|
154
164
|
return policy.tier;
|
|
155
165
|
},
|
|
156
|
-
debug: () =>
|
|
166
|
+
debug: () => {
|
|
167
|
+
const report = temporal ? temporal.report() : engineTemporal?.();
|
|
168
|
+
return report === undefined ? { ...observation } : { ...observation, temporal: report };
|
|
169
|
+
},
|
|
157
170
|
observe(window: IQualityWindow): void {
|
|
158
171
|
if (disposed) return;
|
|
159
172
|
const decision = policy.observe(window);
|
|
@@ -1,3 +1,9 @@
|
|
|
1
|
+
import {
|
|
2
|
+
type IWorldEnvironmentOptions,
|
|
3
|
+
qualityPreset as coreQualityPreset,
|
|
4
|
+
qualityTiers,
|
|
5
|
+
} from "@threenative/core";
|
|
6
|
+
import { exposureSettings } from "./exposure.js";
|
|
1
7
|
// Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
|
|
2
8
|
// it freely — the tiers below are a starting point, not a framework look.
|
|
3
9
|
//
|
|
@@ -20,165 +26,30 @@
|
|
|
20
26
|
// in `sky.ts`, not in this file.
|
|
21
27
|
//
|
|
22
28
|
import type { IGradeSettings } from "./grade.js";
|
|
23
|
-
|
|
29
|
+
export type { QualityTier } from "@threenative/core";
|
|
30
|
+
import type { QualityTier } from "@threenative/core";
|
|
24
31
|
|
|
25
32
|
/**
|
|
26
33
|
* This game's authored looks. GPU family picks the start; measured frame budgets refine it.
|
|
27
34
|
* Edit these presets to change the look without changing the framework.
|
|
28
35
|
*/
|
|
29
|
-
export
|
|
30
|
-
|
|
31
|
-
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
32
|
-
|
|
33
|
-
/**
|
|
34
|
-
* Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
|
|
35
|
-
* `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
|
|
36
|
-
*/
|
|
37
|
-
function isQualityTier(value: string): value is QualityTier {
|
|
38
|
-
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
/**
|
|
42
|
-
* Where each GPU family starts, from `ctx.renderer.gpuClass`.
|
|
43
|
-
*
|
|
44
|
-
* A start, not a ceiling: the measured frame-budget windows move the look from here, and an
|
|
45
|
-
* explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
|
|
46
|
-
* family rule matched — falls back to the `mobile` flag, exactly as before families existed.
|
|
47
|
-
* Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
|
|
48
|
-
*/
|
|
49
|
-
const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
|
|
50
|
-
software: "low",
|
|
51
|
-
"mobile-low": "low",
|
|
52
|
-
"mobile-mid": "low",
|
|
53
|
-
"mobile-high": "medium",
|
|
54
|
-
integrated: "medium",
|
|
55
|
-
discrete: "high",
|
|
56
|
-
};
|
|
36
|
+
export const resolveQualityTier = qualityTiers.resolve;
|
|
57
37
|
|
|
58
38
|
/**
|
|
59
|
-
*
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
* turned out to have no effect.
|
|
64
|
-
*/
|
|
65
|
-
export function resolveQualityTier(
|
|
66
|
-
request: {
|
|
67
|
-
readonly gpuClass?: string;
|
|
68
|
-
readonly mobile?: boolean;
|
|
69
|
-
readonly software?: boolean;
|
|
70
|
-
readonly tier?: string;
|
|
71
|
-
} = {},
|
|
72
|
-
): QualityTier {
|
|
73
|
-
const requested = request.tier;
|
|
74
|
-
if (requested !== undefined) {
|
|
75
|
-
if (!isQualityTier(requested)) {
|
|
76
|
-
throw new Error(
|
|
77
|
-
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
78
|
-
);
|
|
79
|
-
}
|
|
80
|
-
return requested;
|
|
81
|
-
}
|
|
82
|
-
// A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
|
|
83
|
-
// game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
|
|
84
|
-
// drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
|
|
85
|
-
// fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
|
|
86
|
-
// `tier` above still wins over it.
|
|
87
|
-
if (request.software === true) return "low";
|
|
88
|
-
const family =
|
|
89
|
-
request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
|
|
90
|
-
if (family !== undefined) return family;
|
|
91
|
-
return request.mobile === true ? "low" : "high";
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
/**
|
|
95
|
-
* The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the
|
|
96
|
-
* sun disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey
|
|
97
|
-
* platforms and flattens contrast), a corner falloff, and the shared chain's SMAA. Antialiasing is
|
|
98
|
-
* on in every tier that installs a chain; see `screenSpaceAA` in `worldEnvironment.ts`.
|
|
99
|
-
*
|
|
100
|
-
* No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
|
|
101
|
-
* captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
|
|
102
|
-
* smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
|
|
103
|
-
*/
|
|
104
|
-
const shared: IWorldEnvironmentOptions = {
|
|
105
|
-
autoExposureEnabled: false,
|
|
106
|
-
// Bloom cost: ~4.6 ms in the reference ablation — the second most expensive stage there.
|
|
107
|
-
bloomEnabled: true,
|
|
108
|
-
bloomRadius: 0.6,
|
|
109
|
-
bloomStrength: 0.22,
|
|
110
|
-
bloomThreshold: 1,
|
|
111
|
-
exposure: 0.62,
|
|
112
|
-
tonemapMode: "aces",
|
|
113
|
-
vignetteAmount: 0.22,
|
|
114
|
-
};
|
|
115
|
-
|
|
116
|
-
/**
|
|
117
|
-
* What a desktop gets: contact occlusion on top — the dark line where a foot meets the platform
|
|
118
|
-
* and a wall meets the ground, most of what separates "objects in a world" from "objects pasted on
|
|
119
|
-
* a background". Gathered at full resolution and denoised: at half, the upsample left a grain
|
|
120
|
-
* around every foot.
|
|
121
|
-
*/
|
|
122
|
-
const high: IWorldEnvironmentOptions = {
|
|
123
|
-
...shared,
|
|
124
|
-
// GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
|
|
125
|
-
gtaoEnabled: true,
|
|
126
|
-
gtaoRadius: 0.35,
|
|
127
|
-
renderChainTier: "high",
|
|
128
|
-
// Temporal AA is opt-in and no shipped tier names it: add `authoredStageNames: ["traa"]` here to
|
|
129
|
-
// reconstruct at the display raster, and read `setupPost(...).debug().temporal` for the reset and
|
|
130
|
-
// raster state it reports. Its rejection fraction, ghosting and frame-time cost are unqualified.
|
|
131
|
-
};
|
|
132
|
-
|
|
133
|
-
/**
|
|
134
|
-
* The rung in between: the same occlusion at half the directions. Saving unmeasured, and the
|
|
135
|
-
* chain's own antialiasing one notch cheaper.
|
|
136
|
-
*/
|
|
137
|
-
// SMAA owns medium edges; another four-sample world resolve adds mobile bandwidth.
|
|
138
|
-
const medium: IWorldEnvironmentOptions = {
|
|
139
|
-
...high,
|
|
140
|
-
gtaoSamples: 8,
|
|
141
|
-
renderChainTier: "medium",
|
|
142
|
-
samples: 0,
|
|
143
|
-
};
|
|
144
|
-
|
|
145
|
-
/** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
|
|
146
|
-
const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
|
|
147
|
-
|
|
148
|
-
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
149
|
-
|
|
150
|
-
/**
|
|
151
|
-
* This game's colour grade and grain, per tier. The table itself lives in `public/grade.cube` and
|
|
152
|
-
* the maths in `grade.ts`; these are the four numbers the look is dialled with.
|
|
153
|
-
*
|
|
154
|
-
* **The grain default is 1/255, and that is the point.** `film()` scales its noise by
|
|
155
|
-
* the pixel's own value, so on mid-grey concrete this moves a channel by well under half an 8-bit
|
|
156
|
-
* step — below what the framebuffer can show. It shipped at 0.12, and a blind judge called the
|
|
157
|
-
* result "grain clearly visible as speckle over sky and flat walls and behind HUD text". A default
|
|
158
|
-
* must never degrade the look, so raise this number when you want the film look: 0.12 is a visible
|
|
159
|
-
* grain, 0.3 a heavy one.
|
|
160
|
-
*
|
|
161
|
-
* A zero refuses its stage rather than running it at zero strength, so `low` — a phone, where a
|
|
162
|
-
* moving grain is the first thing to go — reports `grain` as refused with its reason instead of
|
|
163
|
-
* reading as applied. The grade survives there: it is one texture fetch and the frame is the
|
|
164
|
-
* same frame without it. `high` keeps a non-zero grain on purpose, so `TN_RENDER_CHAIN` can still
|
|
165
|
-
* name it as applied there rather than reporting the stage a default deliberately declined to run.
|
|
39
|
+
* This game's colour grade and grain, per tier (`grade.ts`, `public/grade.cube`). **Both are off, as in
|
|
40
|
+
* a fresh Unreal project** (Scene.cpp: neutral grade, `FilmGrainIntensity` 0). A zero refuses its stage
|
|
41
|
+
* and `TN_RENDER_CHAIN` says why. Turn them on with `gradeIntensity: 1` and a `grainIntensity` from
|
|
42
|
+
* 0.0039 (under one 8-bit step on mid grey) to 0.12 (a visible film grain).
|
|
166
43
|
*/
|
|
167
44
|
const GRADE_PRESETS: Record<QualityTier, IGradeSettings> = {
|
|
168
|
-
high: { gradeIntensity:
|
|
169
|
-
medium: { gradeIntensity:
|
|
170
|
-
low: { gradeIntensity:
|
|
45
|
+
high: { gradeIntensity: 0, grainAnimated: true, grainIntensity: 0, tier: "high" },
|
|
46
|
+
medium: { gradeIntensity: 0, grainAnimated: false, grainIntensity: 0, tier: "medium" },
|
|
47
|
+
low: { gradeIntensity: 0, grainAnimated: false, grainIntensity: 0, tier: "low" },
|
|
171
48
|
};
|
|
172
49
|
|
|
173
50
|
/** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
|
|
174
51
|
export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
175
|
-
|
|
176
|
-
if (preset === undefined) {
|
|
177
|
-
throw new Error(
|
|
178
|
-
`Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
179
|
-
);
|
|
180
|
-
}
|
|
181
|
-
return preset;
|
|
52
|
+
return { ...coreQualityPreset(tier), exposurePolicy: exposureSettings };
|
|
182
53
|
}
|
|
183
54
|
|
|
184
55
|
/** The grade and grain a tier runs. Throws on a name that is not a tier, for the same reason. */
|
|
@@ -186,7 +57,7 @@ export function gradePreset(tier: string): IGradeSettings {
|
|
|
186
57
|
const preset = GRADE_PRESETS[tier as QualityTier];
|
|
187
58
|
if (preset === undefined) {
|
|
188
59
|
throw new Error(
|
|
189
|
-
`Unknown quality tier ${JSON.stringify(tier)} — expected one of ${
|
|
60
|
+
`Unknown quality tier ${JSON.stringify(tier)} — expected one of ${["low", "medium", "high"].join(", ")}.`,
|
|
190
61
|
);
|
|
191
62
|
}
|
|
192
63
|
return preset;
|
|
@@ -1,11 +1,15 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
// ThreeNative does not read this file.
|
|
3
3
|
//
|
|
4
|
-
// The sky is
|
|
5
|
-
// by
|
|
6
|
-
//
|
|
7
|
-
//
|
|
8
|
-
//
|
|
4
|
+
// The sky is Unreal 5.8.3's default level: a Sky Atmosphere with its volumetric cloud layer, a sky
|
|
5
|
+
// light that captures it, a sun tinted by the air it crosses, and an exponential height fog that
|
|
6
|
+
// takes its colour from the sky (`atmosphere.ts`, `clouds.ts`, `gpuSky.ts`). Sun, sky and fog read
|
|
7
|
+
// one illuminance, so moving the sun recolours all three together, as in Unreal.
|
|
8
|
+
//
|
|
9
|
+
// Override: `SKY_OPTIONS.sky = "photo"` draws `assets/sky.jpg` instead — Poly Haven's "Kloofendal 48d
|
|
10
|
+
// Partly Cloudy (Pure Sky)" by Greg Zaal and Jarod Guest, CC0
|
|
11
|
+
// (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky) — as background, environment and
|
|
12
|
+
// fog colour, with the sun aimed at its photographed sun. `clouds: false` keeps a clear sky.
|
|
9
13
|
import {
|
|
10
14
|
EquirectangularReflectionMapping,
|
|
11
15
|
FogExp2,
|
|
@@ -14,59 +18,105 @@ import {
|
|
|
14
18
|
type Texture,
|
|
15
19
|
Vector3,
|
|
16
20
|
} from "three";
|
|
21
|
+
import { createGpuSky } from "./gpuSky.js";
|
|
17
22
|
import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
|
|
18
23
|
import { palette } from "./palette.js";
|
|
19
24
|
|
|
25
|
+
export const SKY_OPTIONS: { sky: "atmosphere" | "photo"; clouds: boolean; ground: boolean } = {
|
|
26
|
+
sky: "atmosphere",
|
|
27
|
+
clouds: true,
|
|
28
|
+
// The sunlit ground below the horizon stands in for Unreal's Lumen floor bounce: it lifts shadow
|
|
29
|
+
// sides and a mirror reflects it. Set false when the game adds its own global illumination.
|
|
30
|
+
ground: true,
|
|
31
|
+
};
|
|
32
|
+
|
|
33
|
+
/** Unit vector toward the sun: 47.9° up. Move it and the sky, the sun colour and the fog follow. */
|
|
34
|
+
export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
|
|
35
|
+
|
|
20
36
|
/**
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
37
|
+
* Unreal's default level fog in metres: its density and falloff are per 1000 cm (x0.1 per metre), and
|
|
38
|
+
* its line integral carries ln2 against the exact integral `heightFog.ts` evaluates. `fogHeight` sits
|
|
39
|
+
* 68.5 m below the floor, where the default level puts the fog actor. Inscattering is black and the
|
|
40
|
+
* start distance 0, as in Unreal: the colour comes from the sky.
|
|
24
41
|
*/
|
|
25
|
-
const
|
|
42
|
+
const ATMOSPHERE_FOG: HeightFogParams = {
|
|
43
|
+
...HEIGHT_FOG,
|
|
44
|
+
density: 0.00436 * Math.LN2,
|
|
45
|
+
heightFalloff: 0.02,
|
|
46
|
+
fogHeight: -68.5,
|
|
47
|
+
startDistance: 0,
|
|
48
|
+
};
|
|
26
49
|
|
|
27
|
-
/**
|
|
28
|
-
|
|
50
|
+
/** White in the 8-bit environment is this much scene radiance (`createGpuSky`). */
|
|
51
|
+
const ENVIRONMENT_RANGE = 4;
|
|
52
|
+
|
|
53
|
+
/** Photo sky only: how the JPEG was made from the 4k HDR (linear radiance x 0.4, clipped). */
|
|
54
|
+
const PHOTO_RANGE = 2.5;
|
|
29
55
|
|
|
30
|
-
/**
|
|
56
|
+
/** Photo sky only: FogExp2 at 0.003 read as 18% haze at 150 m from 2 m up. */
|
|
31
57
|
const EYE_LEVEL = { density: 0.003, distance: 150, cameraHeight: 2 };
|
|
32
58
|
|
|
33
|
-
|
|
34
|
-
* The distance term's density that, with the height term, keeps the old eye-level haze: at
|
|
35
|
-
* `EYE_LEVEL.distance` along the horizon from `EYE_LEVEL.cameraHeight` the two together transmit what
|
|
36
|
-
* FogExp2 at `EYE_LEVEL.density` did. The distance term is lowered, never removed, so the ground
|
|
37
|
-
* still ends in fog at a kilometre.
|
|
38
|
-
*/
|
|
39
|
-
function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
|
|
59
|
+
function photoDistanceDensity(p: HeightFogParams): number {
|
|
40
60
|
const { distance, density, cameraHeight } = EYE_LEVEL;
|
|
41
61
|
const old = (density * distance) ** 2;
|
|
42
62
|
const height = heightFogDepth(p, cameraHeight, cameraHeight, distance) * Math.LN2;
|
|
43
63
|
return Math.sqrt(Math.max(0, old - height)) / distance;
|
|
44
64
|
}
|
|
45
65
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
scene.
|
|
51
|
-
|
|
52
|
-
//
|
|
53
|
-
// misses, and a sky to reflect, sharper as roughness drops.
|
|
54
|
-
//
|
|
55
|
-
// Not on a software adapter. PMREM-filtering a 4096x2048 photo keeps a CPU rasteriser's GPU
|
|
56
|
-
// process busy past its watchdog and the next pipeline compiles die with the device (measured on
|
|
57
|
-
// four cores: a 28 s hitch and two failed pipelines with it on, 37 pipelines in 11 s with it
|
|
58
|
-
// off). That lane is not render evidence, so it gives up the fill light.
|
|
66
|
+
function setupPhotoSky(scene: Scene, photo: Texture, software: boolean): void {
|
|
67
|
+
SUN_DIRECTION.set(0.555, 0.742, 0.38).normalize();
|
|
68
|
+
photo.mapping = EquirectangularReflectionMapping;
|
|
69
|
+
photo.colorSpace = SRGBColorSpace;
|
|
70
|
+
scene.background = photo;
|
|
71
|
+
scene.backgroundIntensity = PHOTO_RANGE;
|
|
72
|
+
// Not on a software adapter: PMREM-filtering a 4096x2048 photo trips a CPU rasteriser's watchdog.
|
|
59
73
|
if (!software) {
|
|
60
|
-
scene.environment =
|
|
61
|
-
scene.environmentIntensity =
|
|
74
|
+
scene.environment = photo;
|
|
75
|
+
scene.environmentIntensity = PHOTO_RANGE;
|
|
62
76
|
}
|
|
63
|
-
// Almost nothing inside the arena (1.4% at 30 m), and the ground gone into the horizon by a
|
|
64
|
-
// kilometre — so the floor meets the sky instead of ending at a line. The colour is the
|
|
65
|
-
// photograph's own horizon, sampled from the same HDR, so the fade lands where the sky is.
|
|
66
|
-
// `scene.fog` stays the distance term for anything that reads it; `scene.fogNode` is what three
|
|
67
|
-
// applies, and it adds the height term. One owner at a time: `STARTER_MIST` clears both.
|
|
68
77
|
const params: HeightFogParams = { ...HEIGHT_FOG };
|
|
69
|
-
const distanceFog = new FogExp2(palette.skyLow,
|
|
78
|
+
const distanceFog = new FogExp2(palette.skyLow, photoDistanceDensity(params));
|
|
70
79
|
scene.fog = distanceFog;
|
|
71
80
|
scene.fogNode = heightFogNode(distanceFog, params, SUN_DIRECTION);
|
|
72
81
|
}
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* `photo` is only read when `SKY_OPTIONS.sky` is "photo". `fogged` false leaves the sky unfogged;
|
|
85
|
+
* `clouds` false draws the clear atmosphere.
|
|
86
|
+
*/
|
|
87
|
+
export function setupSky(
|
|
88
|
+
scene: Scene,
|
|
89
|
+
photo?: Texture,
|
|
90
|
+
software = false,
|
|
91
|
+
fogged = true,
|
|
92
|
+
clouds = SKY_OPTIONS.clouds,
|
|
93
|
+
): void {
|
|
94
|
+
if (SKY_OPTIONS.sky === "photo") {
|
|
95
|
+
if (photo === undefined) throw new Error('SKY_OPTIONS.sky "photo" needs assets/sky.jpg loaded');
|
|
96
|
+
setupPhotoSky(scene, photo, software);
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
// Height fog only; FogExp2 holds the colour `heightFogNode` reads, at zero density. `createGpuSky`
|
|
100
|
+
// sets that colour from the sky and again whenever the sun moves.
|
|
101
|
+
const fog = new FogExp2(0xffffff, 0);
|
|
102
|
+
scene.fog = fog;
|
|
103
|
+
scene.fogNode = heightFogNode(fog, { ...ATMOSPHERE_FOG }, SUN_DIRECTION);
|
|
104
|
+
const { node, environment } = createGpuSky(
|
|
105
|
+
scene,
|
|
106
|
+
SUN_DIRECTION,
|
|
107
|
+
fogged,
|
|
108
|
+
clouds,
|
|
109
|
+
ATMOSPHERE_FOG,
|
|
110
|
+
SKY_OPTIONS.ground,
|
|
111
|
+
);
|
|
112
|
+
environment.mapping = EquirectangularReflectionMapping;
|
|
113
|
+
environment.colorSpace = SRGBColorSpace;
|
|
114
|
+
// The analytic sky with its sun disc; a software adapter draws the 64 x 32 bake instead, with no
|
|
115
|
+
// LUT or cloud passes at all.
|
|
116
|
+
scene.background = environment;
|
|
117
|
+
scene.backgroundNode = software ? null : node.backgroundNode;
|
|
118
|
+
scene.backgroundIntensity = software ? ENVIRONMENT_RANGE : 1;
|
|
119
|
+
// Unreal's sky light: the same sky, so the fill on every shaded face is the sky's colour.
|
|
120
|
+
scene.environment = environment;
|
|
121
|
+
scene.environmentIntensity = ENVIRONMENT_RANGE;
|
|
122
|
+
}
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
import { Matrix4, type OrthographicCamera, type PerspectiveCamera, Vector2 } from "three";
|
|
5
5
|
import { traa } from "three/addons/tsl/display/TRAANode.js";
|
|
6
6
|
import { uniform } from "three/tsl";
|
|
7
|
-
import type { Node, PassNode,
|
|
7
|
+
import type { Node, PassNode, TextureNode } from "three/webgpu";
|
|
8
8
|
import { type ITemporalAANode, createTemporalAAFrame } from "./temporalAAFrame.js";
|
|
9
9
|
import { type PipelineContext, createTemporalAAHooks } from "./temporalAAHooks.js";
|
|
10
10
|
import { disposeTemporalAAInput } from "./temporalAAInput.js";
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { ChainStage, IWorldEnvironmentStageContext } from "@threenative/core";
|
|
1
2
|
// Generated user source: this kit's `traa` stage. The chain owns stage order, velocity provisioning
|
|
2
3
|
// and the applied report; this file owns the effect, the camera it jitters and the history it
|
|
3
4
|
// disposes. The chain hands the stage the *sampled* velocity texture, while the accessor TRAANode
|
|
@@ -6,7 +7,6 @@ import type { OrthographicCamera, PerspectiveCamera } from "three";
|
|
|
6
7
|
import type { Node, PassNode, TextureNode } from "three/webgpu";
|
|
7
8
|
import { createTemporalAA } from "./temporalAA.js";
|
|
8
9
|
import type { ITemporalRejectionMeasurement } from "./temporalRejectionCounter.js";
|
|
9
|
-
import type { ChainStage, IWorldEnvironmentStageContext } from "./worldEnvironment.js";
|
|
10
10
|
|
|
11
11
|
export type TemporalResetReason =
|
|
12
12
|
| "initial"
|