create-threenative 0.2.8 → 0.2.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-docs/references/assertion-reference.md +87 -35
- package/agent-docs/references/auto-exposure.md +57 -0
- package/agent-docs/references/capability-reference.md +1097 -23
- 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 +1210 -27
- package/dist/index.d.ts +28 -3
- package/dist/index.js +396 -166
- package/dist/threenative.js +986 -235
- 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 +13 -10
- 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 +11 -9
- 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 +13 -10
- 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 +13 -10
- 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 +13 -10
- 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 +25 -5
- package/templates/racing/src/render/worldEnvironment.ts +433 -30
- package/templates/racing/src/scenes/Race.ts +110 -13
- package/templates/racing/src/track/circuit.ts +0 -9
- package/templates/racing/vite.config.ts +10 -2
- package/templates/rain/AGENTS.md +8 -9
- package/templates/rain/CLAUDE.md +8 -9
- package/templates/rain/native-playtests/boot.playtest.json +11 -1
- package/templates/rain/package.json +14 -10
- package/templates/rain/playtests/automation.playtest.json +1 -1
- package/templates/rain/playtests/performance.playtest.json +11 -1
- package/templates/rain/playtests/tiers.playtest.json +15 -0
- package/templates/rain/playtests/weather.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -34
- package/templates/rain/src/render/autoExposure.ts +225 -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/postprocessing.ts +3 -0
- package/templates/rain/src/render/quality.ts +27 -1
- package/templates/rain/src/render/worldEnvironment.ts +433 -30
- package/templates/rain/src/scenes/Boot.ts +14 -0
- package/templates/rain/src/state.ts +5 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -6
- package/templates/rain/tools/generate-shaders.mjs +1 -1
- package/templates/rain/vite.config.ts +10 -2
- package/templates/rts/AGENTS.md +10 -11
- package/templates/rts/CLAUDE.md +10 -11
- package/templates/rts/package.json +12 -9
- 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 +13 -10
- 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 +13 -10
- 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 +13 -10
- 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/AGENTS.md +8 -6
- package/templates/snow/CLAUDE.md +8 -6
- package/templates/snow/package.json +13 -10
- 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/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/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 +33 -1
- package/templates/snow/src/render/materialAssignments.ts +160 -0
- package/templates/snow/src/render/materialLighting.ts +155 -0
- package/templates/snow/src/render/postprocessing.ts +16 -2
- package/templates/snow/src/render/quality.ts +59 -1
- package/templates/snow/src/render/sky.ts +21 -2
- package/templates/snow/src/render/worldEnvironment.ts +433 -30
- package/templates/snow/src/scenes/Snow.ts +29 -1
- package/templates/snow/threenative.config.ts +3 -0
- package/templates/snow/vite.config.ts +10 -2
- 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 +13 -10
- 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 +43 -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 +90 -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 +13 -10
- 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
|
@@ -1,6 +1,14 @@
|
|
|
1
|
-
import { type ICtx, SkeletalMesh3D } from "@threenative/core";
|
|
1
|
+
import { BlendSpace1D, type ICtx, SkeletalMesh3D } from "@threenative/core";
|
|
2
2
|
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
|
-
import {
|
|
3
|
+
import {
|
|
4
|
+
type AnimationClip,
|
|
5
|
+
Group,
|
|
6
|
+
MathUtils,
|
|
7
|
+
type Mesh,
|
|
8
|
+
type Object3D,
|
|
9
|
+
Quaternion,
|
|
10
|
+
Vector3,
|
|
11
|
+
} from "three";
|
|
4
12
|
import { type IStarterConventions, preparePlayerConventions } from "../conventions.js";
|
|
5
13
|
import type { ITouchInput } from "../render/touch-controls.js";
|
|
6
14
|
import type { GameState } from "../state.js";
|
|
@@ -8,16 +16,15 @@ import type { GameState } from "../state.js";
|
|
|
8
16
|
type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
9
17
|
|
|
10
18
|
// Tune these two timers for jump feel; they forgive a late or early button press.
|
|
11
|
-
// 0.12s is 7.2 ticks at
|
|
12
|
-
//
|
|
13
|
-
//
|
|
14
|
-
//
|
|
15
|
-
// has not left the ledge yet, and the jump is counted as an ordinary one
|
|
16
|
-
// (`jumps: 1, coyoteJumps: 0`), which is what it measured when I tried.
|
|
19
|
+
// 0.12s is 7.2 ticks at 60 Hz. The coyote scenario approaches at 1.5 m/s for 130 ticks,
|
|
20
|
+
// then holds 4 ticks toward the edge and 5 more before jumping. Easing adds about 8.5 ticks
|
|
21
|
+
// of startup lag; the capsule leaves support near the end of the edge hold, about 5–6 ticks before
|
|
22
|
+
// the jump, inside the window. Keep these distances and the airborne delay together.
|
|
17
23
|
const COYOTE_TIME = 0.12;
|
|
18
24
|
const JUMP_BUFFER = 0.14;
|
|
19
25
|
const JUMP_SPEED = 5;
|
|
20
|
-
const
|
|
26
|
+
const WALK_SPEED = 1.5;
|
|
27
|
+
const RUN_SPEED = 5;
|
|
21
28
|
/** Capsule for a 1.8 m figure: 0.6 m half-height plus a 0.3 m radius at each end. */
|
|
22
29
|
const HALF_HEIGHT = 0.6;
|
|
23
30
|
const RADIUS = 0.3;
|
|
@@ -30,7 +37,8 @@ const SPAWN = { x: -2, y: PLAYER_STAND_Y, z: 0 } as const;
|
|
|
30
37
|
/** The clips `assets/mannequin.glb` ships, by the name this file plays them under. */
|
|
31
38
|
const CLIPS = {
|
|
32
39
|
idle: "Idle_Loop",
|
|
33
|
-
|
|
40
|
+
walk: "Walk_Loop",
|
|
41
|
+
run: "Jog_Fwd_Loop",
|
|
34
42
|
jumpStart: "Jump_Start",
|
|
35
43
|
jumpLoop: "Jump_Loop",
|
|
36
44
|
jumpLand: "Jump_Land",
|
|
@@ -51,6 +59,8 @@ export class Player {
|
|
|
51
59
|
#jumps = 0;
|
|
52
60
|
#coyoteJumps = 0;
|
|
53
61
|
#odometer = 0;
|
|
62
|
+
#speed = 0;
|
|
63
|
+
#gaits = new BlendSpace1D([WALK_SPEED, RUN_SPEED]);
|
|
54
64
|
#landing = 0;
|
|
55
65
|
#wasGrounded = true;
|
|
56
66
|
#supportSurfaceY = 0;
|
|
@@ -98,6 +108,8 @@ export class Player {
|
|
|
98
108
|
autostep: { maxHeight: 0.4, minWidth: 0.2 },
|
|
99
109
|
object: this.mesh,
|
|
100
110
|
physics: ctx.physics,
|
|
111
|
+
// Walking into dynamic props transfers the character's motion to them.
|
|
112
|
+
pushesDynamicBodies: true,
|
|
101
113
|
shape: CollisionShape3D.capsule(HALF_HEIGHT, RADIUS),
|
|
102
114
|
});
|
|
103
115
|
}
|
|
@@ -110,6 +122,14 @@ export class Player {
|
|
|
110
122
|
): void {
|
|
111
123
|
if (this.#hasPreviousPosition) {
|
|
112
124
|
this.#odometer += this.mesh.position.distanceTo(this.#previousPosition);
|
|
125
|
+
// The solver applies moveAndSlide after update; measure its last completed step.
|
|
126
|
+
this.#speed =
|
|
127
|
+
dt > 0
|
|
128
|
+
? Math.hypot(
|
|
129
|
+
this.mesh.position.x - this.#previousPosition.x,
|
|
130
|
+
this.mesh.position.z - this.#previousPosition.z,
|
|
131
|
+
) / dt
|
|
132
|
+
: 0;
|
|
113
133
|
}
|
|
114
134
|
const grounded = this.body.grounded;
|
|
115
135
|
this.#coyoteTime = Math.max(0, this.#coyoteTime - dt);
|
|
@@ -132,8 +152,13 @@ export class Player {
|
|
|
132
152
|
move.y += touch.move.y;
|
|
133
153
|
move.clampLength(0, 1);
|
|
134
154
|
}
|
|
135
|
-
|
|
136
|
-
|
|
155
|
+
// Touch walks until the stick is fully deflected; no separate run button.
|
|
156
|
+
const running = ctx.input.pressed("run") || (touch?.move.length() ?? 0) >= 1;
|
|
157
|
+
const speed = running ? RUN_SPEED : WALK_SPEED;
|
|
158
|
+
const ease = 1 - Math.exp(-dt / 0.15);
|
|
159
|
+
const moveZ = -move.y;
|
|
160
|
+
this.body.velocity.x += (move.x * speed - this.body.velocity.x) * ease;
|
|
161
|
+
this.body.velocity.z += (moveZ * speed - this.body.velocity.z) * ease;
|
|
137
162
|
this.#previousPosition.copy(this.mesh.position);
|
|
138
163
|
this.body.moveAndSlide(dt);
|
|
139
164
|
this.#hasPreviousPosition = true;
|
|
@@ -147,7 +172,7 @@ export class Player {
|
|
|
147
172
|
this.#conventions.groundSnap.enabled = canCorrectGrounding;
|
|
148
173
|
this.#conventions.applyGrounding(this.#supportSurfaceY, dt);
|
|
149
174
|
this.#captureVisualBodyOffset();
|
|
150
|
-
this.#animate(dt, move.
|
|
175
|
+
this.#animate(dt, move.x, moveZ, jumped);
|
|
151
176
|
}
|
|
152
177
|
|
|
153
178
|
respawn(): void {
|
|
@@ -155,10 +180,15 @@ export class Player {
|
|
|
155
180
|
this.#coyoteTime = 0;
|
|
156
181
|
this.#jumpBuffer = 0;
|
|
157
182
|
this.#hasPreviousPosition = false;
|
|
183
|
+
this.#speed = 0;
|
|
158
184
|
}
|
|
159
185
|
|
|
160
186
|
debug(): {
|
|
187
|
+
clip: string | undefined;
|
|
161
188
|
coyoteJumps: number;
|
|
189
|
+
facing: number;
|
|
190
|
+
facingAxis: "+x" | "-x" | "+z" | "-z";
|
|
191
|
+
gait: "idle" | "walk" | "run" | "air";
|
|
162
192
|
grounded: boolean;
|
|
163
193
|
groundClearance: number | null;
|
|
164
194
|
groundCorrectionEnabled: boolean;
|
|
@@ -167,12 +197,34 @@ export class Player {
|
|
|
167
197
|
normaliseFactor: number;
|
|
168
198
|
odometer: number;
|
|
169
199
|
position: number[];
|
|
200
|
+
speed: number;
|
|
201
|
+
strideSynced: boolean;
|
|
170
202
|
visualAttached: boolean;
|
|
171
203
|
visualAttachmentDrift: number;
|
|
172
204
|
} {
|
|
173
205
|
const visualAttachmentDrift = this.#visualAttachmentDrift();
|
|
206
|
+
const forward = new Vector3(0, 0, 1).applyQuaternion(
|
|
207
|
+
this.character.root.getWorldQuaternion(new Quaternion()),
|
|
208
|
+
);
|
|
174
209
|
return {
|
|
210
|
+
clip: this.character.current,
|
|
175
211
|
coyoteJumps: this.#coyoteJumps,
|
|
212
|
+
facing: Math.atan2(forward.x, forward.z),
|
|
213
|
+
facingAxis:
|
|
214
|
+
Math.abs(forward.x) > Math.abs(forward.z)
|
|
215
|
+
? forward.x >= 0
|
|
216
|
+
? "+x"
|
|
217
|
+
: "-x"
|
|
218
|
+
: forward.z >= 0
|
|
219
|
+
? "+z"
|
|
220
|
+
: "-z",
|
|
221
|
+
gait: !this.body.grounded
|
|
222
|
+
? "air"
|
|
223
|
+
: this.#speed <= 0.05
|
|
224
|
+
? "idle"
|
|
225
|
+
: this.character.current === CLIPS.run
|
|
226
|
+
? "run"
|
|
227
|
+
: "walk",
|
|
176
228
|
grounded: this.body.grounded,
|
|
177
229
|
groundClearance: this.#conventions.groundSnap.clearance,
|
|
178
230
|
groundCorrectionEnabled: this.#conventions.groundSnap.enabled,
|
|
@@ -181,6 +233,8 @@ export class Player {
|
|
|
181
233
|
normaliseFactor: this.#conventions.normaliseFactor,
|
|
182
234
|
odometer: this.#odometer,
|
|
183
235
|
position: this.mesh.position.toArray(),
|
|
236
|
+
speed: this.#speed,
|
|
237
|
+
strideSynced: this.character.stride.synced,
|
|
184
238
|
visualAttached: visualAttachmentDrift <= VISUAL_ATTACHMENT_TOLERANCE,
|
|
185
239
|
visualAttachmentDrift,
|
|
186
240
|
};
|
|
@@ -208,10 +262,10 @@ export class Player {
|
|
|
208
262
|
}
|
|
209
263
|
|
|
210
264
|
/** Faces the direction of travel and picks a clip from what the body is actually doing. */
|
|
211
|
-
#animate(dt: number,
|
|
265
|
+
#animate(dt: number, inputX: number, inputZ: number, jumped: boolean): void {
|
|
212
266
|
const figure = this.character.root;
|
|
213
|
-
if (
|
|
214
|
-
const heading = Math.atan2(
|
|
267
|
+
if (Math.hypot(inputX, inputZ) > 0.05) {
|
|
268
|
+
const heading = Math.atan2(inputX, inputZ);
|
|
215
269
|
const turn = MathUtils.euclideanModulo(heading - figure.rotation.y + Math.PI, Math.PI * 2);
|
|
216
270
|
figure.rotation.y += (turn - Math.PI) * Math.min(1, dt * 12);
|
|
217
271
|
}
|
|
@@ -223,8 +277,15 @@ export class Player {
|
|
|
223
277
|
else if (grounded && !this.#wasGrounded) {
|
|
224
278
|
this.#landing = 0.25;
|
|
225
279
|
this.character.play(CLIPS.jumpLand, { fade: 0.06, mode: "once" });
|
|
226
|
-
} else if (grounded && this.#landing <= 0)
|
|
227
|
-
this
|
|
280
|
+
} else if (grounded && this.#landing <= 0) {
|
|
281
|
+
if (this.#speed > 0.05) {
|
|
282
|
+
const weights = this.#gaits.sample(this.#speed);
|
|
283
|
+
this.character.playWeighted([
|
|
284
|
+
{ clip: CLIPS.walk, weight: weights[0] ?? 0 },
|
|
285
|
+
{ clip: CLIPS.run, weight: weights[1] ?? 0 },
|
|
286
|
+
]);
|
|
287
|
+
} else this.character.play(CLIPS.idle, { fade: 0.2 });
|
|
288
|
+
}
|
|
228
289
|
this.#wasGrounded = grounded;
|
|
229
290
|
this.character.update(dt);
|
|
230
291
|
}
|
|
@@ -19,6 +19,7 @@ const game = defineGame<GameState, IPhysicsContext>({
|
|
|
19
19
|
right: ["ArrowRight", "KeyD"],
|
|
20
20
|
up: ["ArrowUp", "KeyW"],
|
|
21
21
|
},
|
|
22
|
+
run: { keys: ["ShiftLeft", "ShiftRight"] },
|
|
22
23
|
jump: { buttons: [0], keys: ["Space"] },
|
|
23
24
|
flagGust: { keys: ["KeyG"] },
|
|
24
25
|
restart: { keys: ["KeyR"] },
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { type QualityTier, resolveQualityTier } from "./quality.js";
|
|
2
|
+
import { resolveQualityPolicy } from "./qualityPolicy.js";
|
|
2
3
|
|
|
3
4
|
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
4
5
|
|
|
@@ -11,6 +12,8 @@ export interface IQualityWindow {
|
|
|
11
12
|
readonly frame: { readonly p95: number };
|
|
12
13
|
readonly gpuMs?: number;
|
|
13
14
|
readonly gpuAgeFrames?: number;
|
|
15
|
+
/** A completed window's own GPU work, read when the fresh sample is unavailable or stale. */
|
|
16
|
+
readonly gpu?: { readonly samples: number; readonly p50: number };
|
|
14
17
|
readonly surface?: { readonly compiling?: boolean };
|
|
15
18
|
}
|
|
16
19
|
|
|
@@ -18,7 +21,7 @@ export interface IQualityDecision {
|
|
|
18
21
|
readonly tier: QualityTier;
|
|
19
22
|
readonly source: "auto" | "pinned";
|
|
20
23
|
readonly changed: boolean;
|
|
21
|
-
readonly meter: "gpu" | "presented";
|
|
24
|
+
readonly meter: "gpu" | "presented" | "work";
|
|
22
25
|
readonly fallback?: "gpu-unavailable" | "gpu-invalid" | "gpu-age-unavailable" | "gpu-stale";
|
|
23
26
|
readonly reason: string;
|
|
24
27
|
readonly budgetMs: number;
|
|
@@ -45,46 +48,14 @@ export interface IAdaptiveQualityOptions {
|
|
|
45
48
|
|
|
46
49
|
/** The game owns this policy. Platform selects the first look; measured load selects later ones. */
|
|
47
50
|
export function createAdaptiveQuality(
|
|
48
|
-
request: {
|
|
51
|
+
request: {
|
|
52
|
+
readonly gpuClass?: string;
|
|
53
|
+
readonly mobile?: boolean;
|
|
54
|
+
readonly tier?: string;
|
|
55
|
+
} = {},
|
|
49
56
|
options: IAdaptiveQualityOptions = {},
|
|
50
57
|
) {
|
|
51
|
-
const policy =
|
|
52
|
-
targetFps: 60,
|
|
53
|
-
overloadedWindows: 2,
|
|
54
|
-
healthyWindows: 5,
|
|
55
|
-
headroom: 0.2,
|
|
56
|
-
presentationTolerance: 0.05,
|
|
57
|
-
cooldownMs: 5000,
|
|
58
|
-
startupWindows: 1,
|
|
59
|
-
minFrames: 30,
|
|
60
|
-
maxGpuAgeFrames: 4,
|
|
61
|
-
...options,
|
|
62
|
-
};
|
|
63
|
-
for (const key of ["targetFps", "overloadedWindows", "healthyWindows", "minFrames"] as const) {
|
|
64
|
-
if (!Number.isFinite(policy[key]) || policy[key] <= 0)
|
|
65
|
-
throw new Error(`quality ${key} must be positive.`);
|
|
66
|
-
}
|
|
67
|
-
for (const key of ["cooldownMs", "startupWindows", "maxGpuAgeFrames"] as const) {
|
|
68
|
-
if (!Number.isFinite(policy[key]) || policy[key] < 0)
|
|
69
|
-
throw new Error(`quality ${key} must be non-negative.`);
|
|
70
|
-
}
|
|
71
|
-
for (const key of [
|
|
72
|
-
"overloadedWindows",
|
|
73
|
-
"healthyWindows",
|
|
74
|
-
"startupWindows",
|
|
75
|
-
"minFrames",
|
|
76
|
-
"maxGpuAgeFrames",
|
|
77
|
-
] as const) {
|
|
78
|
-
if (!Number.isInteger(policy[key])) throw new Error(`quality ${key} must be an integer.`);
|
|
79
|
-
}
|
|
80
|
-
if (!Number.isFinite(policy.headroom) || policy.headroom <= 0 || policy.headroom >= 1)
|
|
81
|
-
throw new Error("quality headroom must be between zero and one.");
|
|
82
|
-
if (
|
|
83
|
-
!Number.isFinite(policy.presentationTolerance) ||
|
|
84
|
-
policy.presentationTolerance < 0 ||
|
|
85
|
-
policy.presentationTolerance >= 1
|
|
86
|
-
)
|
|
87
|
-
throw new Error("quality presentationTolerance must be between zero and one.");
|
|
58
|
+
const policy = resolveQualityPolicy(options);
|
|
88
59
|
const now = options.now ?? (() => performance.now());
|
|
89
60
|
const ready = options.ready ?? (() => true);
|
|
90
61
|
let tier = resolveQualityTier(request);
|
|
@@ -115,7 +86,23 @@ export function createAdaptiveQuality(
|
|
|
115
86
|
: age > policy.maxGpuAgeFrames
|
|
116
87
|
? "gpu-stale"
|
|
117
88
|
: undefined;
|
|
118
|
-
const
|
|
89
|
+
const series = window.gpu;
|
|
90
|
+
// Completed GPU work keeps stale resolve timing from mistaking host gaps for load.
|
|
91
|
+
const workP50 =
|
|
92
|
+
fallback !== undefined &&
|
|
93
|
+
series !== undefined &&
|
|
94
|
+
Number.isInteger(series.samples) &&
|
|
95
|
+
series.samples >= 4 &&
|
|
96
|
+
Number.isFinite(series.p50) &&
|
|
97
|
+
series.p50 > 0
|
|
98
|
+
? series.p50
|
|
99
|
+
: undefined;
|
|
100
|
+
const costMs =
|
|
101
|
+
fallback === undefined
|
|
102
|
+
? (gpu as number)
|
|
103
|
+
: workP50 !== undefined
|
|
104
|
+
? Math.max(window.frame.p95, workP50)
|
|
105
|
+
: window.presented.p95;
|
|
119
106
|
// Presented intervals include vsync jitter, so fallback overload gets a small tolerance.
|
|
120
107
|
const overloadBudgetMs =
|
|
121
108
|
fallback === undefined ? budgetMs : budgetMs * (1 + policy.presentationTolerance);
|
|
@@ -132,7 +119,7 @@ export function createAdaptiveQuality(
|
|
|
132
119
|
reason,
|
|
133
120
|
budgetMs,
|
|
134
121
|
overloadBudgetMs,
|
|
135
|
-
meter: fallback === undefined ? "gpu" : "presented",
|
|
122
|
+
meter: fallback === undefined ? "gpu" : workP50 !== undefined ? "work" : "presented",
|
|
136
123
|
...reportFields,
|
|
137
124
|
});
|
|
138
125
|
let skip: string | undefined;
|
|
@@ -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
|
+
}
|