create-threenative 0.2.7 → 0.2.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -1
- package/agent-docs/references/assertion-reference.md +87 -35
- package/agent-docs/references/auto-exposure.md +57 -0
- package/agent-docs/references/capability-reference.md +1306 -62
- package/agent-docs/references/debug-surface.md +6 -0
- package/agent-docs/references/finding-assets.md +46 -10
- package/agent-docs/references/performance-basics.md +5 -4
- package/agent-docs/references/terrain-authoring.md +140 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
- package/capabilities.json +1505 -79
- package/dist/index.d.ts +28 -3
- package/dist/index.js +402 -167
- package/dist/threenative.js +989 -237
- package/dist/web-engine-buffer-geometry-utils.js +281 -0
- package/dist/web-engine-decal-geometry.js +184 -0
- package/dist/web-engine-gltf-loader.js +196 -0
- package/dist/web-engine-hdr-loader.js +190 -0
- package/dist/web-engine-lut-cube-loader.js +122 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
- package/dist/web-engine-mesh-bvh.js +32 -0
- package/dist/web-engine-post-effects.js +168 -0
- package/dist/web-engine-runtime.js +42506 -0
- package/package.json +11 -8
- package/template-assets/autoExposure.ts +225 -0
- package/template-assets/exposure.ts +111 -0
- package/template-assets/exposureGraph.ts +178 -0
- package/template-assets/exposureReadback.ts +79 -0
- package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
- package/template-assets/patches/three@0.185.1.patch +6594 -700
- package/template-assets/patches/vite@8.2.0.patch +422 -0
- package/template-assets/worldEnvironment.ts +433 -30
- package/templates/action-rpg/AGENTS.md +11 -10
- package/templates/action-rpg/CLAUDE.md +11 -10
- package/templates/action-rpg/package.json +11 -9
- package/templates/action-rpg/playtests/performance.playtest.json +7 -1
- package/templates/action-rpg/src/progress.ts +0 -4
- package/templates/action-rpg/src/render/autoExposure.ts +225 -0
- package/templates/action-rpg/src/render/backlightControls.ts +66 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
- package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
- package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
- package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
- package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
- package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
- package/templates/action-rpg/src/render/exposure.ts +111 -0
- package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
- package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
- package/templates/action-rpg/src/render/heightFog.ts +118 -0
- package/templates/action-rpg/src/render/lighting.ts +26 -1
- package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
- package/templates/action-rpg/src/render/materialLighting.ts +155 -0
- package/templates/action-rpg/src/render/postprocessing.ts +17 -2
- package/templates/action-rpg/src/render/quality.ts +61 -2
- package/templates/action-rpg/src/render/sky.ts +21 -1
- package/templates/action-rpg/src/render/vfx.ts +133 -58
- package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
- package/templates/action-rpg/src/scenes/Play.ts +81 -16
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/action-rpg/vite.config.ts +10 -2
- package/templates/minimal/AGENTS.md +9 -10
- package/templates/minimal/CLAUDE.md +9 -10
- package/templates/minimal/package.json +9 -8
- package/templates/minimal/playtests/play.playtest.json +7 -1
- package/templates/minimal/playtests/sky.playtest.json +10 -1
- package/templates/minimal/src/render/autoExposure.ts +225 -0
- package/templates/minimal/src/render/backlightControls.ts +66 -0
- package/templates/minimal/src/render/backlightMaterial.ts +147 -0
- package/templates/minimal/src/render/environmentContribution.ts +188 -0
- package/templates/minimal/src/render/environmentRadiance.ts +36 -0
- package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
- package/templates/minimal/src/render/environmentSampling.ts +193 -0
- package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
- package/templates/minimal/src/render/exposure.ts +111 -0
- package/templates/minimal/src/render/exposureGraph.ts +178 -0
- package/templates/minimal/src/render/exposureReadback.ts +79 -0
- package/templates/minimal/src/render/heightFog.ts +118 -0
- package/templates/minimal/src/render/lighting.ts +25 -1
- package/templates/minimal/src/render/materialAssignments.ts +102 -0
- package/templates/minimal/src/render/materialLighting.ts +146 -0
- package/templates/minimal/src/render/postprocessing.ts +16 -2
- package/templates/minimal/src/render/quality.ts +60 -2
- package/templates/minimal/src/render/sky.ts +21 -1
- package/templates/minimal/src/render/worldEnvironment.ts +433 -30
- package/templates/minimal/src/scenes/Play.ts +50 -1
- package/templates/minimal/vite.config.ts +10 -2
- package/templates/platformer/AGENTS.md +7 -5
- package/templates/platformer/CLAUDE.md +7 -5
- package/templates/platformer/package.json +11 -9
- package/templates/platformer/playtests/performance.playtest.json +7 -1
- package/templates/platformer/src/render/autoExposure.ts +225 -0
- package/templates/platformer/src/render/backlightControls.ts +66 -0
- package/templates/platformer/src/render/backlightMaterial.ts +147 -0
- package/templates/platformer/src/render/environmentContribution.ts +188 -0
- package/templates/platformer/src/render/environmentRadiance.ts +36 -0
- package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
- package/templates/platformer/src/render/environmentSampling.ts +193 -0
- package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
- package/templates/platformer/src/render/exposure.ts +111 -0
- package/templates/platformer/src/render/exposureGraph.ts +178 -0
- package/templates/platformer/src/render/exposureReadback.ts +79 -0
- package/templates/platformer/src/render/heightFog.ts +118 -0
- package/templates/platformer/src/render/lighting.ts +26 -1
- package/templates/platformer/src/render/materialAssignments.ts +160 -0
- package/templates/platformer/src/render/materialLighting.ts +155 -0
- package/templates/platformer/src/render/materials.ts +7 -2
- package/templates/platformer/src/render/palette.ts +3 -3
- package/templates/platformer/src/render/postprocessing.ts +17 -2
- package/templates/platformer/src/render/quality.ts +61 -2
- package/templates/platformer/src/render/sky.ts +72 -23
- package/templates/platformer/src/render/skyEnvironment.ts +50 -0
- package/templates/platformer/src/render/worldEnvironment.ts +433 -30
- package/templates/platformer/src/scenes/Play.ts +70 -6
- package/templates/platformer/vite.config.ts +10 -2
- package/templates/puzzle/AGENTS.md +10 -9
- package/templates/puzzle/CLAUDE.md +10 -9
- package/templates/puzzle/package.json +11 -9
- package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
- package/templates/puzzle/playtests/lit.playtest.json +7 -1
- package/templates/puzzle/playtests/performance.playtest.json +7 -1
- package/templates/puzzle/src/render/autoExposure.ts +225 -0
- package/templates/puzzle/src/render/backlightControls.ts +66 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
- package/templates/puzzle/src/render/environmentContribution.ts +188 -0
- package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
- package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
- package/templates/puzzle/src/render/environmentSampling.ts +193 -0
- package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
- package/templates/puzzle/src/render/exposure.ts +111 -0
- package/templates/puzzle/src/render/exposureGraph.ts +178 -0
- package/templates/puzzle/src/render/exposureReadback.ts +79 -0
- package/templates/puzzle/src/render/heightFog.ts +118 -0
- package/templates/puzzle/src/render/lighting.ts +33 -1
- package/templates/puzzle/src/render/materialAssignments.ts +160 -0
- package/templates/puzzle/src/render/materialLighting.ts +155 -0
- package/templates/puzzle/src/render/materials.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +8 -2
- package/templates/puzzle/src/render/quality.ts +62 -1
- package/templates/puzzle/src/render/sky.ts +20 -1
- package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
- package/templates/puzzle/src/scenes/Play.ts +51 -2
- package/templates/puzzle/vite.config.ts +10 -2
- package/templates/racing/AGENTS.md +8 -7
- package/templates/racing/CLAUDE.md +8 -7
- package/templates/racing/package.json +11 -9
- package/templates/racing/playtests/performance.playtest.json +7 -1
- package/templates/racing/playtests/survives.playtest.json +6 -0
- package/templates/racing/src/render/autoExposure.ts +225 -0
- package/templates/racing/src/render/backlightControls.ts +66 -0
- package/templates/racing/src/render/backlightMaterial.ts +147 -0
- package/templates/racing/src/render/environmentContribution.ts +188 -0
- package/templates/racing/src/render/environmentRadiance.ts +36 -0
- package/templates/racing/src/render/environmentSampleCache.ts +43 -0
- package/templates/racing/src/render/environmentSampling.ts +193 -0
- package/templates/racing/src/render/environmentSnapshot.ts +53 -0
- package/templates/racing/src/render/exposure.ts +111 -0
- package/templates/racing/src/render/exposureGraph.ts +178 -0
- package/templates/racing/src/render/exposureReadback.ts +79 -0
- package/templates/racing/src/render/heightFog.ts +118 -0
- package/templates/racing/src/render/lighting.ts +29 -1
- package/templates/racing/src/render/materialAssignments.ts +160 -0
- package/templates/racing/src/render/materialLighting.ts +155 -0
- package/templates/racing/src/render/palette.ts +1 -10
- package/templates/racing/src/render/postprocessing.ts +17 -2
- package/templates/racing/src/render/quality.ts +61 -2
- package/templates/racing/src/render/shapes.ts +0 -25
- package/templates/racing/src/render/sky.ts +21 -1
- package/templates/racing/src/render/worldEnvironment.ts +433 -30
- package/templates/racing/src/scenes/Race.ts +91 -3
- package/templates/racing/src/track/circuit.ts +0 -9
- package/templates/racing/vite.config.ts +10 -2
- package/templates/rain/.codex/config.toml +19 -0
- package/templates/rain/.cursor/mcp.json +32 -0
- package/templates/rain/.gemini/settings.json +32 -0
- package/templates/rain/.mcp.json +32 -0
- package/templates/rain/.vscode/mcp.json +36 -0
- package/templates/rain/.zed/settings.json +36 -0
- package/templates/rain/AGENTS.md +95 -0
- package/templates/rain/CLAUDE.md +97 -0
- package/templates/rain/assets/rain-loop.wav +0 -0
- package/templates/rain/assets/thunder.wav +0 -0
- package/templates/rain/assets/wind-loop.wav +0 -0
- package/templates/rain/index.html +18 -0
- package/templates/rain/kit.json +7 -0
- package/templates/rain/native-playtests/boot.playtest.json +23 -0
- package/templates/rain/native-playtests/lightning.playtest.json +173 -0
- package/templates/rain/opencode.json +41 -0
- package/templates/rain/package.json +59 -0
- package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
- package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
- package/templates/rain/playtests/automation.playtest.json +133 -0
- package/templates/rain/playtests/cinematic.playtest.json +59 -0
- package/templates/rain/playtests/flash.playtest.json +27 -0
- package/templates/rain/playtests/fly.playtest.json +54 -0
- package/templates/rain/playtests/lightning.playtest.json +220 -0
- package/templates/rain/playtests/loading.playtest.json +57 -0
- package/templates/rain/playtests/paused.playtest.json +59 -0
- package/templates/rain/playtests/performance.playtest.json +32 -0
- package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
- package/templates/rain/playtests/simulation.playtest.json +20 -0
- package/templates/rain/playtests/storm.playtest.json +150 -0
- package/templates/rain/playtests/survives.playtest.json +58 -0
- package/templates/rain/playtests/tiers.playtest.json +194 -0
- package/templates/rain/playtests/weather.playtest.json +77 -0
- package/templates/rain/public/favicon.svg +5 -0
- package/templates/rain/src/audio/storm.ts +314 -0
- package/templates/rain/src/game.ts +81 -0
- package/templates/rain/src/main.ts +15 -0
- package/templates/rain/src/render/autoExposure.ts +225 -0
- package/templates/rain/src/render/bloom-shader.ts +65 -0
- package/templates/rain/src/render/camera.ts +160 -0
- package/templates/rain/src/render/clouds-shader.ts +242 -0
- package/templates/rain/src/render/clouds.ts +142 -0
- package/templates/rain/src/render/exposure.ts +111 -0
- package/templates/rain/src/render/exposureGraph.ts +178 -0
- package/templates/rain/src/render/exposureReadback.ts +79 -0
- package/templates/rain/src/render/lighting.ts +39 -0
- package/templates/rain/src/render/lightning.ts +360 -0
- package/templates/rain/src/render/loading.ts +327 -0
- package/templates/rain/src/render/materials.ts +19 -0
- package/templates/rain/src/render/noise-volume.ts +159 -0
- package/templates/rain/src/render/palette.ts +18 -0
- package/templates/rain/src/render/post-shader.ts +178 -0
- package/templates/rain/src/render/postprocessing.ts +229 -0
- package/templates/rain/src/render/quality.ts +161 -0
- package/templates/rain/src/render/rain.ts +299 -0
- package/templates/rain/src/render/sky.ts +28 -0
- package/templates/rain/src/render/world-shader.ts +680 -0
- package/templates/rain/src/render/world.ts +146 -0
- package/templates/rain/src/render/worldEnvironment.ts +1212 -0
- package/templates/rain/src/scenes/Boot.ts +348 -0
- package/templates/rain/src/state.ts +261 -0
- package/templates/rain/src/style.css +1160 -0
- package/templates/rain/src/ui/App.tsx +29 -0
- package/templates/rain/src/ui/GameUi.tsx +187 -0
- package/templates/rain/src/ui/Hud.tsx +327 -0
- package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
- package/templates/rain/src/ui/Menu.tsx +370 -0
- package/templates/rain/src/ui/automation.ts +60 -0
- package/templates/rain/src/ui/main.tsx +7 -0
- package/templates/rain/src/ui/tempest.ts +149 -0
- package/templates/rain/tailwind.config.ts +2 -0
- package/templates/rain/threenative.config.ts +66 -0
- package/templates/rain/tools/generate-shaders.mjs +656 -0
- package/templates/rain/tools/make-storm-audio.mjs +387 -0
- package/templates/rain/tools/storm-dsp.mjs +177 -0
- package/templates/rain/tools/tempest-bloom.frag +10 -0
- package/templates/rain/tools/tempest-clouds.frag +86 -0
- package/templates/rain/tools/tempest-post.frag +47 -0
- package/templates/rain/tools/tempest-world.frag +210 -0
- package/templates/rain/tools/verify-noise-volume.mjs +61 -0
- package/templates/rain/tsconfig.json +17 -0
- package/templates/rain/vite.config.ts +45 -0
- package/templates/rts/AGENTS.md +10 -11
- package/templates/rts/CLAUDE.md +10 -11
- package/templates/rts/package.json +10 -8
- package/templates/rts/playtests/performance.playtest.json +7 -1
- package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-build.playtest.json +10 -1
- package/templates/rts/playtests/rts-orders.playtest.json +7 -1
- package/templates/rts/playtests/rts-train.playtest.json +10 -1
- package/templates/rts/src/render/army.ts +10 -2
- package/templates/rts/src/render/autoExposure.ts +225 -0
- package/templates/rts/src/render/backlightControls.ts +66 -0
- package/templates/rts/src/render/backlightMaterial.ts +147 -0
- package/templates/rts/src/render/environmentContribution.ts +188 -0
- package/templates/rts/src/render/environmentRadiance.ts +36 -0
- package/templates/rts/src/render/environmentSampleCache.ts +43 -0
- package/templates/rts/src/render/environmentSampling.ts +193 -0
- package/templates/rts/src/render/environmentSnapshot.ts +53 -0
- package/templates/rts/src/render/exposure.ts +111 -0
- package/templates/rts/src/render/exposureGraph.ts +178 -0
- package/templates/rts/src/render/exposureReadback.ts +79 -0
- package/templates/rts/src/render/heightFog.ts +118 -0
- package/templates/rts/src/render/lighting.ts +26 -1
- package/templates/rts/src/render/materialAssignments.ts +160 -0
- package/templates/rts/src/render/materialLighting.ts +155 -0
- package/templates/rts/src/render/postprocessing.ts +8 -2
- package/templates/rts/src/render/quality.ts +61 -2
- package/templates/rts/src/render/sky.ts +21 -1
- package/templates/rts/src/render/worldEnvironment.ts +433 -30
- package/templates/rts/src/scenes/Play.ts +54 -3
- package/templates/rts/src/sim/ai.ts +0 -1
- package/templates/rts/src/sim/terrain.ts +0 -4
- package/templates/rts/vite.config.ts +10 -2
- package/templates/runner/AGENTS.md +10 -8
- package/templates/runner/CLAUDE.md +10 -8
- package/templates/runner/package.json +11 -9
- package/templates/runner/playtests/performance.playtest.json +10 -1
- package/templates/runner/src/physics.ts +0 -1
- package/templates/runner/src/render/autoExposure.ts +225 -0
- package/templates/runner/src/render/backlightControls.ts +66 -0
- package/templates/runner/src/render/backlightMaterial.ts +147 -0
- package/templates/runner/src/render/environmentContribution.ts +188 -0
- package/templates/runner/src/render/environmentRadiance.ts +36 -0
- package/templates/runner/src/render/environmentSampleCache.ts +43 -0
- package/templates/runner/src/render/environmentSampling.ts +193 -0
- package/templates/runner/src/render/environmentSnapshot.ts +53 -0
- package/templates/runner/src/render/exposure.ts +111 -0
- package/templates/runner/src/render/exposureGraph.ts +178 -0
- package/templates/runner/src/render/exposureReadback.ts +79 -0
- package/templates/runner/src/render/heightFog.ts +118 -0
- package/templates/runner/src/render/lighting.ts +26 -1
- package/templates/runner/src/render/materialAssignments.ts +160 -0
- package/templates/runner/src/render/materialLighting.ts +155 -0
- package/templates/runner/src/render/postprocessing.ts +17 -2
- package/templates/runner/src/render/quality.ts +61 -2
- package/templates/runner/src/render/sky.ts +21 -1
- package/templates/runner/src/render/worldEnvironment.ts +433 -30
- package/templates/runner/src/scenes/Run.ts +67 -2
- package/templates/runner/threenative.config.ts +3 -0
- package/templates/runner/vite.config.ts +10 -2
- package/templates/sailing/AGENTS.md +14 -13
- package/templates/sailing/CLAUDE.md +14 -13
- package/templates/sailing/native-playtests/survives.playtest.json +7 -0
- package/templates/sailing/package.json +11 -9
- package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
- package/templates/sailing/src/entities/Ship.ts +38 -18
- package/templates/sailing/src/render/autoExposure.ts +225 -0
- package/templates/sailing/src/render/backlightControls.ts +66 -0
- package/templates/sailing/src/render/backlightMaterial.ts +147 -0
- package/templates/sailing/src/render/camera.ts +12 -4
- package/templates/sailing/src/render/environmentContribution.ts +188 -0
- package/templates/sailing/src/render/environmentRadiance.ts +36 -0
- package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
- package/templates/sailing/src/render/environmentSampling.ts +193 -0
- package/templates/sailing/src/render/environmentSetup.ts +24 -0
- package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
- package/templates/sailing/src/render/exposure.ts +111 -0
- package/templates/sailing/src/render/exposureGraph.ts +178 -0
- package/templates/sailing/src/render/exposureReadback.ts +79 -0
- package/templates/sailing/src/render/heightFog.ts +118 -0
- package/templates/sailing/src/render/lighting.ts +26 -1
- package/templates/sailing/src/render/materialAssignments.ts +160 -0
- package/templates/sailing/src/render/materialLighting.ts +155 -0
- package/templates/sailing/src/render/ocean.ts +71 -53
- package/templates/sailing/src/render/postprocessing.ts +16 -2
- package/templates/sailing/src/render/props.ts +0 -45
- package/templates/sailing/src/render/quality.ts +61 -1
- package/templates/sailing/src/render/sky.ts +21 -1
- package/templates/sailing/src/render/worldEnvironment.ts +433 -30
- package/templates/sailing/src/scenes/Boot.ts +12 -1
- package/templates/sailing/src/scenes/Sailing.ts +87 -2
- package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
- package/templates/sailing/threenative.config.ts +3 -0
- package/templates/sailing/vite.config.ts +10 -2
- package/templates/shooter/AGENTS.md +8 -6
- package/templates/shooter/CLAUDE.md +8 -6
- package/templates/shooter/package.json +11 -9
- package/templates/shooter/playtests/performance.playtest.json +7 -1
- package/templates/shooter/src/entities/Enemy.ts +0 -15
- package/templates/shooter/src/entities/Rifle.ts +38 -1
- package/templates/shooter/src/render/autoExposure.ts +225 -0
- package/templates/shooter/src/render/backlightControls.ts +66 -0
- package/templates/shooter/src/render/backlightMaterial.ts +147 -0
- package/templates/shooter/src/render/camera.ts +1 -12
- package/templates/shooter/src/render/decals.ts +299 -5
- package/templates/shooter/src/render/environmentContribution.ts +188 -0
- package/templates/shooter/src/render/environmentRadiance.ts +36 -0
- package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
- package/templates/shooter/src/render/environmentSampling.ts +193 -0
- package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
- package/templates/shooter/src/render/exposure.ts +111 -0
- package/templates/shooter/src/render/exposureGraph.ts +178 -0
- package/templates/shooter/src/render/exposureReadback.ts +79 -0
- package/templates/shooter/src/render/gunfx.ts +0 -1
- package/templates/shooter/src/render/heightFog.ts +118 -0
- package/templates/shooter/src/render/lighting.ts +26 -1
- package/templates/shooter/src/render/materialAssignments.ts +160 -0
- package/templates/shooter/src/render/materialLighting.ts +155 -0
- package/templates/shooter/src/render/postprocessing.ts +17 -2
- package/templates/shooter/src/render/quality.ts +61 -2
- package/templates/shooter/src/render/scale.ts +2 -93
- package/templates/shooter/src/render/sky.ts +21 -1
- package/templates/shooter/src/render/vehicles.ts +0 -17
- package/templates/shooter/src/render/worldEnvironment.ts +433 -30
- package/templates/shooter/src/scenes/Play.ts +64 -2
- package/templates/shooter/vite.config.ts +10 -2
- package/templates/snow/.codex/config.toml +19 -0
- package/templates/snow/.cursor/mcp.json +32 -0
- package/templates/snow/.gemini/settings.json +32 -0
- package/templates/snow/.mcp.json +32 -0
- package/templates/snow/.vscode/mcp.json +36 -0
- package/templates/snow/.zed/settings.json +36 -0
- package/templates/snow/AGENTS.md +90 -0
- package/templates/snow/CLAUDE.md +92 -0
- package/templates/snow/README.md +26 -0
- package/templates/snow/assets/crunch.wav +0 -0
- package/templates/snow/assets/wind.wav +0 -0
- package/templates/snow/index.html +12 -0
- package/templates/snow/kit.json +7 -0
- package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
- package/templates/snow/native-playtests/survives.playtest.json +47 -0
- package/templates/snow/opencode.json +41 -0
- package/templates/snow/package.json +60 -0
- package/templates/snow/playtests/footsteps.playtest.json +95 -0
- package/templates/snow/playtests/performance.playtest.json +36 -0
- package/templates/snow/playtests/snow-physics.playtest.json +154 -0
- package/templates/snow/playtests/survives.playtest.json +56 -0
- package/templates/snow/playtests/touch-controls.playtest.json +71 -0
- package/templates/snow/playtests/weather.playtest.json +119 -0
- package/templates/snow/public/favicon.svg +5 -0
- package/templates/snow/src/audio.ts +58 -0
- package/templates/snow/src/commands.ts +8 -0
- package/templates/snow/src/entities/Explorer.ts +279 -0
- package/templates/snow/src/game.ts +69 -0
- package/templates/snow/src/main.ts +15 -0
- package/templates/snow/src/render/autoExposure.ts +225 -0
- package/templates/snow/src/render/backlightControls.ts +66 -0
- package/templates/snow/src/render/backlightMaterial.ts +147 -0
- package/templates/snow/src/render/bootPrint.ts +50 -0
- package/templates/snow/src/render/camera.ts +84 -0
- package/templates/snow/src/render/environmentContribution.ts +188 -0
- package/templates/snow/src/render/environmentRadiance.ts +36 -0
- package/templates/snow/src/render/environmentSampleCache.ts +43 -0
- package/templates/snow/src/render/environmentSampling.ts +193 -0
- package/templates/snow/src/render/environmentSnapshot.ts +53 -0
- package/templates/snow/src/render/explorer.ts +321 -0
- package/templates/snow/src/render/exposure.ts +111 -0
- package/templates/snow/src/render/exposureGraph.ts +178 -0
- package/templates/snow/src/render/exposureReadback.ts +79 -0
- package/templates/snow/src/render/heightFog.ts +118 -0
- package/templates/snow/src/render/lighting.ts +82 -0
- package/templates/snow/src/render/loading.ts +325 -0
- package/templates/snow/src/render/materialAssignments.ts +160 -0
- package/templates/snow/src/render/materialLighting.ts +155 -0
- package/templates/snow/src/render/materials.ts +36 -0
- package/templates/snow/src/render/palette.ts +17 -0
- package/templates/snow/src/render/postprocessing.ts +58 -0
- package/templates/snow/src/render/props.ts +42 -0
- package/templates/snow/src/render/quality.ts +193 -0
- package/templates/snow/src/render/scenery.ts +244 -0
- package/templates/snow/src/render/sky.ts +76 -0
- package/templates/snow/src/render/snowSurface.ts +259 -0
- package/templates/snow/src/render/touch-controls.ts +143 -0
- package/templates/snow/src/render/weather.ts +279 -0
- package/templates/snow/src/render/worldEnvironment.ts +1212 -0
- package/templates/snow/src/scenes/Boot.ts +12 -0
- package/templates/snow/src/scenes/Snow.ts +663 -0
- package/templates/snow/src/state.ts +46 -0
- package/templates/snow/src/style.css +143 -0
- package/templates/snow/src/terrain.ts +64 -0
- package/templates/snow/src/ui/App.tsx +15 -0
- package/templates/snow/src/ui/Controls.tsx +322 -0
- package/templates/snow/src/ui/GameUi.tsx +354 -0
- package/templates/snow/src/ui/icons.tsx +54 -0
- package/templates/snow/src/ui/main.tsx +7 -0
- package/templates/snow/tailwind.config.ts +2 -0
- package/templates/snow/threenative.config.ts +54 -0
- package/templates/snow/tsconfig.json +17 -0
- package/templates/snow/vite.config.ts +45 -0
- package/templates/starter/AGENTS.md +11 -16
- package/templates/starter/CLAUDE.md +11 -16
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
- package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
- package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
- package/templates/starter/package.json +11 -9
- package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
- package/templates/starter/playtests/movement.playtest.json +192 -0
- package/templates/starter/playtests/play.playtest.json +18 -2
- package/templates/starter/playtests/production-readiness.playtest.json +1 -1
- package/templates/starter/public/grade.cube +735 -0
- package/templates/starter/src/entities/Crate.ts +4 -0
- package/templates/starter/src/entities/Player.ts +79 -18
- package/templates/starter/src/game.ts +1 -0
- package/templates/starter/src/render/adaptiveQuality.ts +28 -41
- package/templates/starter/src/render/autoExposure.ts +225 -0
- package/templates/starter/src/render/backlightControls.ts +66 -0
- package/templates/starter/src/render/backlightMaterial.ts +147 -0
- package/templates/starter/src/render/environmentContribution.ts +188 -0
- package/templates/starter/src/render/environmentRadiance.ts +36 -0
- package/templates/starter/src/render/environmentSampleCache.ts +43 -0
- package/templates/starter/src/render/environmentSampling.ts +193 -0
- package/templates/starter/src/render/environmentSnapshot.ts +53 -0
- package/templates/starter/src/render/exposure.ts +111 -0
- package/templates/starter/src/render/exposureGraph.ts +178 -0
- package/templates/starter/src/render/exposureReadback.ts +79 -0
- package/templates/starter/src/render/grade.ts +157 -0
- package/templates/starter/src/render/heightFog.ts +118 -0
- package/templates/starter/src/render/lighting.ts +26 -1
- package/templates/starter/src/render/materialAssignments.ts +160 -0
- package/templates/starter/src/render/materialLighting.ts +155 -0
- package/templates/starter/src/render/postprocessing.ts +84 -4
- package/templates/starter/src/render/quality.ts +80 -8
- package/templates/starter/src/render/qualityPolicy.ts +54 -0
- package/templates/starter/src/render/rendererGate.ts +36 -0
- package/templates/starter/src/render/sky.ts +23 -1
- package/templates/starter/src/render/temporalAA.ts +197 -0
- package/templates/starter/src/render/temporalAAFrame.ts +179 -0
- package/templates/starter/src/render/temporalAAHooks.ts +101 -0
- package/templates/starter/src/render/temporalAAInput.ts +56 -0
- package/templates/starter/src/render/temporalAAResolve.ts +65 -0
- package/templates/starter/src/render/temporalAAStage.ts +76 -0
- package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
- package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
- package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
- package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
- package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
- package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
- package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
- package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
- package/templates/starter/src/render/temporalResolve.ts +139 -0
- package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
- package/templates/starter/src/render/temporalResolveMath.ts +196 -0
- package/templates/starter/src/render/volumetricFog.ts +124 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
- package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
- package/templates/starter/src/render/worldEnvironment.ts +433 -30
- package/templates/starter/src/scenes/Play.ts +110 -1
- package/templates/starter/src/state.ts +1 -0
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/ui/Menu.tsx +1 -1
- package/templates/starter/tools/make-grade-lut.mjs +101 -0
- package/templates/starter/vite.config.ts +10 -2
- package/templates/tower-defense/AGENTS.md +10 -9
- package/templates/tower-defense/CLAUDE.md +10 -9
- package/templates/tower-defense/package.json +11 -9
- package/templates/tower-defense/playtests/performance.playtest.json +7 -1
- package/templates/tower-defense/src/render/autoExposure.ts +225 -0
- package/templates/tower-defense/src/render/backlightControls.ts +66 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
- package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
- package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
- package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
- package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
- package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
- package/templates/tower-defense/src/render/exposure.ts +111 -0
- package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
- package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
- package/templates/tower-defense/src/render/lighting.ts +33 -1
- package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
- package/templates/tower-defense/src/render/materialLighting.ts +155 -0
- package/templates/tower-defense/src/render/postprocessing.ts +8 -2
- package/templates/tower-defense/src/render/quality.ts +61 -2
- package/templates/tower-defense/src/render/shapes.ts +0 -3
- package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
- package/templates/tower-defense/src/scenes/Battle.ts +65 -2
- package/templates/tower-defense/vite.config.ts +10 -2
- package/templates/minimal/src/scenes/Boot.ts +0 -5
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
// Generated for you. Scene-owned material assignments; no engine appearance hooks.
|
|
2
|
+
import {
|
|
3
|
+
type Camera,
|
|
4
|
+
type DirectionalLight,
|
|
5
|
+
Material,
|
|
6
|
+
Mesh,
|
|
7
|
+
MeshStandardMaterial,
|
|
8
|
+
type Object3D,
|
|
9
|
+
type Scene,
|
|
10
|
+
type Texture,
|
|
11
|
+
} from "three";
|
|
12
|
+
import { type IBacklightControls, backlightMaterial } from "./backlightMaterial.js";
|
|
13
|
+
import {
|
|
14
|
+
type IEnvironmentMeasurement,
|
|
15
|
+
measureEnvironment,
|
|
16
|
+
reportEnvironmentContribution,
|
|
17
|
+
} from "./environmentContribution.js";
|
|
18
|
+
import {
|
|
19
|
+
type IEnvironmentSourceSnapshot,
|
|
20
|
+
captureEnvironmentSnapshot,
|
|
21
|
+
environmentSnapshotCurrent,
|
|
22
|
+
} from "./environmentSnapshot.js";
|
|
23
|
+
import { type ILightingConvention, createLightingConvention } from "./lighting.js";
|
|
24
|
+
import { createMaterialAssignments } from "./materialAssignments.js";
|
|
25
|
+
import { type IMaterialLightingEnvironment, materialLightingEnabled } from "./quality.js";
|
|
26
|
+
interface IMaterialLightingOptions extends IMaterialLightingEnvironment {
|
|
27
|
+
readonly enabled: boolean;
|
|
28
|
+
readonly overrides?: Partial<ILightingConvention>;
|
|
29
|
+
}
|
|
30
|
+
/** Call once AFTER the scene's loaded character, arena and props are attached. */
|
|
31
|
+
export function createMaterialLighting(
|
|
32
|
+
scene: Scene,
|
|
33
|
+
camera: Camera,
|
|
34
|
+
key: DirectionalLight,
|
|
35
|
+
options: IMaterialLightingOptions,
|
|
36
|
+
) {
|
|
37
|
+
const settings = createLightingConvention(options.overrides);
|
|
38
|
+
let enabled = false;
|
|
39
|
+
let disposed = false;
|
|
40
|
+
let fillApproved = false;
|
|
41
|
+
let measured = measureEnvironment(scene, settings.maxSourceTexels);
|
|
42
|
+
let measurementSnapshot = captureEnvironmentSnapshot(scene);
|
|
43
|
+
const controls: IBacklightControls = {
|
|
44
|
+
key,
|
|
45
|
+
scene,
|
|
46
|
+
camera,
|
|
47
|
+
get rimGain() {
|
|
48
|
+
return settings.rimGain;
|
|
49
|
+
},
|
|
50
|
+
set rimGain(value) {
|
|
51
|
+
settings.rimGain = value;
|
|
52
|
+
},
|
|
53
|
+
get fillGain() {
|
|
54
|
+
return settings.fillGain;
|
|
55
|
+
},
|
|
56
|
+
set fillGain(value) {
|
|
57
|
+
settings.fillGain = value;
|
|
58
|
+
},
|
|
59
|
+
fillColor: settings.fillColor,
|
|
60
|
+
fillDirection: settings.fillDirection,
|
|
61
|
+
get fillAngularSize() {
|
|
62
|
+
return settings.fillAngularSize;
|
|
63
|
+
},
|
|
64
|
+
set fillAngularSize(value) {
|
|
65
|
+
settings.fillAngularSize = value;
|
|
66
|
+
},
|
|
67
|
+
get fillAdmitted() {
|
|
68
|
+
return enabled && fillApproved && environmentSnapshotCurrent(scene, measurementSnapshot);
|
|
69
|
+
},
|
|
70
|
+
};
|
|
71
|
+
const assignments = createMaterialAssignments(scene, controls);
|
|
72
|
+
function report() {
|
|
73
|
+
if (!environmentSnapshotCurrent(scene, measurementSnapshot)) {
|
|
74
|
+
measured = measureEnvironment(scene, settings.maxSourceTexels);
|
|
75
|
+
measurementSnapshot = captureEnvironmentSnapshot(scene);
|
|
76
|
+
}
|
|
77
|
+
fillApproved =
|
|
78
|
+
measured.status === "measured" &&
|
|
79
|
+
measured.meanRadiance !== null &&
|
|
80
|
+
measured.meanRadiance <= settings.darkThreshold;
|
|
81
|
+
return reportEnvironmentContribution(
|
|
82
|
+
scene,
|
|
83
|
+
{
|
|
84
|
+
...settings,
|
|
85
|
+
rimGain: controls.rimGain,
|
|
86
|
+
fillGain: controls.fillGain,
|
|
87
|
+
fillColor: controls.fillColor,
|
|
88
|
+
fillAdmitted: controls.fillAdmitted,
|
|
89
|
+
},
|
|
90
|
+
measured,
|
|
91
|
+
);
|
|
92
|
+
}
|
|
93
|
+
let observation: ReturnType<typeof report>;
|
|
94
|
+
function setEnabled(requested: boolean): void {
|
|
95
|
+
if (disposed) return;
|
|
96
|
+
enabled = requested && materialLightingEnabled("high", options);
|
|
97
|
+
assignments.setEnabled(enabled);
|
|
98
|
+
observation = report();
|
|
99
|
+
}
|
|
100
|
+
setEnabled(options.enabled);
|
|
101
|
+
return {
|
|
102
|
+
controls,
|
|
103
|
+
setEnabled,
|
|
104
|
+
/** Enroll a newly attached game-owned subtree. */
|
|
105
|
+
enroll(root: Object3D): void {
|
|
106
|
+
if (!disposed) assignments.enroll(root);
|
|
107
|
+
},
|
|
108
|
+
/** Restore assignments before removing a subtree or disposing borrowed materials. */
|
|
109
|
+
release(root: Object3D): void {
|
|
110
|
+
if (!disposed) assignments.release(root);
|
|
111
|
+
},
|
|
112
|
+
report() {
|
|
113
|
+
observation = report();
|
|
114
|
+
return observation;
|
|
115
|
+
},
|
|
116
|
+
/** Root's later GPU sampler can provide a measured snapshot of the current environment. */
|
|
117
|
+
setEnvironmentMeasurement(
|
|
118
|
+
measurement: IEnvironmentMeasurement,
|
|
119
|
+
source: Texture | null = scene.environment,
|
|
120
|
+
intensity = scene.environmentIntensity,
|
|
121
|
+
snapshot: IEnvironmentSourceSnapshot = captureEnvironmentSnapshot(scene),
|
|
122
|
+
): void {
|
|
123
|
+
if (disposed) return;
|
|
124
|
+
if (
|
|
125
|
+
measurement.status === "measured" &&
|
|
126
|
+
(measurement.meanRadiance === null ||
|
|
127
|
+
!Number.isFinite(measurement.meanRadiance) ||
|
|
128
|
+
measurement.meanRadiance < 0 ||
|
|
129
|
+
measurement.meanRGB === null ||
|
|
130
|
+
!measurement.meanRGB.every((value) => Number.isFinite(value) && value >= 0))
|
|
131
|
+
)
|
|
132
|
+
throw new Error("Measured environment radiance must be finite and nonnegative.");
|
|
133
|
+
if (
|
|
134
|
+
source !== snapshot.source ||
|
|
135
|
+
intensity !== snapshot.intensity ||
|
|
136
|
+
!environmentSnapshotCurrent(scene, snapshot)
|
|
137
|
+
)
|
|
138
|
+
return;
|
|
139
|
+
measured = measurement;
|
|
140
|
+
measurementSnapshot = snapshot;
|
|
141
|
+
observation = report();
|
|
142
|
+
},
|
|
143
|
+
debug: () => ({
|
|
144
|
+
...observation,
|
|
145
|
+
enabled,
|
|
146
|
+
...assignments.debug(),
|
|
147
|
+
}),
|
|
148
|
+
dispose(): void {
|
|
149
|
+
if (disposed) return;
|
|
150
|
+
enabled = false;
|
|
151
|
+
disposed = true;
|
|
152
|
+
assignments.dispose();
|
|
153
|
+
},
|
|
154
|
+
};
|
|
155
|
+
}
|
|
@@ -53,14 +53,19 @@ export function toon(
|
|
|
53
53
|
);
|
|
54
54
|
}
|
|
55
55
|
|
|
56
|
-
/** Unlit, for things that
|
|
56
|
+
/** Unlit, for things that stay bright whatever the sun does; opacity below 1 enables transparency. */
|
|
57
57
|
export function flat(
|
|
58
58
|
color: ColorRepresentation,
|
|
59
59
|
options: { depthWrite?: boolean; fog?: boolean; opacity?: number; side?: typeof DoubleSide } = {},
|
|
60
60
|
): MeshBasicMaterial {
|
|
61
61
|
return cached(
|
|
62
62
|
`flat|${String(color)}|${JSON.stringify(options)}`,
|
|
63
|
-
() =>
|
|
63
|
+
() =>
|
|
64
|
+
new MeshBasicMaterial({
|
|
65
|
+
color,
|
|
66
|
+
...options,
|
|
67
|
+
transparent: options.opacity !== undefined && options.opacity < 1,
|
|
68
|
+
}),
|
|
64
69
|
);
|
|
65
70
|
}
|
|
66
71
|
|
|
@@ -13,11 +13,11 @@
|
|
|
13
13
|
export const palette = {
|
|
14
14
|
grass: 0x5cbb37,
|
|
15
15
|
/** Distance fades into this; also the loading screen's background. */
|
|
16
|
-
horizon:
|
|
16
|
+
horizon: 0xa9dcf7,
|
|
17
17
|
rock: 0xa8927a,
|
|
18
18
|
/** The loading screen's progress track. */
|
|
19
|
-
skyHigh:
|
|
20
|
-
skyLow:
|
|
19
|
+
skyHigh: 0x0a63c8,
|
|
20
|
+
skyLow: 0x2b93e8,
|
|
21
21
|
/** The one saturated role: coins, gems, stars, the goal. */
|
|
22
22
|
accent: 0xffd23f,
|
|
23
23
|
} as const;
|
|
@@ -28,10 +28,14 @@ export function setupPost(
|
|
|
28
28
|
mobile?: boolean;
|
|
29
29
|
/** The renderer named a software adapter; this game's answer is its `low` tier. */
|
|
30
30
|
software?: boolean;
|
|
31
|
+
/** The renderer's GPU family (`ctx.renderer.gpuClass?.class`); `quality.ts` maps it to a start tier. */
|
|
32
|
+
gpuClass?: string;
|
|
31
33
|
/** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
|
|
32
34
|
tier?: QualityTier;
|
|
35
|
+
/** Scene-owned material assignments follow the resolved tier. */
|
|
36
|
+
onTierChanged?: (tier: QualityTier) => void;
|
|
33
37
|
} = {},
|
|
34
|
-
): void {
|
|
38
|
+
): { readonly tier: QualityTier; dispose(): void } {
|
|
35
39
|
// The native production collector explicitly marks a software-only hosted smoke run. This is
|
|
36
40
|
// a profile input, not a host fact: the normal desktop game remains high, while this run uses
|
|
37
41
|
// the existing low look so screenshot and lifecycle evidence can settle on a CPU adapter.
|
|
@@ -41,6 +45,7 @@ export function setupPost(
|
|
|
41
45
|
environment.tier ?? (hostedSoftware ? "low" : undefined);
|
|
42
46
|
const tier = resolveQualityTier({
|
|
43
47
|
mobile: environment.mobile,
|
|
48
|
+
gpuClass: environment.gpuClass,
|
|
44
49
|
software: environment.software,
|
|
45
50
|
tier: requestedTier,
|
|
46
51
|
});
|
|
@@ -52,5 +57,15 @@ export function setupPost(
|
|
|
52
57
|
} source=${source}`,
|
|
53
58
|
);
|
|
54
59
|
const world = new WorldEnvironment(qualityPreset(tier));
|
|
55
|
-
world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
|
|
60
|
+
const applied = world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
|
|
61
|
+
environment.onTierChanged?.(tier);
|
|
62
|
+
let disposed = false;
|
|
63
|
+
return {
|
|
64
|
+
tier,
|
|
65
|
+
dispose(): void {
|
|
66
|
+
if (disposed) return;
|
|
67
|
+
disposed = true;
|
|
68
|
+
applied.dispose?.();
|
|
69
|
+
},
|
|
70
|
+
};
|
|
56
71
|
}
|
|
@@ -34,6 +34,23 @@ function isQualityTier(value: string): value is QualityTier {
|
|
|
34
34
|
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
35
35
|
}
|
|
36
36
|
|
|
37
|
+
/**
|
|
38
|
+
* Where each GPU family starts, from `ctx.renderer.gpuClass`.
|
|
39
|
+
*
|
|
40
|
+
* A start, not a ceiling: the measured frame-budget windows move the look from here, and an
|
|
41
|
+
* explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
|
|
42
|
+
* family rule matched — falls back to the `mobile` flag, exactly as before families existed.
|
|
43
|
+
* Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
|
|
44
|
+
*/
|
|
45
|
+
const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
|
|
46
|
+
software: "low",
|
|
47
|
+
"mobile-low": "low",
|
|
48
|
+
"mobile-mid": "low",
|
|
49
|
+
"mobile-high": "medium",
|
|
50
|
+
integrated: "medium",
|
|
51
|
+
discrete: "high",
|
|
52
|
+
};
|
|
53
|
+
|
|
37
54
|
/**
|
|
38
55
|
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
39
56
|
*
|
|
@@ -42,7 +59,12 @@ function isQualityTier(value: string): value is QualityTier {
|
|
|
42
59
|
* turned out to have no effect.
|
|
43
60
|
*/
|
|
44
61
|
export function resolveQualityTier(
|
|
45
|
-
request: {
|
|
62
|
+
request: {
|
|
63
|
+
readonly gpuClass?: string;
|
|
64
|
+
readonly mobile?: boolean;
|
|
65
|
+
readonly software?: boolean;
|
|
66
|
+
readonly tier?: string;
|
|
67
|
+
} = {},
|
|
46
68
|
): QualityTier {
|
|
47
69
|
const requested = request.tier;
|
|
48
70
|
if (requested !== undefined) {
|
|
@@ -59,6 +81,9 @@ export function resolveQualityTier(
|
|
|
59
81
|
// fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
|
|
60
82
|
// `tier` above still wins over it.
|
|
61
83
|
if (request.software === true) return "low";
|
|
84
|
+
const family =
|
|
85
|
+
request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
|
|
86
|
+
if (family !== undefined) return family;
|
|
62
87
|
return request.mobile === true ? "low" : "high";
|
|
63
88
|
}
|
|
64
89
|
|
|
@@ -76,6 +101,7 @@ const shared: IWorldEnvironmentOptions = {
|
|
|
76
101
|
bloomThreshold: 1,
|
|
77
102
|
// The sky photograph arrives at 2.5x, so the curve and the exposure below are what bring it
|
|
78
103
|
// back to a daylight frame instead of a white one.
|
|
104
|
+
autoExposureEnabled: false,
|
|
79
105
|
exposure: 0.6,
|
|
80
106
|
tonemapMode: "aces",
|
|
81
107
|
vignetteAmount: 0.2,
|
|
@@ -95,7 +121,7 @@ const high: IWorldEnvironmentOptions = {
|
|
|
95
121
|
};
|
|
96
122
|
|
|
97
123
|
/** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
|
|
98
|
-
const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8 };
|
|
124
|
+
const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8, renderChainTier: "medium" };
|
|
99
125
|
|
|
100
126
|
/**
|
|
101
127
|
* What a phone gets: the curve, the narrow bloom and the vignette, nothing screen-space. On a
|
|
@@ -116,3 +142,36 @@ export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
|
116
142
|
}
|
|
117
143
|
return preset;
|
|
118
144
|
}
|
|
145
|
+
|
|
146
|
+
/** First admitted material lane: high desktop hardware WebGPU in the browser only. */
|
|
147
|
+
export interface IMaterialLightingEnvironment {
|
|
148
|
+
readonly web: boolean;
|
|
149
|
+
readonly rendererKind: string;
|
|
150
|
+
readonly mobile?: boolean;
|
|
151
|
+
readonly software?: boolean;
|
|
152
|
+
readonly webglFallback?: boolean;
|
|
153
|
+
}
|
|
154
|
+
export function materialLightingEnabled(
|
|
155
|
+
tier: QualityTier,
|
|
156
|
+
environment: IMaterialLightingEnvironment,
|
|
157
|
+
): boolean {
|
|
158
|
+
return (
|
|
159
|
+
tier === "high" &&
|
|
160
|
+
environment.web &&
|
|
161
|
+
environment.rendererKind === "webgpu" &&
|
|
162
|
+
environment.mobile !== true &&
|
|
163
|
+
environment.software !== true &&
|
|
164
|
+
environment.webglFallback !== true
|
|
165
|
+
);
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/** A WebGPURenderer wrapper may run an ordinary WebGL fallback backend. */
|
|
169
|
+
export function isWebGLFallbackRenderer(renderer: unknown): boolean {
|
|
170
|
+
if (renderer === null || typeof renderer !== "object") return false;
|
|
171
|
+
const backend = Reflect.get(renderer, "backend");
|
|
172
|
+
return (
|
|
173
|
+
backend !== null &&
|
|
174
|
+
typeof backend === "object" &&
|
|
175
|
+
Reflect.get(backend, "isWebGLBackend") === true
|
|
176
|
+
);
|
|
177
|
+
}
|
|
@@ -1,49 +1,99 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
//
|
|
3
|
-
//
|
|
4
|
-
//
|
|
5
|
-
// The same image is the background, the environment light every surface reflects and is filled by,
|
|
6
|
-
// and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
|
|
7
|
-
// equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
|
|
3
|
+
// A vertical blue gradient supplies the background; a measured environment supplies the light.
|
|
4
|
+
// The background's lower hemisphere matches skyFloor around the floating route.
|
|
8
5
|
import {
|
|
9
6
|
BackSide,
|
|
10
7
|
Color,
|
|
8
|
+
DataTexture,
|
|
11
9
|
EquirectangularReflectionMapping,
|
|
12
10
|
Float32BufferAttribute,
|
|
13
11
|
FogExp2,
|
|
12
|
+
LinearFilter,
|
|
14
13
|
Mesh,
|
|
15
14
|
MeshBasicMaterial,
|
|
15
|
+
RGBAFormat,
|
|
16
16
|
SRGBColorSpace,
|
|
17
17
|
type Scene,
|
|
18
18
|
SphereGeometry,
|
|
19
19
|
type Texture,
|
|
20
|
+
UnsignedByteType,
|
|
20
21
|
Vector3,
|
|
21
22
|
} from "three";
|
|
23
|
+
import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
|
|
22
24
|
import { palette } from "./palette.js";
|
|
23
25
|
|
|
26
|
+
/** Unit vector toward the authored sun, 47.9° above the horizon. */
|
|
27
|
+
export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
|
|
28
|
+
|
|
29
|
+
/** The look this fog replaced: FogExp2 at 0.003, measured at 150 m from 2 m up. */
|
|
30
|
+
const EYE_LEVEL = { density: 0.003, distance: 150, cameraHeight: 2 };
|
|
31
|
+
|
|
24
32
|
/**
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
*
|
|
33
|
+
* The distance term's density that, with the height term, keeps the old eye-level haze: at
|
|
34
|
+
* `EYE_LEVEL.distance` along the horizon from `EYE_LEVEL.cameraHeight` the two together transmit what
|
|
35
|
+
* FogExp2 at `EYE_LEVEL.density` did. The distance term is lowered, never removed, so the ground
|
|
36
|
+
* still ends in fog at a kilometre.
|
|
28
37
|
*/
|
|
29
|
-
|
|
38
|
+
function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
|
|
39
|
+
const { distance, density, cameraHeight } = EYE_LEVEL;
|
|
40
|
+
const old = (density * distance) ** 2;
|
|
41
|
+
const height = heightFogDepth(p, cameraHeight, cameraHeight, distance) * Math.LN2;
|
|
42
|
+
return Math.sqrt(Math.max(0, old - height)) / distance;
|
|
43
|
+
}
|
|
30
44
|
|
|
31
|
-
|
|
32
|
-
|
|
45
|
+
export function gradientColor(row: number, height: number): Color {
|
|
46
|
+
const high = new Color(palette.skyHigh);
|
|
47
|
+
const mid = new Color(palette.skyLow);
|
|
48
|
+
const horizon = new Color(palette.horizon);
|
|
49
|
+
const deep = high.clone().lerp(horizon, 0.45);
|
|
50
|
+
// DataTexture rows start at v=0 (nadir); equirectangular v=0.5 is the horizon.
|
|
51
|
+
const elevation = Math.sin((row / (height - 1) - 0.5) * Math.PI);
|
|
52
|
+
return elevation < 0
|
|
53
|
+
? horizon.clone().lerp(deep, Math.min(1, -elevation / 0.6))
|
|
54
|
+
: elevation < 0.5
|
|
55
|
+
? horizon.clone().lerp(mid, elevation * 2)
|
|
56
|
+
: mid.clone().lerp(high, (elevation - 0.5) * 2);
|
|
57
|
+
}
|
|
33
58
|
|
|
34
|
-
|
|
59
|
+
/** sRGB equirectangular radiance, from the lower haze through the horizon to the zenith. */
|
|
60
|
+
export function skyTexture(): DataTexture {
|
|
61
|
+
// three's PMREM sizes its cube from width / 4, needing at least 16: keep width >= 64.
|
|
62
|
+
const width = 256;
|
|
63
|
+
const height = 128;
|
|
64
|
+
const data = new Uint8Array(width * height * 4);
|
|
65
|
+
for (let row = 0; row < height; row += 1) {
|
|
66
|
+
const encoded = gradientColor(row, height).convertLinearToSRGB();
|
|
67
|
+
for (let column = 0; column < width; column += 1) {
|
|
68
|
+
data.set(
|
|
69
|
+
[...encoded.toArray().map((value) => Math.round(value * 255)), 255],
|
|
70
|
+
(row * width + column) * 4,
|
|
71
|
+
);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
const sky = new DataTexture(data, width, height, RGBAFormat, UnsignedByteType);
|
|
35
75
|
sky.mapping = EquirectangularReflectionMapping;
|
|
36
76
|
sky.colorSpace = SRGBColorSpace;
|
|
77
|
+
sky.magFilter = LinearFilter;
|
|
78
|
+
sky.minFilter = LinearFilter;
|
|
79
|
+
sky.needsUpdate = true;
|
|
80
|
+
return sky;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
export function setupSky(scene: Scene, sky: Texture, environment: Texture = sky): void {
|
|
84
|
+
sky.mapping = EquirectangularReflectionMapping;
|
|
37
85
|
scene.background = sky;
|
|
38
|
-
scene.backgroundIntensity =
|
|
86
|
+
scene.backgroundIntensity = 1;
|
|
39
87
|
// three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
|
|
40
|
-
//
|
|
41
|
-
|
|
42
|
-
scene.
|
|
43
|
-
scene.environmentIntensity = SKY_RANGE;
|
|
88
|
+
// The measured fill lights faces the sun misses and supplies reflections as roughness drops.
|
|
89
|
+
scene.environment = environment;
|
|
90
|
+
scene.environmentIntensity = 1;
|
|
44
91
|
// The route runs to x=97 with the backdrop cliffs another 60 m behind them, so this is thin on
|
|
45
92
|
// purpose: at this density it is under 2% inside the playfield and only reads past the castle.
|
|
46
|
-
scene.fog
|
|
93
|
+
// `scene.fog` stays the distance term; `scene.fogNode` is what three applies and adds the height term.
|
|
94
|
+
const distanceFog = new FogExp2(palette.horizon, distanceDensity());
|
|
95
|
+
scene.fog = distanceFog;
|
|
96
|
+
scene.fogNode = heightFogNode(distanceFog, HEIGHT_FOG, SUN_DIRECTION);
|
|
47
97
|
}
|
|
48
98
|
|
|
49
99
|
/**
|
|
@@ -56,11 +106,10 @@ const FLOOR_RADIUS = 480;
|
|
|
56
106
|
const RISE = 0.35;
|
|
57
107
|
|
|
58
108
|
/**
|
|
59
|
-
* What the world floats in.
|
|
60
|
-
* ground: everything under the horizon was a white void the fog could not hide. This is the lower
|
|
109
|
+
* What the world floats in. The route has no ground; this is the lower
|
|
61
110
|
* hemisphere, from the fog colour at the horizon to a deeper sky blue straight down, so distant
|
|
62
111
|
* rock fades into it exactly as it fades into the fog. It climbs 20 degrees past the horizon and
|
|
63
|
-
* fades out there, so the
|
|
112
|
+
* fades out there, so the gradient melts into the haze instead of meeting it at a hard line.
|
|
64
113
|
* It is not fogged and never writes depth.
|
|
65
114
|
*/
|
|
66
115
|
export function skyFloor(): Mesh {
|
|
@@ -102,8 +151,8 @@ export function skyFloor(): Mesh {
|
|
|
102
151
|
/**
|
|
103
152
|
* The cloud bank, as a list of lobes to instance.
|
|
104
153
|
*
|
|
105
|
-
* Eighteen clouds of five to nine squashed lobes is 130-odd separate spheres, and
|
|
106
|
-
* is
|
|
154
|
+
* Eighteen clouds of five to nine squashed lobes is 130-odd separate spheres, and the gradient sky
|
|
155
|
+
* is static — so the scene builds one `InstancedBatch` of a unit sphere from this and never
|
|
107
156
|
* touches it again. The motion in the sky is the airship in `scenery.ts`, which crosses the frame
|
|
108
157
|
* in twenty seconds, and the parallax of a fox covering ninety-seven metres.
|
|
109
158
|
*
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
import {
|
|
3
|
+
Color,
|
|
4
|
+
DataTexture,
|
|
5
|
+
DataUtils,
|
|
6
|
+
EquirectangularReflectionMapping,
|
|
7
|
+
HalfFloatType,
|
|
8
|
+
LinearFilter,
|
|
9
|
+
LinearSRGBColorSpace,
|
|
10
|
+
RGBAFormat,
|
|
11
|
+
} from "three";
|
|
12
|
+
import { gradientColor } from "./sky.js";
|
|
13
|
+
|
|
14
|
+
// Measured from the photographed sky this kit used to light with, preserving its tuned lighting
|
|
15
|
+
// when the background became a stylized gradient; edit these fills to relight.
|
|
16
|
+
const UPPER_FILL = new Color(0.355, 0.423, 0.627);
|
|
17
|
+
const LOWER_FILL = new Color(0.68, 0.67, 0.633);
|
|
18
|
+
export function skyEnvironment(): DataTexture {
|
|
19
|
+
const width = 256;
|
|
20
|
+
const height = 128;
|
|
21
|
+
const data = new Uint16Array(width * height * 4);
|
|
22
|
+
const upperMean = new Color(0, 0, 0);
|
|
23
|
+
let weights = 0;
|
|
24
|
+
for (let row = height / 2; row < height; row += 1) {
|
|
25
|
+
const elevation = (row / (height - 1) - 0.5) * Math.PI;
|
|
26
|
+
const weight = Math.abs(Math.cos(elevation));
|
|
27
|
+
upperMean.add(gradientColor(row, height).multiplyScalar(weight));
|
|
28
|
+
weights += weight;
|
|
29
|
+
}
|
|
30
|
+
upperMean.multiplyScalar(1 / weights);
|
|
31
|
+
const scale = new Color(
|
|
32
|
+
UPPER_FILL.r / upperMean.r,
|
|
33
|
+
UPPER_FILL.g / upperMean.g,
|
|
34
|
+
UPPER_FILL.b / upperMean.b,
|
|
35
|
+
);
|
|
36
|
+
for (let row = 0; row < height; row += 1) {
|
|
37
|
+
const color = row < height / 2 ? LOWER_FILL : gradientColor(row, height).multiply(scale);
|
|
38
|
+
const rgba = [color.r, color.g, color.b, 1].map(DataUtils.toHalfFloat);
|
|
39
|
+
for (let column = 0; column < width; column += 1) {
|
|
40
|
+
data.set(rgba, (row * width + column) * 4);
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
const environment = new DataTexture(data, width, height, RGBAFormat, HalfFloatType);
|
|
44
|
+
environment.colorSpace = LinearSRGBColorSpace;
|
|
45
|
+
environment.mapping = EquirectangularReflectionMapping;
|
|
46
|
+
environment.minFilter = LinearFilter;
|
|
47
|
+
environment.magFilter = LinearFilter;
|
|
48
|
+
environment.needsUpdate = true;
|
|
49
|
+
return environment;
|
|
50
|
+
}
|