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
|
@@ -70,6 +70,15 @@
|
|
|
70
70
|
"atSteps": [{ "label": "armed", "equals": "attack" }, { "label": "ordered", "equals": "" }]
|
|
71
71
|
}
|
|
72
72
|
],
|
|
73
|
-
"renderChain": {
|
|
73
|
+
"renderChain": {
|
|
74
|
+
"tier": "high",
|
|
75
|
+
"perAdapter": {
|
|
76
|
+
"integrated": { "tier": "medium" },
|
|
77
|
+
"mobile-high": { "tier": "medium" },
|
|
78
|
+
"mobile-low": { "tier": "low" },
|
|
79
|
+
"mobile-mid": { "tier": "low" },
|
|
80
|
+
"software": { "tier": "low" }
|
|
81
|
+
}
|
|
82
|
+
}
|
|
74
83
|
}
|
|
75
84
|
}
|
|
@@ -63,6 +63,15 @@
|
|
|
63
63
|
},
|
|
64
64
|
{ "id": "state", "path": "primaryProgress", "changed": true }
|
|
65
65
|
],
|
|
66
|
-
"renderChain": {
|
|
66
|
+
"renderChain": {
|
|
67
|
+
"tier": "high",
|
|
68
|
+
"perAdapter": {
|
|
69
|
+
"integrated": { "tier": "medium" },
|
|
70
|
+
"mobile-high": { "tier": "medium" },
|
|
71
|
+
"mobile-low": { "tier": "low" },
|
|
72
|
+
"mobile-mid": { "tier": "low" },
|
|
73
|
+
"software": { "tier": "low" }
|
|
74
|
+
}
|
|
75
|
+
}
|
|
67
76
|
}
|
|
68
77
|
}
|
|
@@ -144,7 +144,13 @@
|
|
|
144
144
|
],
|
|
145
145
|
"renderChain": {
|
|
146
146
|
"tier": "high",
|
|
147
|
-
"perAdapter": {
|
|
147
|
+
"perAdapter": {
|
|
148
|
+
"integrated": { "tier": "medium" },
|
|
149
|
+
"mobile-high": { "tier": "medium" },
|
|
150
|
+
"mobile-low": { "tier": "low" },
|
|
151
|
+
"mobile-mid": { "tier": "low" },
|
|
152
|
+
"software": { "tier": "low" }
|
|
153
|
+
}
|
|
148
154
|
}
|
|
149
155
|
}
|
|
150
156
|
}
|
|
@@ -57,6 +57,15 @@
|
|
|
57
57
|
},
|
|
58
58
|
{ "id": "state", "path": "supplyUsed", "gte": 24 }
|
|
59
59
|
],
|
|
60
|
-
"renderChain": {
|
|
60
|
+
"renderChain": {
|
|
61
|
+
"tier": "high",
|
|
62
|
+
"perAdapter": {
|
|
63
|
+
"integrated": { "tier": "medium" },
|
|
64
|
+
"mobile-high": { "tier": "medium" },
|
|
65
|
+
"mobile-low": { "tier": "low" },
|
|
66
|
+
"mobile-mid": { "tier": "low" },
|
|
67
|
+
"software": { "tier": "low" }
|
|
68
|
+
}
|
|
69
|
+
}
|
|
61
70
|
}
|
|
62
71
|
}
|
|
@@ -68,7 +68,10 @@ const _work = new Color(0x77eddf);
|
|
|
68
68
|
const _queue = new Color(0x77cddd);
|
|
69
69
|
const _backing = new Color(palette.gridLine);
|
|
70
70
|
|
|
71
|
-
export function createArmy(
|
|
71
|
+
export function createArmy(
|
|
72
|
+
models: IUnitModels,
|
|
73
|
+
receivers: { added?: (mesh: Object3D) => void; removed?: (mesh: Object3D) => void } = {},
|
|
74
|
+
): IArmy {
|
|
72
75
|
const root = new Object3D();
|
|
73
76
|
const batches = new Map<string, IBatch>();
|
|
74
77
|
const markers: IMarker[] = [];
|
|
@@ -137,6 +140,7 @@ export function createArmy(models: IUnitModels): IArmy {
|
|
|
137
140
|
mesh.receiveShadow = true;
|
|
138
141
|
mesh.frustumCulled = false;
|
|
139
142
|
root.add(mesh);
|
|
143
|
+
receivers.added?.(mesh);
|
|
140
144
|
return mesh;
|
|
141
145
|
});
|
|
142
146
|
const made: IBatch = { list: [], parts };
|
|
@@ -290,7 +294,11 @@ export function createArmy(models: IUnitModels): IArmy {
|
|
|
290
294
|
dispose: () => {
|
|
291
295
|
// The model geometries belong to `models`, which frees them; the materials are shared by
|
|
292
296
|
// every model and by a later rebuild, so nothing here disposes one.
|
|
293
|
-
for (const entry of batches.values())
|
|
297
|
+
for (const entry of batches.values())
|
|
298
|
+
for (const part of entry.parts) {
|
|
299
|
+
receivers.removed?.(part);
|
|
300
|
+
root.remove(part);
|
|
301
|
+
}
|
|
294
302
|
batches.clear();
|
|
295
303
|
for (const ring of rings) {
|
|
296
304
|
ring.geometry.dispose();
|
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
// Generated for you: ordinary Three.js GPU metering; exposure.ts owns the game's look.
|
|
2
|
+
import { type RenderTarget, Texture, Vector2 } from "three";
|
|
3
|
+
import { float, ivec2, nodeObject, texture, textureLoad, uniform, vec4 } from "three/tsl";
|
|
4
|
+
import {
|
|
5
|
+
type Node,
|
|
6
|
+
type NodeBuilder,
|
|
7
|
+
type NodeFrame,
|
|
8
|
+
NodeMaterial,
|
|
9
|
+
NodeUpdateType,
|
|
10
|
+
QuadMesh,
|
|
11
|
+
type Renderer,
|
|
12
|
+
RendererUtils,
|
|
13
|
+
TempNode,
|
|
14
|
+
} from "three/webgpu";
|
|
15
|
+
import {
|
|
16
|
+
type IExposureSettings,
|
|
17
|
+
exposureLuminance,
|
|
18
|
+
exposureMeter,
|
|
19
|
+
exposureReductionSizes,
|
|
20
|
+
validateExposureSettings,
|
|
21
|
+
} from "./exposure.js";
|
|
22
|
+
|
|
23
|
+
import {
|
|
24
|
+
type ColourTexture,
|
|
25
|
+
type Decode,
|
|
26
|
+
type Meter,
|
|
27
|
+
adaptExposure,
|
|
28
|
+
exposureBins,
|
|
29
|
+
exposureTarget,
|
|
30
|
+
exposureTiles,
|
|
31
|
+
histogramExposure,
|
|
32
|
+
histogramTiles,
|
|
33
|
+
reduceExposure,
|
|
34
|
+
} from "./exposureGraph.js";
|
|
35
|
+
import { ExposureReadback } from "./exposureReadback.js";
|
|
36
|
+
|
|
37
|
+
/** Scene-referred exposure changes light, never coverage/compositing alpha. */
|
|
38
|
+
export function applyExposure(colour: Node<"vec4">, exposure: Node<"float">): Node<"vec4"> {
|
|
39
|
+
return vec4(colour.rgb.mul(exposure), colour.a);
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** Owns scratch targets only. Never draws the world or installs another output transform. */
|
|
43
|
+
export class AutoExposureNode extends TempNode<"float"> {
|
|
44
|
+
static get type(): string {
|
|
45
|
+
return "AutoExposureNode";
|
|
46
|
+
}
|
|
47
|
+
readonly input: ColourTexture;
|
|
48
|
+
readonly settings: Readonly<IExposureSettings>;
|
|
49
|
+
readonly #constant: number;
|
|
50
|
+
readonly #size = new Vector2();
|
|
51
|
+
readonly #sourceSize = uniform(new Vector2(1, 1));
|
|
52
|
+
readonly #reduceSize = uniform(new Vector2(1, 1));
|
|
53
|
+
readonly #blockSize = uniform(new Vector2(1, 1));
|
|
54
|
+
readonly #delta = uniform(0);
|
|
55
|
+
readonly #resetMode = uniform(1); // 0 = history, 1 = seed, 2 = next measured target
|
|
56
|
+
readonly #seed = uniform(0);
|
|
57
|
+
readonly #enabled = uniform(false);
|
|
58
|
+
readonly #quad = new QuadMesh();
|
|
59
|
+
readonly #meterMaterial = new NodeMaterial();
|
|
60
|
+
readonly #reduceMaterial = new NodeMaterial();
|
|
61
|
+
readonly #tilesMaterial = new NodeMaterial();
|
|
62
|
+
readonly #histogramMaterial = new NodeMaterial();
|
|
63
|
+
readonly #adaptMaterial = new NodeMaterial();
|
|
64
|
+
readonly #tilesTarget = exposureTarget();
|
|
65
|
+
readonly #histogramTarget = exposureTarget();
|
|
66
|
+
#readTarget = exposureTarget();
|
|
67
|
+
#writeTarget = exposureTarget();
|
|
68
|
+
#levels: RenderTarget[] = [];
|
|
69
|
+
readonly #reduced = texture(new Texture());
|
|
70
|
+
readonly #blocks = texture(new Texture());
|
|
71
|
+
readonly #previous = texture(this.#readTarget.texture);
|
|
72
|
+
readonly #result = texture(this.#writeTarget.texture);
|
|
73
|
+
#disposed = false;
|
|
74
|
+
readonly #observation: ExposureReadback;
|
|
75
|
+
// Three's runtime accepts undefined on first use, but its declaration requires a state.
|
|
76
|
+
#rendererState: Parameters<typeof RendererUtils.resetRendererState>[1] | undefined;
|
|
77
|
+
|
|
78
|
+
constructor(
|
|
79
|
+
input: ColourTexture,
|
|
80
|
+
settings: IExposureSettings,
|
|
81
|
+
constantExposure: number,
|
|
82
|
+
meter: Meter = (colour, uv) => exposureMeter(colour, uv),
|
|
83
|
+
decode: Decode = (mean) => exposureLuminance(mean),
|
|
84
|
+
) {
|
|
85
|
+
super("float");
|
|
86
|
+
validateExposureSettings(settings);
|
|
87
|
+
if (!Number.isFinite(Math.fround(constantExposure)) || Math.fround(constantExposure) <= 0)
|
|
88
|
+
throw new Error("Exposure constant must be finite and positive.");
|
|
89
|
+
this.input = input;
|
|
90
|
+
this.settings = Object.freeze({ ...settings });
|
|
91
|
+
const policy = this.settings;
|
|
92
|
+
this.#constant = constantExposure;
|
|
93
|
+
this.#seed.value = Math.log2(settings.initialExposure);
|
|
94
|
+
this.#enabled.value = settings.enabled;
|
|
95
|
+
this.#observation = new ExposureReadback(constantExposure, () => this.#enabled.value);
|
|
96
|
+
this.updateBeforeType = NodeUpdateType.FRAME;
|
|
97
|
+
this.#meterMaterial.fragmentNode = reduceExposure(input, this.#sourceSize, meter);
|
|
98
|
+
this.#reduceMaterial.fragmentNode = reduceExposure(this.#reduced, this.#reduceSize);
|
|
99
|
+
this.#tilesTarget.setSize(exposureBins, exposureTiles);
|
|
100
|
+
this.#histogramTarget.setSize(exposureBins, 1);
|
|
101
|
+
this.#tilesMaterial.fragmentNode = histogramTiles(this.#blocks, this.#blockSize, policy);
|
|
102
|
+
this.#histogramMaterial.fragmentNode = histogramExposure(texture(this.#tilesTarget.texture));
|
|
103
|
+
this.#adaptMaterial.fragmentNode = adaptExposure(
|
|
104
|
+
texture(this.#histogramTarget.texture),
|
|
105
|
+
this.#previous,
|
|
106
|
+
this.#resetMode,
|
|
107
|
+
this.#seed,
|
|
108
|
+
this.#delta,
|
|
109
|
+
policy,
|
|
110
|
+
decode,
|
|
111
|
+
);
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
override setup(builder: NodeBuilder): Node<"float"> {
|
|
115
|
+
// Force the existing pass dependency even in disabled mode; off never means unmeasured.
|
|
116
|
+
super.setup(builder);
|
|
117
|
+
return this.#enabled.select(
|
|
118
|
+
textureLoad(this.#result, ivec2(0)).r.exp2(),
|
|
119
|
+
float(this.#constant),
|
|
120
|
+
);
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
get exposureNode(): Node<"float"> {
|
|
124
|
+
return nodeObject(this);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
reset(exposure?: number): void {
|
|
128
|
+
if (this.#disposed) throw new Error("Exposure node is disposed.");
|
|
129
|
+
if (
|
|
130
|
+
exposure !== undefined &&
|
|
131
|
+
(!Number.isFinite(Math.fround(exposure)) || Math.fround(exposure) <= 0)
|
|
132
|
+
)
|
|
133
|
+
throw new Error("Exposure reset must be finite and positive.");
|
|
134
|
+
this.#resetMode.value = exposure === undefined ? 2 : 1;
|
|
135
|
+
if (exposure !== undefined) this.#seed.value = Math.log2(exposure);
|
|
136
|
+
this.#observation.invalidate();
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
setEnabled(enabled: boolean): void {
|
|
140
|
+
if (typeof enabled !== "boolean") throw new Error("Exposure enabled must be boolean.");
|
|
141
|
+
if (this.#disposed) throw new Error("Exposure node is disposed.");
|
|
142
|
+
this.#enabled.value = enabled;
|
|
143
|
+
this.#observation.invalidate();
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
getObservation(): Record<string, unknown> {
|
|
147
|
+
return this.#observation.get();
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
override updateBefore(frame: NodeFrame): undefined {
|
|
151
|
+
if (this.#disposed) throw new Error("Exposure node is disposed.");
|
|
152
|
+
const renderer = frame.renderer;
|
|
153
|
+
if (renderer === null) throw new Error("Exposure requires a renderer.");
|
|
154
|
+
if (!Number.isFinite(frame.deltaTime) || frame.deltaTime < 0 || !Number.isFinite(frame.time))
|
|
155
|
+
throw new Error("Exposure frame time must be finite and nonnegative.");
|
|
156
|
+
renderer.getDrawingBufferSize(this.#size);
|
|
157
|
+
// Level 0 meters 4x4 pixels, level 1 averages 16x16. The histogram gathers level 1.
|
|
158
|
+
const sizes = exposureReductionSizes(this.#size.x, this.#size.y).slice(0, 2);
|
|
159
|
+
this.#sourceSize.value.copy(this.#size);
|
|
160
|
+
this.#delta.value = Math.min(frame.deltaTime, this.settings.maxDelta);
|
|
161
|
+
while (this.#levels.length > sizes.length) this.#levels.pop()?.dispose();
|
|
162
|
+
for (const [i, [width, height]] of sizes.entries()) {
|
|
163
|
+
const level = this.#levels[i] ?? exposureTarget();
|
|
164
|
+
this.#levels[i] = level;
|
|
165
|
+
level.setSize(width, height);
|
|
166
|
+
}
|
|
167
|
+
this.#rendererState ??= RendererUtils.saveRendererState(renderer);
|
|
168
|
+
this.#rendererState = RendererUtils.resetRendererState(renderer, this.#rendererState);
|
|
169
|
+
try {
|
|
170
|
+
for (const [i, level] of this.#levels.entries()) {
|
|
171
|
+
const previous = this.#levels[i - 1];
|
|
172
|
+
if (previous !== undefined) {
|
|
173
|
+
this.#reduced.value = previous.texture;
|
|
174
|
+
this.#reduceSize.value.set(previous.width, previous.height);
|
|
175
|
+
}
|
|
176
|
+
this.#quad.material = i === 0 ? this.#meterMaterial : this.#reduceMaterial;
|
|
177
|
+
renderer.setRenderTarget(level);
|
|
178
|
+
this.#quad.render(renderer);
|
|
179
|
+
}
|
|
180
|
+
const final = this.#levels.at(-1);
|
|
181
|
+
if (final === undefined) throw new Error("Exposure reduction is empty.");
|
|
182
|
+
this.#blocks.value = final.texture;
|
|
183
|
+
this.#blockSize.value.set(final.width, final.height);
|
|
184
|
+
this.#quad.material = this.#tilesMaterial;
|
|
185
|
+
renderer.setRenderTarget(this.#tilesTarget);
|
|
186
|
+
this.#quad.render(renderer);
|
|
187
|
+
this.#quad.material = this.#histogramMaterial;
|
|
188
|
+
renderer.setRenderTarget(this.#histogramTarget);
|
|
189
|
+
this.#quad.render(renderer);
|
|
190
|
+
const write = this.#writeTarget;
|
|
191
|
+
this.#previous.value = this.#readTarget.texture;
|
|
192
|
+
this.#quad.material = this.#adaptMaterial;
|
|
193
|
+
renderer.setRenderTarget(write);
|
|
194
|
+
this.#quad.render(renderer);
|
|
195
|
+
this.#result.value = write.texture;
|
|
196
|
+
this.#writeTarget = this.#readTarget;
|
|
197
|
+
this.#readTarget = write;
|
|
198
|
+
this.#resetMode.value = 0;
|
|
199
|
+
this.#observation.report(renderer, write, frame.time, this.settings.reportInterval);
|
|
200
|
+
} finally {
|
|
201
|
+
RendererUtils.restoreRendererState(renderer, this.#rendererState);
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
override dispose(): void {
|
|
206
|
+
if (this.#disposed) return;
|
|
207
|
+
this.#disposed = true;
|
|
208
|
+
this.#observation.dispose();
|
|
209
|
+
for (const level of [
|
|
210
|
+
...this.#levels,
|
|
211
|
+
this.#tilesTarget,
|
|
212
|
+
this.#histogramTarget,
|
|
213
|
+
this.#readTarget,
|
|
214
|
+
this.#writeTarget,
|
|
215
|
+
])
|
|
216
|
+
level.dispose();
|
|
217
|
+
this.#levels = [];
|
|
218
|
+
this.#meterMaterial.dispose();
|
|
219
|
+
this.#reduceMaterial.dispose();
|
|
220
|
+
this.#tilesMaterial.dispose();
|
|
221
|
+
this.#histogramMaterial.dispose();
|
|
222
|
+
this.#adaptMaterial.dispose();
|
|
223
|
+
super.dispose();
|
|
224
|
+
}
|
|
225
|
+
}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { Camera, Color, Object3D, Vector3 } from "three";
|
|
2
|
+
import type { IBacklightControls } from "./backlightMaterial.js";
|
|
3
|
+
function finiteColor(color: Color) {
|
|
4
|
+
return (
|
|
5
|
+
Number.isFinite(color.r) &&
|
|
6
|
+
color.r >= 0 &&
|
|
7
|
+
Number.isFinite(color.g) &&
|
|
8
|
+
color.g >= 0 &&
|
|
9
|
+
Number.isFinite(color.b) &&
|
|
10
|
+
color.b >= 0
|
|
11
|
+
);
|
|
12
|
+
}
|
|
13
|
+
export function validateControls(controls: IBacklightControls) {
|
|
14
|
+
if (
|
|
15
|
+
!Number.isFinite(controls.rimGain) ||
|
|
16
|
+
controls.rimGain < 0 ||
|
|
17
|
+
!Number.isFinite(controls.key.intensity) ||
|
|
18
|
+
controls.key.intensity < 0 ||
|
|
19
|
+
!finiteColor(controls.key.color) ||
|
|
20
|
+
!Number.isFinite(controls.fillGain) ||
|
|
21
|
+
controls.fillGain < 0 ||
|
|
22
|
+
!Number.isFinite(controls.fillAngularSize) ||
|
|
23
|
+
controls.fillAngularSize <= 0 ||
|
|
24
|
+
controls.fillAngularSize > 1.5 ||
|
|
25
|
+
!Number.isFinite(controls.fillDirection.lengthSq()) ||
|
|
26
|
+
controls.fillDirection.lengthSq() === 0 ||
|
|
27
|
+
!finiteColor(controls.fillColor)
|
|
28
|
+
)
|
|
29
|
+
throw new Error(
|
|
30
|
+
"Backlight controls require finite nonnegative gains, a direction and angular size in (0, 1.5].",
|
|
31
|
+
);
|
|
32
|
+
}
|
|
33
|
+
export function resolveKey(
|
|
34
|
+
controls: IBacklightControls,
|
|
35
|
+
direction: Vector3,
|
|
36
|
+
target: Vector3,
|
|
37
|
+
camera: Camera = controls.camera,
|
|
38
|
+
) {
|
|
39
|
+
validateControls(controls);
|
|
40
|
+
// Read the renderer/game-updated matrices, as upstream Three light uniforms do.
|
|
41
|
+
// Targets outside the scene must be updated by their owner before rendering.
|
|
42
|
+
// Never mutate shared light/ancestor matrices inside a material render callback.
|
|
43
|
+
target.setFromMatrixPosition(controls.key.target.matrixWorld);
|
|
44
|
+
direction.setFromMatrixPosition(controls.key.matrixWorld).sub(target);
|
|
45
|
+
if (
|
|
46
|
+
!Number.isFinite(direction.x) ||
|
|
47
|
+
!Number.isFinite(direction.y) ||
|
|
48
|
+
!Number.isFinite(direction.z)
|
|
49
|
+
)
|
|
50
|
+
throw new Error("Key endpoints must be finite.");
|
|
51
|
+
const lengthSq = direction.lengthSq();
|
|
52
|
+
if (!Number.isFinite(lengthSq)) throw new Error("Key direction magnitude must be finite.");
|
|
53
|
+
if (lengthSq <= 1e-12) {
|
|
54
|
+
direction.set(0, 1, 0);
|
|
55
|
+
return 0;
|
|
56
|
+
}
|
|
57
|
+
direction.normalize();
|
|
58
|
+
if (!controls.key.layers.test(camera.layers)) return 0;
|
|
59
|
+
let current: Object3D | null = controls.key;
|
|
60
|
+
while (current !== null) {
|
|
61
|
+
if (!current.visible) return 0;
|
|
62
|
+
if (current === controls.scene) return controls.key.intensity;
|
|
63
|
+
current = current.parent;
|
|
64
|
+
}
|
|
65
|
+
return 0;
|
|
66
|
+
}
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
// Generated for you. Ordinary Three.js; controls belong to your game.
|
|
2
|
+
import {
|
|
3
|
+
type Camera,
|
|
4
|
+
type Color,
|
|
5
|
+
type DirectionalLight,
|
|
6
|
+
Material,
|
|
7
|
+
type MeshStandardMaterial,
|
|
8
|
+
type Object3D,
|
|
9
|
+
type Scene,
|
|
10
|
+
Vector3,
|
|
11
|
+
} from "three";
|
|
12
|
+
import {
|
|
13
|
+
cameraViewMatrix,
|
|
14
|
+
clamp,
|
|
15
|
+
dot,
|
|
16
|
+
float,
|
|
17
|
+
materialColor,
|
|
18
|
+
materialEmissive,
|
|
19
|
+
materialMetalness,
|
|
20
|
+
materialRoughness,
|
|
21
|
+
max,
|
|
22
|
+
mix,
|
|
23
|
+
normalView,
|
|
24
|
+
positionViewDirection,
|
|
25
|
+
pow,
|
|
26
|
+
reflect,
|
|
27
|
+
smoothstep,
|
|
28
|
+
uniform,
|
|
29
|
+
vec3,
|
|
30
|
+
} from "three/tsl";
|
|
31
|
+
import { MeshStandardNodeMaterial } from "three/webgpu";
|
|
32
|
+
import { resolveKey, validateControls } from "./backlightControls.js";
|
|
33
|
+
|
|
34
|
+
export interface IBacklightControls {
|
|
35
|
+
readonly key: DirectionalLight;
|
|
36
|
+
readonly scene: Scene;
|
|
37
|
+
readonly camera: Camera;
|
|
38
|
+
/** Mutable game-owned controls: zero disables the rim, independent of source reporting. */
|
|
39
|
+
rimGain: number;
|
|
40
|
+
fillGain: number;
|
|
41
|
+
readonly fillColor: Color;
|
|
42
|
+
readonly fillDirection: Vector3;
|
|
43
|
+
/** Angular radius of the authored fill disc, in radians. */
|
|
44
|
+
fillAngularSize: number;
|
|
45
|
+
/** Caller admits fill only after a measured-dark or missing environment is qualified. */
|
|
46
|
+
fillAdmitted: boolean;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
const graphs = new WeakMap<IBacklightControls, ReturnType<typeof createGraph>>();
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* Preserve the upstream standard PBR/normal/skinning paths and original material emissive.
|
|
53
|
+
* This is an additive artistic convention, not a physical subsurface model or IBL replacement.
|
|
54
|
+
* Cache at the caller to preserve shared source-material relationships; dispose only conversions
|
|
55
|
+
* it owns, never maps/source materials borrowed from a loaded model.
|
|
56
|
+
*/
|
|
57
|
+
export function backlightMaterial(source: MeshStandardMaterial, controls: IBacklightControls) {
|
|
58
|
+
if (
|
|
59
|
+
("isMeshPhysicalMaterial" in source && source.isMeshPhysicalMaterial === true) ||
|
|
60
|
+
source.onBeforeCompile !== Material.prototype.onBeforeCompile
|
|
61
|
+
)
|
|
62
|
+
throw new Error(
|
|
63
|
+
"Physical/custom standard materials require separate qualification; conversion refused.",
|
|
64
|
+
);
|
|
65
|
+
validateControls(controls);
|
|
66
|
+
const material = new MeshStandardNodeMaterial().copy(source);
|
|
67
|
+
// NodeMaterial.copy skips Material.copy, and `alphaTest` lives in `_alphaTest`, which it never copies.
|
|
68
|
+
material.alphaTest = source.alphaTest;
|
|
69
|
+
let graph = graphs.get(controls);
|
|
70
|
+
if (!graph) {
|
|
71
|
+
graph = createGraph(controls);
|
|
72
|
+
graphs.set(controls, graph);
|
|
73
|
+
}
|
|
74
|
+
material.emissiveNode = graph;
|
|
75
|
+
return material;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function createGraph(controls: IBacklightControls) {
|
|
79
|
+
const rimGain = uniform(controls.rimGain).onRenderUpdate(() => {
|
|
80
|
+
validateControls(controls);
|
|
81
|
+
return controls.rimGain;
|
|
82
|
+
});
|
|
83
|
+
const fillGain = uniform(0).onRenderUpdate(() => {
|
|
84
|
+
validateControls(controls);
|
|
85
|
+
return controls.fillAdmitted ? controls.fillGain : 0;
|
|
86
|
+
});
|
|
87
|
+
const fillColor = uniform(controls.fillColor).onRenderUpdate(() => {
|
|
88
|
+
validateControls(controls);
|
|
89
|
+
return controls.fillColor;
|
|
90
|
+
});
|
|
91
|
+
const fillDirection = uniform(controls.fillDirection).onRenderUpdate(() => {
|
|
92
|
+
validateControls(controls);
|
|
93
|
+
return controls.fillDirection;
|
|
94
|
+
});
|
|
95
|
+
const fillAngularSize = uniform(controls.fillAngularSize).onRenderUpdate(() => {
|
|
96
|
+
validateControls(controls);
|
|
97
|
+
return controls.fillAngularSize;
|
|
98
|
+
});
|
|
99
|
+
const keyColor = uniform(controls.key.color).onRenderUpdate(() => {
|
|
100
|
+
validateControls(controls);
|
|
101
|
+
return controls.key.color;
|
|
102
|
+
});
|
|
103
|
+
const keyDirectionValue = new Vector3(0, 1, 0);
|
|
104
|
+
const keyTargetValue = new Vector3();
|
|
105
|
+
const keyDirection = uniform(keyDirectionValue).onRenderUpdate((frame) => {
|
|
106
|
+
resolveKey(controls, keyDirectionValue, keyTargetValue, frame.camera ?? controls.camera);
|
|
107
|
+
return keyDirectionValue;
|
|
108
|
+
});
|
|
109
|
+
// Removal/visibility/intensity are live. A removed sun cannot leave an invented rim behind.
|
|
110
|
+
const keyGain = uniform(0).onRenderUpdate((frame) =>
|
|
111
|
+
resolveKey(controls, keyDirectionValue, keyTargetValue, frame.camera ?? controls.camera),
|
|
112
|
+
);
|
|
113
|
+
const N = normalView.normalize();
|
|
114
|
+
const V = positionViewDirection.normalize();
|
|
115
|
+
const L = cameraViewMatrix.transformDirection(keyDirection);
|
|
116
|
+
const grazing = pow(float(1).sub(clamp(dot(N, V), 0, 1)), 3);
|
|
117
|
+
const behind = max(dot(L, V).negate(), 0);
|
|
118
|
+
// Suppress broad surfaces already facing the key; back-facing edges retain wrap.
|
|
119
|
+
// Tint by base reflectance so dark surfaces do not inherit a white emissive wash.
|
|
120
|
+
const surfaceBacklit = float(1).sub(smoothstep(-0.15, 0.15, dot(N, L)));
|
|
121
|
+
const rim = keyColor
|
|
122
|
+
.mul(keyGain)
|
|
123
|
+
.mul(rimGain)
|
|
124
|
+
.mul(grazing)
|
|
125
|
+
.mul(behind)
|
|
126
|
+
.mul(surfaceBacklit)
|
|
127
|
+
.mul(clamp(materialColor, 0, 1));
|
|
128
|
+
|
|
129
|
+
const F = cameraViewMatrix.transformDirection(fillDirection.normalize());
|
|
130
|
+
const cosRadius = fillAngularSize.cos();
|
|
131
|
+
// Broaden a rough surface's reflected disc with approximate solid-angle attenuation,
|
|
132
|
+
// not a proven energy-conserving BRDF. A positive transition avoids equal smoothstep bounds.
|
|
133
|
+
const spread = fillAngularSize.add(max(materialRoughness.mul(1.2), 0.005)).min(Math.PI / 2);
|
|
134
|
+
const reflectedDisc = smoothstep(spread.cos(), cosRadius, dot(reflect(V.negate(), N), F));
|
|
135
|
+
const energy = float(1)
|
|
136
|
+
.sub(cosRadius)
|
|
137
|
+
.div(max(float(1).sub(spread.cos()), 0.0001));
|
|
138
|
+
const reflectance = mix(vec3(0.04), materialColor, materialMetalness);
|
|
139
|
+
const specularFill = reflectance.mul(reflectedDisc).mul(energy);
|
|
140
|
+
const diffuseFill = materialColor
|
|
141
|
+
.mul(float(1).sub(materialMetalness))
|
|
142
|
+
.mul(max(dot(N, F), 0))
|
|
143
|
+
.mul(float(1).sub(cosRadius))
|
|
144
|
+
.mul(2);
|
|
145
|
+
const fill = diffuseFill.add(specularFill).mul(fillColor).mul(fillGain);
|
|
146
|
+
return materialEmissive.add(rim).add(fill);
|
|
147
|
+
}
|