create-threenative 0.2.10 → 0.2.12
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
|
@@ -0,0 +1,444 @@
|
|
|
1
|
+
// Generated for you. Plain maths, edit or delete it freely: the sky the sun lights, in the sun's own units.
|
|
2
|
+
//
|
|
3
|
+
// Unreal's default level draws its sky from the Sky Atmosphere, lights the scene with a Sky Light
|
|
4
|
+
// that captures it, and tints the sun by the air the sun passes through. All three read ONE sun
|
|
5
|
+
// illuminance, so the sun-to-sky ratio is a consequence of the model and not a constant. This file
|
|
6
|
+
// ports that model: single scattering with Rayleigh and Mie phase functions, an ozone absorption
|
|
7
|
+
// layer, a ground bounce, and the isotropic multiple-scattering approximation (Hillaire, "A
|
|
8
|
+
// Scalable and Production Ready Sky and Atmosphere Rendering Technique", EGSR 2020, the paper the
|
|
9
|
+
// Unreal atmosphere implements). Coefficients are Unreal 5.8.3's defaults, read from
|
|
10
|
+
// Engine/Source/Runtime/Engine/Private/Components/SkyAtmosphereComponent.cpp:95-128 and checked
|
|
11
|
+
// against tools/unreal-reference/template-actors.json. The integration structure follows
|
|
12
|
+
// Engine/Shaders/Private/SkyAtmosphere.usf (IntegrateSingleScatteredLuminance and the multiple
|
|
13
|
+
// scattering pass) and the phase functions in ParticipatingMediaCommon.ush.
|
|
14
|
+
//
|
|
15
|
+
// Units: every radiance below is per unit sun illuminance (1.0 outside the atmosphere). Multiply
|
|
16
|
+
// by the sun's illuminance in the scene's light units (lighting.ts) to get scene radiance, so the
|
|
17
|
+
// sun and the sky can never disagree about exposure.
|
|
18
|
+
//
|
|
19
|
+
// Plain numbers and no `three` import: the same code runs under node for the unit check.
|
|
20
|
+
// ponytail: direct numerical integration at load (about a second at 256x128). A transmittance LUT,
|
|
21
|
+
// or core's `SkyCapture` once its sky-view LUT is physical, replaces the inner loops.
|
|
22
|
+
|
|
23
|
+
export type Rgb = readonly [number, number, number];
|
|
24
|
+
type Vec3 = readonly [number, number, number];
|
|
25
|
+
|
|
26
|
+
export const BOTTOM_KM = 6360;
|
|
27
|
+
export const TOP_KM = 6420;
|
|
28
|
+
export const RAYLEIGH: Rgb = [0.005802, 0.013558, 0.0331]; // per km at sea level
|
|
29
|
+
export const MIE_SCATTER = 0.003996;
|
|
30
|
+
export const MIE_ABSORB = 0.000444;
|
|
31
|
+
export const OZONE: Rgb = [0.00065, 0.001881, 0.000085];
|
|
32
|
+
export const MIE_G = 0.8;
|
|
33
|
+
export const GROUND_ALBEDO = 0.4; // 170/255 sRGB, linear
|
|
34
|
+
export const CAMERA_KM = 0.06; // the reference floor sits 60 m above the planet top
|
|
35
|
+
const FOUR_PI = 4 * Math.PI;
|
|
36
|
+
|
|
37
|
+
const rayleighPhase = (c: number): number => (3 / (16 * Math.PI)) * (1 + c * c);
|
|
38
|
+
const hgPhase = (c: number): number =>
|
|
39
|
+
(1 - MIE_G * MIE_G) / (FOUR_PI * (1 + MIE_G * MIE_G - 2 * MIE_G * c) ** 1.5);
|
|
40
|
+
|
|
41
|
+
const dot = (a: Vec3, b: Vec3): number => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
|
|
42
|
+
|
|
43
|
+
interface IMedium {
|
|
44
|
+
ray: Rgb;
|
|
45
|
+
mie: number;
|
|
46
|
+
ext: Rgb;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function medium(h: number): IMedium {
|
|
50
|
+
const ray = Math.exp(-h / 8);
|
|
51
|
+
const mie = Math.exp(-h / 1.2);
|
|
52
|
+
const ozone = Math.max(0, Math.min(1, h < 25 ? h / 15 - 2 / 3 : -h / 15 + 8 / 3));
|
|
53
|
+
const e = (i: 0 | 1 | 2): number =>
|
|
54
|
+
RAYLEIGH[i] * ray + (MIE_SCATTER + MIE_ABSORB) * mie + OZONE[i] * ozone;
|
|
55
|
+
return {
|
|
56
|
+
ray: [RAYLEIGH[0] * ray, RAYLEIGH[1] * ray, RAYLEIGH[2] * ray],
|
|
57
|
+
mie: MIE_SCATTER * mie,
|
|
58
|
+
ext: [e(0), e(1), e(2)],
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** Distance from a point at radius `r`, heading with cosine `mu` to the local up, to a sphere. */
|
|
63
|
+
function hitSphere(r: number, mu: number, radius: number, far: boolean): number | undefined {
|
|
64
|
+
const b = r * mu;
|
|
65
|
+
const disc = b * b - (r * r - radius * radius);
|
|
66
|
+
if (disc < 0) return undefined;
|
|
67
|
+
const t = far ? -b + Math.sqrt(disc) : -b - Math.sqrt(disc);
|
|
68
|
+
return t >= 0 ? t : undefined;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Optical depth from a point to the top of the atmosphere; undefined when the planet blocks the way.
|
|
73
|
+
* Unreal stores this in its transmittance LUT, ten samples a ray (r.SkyAtmosphere.TransmittanceLUT.SampleCount).
|
|
74
|
+
*/
|
|
75
|
+
function opticalDepthToTop(r: number, mu: number): Rgb | undefined {
|
|
76
|
+
if (mu < 0 && hitSphere(r, mu, BOTTOM_KM, false) !== undefined) return undefined;
|
|
77
|
+
const length = hitSphere(r, mu, TOP_KM, true) ?? 0;
|
|
78
|
+
const sum: [number, number, number] = [0, 0, 0];
|
|
79
|
+
for (const { from, to, at } of linear(10)(length)) {
|
|
80
|
+
const m = medium(Math.max(0, Math.sqrt(r * r + 2 * r * mu * at + at * at) - BOTTOM_KM));
|
|
81
|
+
for (let c = 0; c < 3; c += 1) sum[c] = (sum[c] ?? 0) + m.ext[c as 0 | 1 | 2] * (to - from);
|
|
82
|
+
}
|
|
83
|
+
return sum;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** Fraction of the sun's illuminance that reaches the ground, per channel. */
|
|
87
|
+
export function sunTransmittance(elevationRad: number): Rgb {
|
|
88
|
+
const depth = opticalDepthToTop(BOTTOM_KM + CAMERA_KM, Math.sin(elevationRad));
|
|
89
|
+
if (depth === undefined) return [0, 0, 0];
|
|
90
|
+
return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* The colour Unreal gives the sun light itself (FAtmosphereSetup::GetTransmittanceAtGroundLevel,
|
|
95
|
+
* Engine/Source/Runtime/Engine/Private/Components/SkyAtmosphere*): a CPU estimate, not the exact
|
|
96
|
+
* integral. It starts 500 m above the planet, sums 15 equal segments by their start point (the
|
|
97
|
+
* rule over-counts the dense low air) and has no minimum elevation (TransmittanceMinLightElevationAngle
|
|
98
|
+
* is -90). The sky itself reads the transmittance LUT (`sunTransmittance`), so the two differ.
|
|
99
|
+
*/
|
|
100
|
+
export function sunLightTransmittance(elevationRad: number): Rgb {
|
|
101
|
+
const f = Math.fround;
|
|
102
|
+
const r0 = BOTTOM_KM + 0.5;
|
|
103
|
+
const mu = Math.sin(elevationRad);
|
|
104
|
+
const tMax = hitSphere(r0, mu, TOP_KM, true) ?? 0;
|
|
105
|
+
const depth: [number, number, number] = [0, 0, 0];
|
|
106
|
+
const step = f(1 / 15);
|
|
107
|
+
for (let t = 0; t < 1; t = f(t + step)) {
|
|
108
|
+
const along = tMax * t;
|
|
109
|
+
const h = Math.max(0, Math.sqrt(r0 * r0 + 2 * r0 * mu * along + along * along) - BOTTOM_KM);
|
|
110
|
+
const m = medium(h);
|
|
111
|
+
for (let c = 0; c < 3; c += 1) depth[c] = (depth[c] ?? 0) + m.ext[c as 0 | 1 | 2] * step * tMax;
|
|
112
|
+
}
|
|
113
|
+
return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/** Fraction of the sun's illuminance that reaches radius `r` where the sun's cosine to local up is `mu`. */
|
|
117
|
+
export function transmittanceToTop(r: number, mu: number): Rgb {
|
|
118
|
+
const depth = opticalDepthToTop(r, mu);
|
|
119
|
+
if (depth === undefined) return [0, 0, 0];
|
|
120
|
+
return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
type Multi = (heightKm: number, cosSun: number) => Rgb;
|
|
124
|
+
|
|
125
|
+
/** One ray segment: it spans [from, to] in kilometres and its medium is read at `at`. */
|
|
126
|
+
interface ISegment {
|
|
127
|
+
from: number;
|
|
128
|
+
to: number;
|
|
129
|
+
at: number;
|
|
130
|
+
}
|
|
131
|
+
type Sampling = (tMax: number) => ISegment[];
|
|
132
|
+
|
|
133
|
+
/** Unreal's fixed march (the transmittance, multiple-scattering and distant sky light passes): equal segments, read `offset` of the way in. */
|
|
134
|
+
const linear =
|
|
135
|
+
(steps: number, offset = 0.3): Sampling =>
|
|
136
|
+
(tMax) =>
|
|
137
|
+
Array.from({ length: steps }, (_, i) => ({
|
|
138
|
+
from: (tMax * i) / steps,
|
|
139
|
+
to: (tMax * (i + 1)) / steps,
|
|
140
|
+
at: (tMax * (i + offset)) / steps,
|
|
141
|
+
}));
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* Unreal's sky-view march (SamplingSetup.VariableSampleCount in SkyAtmosphere.usf): the count grows
|
|
145
|
+
* from `min` to `max` with the distance, the segments grow with the square of it, and the last one
|
|
146
|
+
* runs on to the end of the ray.
|
|
147
|
+
*/
|
|
148
|
+
const variable =
|
|
149
|
+
(min: number, max: number, distanceKm: number, offset = 0.3): Sampling =>
|
|
150
|
+
(tMax) => {
|
|
151
|
+
const count = min + (max - min) * Math.min(1, Math.max(0, tMax / distanceKm));
|
|
152
|
+
const whole = Math.floor(count);
|
|
153
|
+
const tMaxWhole = (tMax * whole) / count;
|
|
154
|
+
return Array.from({ length: Math.ceil(count) }, (_, i) => {
|
|
155
|
+
const [u0, u1] = [(i / whole) ** 2, ((i + 1) / whole) ** 2];
|
|
156
|
+
const from = tMaxWhole * u0;
|
|
157
|
+
const to = u1 > 1 ? tMax : tMaxWhole * u1;
|
|
158
|
+
return { from, to, at: from + (to - from) * offset };
|
|
159
|
+
});
|
|
160
|
+
};
|
|
161
|
+
|
|
162
|
+
interface IGather {
|
|
163
|
+
radiance: [number, number, number];
|
|
164
|
+
/** Integral of the scattering coefficient along the ray, attenuated: the transfer factor. */
|
|
165
|
+
transfer: [number, number, number];
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* One view ray from (0, r0, 0) along `dir`, the planet at the origin and `sun` a unit vector.
|
|
170
|
+
* `iso` swaps the phase functions for the isotropic one, as the multiple-scattering pass does.
|
|
171
|
+
* `multi` adds the multiple-scattering luminance at each sample.
|
|
172
|
+
*/
|
|
173
|
+
function march(
|
|
174
|
+
r0: number,
|
|
175
|
+
dir: Vec3,
|
|
176
|
+
sun: Vec3,
|
|
177
|
+
iso: boolean,
|
|
178
|
+
multi: Multi | undefined,
|
|
179
|
+
ground: boolean,
|
|
180
|
+
sampling: Sampling,
|
|
181
|
+
): IGather {
|
|
182
|
+
const out: IGather = { radiance: [0, 0, 0], transfer: [0, 0, 0] };
|
|
183
|
+
const mu0 = dir[1];
|
|
184
|
+
const groundT = mu0 < 0 ? hitSphere(r0, mu0, BOTTOM_KM, false) : undefined;
|
|
185
|
+
const tMax = groundT ?? hitSphere(r0, mu0, TOP_KM, true) ?? 0;
|
|
186
|
+
const cosView = dot(dir, sun);
|
|
187
|
+
const phaseRay = iso ? 1 / FOUR_PI : rayleighPhase(cosView);
|
|
188
|
+
const phaseMie = iso ? 1 / FOUR_PI : hgPhase(cosView);
|
|
189
|
+
const through: [number, number, number] = [1, 1, 1];
|
|
190
|
+
const at = (t: number): Vec3 => [dir[0] * t, r0 + dir[1] * t, dir[2] * t];
|
|
191
|
+
for (const { from, to, at: mid } of sampling(tMax)) {
|
|
192
|
+
const dt = to - from;
|
|
193
|
+
const p = at(mid);
|
|
194
|
+
const rr = Math.hypot(p[0], p[1], p[2]);
|
|
195
|
+
const cosSun = dot(p, sun) / rr;
|
|
196
|
+
const m = medium(Math.max(0, rr - BOTTOM_KM));
|
|
197
|
+
const depth = opticalDepthToTop(rr, cosSun);
|
|
198
|
+
const ms = multi?.(Math.max(0, rr - BOTTOM_KM), cosSun);
|
|
199
|
+
for (let c = 0; c < 3; c += 1) {
|
|
200
|
+
const k = c as 0 | 1 | 2;
|
|
201
|
+
const e = m.ext[k];
|
|
202
|
+
const scatter = m.ray[k] + m.mie;
|
|
203
|
+
const stepT = Math.exp(-e * dt);
|
|
204
|
+
let source = 0;
|
|
205
|
+
if (depth !== undefined)
|
|
206
|
+
source += Math.exp(-depth[k]) * (m.ray[k] * phaseRay + m.mie * phaseMie);
|
|
207
|
+
if (ms !== undefined) source += ms[k] * scatter;
|
|
208
|
+
const integral = e > 1e-12 ? (1 - stepT) / e : dt;
|
|
209
|
+
out.radiance[c] = (out.radiance[c] ?? 0) + (through[c] ?? 1) * source * integral;
|
|
210
|
+
out.transfer[c] = (out.transfer[c] ?? 0) + (through[c] ?? 1) * scatter * integral;
|
|
211
|
+
through[c] = (through[c] ?? 1) * stepT;
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
// The sky pass draws no ground luminance (Unreal's sky render passes Ground = false), so the nadir
|
|
215
|
+
// is only the in-scatter up to the planet, near black. The multiple-scattering pass does bounce
|
|
216
|
+
// light off the ground (Ground = true), so `iso` keeps it.
|
|
217
|
+
if (ground && groundT !== undefined) {
|
|
218
|
+
const p = at(groundT);
|
|
219
|
+
const rr = Math.hypot(p[0], p[1], p[2]);
|
|
220
|
+
const cosSun = dot(p, sun) / rr;
|
|
221
|
+
const depth = opticalDepthToTop(rr, cosSun);
|
|
222
|
+
if (depth !== undefined && cosSun > 0)
|
|
223
|
+
for (let c = 0; c < 3; c += 1)
|
|
224
|
+
out.radiance[c] =
|
|
225
|
+
(out.radiance[c] ?? 0) +
|
|
226
|
+
(through[c] ?? 1) * Math.exp(-depth[c as 0 | 1 | 2]) * cosSun * (GROUND_ALBEDO / Math.PI);
|
|
227
|
+
}
|
|
228
|
+
return out;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
/**
|
|
232
|
+
* Multiple-scattering luminance per unit scattering coefficient, by altitude and the cosine
|
|
233
|
+
* between the local up and the sun: Psi = L2 / (1 - f), the isotropic infinite-bounce sum.
|
|
234
|
+
* Unreal gathers L2 and f from two rays only, straight up and straight down (the shipped "cheap"
|
|
235
|
+
* approximation in RenderMultiScatteredLuminanceLutCS); the full sphere gather overestimated the
|
|
236
|
+
* ground bounce against the Unreal frames by up to 1.6x, so this uses the same two rays.
|
|
237
|
+
*/
|
|
238
|
+
function multipleScatteringTable(): Multi {
|
|
239
|
+
const nh = 12;
|
|
240
|
+
const nc = 16;
|
|
241
|
+
const dirs: Vec3[] = [
|
|
242
|
+
[0, 1, 0],
|
|
243
|
+
[0, -1, 0],
|
|
244
|
+
];
|
|
245
|
+
const table: Rgb[] = [];
|
|
246
|
+
for (let ih = 0; ih < nh; ih += 1) {
|
|
247
|
+
const h = ((ih + 0.5) / nh) ** 2 * (TOP_KM - BOTTOM_KM);
|
|
248
|
+
for (let ic = 0; ic < nc; ic += 1) {
|
|
249
|
+
const cosSun = -1 + (2 * (ic + 0.5)) / nc;
|
|
250
|
+
const sun: Vec3 = [Math.sqrt(1 - cosSun * cosSun), cosSun, 0];
|
|
251
|
+
const sum = [0, 0, 0];
|
|
252
|
+
const transfer = [0, 0, 0];
|
|
253
|
+
for (const dir of dirs) {
|
|
254
|
+
const ray = march(BOTTOM_KM + h, dir, sun, true, undefined, true, linear(15));
|
|
255
|
+
for (let c = 0; c < 3; c += 1) {
|
|
256
|
+
sum[c] = (sum[c] ?? 0) + (ray.radiance[c] ?? 0);
|
|
257
|
+
transfer[c] = (transfer[c] ?? 0) + (ray.transfer[c] ?? 0);
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
table.push(
|
|
261
|
+
[0, 1, 2].map((c) => {
|
|
262
|
+
const l2 = (sum[c] ?? 0) / dirs.length;
|
|
263
|
+
const f = Math.min(0.99, (transfer[c] ?? 0) / dirs.length);
|
|
264
|
+
return l2 / (1 - f);
|
|
265
|
+
}) as unknown as Rgb,
|
|
266
|
+
);
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
return (h, cosSun) => {
|
|
270
|
+
const u = Math.min(
|
|
271
|
+
nh - 1,
|
|
272
|
+
Math.max(0, Math.sqrt(Math.max(0, h) / (TOP_KM - BOTTOM_KM)) * nh - 0.5),
|
|
273
|
+
);
|
|
274
|
+
const v = Math.min(nc - 1, Math.max(0, ((cosSun + 1) / 2) * nc - 0.5));
|
|
275
|
+
const [u0, v0] = [Math.floor(u), Math.floor(v)];
|
|
276
|
+
const [u1, v1] = [Math.min(nh - 1, u0 + 1), Math.min(nc - 1, v0 + 1)];
|
|
277
|
+
const [fu, fv] = [u - u0, v - v0];
|
|
278
|
+
const cell = (i: number, j: number): Rgb => table[i * nc + j] as Rgb;
|
|
279
|
+
return [0, 1, 2].map((c) => {
|
|
280
|
+
const k = c as 0 | 1 | 2;
|
|
281
|
+
const a = cell(u0, v0)[k] * (1 - fv) + cell(u0, v1)[k] * fv;
|
|
282
|
+
const b = cell(u1, v0)[k] * (1 - fv) + cell(u1, v1)[k] * fv;
|
|
283
|
+
return a * (1 - fu) + b * fu;
|
|
284
|
+
}) as unknown as Rgb;
|
|
285
|
+
};
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/**
|
|
289
|
+
* Unreal's distant sky light: the mean radiance over the whole sphere seen from `altitudeKm`
|
|
290
|
+
* (r.SkyAtmosphere.DistantSkyLightLUT.Altitude, 6 km), isotropic phase, no ground bounce, the
|
|
291
|
+
* multiple-scattering term included (RenderDistantSkyLightLutCS in
|
|
292
|
+
* Engine/Shaders/Private/SkyAtmosphere.usf). Height fog and volumetric clouds both light with it
|
|
293
|
+
* (GetViewDistanceSkyLightColor). Per unit sun illuminance, like `bakeSkyRadiance`.
|
|
294
|
+
*/
|
|
295
|
+
const DISTANT_SKY_LIGHT_ALTITUDE_KM = 6;
|
|
296
|
+
/**
|
|
297
|
+
* Unreal's distant sky light shader: one 8 x 8 group, one stratified direction a thread, ten linear
|
|
298
|
+
* samples a ray (RenderDistantSkyLightLutCS). The directions come from a seeded linear congruential
|
|
299
|
+
* stream (0xDE4DC0DE, GUniformSphereSamplesBuffer in SkyAtmosphereRendering.cpp), so the coarse
|
|
300
|
+
* result is one fixed draw, not a mean; the same draw is reproduced here.
|
|
301
|
+
*/
|
|
302
|
+
const DISTANT_GROUP = 8;
|
|
303
|
+
function distantDirections(): Vec3[] {
|
|
304
|
+
let seed = 0xde4dc0de;
|
|
305
|
+
const fraction = (): number => {
|
|
306
|
+
seed = (Math.imul(seed, 196314165) + 907633515) >>> 0;
|
|
307
|
+
return (seed >>> 9) / 8388608;
|
|
308
|
+
};
|
|
309
|
+
const dirs: Vec3[] = new Array(DISTANT_GROUP * DISTANT_GROUP);
|
|
310
|
+
for (let i = 0; i < DISTANT_GROUP; i += 1) {
|
|
311
|
+
for (let j = 0; j < DISTANT_GROUP; j += 1) {
|
|
312
|
+
const up = 1 - (2 * (i + fraction())) / DISTANT_GROUP;
|
|
313
|
+
const phi = (2 * Math.PI * (j + fraction())) / DISTANT_GROUP;
|
|
314
|
+
const ring = Math.sqrt(1 - up * up);
|
|
315
|
+
dirs[j * DISTANT_GROUP + i] = [ring * Math.cos(phi), up, ring * Math.sin(phi)];
|
|
316
|
+
}
|
|
317
|
+
}
|
|
318
|
+
return dirs;
|
|
319
|
+
}
|
|
320
|
+
function distantSkyLight(toSun: { x: number; y: number; z: number }): Rgb {
|
|
321
|
+
const sun: Vec3 = [toSun.x, toSun.y, toSun.z];
|
|
322
|
+
const multi = multipleScatteringTable();
|
|
323
|
+
const dirs = distantDirections();
|
|
324
|
+
const sum: [number, number, number] = [0, 0, 0];
|
|
325
|
+
for (const dir of dirs) {
|
|
326
|
+
const ray = march(
|
|
327
|
+
BOTTOM_KM + DISTANT_SKY_LIGHT_ALTITUDE_KM,
|
|
328
|
+
dir,
|
|
329
|
+
sun,
|
|
330
|
+
true,
|
|
331
|
+
multi,
|
|
332
|
+
false,
|
|
333
|
+
linear(10),
|
|
334
|
+
);
|
|
335
|
+
for (let c = 0; c < 3; c += 1) sum[c] = (sum[c] ?? 0) + (ray.radiance[c] ?? 0) / dirs.length;
|
|
336
|
+
}
|
|
337
|
+
return sum;
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
/**
|
|
341
|
+
* The light height fog and clouds take from the sky, per unit sun illuminance: Unreal's distant sky
|
|
342
|
+
* light (GetViewDistanceSkyLightColor). It needs no fit. The 0.76 / 0.871 / 0.941 factors that stood
|
|
343
|
+
* here made up for a finer march than Unreal's own, ten samples a ray from one fixed 8 x 8 draw of
|
|
344
|
+
* directions (`distantSkyLight`); the same march agrees with the Unreal L3 void within 2.4 percent in
|
|
345
|
+
* green and blue at 15 and 60 degrees, and within 0.6 percent in red at 15 degrees. Red stays 10 percent
|
|
346
|
+
* high at 60 degrees, the same excess the clear sky shows at a high sun (open, PRD-633).
|
|
347
|
+
*/
|
|
348
|
+
export function viewDistanceSkyLight(toSun: { x: number; y: number; z: number }): Rgb {
|
|
349
|
+
return distantSkyLight(toSun);
|
|
350
|
+
}
|
|
351
|
+
|
|
352
|
+
/**
|
|
353
|
+
* Sky radiance per unit sun illuminance on an equirectangular grid in three's layout: row 0 is the
|
|
354
|
+
* zenith, the middle row the horizon, the last row the nadir, and u = atan2(z, x) / 2pi + 0.5. `sun`
|
|
355
|
+
* is the unit direction toward the sun, y up.
|
|
356
|
+
*
|
|
357
|
+
* Below the horizon it draws the atmosphere's sunlit ground (albedo `GROUND_ALBEDO`, the term
|
|
358
|
+
* Unreal's multiple-scattering pass uses), where Unreal's own sky capture is near black. Unreal's
|
|
359
|
+
* default level fills that half with Lumen: the floor bounces sun into shadow sides and a mirror
|
|
360
|
+
* reflects it. This environment is the only indirect light the templates have, so the ground stands
|
|
361
|
+
* in for that bounce; without it shadow sides read navy and a chrome ball's lower half black (judge,
|
|
362
|
+
* PRD-633). `ground` false draws Unreal's dark nadir, for a game with its own global illumination.
|
|
363
|
+
*/
|
|
364
|
+
export function bakeSkyRadiance(
|
|
365
|
+
toSun: { x: number; y: number; z: number },
|
|
366
|
+
width: number,
|
|
367
|
+
height: number,
|
|
368
|
+
ground: boolean,
|
|
369
|
+
): Float32Array {
|
|
370
|
+
const sun: Vec3 = [toSun.x, toSun.y, toSun.z];
|
|
371
|
+
const multi = multipleScatteringTable();
|
|
372
|
+
const data = new Float32Array(width * height * 3);
|
|
373
|
+
const r0 = BOTTOM_KM + CAMERA_KM;
|
|
374
|
+
for (let y = 0; y < height; y += 1) {
|
|
375
|
+
const elevation = Math.PI / 2 - ((y + 0.5) / height) * Math.PI;
|
|
376
|
+
for (let x = 0; x < width; x += 1) {
|
|
377
|
+
// three's equirectangular lookup: u = atan2(z, x) / 2pi + 0.5.
|
|
378
|
+
const azimuth = ((x + 0.5) / width - 0.5) * 2 * Math.PI;
|
|
379
|
+
const dir: Vec3 = [
|
|
380
|
+
Math.cos(azimuth) * Math.cos(elevation),
|
|
381
|
+
Math.sin(elevation),
|
|
382
|
+
Math.sin(azimuth) * Math.cos(elevation),
|
|
383
|
+
];
|
|
384
|
+
const ray = march(r0, dir, sun, false, multi, ground, variable(4, 32, 150));
|
|
385
|
+
const o = (y * width + x) * 3;
|
|
386
|
+
data[o] = ray.radiance[0];
|
|
387
|
+
data[o + 1] = ray.radiance[1];
|
|
388
|
+
data[o + 2] = ray.radiance[2];
|
|
389
|
+
}
|
|
390
|
+
}
|
|
391
|
+
return data;
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
/** The default level's sun: 6 lux, 6500 K (tools/unreal-reference/template-actors.json, every sun). */
|
|
395
|
+
const SUN_LUX = 6;
|
|
396
|
+
export const SUN_KELVIN = 6500;
|
|
397
|
+
|
|
398
|
+
/**
|
|
399
|
+
* The sun in three's light units. Unreal renders a lit diffuse surface as albedo x lux x cos(theta);
|
|
400
|
+
* three's Lambert BRDF carries a 1/pi, so the same lux is pi times as large here. Measured on the
|
|
401
|
+
* Unreal L1 cells (no atmosphere, scene-linear EXR): a 0.18 floor under the 60 degree sun reads
|
|
402
|
+
* 0.874 luminance, within 7% of 0.18 x 6 x sin(60 deg) = 0.935 (the residual is checked on the
|
|
403
|
+
* engine's own L1 capture).
|
|
404
|
+
*/
|
|
405
|
+
export const SUN_ILLUMINANCE = SUN_LUX * Math.PI;
|
|
406
|
+
|
|
407
|
+
/**
|
|
408
|
+
* Sky radiance relative to the sun, as Unreal renders it. TEMPORARY, measured and not derived: with
|
|
409
|
+
* the sun at 6 lux the model above is 1.3x too bright against the Unreal L2 frames, flat across
|
|
410
|
+
* channels and across the 15 and 4 degree suns (1.30 / 1.30 / 1.35 at 19 degrees elevation), so
|
|
411
|
+
* the sky is scaled by 1/1.3. The lens attenuation constant 0.78 (PostProcessEyeAdaptation.cpp,
|
|
412
|
+
* r.EyeAdaptation.LensAttenuation) has the right size but the path that would apply it to the
|
|
413
|
+
* atmosphere and not to the sun is not found in the source yet.
|
|
414
|
+
*/
|
|
415
|
+
export const SKY_TO_SUN = 0.78;
|
|
416
|
+
|
|
417
|
+
/**
|
|
418
|
+
* Colour of a black-body-like light at `kelvin` as linear sRGB with unit luminance: the Planckian
|
|
419
|
+
* locus fit in the CIE 1960 UCS plane (Krystek 1985) that Unreal uses for a light's temperature
|
|
420
|
+
* (Engine/Source/Runtime/Core/Private/Math/Color.cpp, MakeFromColorTemperature), then XYZ to BT.709.
|
|
421
|
+
*/
|
|
422
|
+
export function temperatureColour(kelvin: number): Rgb {
|
|
423
|
+
const t = Math.min(15000, Math.max(1000, kelvin));
|
|
424
|
+
const u =
|
|
425
|
+
(0.860117757 + 1.54118254e-4 * t + 1.28641212e-7 * t * t) /
|
|
426
|
+
(1 + 8.42420235e-4 * t + 7.08145163e-7 * t * t);
|
|
427
|
+
const v =
|
|
428
|
+
(0.317398726 + 4.22806245e-5 * t + 4.20481691e-8 * t * t) /
|
|
429
|
+
(1 - 2.89741816e-5 * t + 1.61456053e-7 * t * t);
|
|
430
|
+
const d = 2 * u - 8 * v + 4;
|
|
431
|
+
const x = (3 * u) / d;
|
|
432
|
+
const y = (2 * v) / d;
|
|
433
|
+
const [bx, bz] = [x / y, (1 - x - y) / y];
|
|
434
|
+
return [
|
|
435
|
+
Math.max(0, 3.2404542 * bx - 1.5371385 - 0.4985314 * bz),
|
|
436
|
+
Math.max(0, -0.969266 * bx + 1.8760108 + 0.041556 * bz),
|
|
437
|
+
Math.max(0, 0.0556434 * bx - 0.2040259 + 1.0572252 * bz),
|
|
438
|
+
];
|
|
439
|
+
}
|
|
440
|
+
|
|
441
|
+
/** The scene's sun light, registered by `setupLighting` so `setupSky` can tint it by the air. */
|
|
442
|
+
export const sunLight: {
|
|
443
|
+
current?: { color: { setRGB(r: number, g: number, b: number): unknown } };
|
|
444
|
+
} = {};
|
|
@@ -5,7 +5,6 @@ import {
|
|
|
5
5
|
type DirectionalLight,
|
|
6
6
|
Material,
|
|
7
7
|
type MeshStandardMaterial,
|
|
8
|
-
type Object3D,
|
|
9
8
|
type Scene,
|
|
10
9
|
Vector3,
|
|
11
10
|
} from "three";
|
|
@@ -75,41 +74,73 @@ export function backlightMaterial(source: MeshStandardMaterial, controls: IBackl
|
|
|
75
74
|
return material;
|
|
76
75
|
}
|
|
77
76
|
|
|
77
|
+
interface IRenderFrame {
|
|
78
|
+
readonly renderId?: number;
|
|
79
|
+
readonly frameId?: number;
|
|
80
|
+
readonly camera?: Camera | null;
|
|
81
|
+
}
|
|
82
|
+
|
|
78
83
|
function createGraph(controls: IBacklightControls) {
|
|
79
|
-
|
|
84
|
+
// One render validates the controls and resolves the key once for all eight uniforms: each read can
|
|
85
|
+
// be a native bridge call, and a render reads the same values throughout.
|
|
86
|
+
let checkedFrame: IRenderFrame | undefined;
|
|
87
|
+
let checkedRender: number | undefined;
|
|
88
|
+
const check = (frame: IRenderFrame) => {
|
|
89
|
+
const render = frame.renderId ?? frame.frameId;
|
|
90
|
+
if (frame === checkedFrame && render === checkedRender) return;
|
|
80
91
|
validateControls(controls);
|
|
92
|
+
checkedFrame = frame;
|
|
93
|
+
checkedRender = render;
|
|
94
|
+
};
|
|
95
|
+
const keyDirectionValue = new Vector3(0, 1, 0);
|
|
96
|
+
const keyTargetValue = new Vector3();
|
|
97
|
+
let keyFrame: IRenderFrame | undefined;
|
|
98
|
+
let keyRender: number | undefined;
|
|
99
|
+
let keyGainValue = 0;
|
|
100
|
+
const key = (frame: IRenderFrame) => {
|
|
101
|
+
const render = frame.renderId ?? frame.frameId;
|
|
102
|
+
if (frame !== keyFrame || render !== keyRender) {
|
|
103
|
+
keyGainValue = resolveKey(
|
|
104
|
+
controls,
|
|
105
|
+
keyDirectionValue,
|
|
106
|
+
keyTargetValue,
|
|
107
|
+
frame.camera ?? controls.camera,
|
|
108
|
+
);
|
|
109
|
+
keyFrame = frame;
|
|
110
|
+
keyRender = render;
|
|
111
|
+
}
|
|
112
|
+
return keyGainValue;
|
|
113
|
+
};
|
|
114
|
+
const rimGain = uniform(controls.rimGain).onRenderUpdate((frame) => {
|
|
115
|
+
check(frame);
|
|
81
116
|
return controls.rimGain;
|
|
82
117
|
});
|
|
83
|
-
const fillGain = uniform(0).onRenderUpdate(() => {
|
|
84
|
-
|
|
118
|
+
const fillGain = uniform(0).onRenderUpdate((frame) => {
|
|
119
|
+
check(frame);
|
|
85
120
|
return controls.fillAdmitted ? controls.fillGain : 0;
|
|
86
121
|
});
|
|
87
|
-
const fillColor = uniform(controls.fillColor).onRenderUpdate(() => {
|
|
88
|
-
|
|
122
|
+
const fillColor = uniform(controls.fillColor).onRenderUpdate((frame) => {
|
|
123
|
+
check(frame);
|
|
89
124
|
return controls.fillColor;
|
|
90
125
|
});
|
|
91
|
-
const fillDirection = uniform(controls.fillDirection).onRenderUpdate(() => {
|
|
92
|
-
|
|
126
|
+
const fillDirection = uniform(controls.fillDirection).onRenderUpdate((frame) => {
|
|
127
|
+
check(frame);
|
|
93
128
|
return controls.fillDirection;
|
|
94
129
|
});
|
|
95
|
-
const fillAngularSize = uniform(controls.fillAngularSize).onRenderUpdate(() => {
|
|
96
|
-
|
|
130
|
+
const fillAngularSize = uniform(controls.fillAngularSize).onRenderUpdate((frame) => {
|
|
131
|
+
check(frame);
|
|
97
132
|
return controls.fillAngularSize;
|
|
98
133
|
});
|
|
99
|
-
const keyColor = uniform(controls.key.color).onRenderUpdate(() => {
|
|
100
|
-
|
|
134
|
+
const keyColor = uniform(controls.key.color).onRenderUpdate((frame) => {
|
|
135
|
+
check(frame);
|
|
101
136
|
return controls.key.color;
|
|
102
137
|
});
|
|
103
|
-
const keyDirectionValue = new Vector3(0, 1, 0);
|
|
104
|
-
const keyTargetValue = new Vector3();
|
|
105
138
|
const keyDirection = uniform(keyDirectionValue).onRenderUpdate((frame) => {
|
|
106
|
-
|
|
139
|
+
key(frame);
|
|
107
140
|
return keyDirectionValue;
|
|
108
141
|
});
|
|
109
142
|
// Removal/visibility/intensity are live. A removed sun cannot leave an invented rim behind.
|
|
110
|
-
const keyGain = uniform(0).onRenderUpdate((frame) =>
|
|
111
|
-
resolveKey(controls, keyDirectionValue, keyTargetValue, frame.camera ?? controls.camera),
|
|
112
|
-
);
|
|
143
|
+
const keyGain = uniform(0).onRenderUpdate((frame) => key(frame));
|
|
113
144
|
const N = normalView.normalize();
|
|
114
145
|
const V = positionViewDirection.normalize();
|
|
115
146
|
const L = cameraViewMatrix.transformDirection(keyDirection);
|