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
|
@@ -0,0 +1,605 @@
|
|
|
1
|
+
// Generated for you. Plain maths, edit or delete it freely: the cloud layer Unreal's default level draws.
|
|
2
|
+
// Model references (UE 5.8.3): Engine/Content/EngineSky/VolumetricClouds/m_SimpleVolumetricCloud
|
|
3
|
+
// (the default cloud material; its node graph and parameter defaults are read through the editor),
|
|
4
|
+
// Engine/Shaders/Private/VolumetricCloud.usf (dual HG phase, scattering octaves, sky term, shadow
|
|
5
|
+
// march), Engine/Source/Runtime/Engine/Private/Components/VolumetricCloudComponent.cpp (km defaults).
|
|
6
|
+
// Independent CPU implementation. The material samples four Unreal textures that this repository
|
|
7
|
+
// must not carry, so each one is regenerated here from a seeded noise whose per-channel value
|
|
8
|
+
// quantiles and correlation lengths match the Unreal texture (measured, see the spec).
|
|
9
|
+
import {
|
|
10
|
+
BOTTOM_KM,
|
|
11
|
+
CAMERA_KM,
|
|
12
|
+
MIE_ABSORB,
|
|
13
|
+
MIE_SCATTER,
|
|
14
|
+
RAYLEIGH,
|
|
15
|
+
type Rgb,
|
|
16
|
+
transmittanceToTop,
|
|
17
|
+
} from "./atmosphere.js";
|
|
18
|
+
|
|
19
|
+
const PLANET = BOTTOM_KM;
|
|
20
|
+
export const CLOUD_BOTTOM_KM = 5; // VolumetricCloudComponent LayerBottomAltitude in the reference level
|
|
21
|
+
export const CLOUD_TOP_KM = 15; // bottom + LayerHeight 10
|
|
22
|
+
const CAMERA = PLANET + CAMERA_KM;
|
|
23
|
+
|
|
24
|
+
/** m_SimpleVolumetricCloud parameter defaults (the instance overrides only textures). */
|
|
25
|
+
export const CLOUD_MATERIAL = {
|
|
26
|
+
layoutKm: 256, // Layout_CloudGlobalScale: the pattern repeats every 256 km
|
|
27
|
+
density: 0.008, // Cloud_GlobalDensity, extinction per metre
|
|
28
|
+
coverage: -0.2, // Cloud_GlobalCoverage
|
|
29
|
+
noise1Scale: [4.167, 4.444, 9.091], // Noise1_Coordinates, in volume repeats per layout tile
|
|
30
|
+
noise2Scale: [60, 60, 75], // Noise2_Coordinates, the distortion lookup
|
|
31
|
+
noiseBias: [0.5, 0.8], // Noise_Bias R (shape) and G (distortion)
|
|
32
|
+
noiseStrength: [0.8, 0.08], // Noise_Strength R and G
|
|
33
|
+
insideLayer: [0.02, 0.98], // the material returns zero in the outer 2% of the layer
|
|
34
|
+
albedo: 0.98, // Cloud_AlbedoColor
|
|
35
|
+
skyOcclusion: 0.5, // Cloud_AlbedoColor alpha, drives the sky-light term
|
|
36
|
+
phase: { g: 0.8, g2: 0.166667, blend: 0.575 }, // Phase_Controls
|
|
37
|
+
multiScatter: { contribution: 0.666667, occlusion: 0.25, eccentricity: 0.18, octaves: 2 },
|
|
38
|
+
} as const;
|
|
39
|
+
export const CLOUD_MODEL = {
|
|
40
|
+
viewStepMetres: 300,
|
|
41
|
+
minViewSteps: 32,
|
|
42
|
+
maxViewSteps: 192,
|
|
43
|
+
lightSteps: 6,
|
|
44
|
+
// TracingMaxDistance, taken from the layer entry point (TracingMaxDistanceMode 0, the default).
|
|
45
|
+
tracingKm: 200,
|
|
46
|
+
// TracingMaxDistance of the reference actor is 200 km (tools/unreal-reference/template-actors.json).
|
|
47
|
+
horizonFadeStartKm: 150,
|
|
48
|
+
horizonFadeEndKm: 200,
|
|
49
|
+
} as const;
|
|
50
|
+
export const PATTERN_SIZE = 256;
|
|
51
|
+
export const VOLUME_SIZE = 64;
|
|
52
|
+
// Value quantiles (17 points, 0 to 1) of T_CloudPattern R,G,B, of the volume's R and G channels.
|
|
53
|
+
const PATTERN_QUANTILES = [
|
|
54
|
+
[0, 0, 0, 0, 0, 0.012, 0.034, 0.06, 0.092, 0.13, 0.176, 0.234, 0.307, 0.405, 0.541, 0.753, 1],
|
|
55
|
+
[
|
|
56
|
+
0, 0, 0, 0.001, 0.006, 0.021, 0.048, 0.086, 0.135, 0.193, 0.26, 0.342, 0.44, 0.562, 0.731,
|
|
57
|
+
0.978, 1,
|
|
58
|
+
],
|
|
59
|
+
[
|
|
60
|
+
0, 0, 0, 0.004, 0.018, 0.036, 0.054, 0.072, 0.092, 0.113, 0.138, 0.168, 0.204, 0.248, 0.314,
|
|
61
|
+
0.435, 1,
|
|
62
|
+
],
|
|
63
|
+
] as const;
|
|
64
|
+
const VOLUME_QUANTILES = [
|
|
65
|
+
[
|
|
66
|
+
-0.147, 0.309, 0.365, 0.405, 0.437, 0.464, 0.489, 0.513, 0.536, 0.558, 0.582, 0.606, 0.633,
|
|
67
|
+
0.665, 0.703, 0.756, 1.071,
|
|
68
|
+
],
|
|
69
|
+
[
|
|
70
|
+
0, 0.173, 0.235, 0.282, 0.322, 0.357, 0.39, 0.42, 0.45, 0.481, 0.512, 0.545, 0.581, 0.619,
|
|
71
|
+
0.666, 0.728, 1.022,
|
|
72
|
+
],
|
|
73
|
+
] as const;
|
|
74
|
+
// Cells per repeat of the pattern's base octave: sets each channel's correlation length.
|
|
75
|
+
const PATTERN_CELLS = [6, 15, 30] as const;
|
|
76
|
+
// T_Profile_08 channels as degree-4 polynomials in (altitude in layer, pattern value):
|
|
77
|
+
// exponents [i, j] and coefficients for u^i v^j. Fitted to the texture (rms error 0.006 to 0.012).
|
|
78
|
+
const PROFILE_TERMS: ReadonlyArray<readonly [number, number]> = [
|
|
79
|
+
[0, 0],
|
|
80
|
+
[0, 1],
|
|
81
|
+
[0, 2],
|
|
82
|
+
[0, 3],
|
|
83
|
+
[0, 4],
|
|
84
|
+
[1, 0],
|
|
85
|
+
[1, 1],
|
|
86
|
+
[1, 2],
|
|
87
|
+
[1, 3],
|
|
88
|
+
[2, 0],
|
|
89
|
+
[2, 1],
|
|
90
|
+
[2, 2],
|
|
91
|
+
[3, 0],
|
|
92
|
+
[3, 1],
|
|
93
|
+
[4, 0],
|
|
94
|
+
];
|
|
95
|
+
const PROFILE_COEFFICIENTS = [
|
|
96
|
+
[
|
|
97
|
+
0.3741, 0.499, -1.2672, 1.2328, -0.4107, 0.8894, 0.3392, 0.4021, -0.2367, -2.8264, -1.2088,
|
|
98
|
+
0.4296, 2.6391, 0.5109, -0.8971,
|
|
99
|
+
],
|
|
100
|
+
[
|
|
101
|
+
0.2818, 0.049, -0.3788, 0.7721, -0.1495, -0.1268, 1.0841, -1.9311, 0.0666, 2.8644, 0.0744,
|
|
102
|
+
1.329, -5.4491, -0.7025, 2.7003,
|
|
103
|
+
],
|
|
104
|
+
[
|
|
105
|
+
0.049, 0.0514, -0.119, 0.1602, -0.077, 0.7471, 0.0678, -0.1132, 0.0743, -1.4245, -0.0577,
|
|
106
|
+
-0.0141, 2.7099, 0.0675, -1.6358,
|
|
107
|
+
],
|
|
108
|
+
] as const;
|
|
109
|
+
|
|
110
|
+
const clamp = (v: number): number => Math.max(0, Math.min(1, v));
|
|
111
|
+
const smooth = (v: number): number => {
|
|
112
|
+
const t = clamp(v);
|
|
113
|
+
return t * t * (3 - 2 * t);
|
|
114
|
+
};
|
|
115
|
+
const mod = (a: number, n: number): number => ((a % n) + n) % n;
|
|
116
|
+
|
|
117
|
+
function rng(seed: number): () => number {
|
|
118
|
+
let state = seed | 0;
|
|
119
|
+
return () => {
|
|
120
|
+
state = (Math.imul(state, 1664525) + 1013904223) | 0;
|
|
121
|
+
return (state >>> 0) / 4294967296;
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* One axis of a periodic lattice, per voxel: the two cells it blends (wrapped), and the blend weight of
|
|
127
|
+
* the second (`smooth` of the fraction) with its complement. Computed once per axis position, not once
|
|
128
|
+
* per voxel and neighbour; the expressions are the ones the per-voxel loop used, so every float matches.
|
|
129
|
+
*/
|
|
130
|
+
function latticeAxis(cells: number, size: number) {
|
|
131
|
+
const first = new Int32Array(size);
|
|
132
|
+
const second = new Int32Array(size);
|
|
133
|
+
const upper = new Float64Array(size);
|
|
134
|
+
const lower = new Float64Array(size);
|
|
135
|
+
for (let n = 0; n < size; n++) {
|
|
136
|
+
const f = ((n + 0.5) / size) * cells - 0.5;
|
|
137
|
+
const i = Math.floor(f);
|
|
138
|
+
const w = smooth(f - i);
|
|
139
|
+
first[n] = mod(i, cells);
|
|
140
|
+
second[n] = mod(i + 1, cells);
|
|
141
|
+
upper[n] = w;
|
|
142
|
+
lower[n] = 1 - w;
|
|
143
|
+
}
|
|
144
|
+
return { first, second, upper, lower };
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/** Periodic value noise on a size^dims grid with `cells` lattice cells per axis. */
|
|
148
|
+
function valueNoise(cells: number, size: number, dims: 2 | 3, next: () => number): Float32Array {
|
|
149
|
+
const lattice = Float32Array.from({ length: cells ** dims }, next);
|
|
150
|
+
const out = new Float32Array(size ** dims);
|
|
151
|
+
const depth = dims === 3 ? size : 1;
|
|
152
|
+
const layers = dims === 3 ? 2 : 1;
|
|
153
|
+
const axis = latticeAxis(cells, size);
|
|
154
|
+
// Typed-array reads are in range by construction (every index is below `size`), hence the casts.
|
|
155
|
+
const { first, second, lower, upper } = axis;
|
|
156
|
+
for (let z = 0; z < depth; z++) {
|
|
157
|
+
for (let y = 0; y < size; y++) {
|
|
158
|
+
for (let x = 0; x < size; x++) {
|
|
159
|
+
let sum = 0;
|
|
160
|
+
for (let c = 0; c < layers; c++) {
|
|
161
|
+
const zOffset = dims === 3 ? cells * cells * ((c ? second[z] : first[z]) as number) : 0;
|
|
162
|
+
const wz = dims === 3 ? ((c ? upper[z] : lower[z]) as number) : 1;
|
|
163
|
+
for (let b = 0; b < 2; b++) {
|
|
164
|
+
const yOffset = cells * ((b ? second[y] : first[y]) as number);
|
|
165
|
+
const wy = (b ? upper[y] : lower[y]) as number;
|
|
166
|
+
for (let a = 0; a < 2; a++) {
|
|
167
|
+
const at = ((a ? second[x] : first[x]) as number) + yOffset + zOffset;
|
|
168
|
+
sum += (lattice[at] ?? 0) * ((a ? upper[x] : lower[x]) as number) * wy * wz;
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
out[x + size * (y + size * z)] = sum;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
return out;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/**
|
|
180
|
+
* Periodic inverted Worley F1: 1 minus the distance to the nearest of one point per cell.
|
|
181
|
+
*
|
|
182
|
+
* The nearest of the 27 surrounding cells' points is a minimum, so it does not depend on the order the
|
|
183
|
+
* cells are visited, and a cell whose nearest possible point (its whole cell box) is already farther
|
|
184
|
+
* than the best so far cannot change it. The cells are visited centre first and the far ones are
|
|
185
|
+
* skipped by that bound; each point's distance is computed with the same expression as before, so the
|
|
186
|
+
* result is bit for bit the full 27-cell scan.
|
|
187
|
+
*/
|
|
188
|
+
function worleyInverted(cells: number, size: number, next: () => number): Float32Array {
|
|
189
|
+
const points = Float32Array.from({ length: cells ** 3 * 3 }, next);
|
|
190
|
+
const out = new Float32Array(size ** 3);
|
|
191
|
+
// Per axis position: the sample point, its cell, the wrapped cell and the squared distance from the
|
|
192
|
+
// sample to the nearest edge of the box of each of the three neighbours (-1, 0, +1). A point lies
|
|
193
|
+
// in [0, 1) of its cell, and the margin covers the rounding of the bound itself.
|
|
194
|
+
const p = new Float64Array(size);
|
|
195
|
+
const cell = new Int32Array(size);
|
|
196
|
+
const wrapped = new Int32Array(size * 3);
|
|
197
|
+
const gap = new Float64Array(size * 3);
|
|
198
|
+
const margin = 1e-9;
|
|
199
|
+
for (let n = 0; n < size; n++) {
|
|
200
|
+
p[n] = ((n + 0.5) / size) * cells;
|
|
201
|
+
cell[n] = Math.floor(p[n] as number);
|
|
202
|
+
for (let d = 0; d < 3; d++) {
|
|
203
|
+
const low = (cell[n] as number) + d - 1 - (p[n] as number);
|
|
204
|
+
wrapped[n * 3 + d] = mod((cell[n] as number) + d - 1, cells);
|
|
205
|
+
gap[n * 3 + d] = low > 0 ? low * low : low + 1 < 0 ? (low + 1) ** 2 : 0;
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
for (let z = 0; z < size; z++) {
|
|
209
|
+
const pz = p[z] as number;
|
|
210
|
+
const cz = cell[z] as number;
|
|
211
|
+
for (let y = 0; y < size; y++) {
|
|
212
|
+
const py = p[y] as number;
|
|
213
|
+
const cy = cell[y] as number;
|
|
214
|
+
for (let x = 0; x < size; x++) {
|
|
215
|
+
const px = p[x] as number;
|
|
216
|
+
const cx = cell[x] as number;
|
|
217
|
+
let best = 9;
|
|
218
|
+
for (let a = 0; a < 3; a++) {
|
|
219
|
+
const kk = (a + 1) % 3;
|
|
220
|
+
const gz = gap[z * 3 + kk] as number;
|
|
221
|
+
if (gz > best + margin) continue;
|
|
222
|
+
const k = kk - 1;
|
|
223
|
+
const zOffset = cells * cells * (wrapped[z * 3 + kk] as number);
|
|
224
|
+
for (let b = 0; b < 3; b++) {
|
|
225
|
+
const jj = (b + 1) % 3;
|
|
226
|
+
const gyz = gz + (gap[y * 3 + jj] as number);
|
|
227
|
+
if (gyz > best + margin) continue;
|
|
228
|
+
const j = jj - 1;
|
|
229
|
+
const yOffset = cells * (wrapped[y * 3 + jj] as number);
|
|
230
|
+
for (let c = 0; c < 3; c++) {
|
|
231
|
+
const ii = (c + 1) % 3;
|
|
232
|
+
if (gyz + (gap[x * 3 + ii] as number) > best + margin) continue;
|
|
233
|
+
const i = ii - 1;
|
|
234
|
+
const at = 3 * ((wrapped[x * 3 + ii] as number) + yOffset + zOffset);
|
|
235
|
+
const dx = cx + i + (points[at] ?? 0) - px;
|
|
236
|
+
const dy = cy + j + (points[at + 1] ?? 0) - py;
|
|
237
|
+
const dz = cz + k + (points[at + 2] ?? 0) - pz;
|
|
238
|
+
best = Math.min(best, dx * dx + dy * dy + dz * dz);
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
out[x + size * (y + size * z)] = 1 - Math.sqrt(best);
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
return out;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
const standardise = (v: Float32Array): Float32Array => {
|
|
250
|
+
let mean = 0;
|
|
251
|
+
for (const x of v) mean += x;
|
|
252
|
+
mean /= v.length;
|
|
253
|
+
let variance = 0;
|
|
254
|
+
for (const x of v) variance += (x - mean) ** 2;
|
|
255
|
+
const scale = 1 / Math.sqrt(variance / v.length || 1);
|
|
256
|
+
return v.map((x) => (x - mean) * scale);
|
|
257
|
+
};
|
|
258
|
+
|
|
259
|
+
/** Replace each value by the quantile-table value at its rank, keeping the noise's spatial order. */
|
|
260
|
+
function matchQuantiles(values: Float32Array, table: readonly number[]): Float32Array {
|
|
261
|
+
const sorted = Float32Array.from(values).sort();
|
|
262
|
+
const last = table.length - 1;
|
|
263
|
+
return values.map((value) => {
|
|
264
|
+
let lo = 0;
|
|
265
|
+
let hi = sorted.length;
|
|
266
|
+
while (lo < hi) {
|
|
267
|
+
const mid = (lo + hi) >> 1;
|
|
268
|
+
if ((sorted[mid] ?? 0) < value) lo = mid + 1;
|
|
269
|
+
else hi = mid;
|
|
270
|
+
}
|
|
271
|
+
const t = (lo / Math.max(1, sorted.length - 1)) * last;
|
|
272
|
+
const i = Math.min(last - 1, Math.floor(t));
|
|
273
|
+
return (table[i] ?? 0) + ((table[i + 1] ?? 0) - (table[i] ?? 0)) * (t - i);
|
|
274
|
+
});
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
export interface ICloudTextures {
|
|
278
|
+
/** RGBA float, PATTERN_SIZE squared, one cloud type per channel (alpha unused). */
|
|
279
|
+
pattern: Float32Array;
|
|
280
|
+
/** RG float, VOLUME_SIZE cubed: R is the distortion noise, G the shape noise. */
|
|
281
|
+
volume: Float32Array;
|
|
282
|
+
}
|
|
283
|
+
const textureCache = new Map<number, ICloudTextures>();
|
|
284
|
+
|
|
285
|
+
export function cloudTextures(seed = 631): ICloudTextures {
|
|
286
|
+
const cached = textureCache.get(seed);
|
|
287
|
+
if (cached) return cached;
|
|
288
|
+
const next = rng(seed);
|
|
289
|
+
const n = PATTERN_SIZE;
|
|
290
|
+
const pattern = new Float32Array(n * n * 4);
|
|
291
|
+
for (let c = 0; c < 3; c++) {
|
|
292
|
+
let field = new Float32Array(n * n);
|
|
293
|
+
for (let o = 0; o < 3; o++) {
|
|
294
|
+
const octave = valueNoise((PATTERN_CELLS[c] ?? 8) * 2 ** o, n, 2, next);
|
|
295
|
+
field = field.map((v, i) => v + (octave[i] ?? 0) * 0.5 ** o);
|
|
296
|
+
}
|
|
297
|
+
const mapped = matchQuantiles(field, PATTERN_QUANTILES[c] ?? []);
|
|
298
|
+
for (let i = 0; i < n * n; i++) pattern[i * 4 + c] = mapped[i] ?? 0;
|
|
299
|
+
}
|
|
300
|
+
const v = VOLUME_SIZE;
|
|
301
|
+
const blend = (
|
|
302
|
+
cells: number,
|
|
303
|
+
noiseCells: number,
|
|
304
|
+
weight: number,
|
|
305
|
+
table: readonly number[],
|
|
306
|
+
): Float32Array => {
|
|
307
|
+
const worley = standardise(worleyInverted(cells, v, next));
|
|
308
|
+
const smoothNoise = standardise(valueNoise(noiseCells, v, 3, next));
|
|
309
|
+
return matchQuantiles(
|
|
310
|
+
worley.map((x, i) => weight * x + (1 - weight) * (smoothNoise[i] ?? 0)),
|
|
311
|
+
table,
|
|
312
|
+
);
|
|
313
|
+
};
|
|
314
|
+
const shape = blend(6, 3, 0.7, VOLUME_QUANTILES[1]);
|
|
315
|
+
const distortion = blend(3, 8, 0.92, VOLUME_QUANTILES[0]);
|
|
316
|
+
const volume = new Float32Array(v ** 3 * 2);
|
|
317
|
+
for (let i = 0; i < v ** 3; i++) {
|
|
318
|
+
volume[i * 2] = distortion[i] ?? 0;
|
|
319
|
+
volume[i * 2 + 1] = shape[i] ?? 0;
|
|
320
|
+
}
|
|
321
|
+
const textures = { pattern, volume };
|
|
322
|
+
textureCache.set(seed, textures);
|
|
323
|
+
return textures;
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
/** T_Profile_08 stand-in: the three cloud types' vertical profile at altitude fraction u, pattern v. */
|
|
327
|
+
function cloudProfile(type: 0 | 1 | 2, u: number, v: number): number {
|
|
328
|
+
const coefficients = PROFILE_COEFFICIENTS[type];
|
|
329
|
+
const u2 = u * u;
|
|
330
|
+
const u3 = u2 * u;
|
|
331
|
+
const v2 = v * v;
|
|
332
|
+
const v3 = v2 * v;
|
|
333
|
+
const u4 = u3 * u;
|
|
334
|
+
const v4 = v3 * v;
|
|
335
|
+
const us = [1, u, u2, u3, u4];
|
|
336
|
+
const vs = [1, v, v2, v3, v4];
|
|
337
|
+
let sum = 0;
|
|
338
|
+
for (let i = 0; i < PROFILE_TERMS.length; i++) {
|
|
339
|
+
const term = PROFILE_TERMS[i] ?? [0, 0];
|
|
340
|
+
sum += (coefficients[i] ?? 0) * (us[term[0]] ?? 0) * (vs[term[1]] ?? 0);
|
|
341
|
+
}
|
|
342
|
+
return sum;
|
|
343
|
+
}
|
|
344
|
+
/** Profile baked to a 64 x 64 RGBA texture, u along x and the pattern value along y. */
|
|
345
|
+
export function cloudProfileTexture(size = 64): Float32Array {
|
|
346
|
+
const out = new Float32Array(size * size * 4);
|
|
347
|
+
for (let y = 0; y < size; y++)
|
|
348
|
+
for (let x = 0; x < size; x++)
|
|
349
|
+
for (let c = 0; c < 3; c++)
|
|
350
|
+
out[(y * size + x) * 4 + c] = cloudProfile(
|
|
351
|
+
c as 0 | 1 | 2,
|
|
352
|
+
(x + 0.5) / size,
|
|
353
|
+
(y + 0.5) / size,
|
|
354
|
+
);
|
|
355
|
+
return out;
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
// The two samplers run per ray step in the CPU sky bake. The wrapped cell indices and the complementary
|
|
359
|
+
// weights are computed once per call, not once per tap or closure; every product and sum is the one the
|
|
360
|
+
// closure form evaluated, in the same order.
|
|
361
|
+
function samplePattern(pattern: Float32Array, u: number, v: number, c: number): number {
|
|
362
|
+
const n = PATTERN_SIZE;
|
|
363
|
+
const fx = u * n - 0.5;
|
|
364
|
+
const fy = v * n - 0.5;
|
|
365
|
+
const ix = Math.floor(fx);
|
|
366
|
+
const iy = Math.floor(fy);
|
|
367
|
+
const wx = fx - ix;
|
|
368
|
+
const wy = fy - iy;
|
|
369
|
+
const x0 = mod(ix, n);
|
|
370
|
+
const x1 = mod(ix + 1, n);
|
|
371
|
+
const row0 = mod(iy, n) * n;
|
|
372
|
+
const row1 = mod(iy + 1, n) * n;
|
|
373
|
+
const nx = 1 - wx;
|
|
374
|
+
return (
|
|
375
|
+
((pattern[(row0 + x0) * 4 + c] ?? 0) * nx + (pattern[(row0 + x1) * 4 + c] ?? 0) * wx) *
|
|
376
|
+
(1 - wy) +
|
|
377
|
+
((pattern[(row1 + x0) * 4 + c] ?? 0) * nx + (pattern[(row1 + x1) * 4 + c] ?? 0) * wx) * wy
|
|
378
|
+
);
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
function sampleVolume(volume: Float32Array, x: number, y: number, z: number, c: number): number {
|
|
382
|
+
const n = VOLUME_SIZE;
|
|
383
|
+
const fx = x * n - 0.5;
|
|
384
|
+
const fy = y * n - 0.5;
|
|
385
|
+
const fz = z * n - 0.5;
|
|
386
|
+
const ix = Math.floor(fx);
|
|
387
|
+
const iy = Math.floor(fy);
|
|
388
|
+
const iz = Math.floor(fz);
|
|
389
|
+
const wx = fx - ix;
|
|
390
|
+
const wy = fy - iy;
|
|
391
|
+
const wz = fz - iz;
|
|
392
|
+
const x0 = mod(ix, n);
|
|
393
|
+
const x1 = mod(ix + 1, n);
|
|
394
|
+
const y0 = n * mod(iy, n);
|
|
395
|
+
const y1 = n * mod(iy + 1, n);
|
|
396
|
+
const z0 = n * n * mod(iz, n);
|
|
397
|
+
const z1 = n * n * mod(iz + 1, n);
|
|
398
|
+
const nx = 1 - wx;
|
|
399
|
+
const ny = 1 - wy;
|
|
400
|
+
const plane0 =
|
|
401
|
+
((volume[(x0 + y0 + z0) * 2 + c] ?? 0) * nx + (volume[(x1 + y0 + z0) * 2 + c] ?? 0) * wx) * ny +
|
|
402
|
+
((volume[(x0 + y1 + z0) * 2 + c] ?? 0) * nx + (volume[(x1 + y1 + z0) * 2 + c] ?? 0) * wx) * wy;
|
|
403
|
+
const plane1 =
|
|
404
|
+
((volume[(x0 + y0 + z1) * 2 + c] ?? 0) * nx + (volume[(x1 + y0 + z1) * 2 + c] ?? 0) * wx) * ny +
|
|
405
|
+
((volume[(x0 + y1 + z1) * 2 + c] ?? 0) * nx + (volume[(x1 + y1 + z1) * 2 + c] ?? 0) * wx) * wy;
|
|
406
|
+
return plane0 * (1 - wz) + plane1 * wz;
|
|
407
|
+
}
|
|
408
|
+
|
|
409
|
+
/**
|
|
410
|
+
* Extinction per metre at planet-centred (x, y, z) km, y up. The material's graph, with wind at
|
|
411
|
+
* zero and the three cloud types at weight one: coverage pattern times (altitude profile
|
|
412
|
+
* minus one half plus distorted shape noise), times Cloud_GlobalDensity, zero near layer edges.
|
|
413
|
+
*/
|
|
414
|
+
function cloudDensityField(seed = 631): (x: number, y: number, z: number) => number {
|
|
415
|
+
const { pattern, volume } = cloudTextures(seed);
|
|
416
|
+
const m = CLOUD_MATERIAL;
|
|
417
|
+
return (x, y, z) => {
|
|
418
|
+
const altitude = Math.hypot(x, y, z) - PLANET;
|
|
419
|
+
if (altitude <= CLOUD_BOTTOM_KM || altitude >= CLOUD_TOP_KM) return 0;
|
|
420
|
+
const h = (altitude - CLOUD_BOTTOM_KM) / (CLOUD_TOP_KM - CLOUD_BOTTOM_KM);
|
|
421
|
+
if (h < m.insideLayer[0] || h > m.insideLayer[1]) return 0;
|
|
422
|
+
const u = x / m.layoutKm;
|
|
423
|
+
const v = z / m.layoutKm;
|
|
424
|
+
const p0 = samplePattern(pattern, u, v, 0);
|
|
425
|
+
const p1 = samplePattern(pattern, u, v, 1);
|
|
426
|
+
const p2 = samplePattern(pattern, u, v, 2);
|
|
427
|
+
const coverage = Math.max(p0, p1, p2);
|
|
428
|
+
if (coverage <= 0) return 0;
|
|
429
|
+
const profile =
|
|
430
|
+
Math.max(cloudProfile(0, h, p0), cloudProfile(1, h, p1), cloudProfile(2, h, p2)) - 0.5;
|
|
431
|
+
const sky: [number, number, number] = [u + 0.5, v + 0.5, (y - PLANET) / m.layoutKm];
|
|
432
|
+
const a = h * 0.95 + 0.05;
|
|
433
|
+
const c = (2 * Math.abs(a - 0.5)) ** 2;
|
|
434
|
+
const warp =
|
|
435
|
+
(sampleVolume(
|
|
436
|
+
volume,
|
|
437
|
+
sky[0] * m.noise2Scale[0],
|
|
438
|
+
sky[1] * m.noise2Scale[1],
|
|
439
|
+
sky[2] * m.noise2Scale[2],
|
|
440
|
+
0,
|
|
441
|
+
) -
|
|
442
|
+
m.noiseBias[1]) *
|
|
443
|
+
m.noiseStrength[1];
|
|
444
|
+
const shape = sampleVolume(
|
|
445
|
+
volume,
|
|
446
|
+
sky[0] * m.noise1Scale[0] + a * warp,
|
|
447
|
+
sky[1] * m.noise1Scale[1] + a * warp,
|
|
448
|
+
sky[2] * m.noise1Scale[2] + c * warp,
|
|
449
|
+
1,
|
|
450
|
+
);
|
|
451
|
+
const noise = (shape - m.noiseBias[0] + m.coverage) * m.noiseStrength[0];
|
|
452
|
+
return clamp(coverage * (profile + noise) * m.density);
|
|
453
|
+
};
|
|
454
|
+
}
|
|
455
|
+
|
|
456
|
+
/** Beer–Lambert transmission for a nonnegative optical depth. */
|
|
457
|
+
const cloudTransmittance = (depth: number): number => Math.exp(-Math.max(0, depth));
|
|
458
|
+
const hg = (cosine: number, g: number): number =>
|
|
459
|
+
(1 - g * g) / (4 * Math.PI * (1 + g * g - 2 * g * cosine) ** 1.5);
|
|
460
|
+
/** The material's dual lobe: HG(g) blended toward HG(g2). */
|
|
461
|
+
const cloudPhase = (cosine: number): number => {
|
|
462
|
+
const p = CLOUD_MATERIAL.phase;
|
|
463
|
+
const forward = hg(cosine, p.g);
|
|
464
|
+
return forward + p.blend * (hg(cosine, p.g2) - forward);
|
|
465
|
+
};
|
|
466
|
+
/** Per scattering octave: scattering and extinction scale, and the lerp toward isotropic phase. */
|
|
467
|
+
export function cloudOctaves(): Array<{ scatter: number; extinction: number; anisotropy: number }> {
|
|
468
|
+
const ms = CLOUD_MATERIAL.multiScatter;
|
|
469
|
+
let s = ms.contribution;
|
|
470
|
+
let e = ms.occlusion;
|
|
471
|
+
let f = ms.eccentricity;
|
|
472
|
+
const out = [{ scatter: 1, extinction: 1, anisotropy: 1 }];
|
|
473
|
+
for (let i = 1; i <= ms.octaves; i++) {
|
|
474
|
+
const last = out[i - 1] ?? { scatter: 1, extinction: 1, anisotropy: 1 };
|
|
475
|
+
out.push({ scatter: last.scatter * s, extinction: last.extinction * e, anisotropy: f });
|
|
476
|
+
s *= s;
|
|
477
|
+
e *= e;
|
|
478
|
+
f *= f;
|
|
479
|
+
}
|
|
480
|
+
return out;
|
|
481
|
+
}
|
|
482
|
+
const sphereExit = (r: number, mu: number, radius: number): number =>
|
|
483
|
+
-r * mu + Math.sqrt(r * r * mu * mu + radius * radius - r * r);
|
|
484
|
+
|
|
485
|
+
/** Composite in place, in bakeSkyRadiance's radiance per unit sun illuminance; no DOM or GPU. */
|
|
486
|
+
export function bakeCloudRadiance(
|
|
487
|
+
radiance: Float32Array,
|
|
488
|
+
sun: { x: number; y: number; z: number },
|
|
489
|
+
width: number,
|
|
490
|
+
height: number,
|
|
491
|
+
seed = 631,
|
|
492
|
+
): void {
|
|
493
|
+
if (
|
|
494
|
+
!Number.isInteger(width) ||
|
|
495
|
+
!Number.isInteger(height) ||
|
|
496
|
+
width < 1 ||
|
|
497
|
+
height < 1 ||
|
|
498
|
+
radiance.length !== width * height * 3 ||
|
|
499
|
+
!Number.isFinite(seed) ||
|
|
500
|
+
!(Math.abs(Math.hypot(sun.x, sun.y, sun.z) - 1) <= 0.001)
|
|
501
|
+
) {
|
|
502
|
+
throw new Error(
|
|
503
|
+
"Cloud bake requires matching positive dimensions, a finite seed and a unit sun",
|
|
504
|
+
);
|
|
505
|
+
}
|
|
506
|
+
const density = cloudDensityField(seed);
|
|
507
|
+
const octaves = cloudOctaves();
|
|
508
|
+
const ambient = [0, 0, 0];
|
|
509
|
+
let weights = 0;
|
|
510
|
+
for (let y = 0; y < height / 2; y += 1) {
|
|
511
|
+
const theta = ((y + 0.5) / height) * Math.PI;
|
|
512
|
+
const weight = Math.sin(theta) * Math.max(0, Math.cos(theta));
|
|
513
|
+
for (let x = 0; x < width; x += 1) {
|
|
514
|
+
for (let c = 0; c < 3; c += 1)
|
|
515
|
+
ambient[c] = (ambient[c] ?? 0) + (radiance[(y * width + x) * 3 + c] ?? 0) * weight;
|
|
516
|
+
weights += weight;
|
|
517
|
+
}
|
|
518
|
+
}
|
|
519
|
+
for (let c = 0; c < 3; c += 1) ambient[c] = (ambient[c] ?? 0) / Math.max(weights, 1e-9);
|
|
520
|
+
for (let y = 0; y < height / 2; y += 1) {
|
|
521
|
+
const elevation = Math.PI / 2 - ((y + 0.5) / height) * Math.PI;
|
|
522
|
+
const dy = Math.sin(elevation);
|
|
523
|
+
const horizontal = Math.cos(elevation);
|
|
524
|
+
const entry = sphereExit(CAMERA, dy, PLANET + CLOUD_BOTTOM_KM);
|
|
525
|
+
if (entry > 350) continue;
|
|
526
|
+
const length = Math.min(
|
|
527
|
+
CLOUD_MODEL.tracingKm,
|
|
528
|
+
sphereExit(CAMERA, dy, PLANET + CLOUD_TOP_KM) - entry,
|
|
529
|
+
);
|
|
530
|
+
const steps = Math.min(
|
|
531
|
+
CLOUD_MODEL.maxViewSteps,
|
|
532
|
+
Math.max(CLOUD_MODEL.minViewSteps, Math.ceil((length * 1000) / CLOUD_MODEL.viewStepMetres)),
|
|
533
|
+
);
|
|
534
|
+
const dt = length / steps;
|
|
535
|
+
const fade =
|
|
536
|
+
1 -
|
|
537
|
+
smooth(
|
|
538
|
+
(entry - CLOUD_MODEL.horizonFadeStartKm) /
|
|
539
|
+
(CLOUD_MODEL.horizonFadeEndKm - CLOUD_MODEL.horizonFadeStartKm),
|
|
540
|
+
);
|
|
541
|
+
// shortcut: integrate the clear-air column to layer entry, not per cloud sample; upgrade for airborne cameras.
|
|
542
|
+
const airDepth = [0, 0, 0];
|
|
543
|
+
for (let i = 0; i < 8; i += 1) {
|
|
544
|
+
const t = (entry * (i + 0.5)) / 8;
|
|
545
|
+
const h = Math.hypot(horizontal * t, CAMERA + dy * t) - PLANET;
|
|
546
|
+
for (let c = 0; c < 3; c += 1)
|
|
547
|
+
airDepth[c] =
|
|
548
|
+
(airDepth[c] ?? 0) +
|
|
549
|
+
(((RAYLEIGH[c as 0 | 1 | 2] ?? 0) * Math.exp(-h / 8) +
|
|
550
|
+
(MIE_SCATTER + MIE_ABSORB) * Math.exp(-h / 1.2)) *
|
|
551
|
+
entry) /
|
|
552
|
+
8;
|
|
553
|
+
}
|
|
554
|
+
for (let x = 0; x < width; x += 1) {
|
|
555
|
+
const azimuth = ((x + 0.5) / width - 0.5) * 2 * Math.PI;
|
|
556
|
+
const dx = horizontal * Math.cos(azimuth);
|
|
557
|
+
const dz = horizontal * Math.sin(azimuth);
|
|
558
|
+
const phase = cloudPhase(dx * sun.x + dy * sun.y + dz * sun.z);
|
|
559
|
+
let through = 1;
|
|
560
|
+
const light = [0, 0, 0];
|
|
561
|
+
for (let i = 0; i < steps && through > 0.005; i += 1) {
|
|
562
|
+
const t = entry + (i + 0.5) * dt;
|
|
563
|
+
const px = dx * t;
|
|
564
|
+
const py = CAMERA + dy * t;
|
|
565
|
+
const pz = dz * t;
|
|
566
|
+
const extinction = density(px, py, pz) * 1000 * fade; // per km
|
|
567
|
+
if (extinction === 0) continue;
|
|
568
|
+
const r = Math.hypot(px, py, pz);
|
|
569
|
+
const shadowLength = Math.min(
|
|
570
|
+
15,
|
|
571
|
+
sphereExit(r, (px * sun.x + py * sun.y + pz * sun.z) / r, PLANET + CLOUD_TOP_KM),
|
|
572
|
+
);
|
|
573
|
+
let shadowDepth = 0;
|
|
574
|
+
for (let j = 0; j < CLOUD_MODEL.lightSteps; j += 1) {
|
|
575
|
+
const s = shadowLength * ((j + 0.5) / CLOUD_MODEL.lightSteps) ** 2;
|
|
576
|
+
const ds = (shadowLength * (2 * j + 1)) / CLOUD_MODEL.lightSteps ** 2;
|
|
577
|
+
shadowDepth += density(px + sun.x * s, py + sun.y * s, pz + sun.z * s) * 1000 * ds;
|
|
578
|
+
}
|
|
579
|
+
const stepT = cloudTransmittance(extinction * dt);
|
|
580
|
+
let direct = 0;
|
|
581
|
+
for (const o of octaves)
|
|
582
|
+
direct +=
|
|
583
|
+
o.scatter *
|
|
584
|
+
cloudTransmittance(shadowDepth * o.extinction) *
|
|
585
|
+
(1 / (4 * Math.PI) + (phase - 1 / (4 * Math.PI)) * o.anisotropy);
|
|
586
|
+
// The sun reaches this sample through the air above it, not through the whole atmosphere.
|
|
587
|
+
const sunlight = transmittanceToTop(r, (px * sun.x + py * sun.y + pz * sun.z) / r);
|
|
588
|
+
for (let c = 0; c < 3; c += 1) {
|
|
589
|
+
const source =
|
|
590
|
+
direct * (sunlight[c as 0 | 1 | 2] ?? 0) +
|
|
591
|
+
(ambient[c] ?? 0) * CLOUD_MATERIAL.skyOcclusion;
|
|
592
|
+
light[c] = (light[c] ?? 0) + through * (1 - stepT) * CLOUD_MATERIAL.albedo * source;
|
|
593
|
+
}
|
|
594
|
+
through *= stepT;
|
|
595
|
+
}
|
|
596
|
+
for (let c = 0; c < 3; c += 1) {
|
|
597
|
+
const at = (y * width + x) * 3 + c;
|
|
598
|
+
const sky = radiance[at] ?? 0;
|
|
599
|
+
radiance[at] =
|
|
600
|
+
sky + Math.exp(-(airDepth[c] ?? 0)) * ((light[c] ?? 0) - sky * (1 - through));
|
|
601
|
+
}
|
|
602
|
+
}
|
|
603
|
+
}
|
|
604
|
+
}
|
|
605
|
+
export type { Rgb };
|