create-threenative 0.2.10 → 0.2.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-docs/references/assertion-reference.md +109 -3
- package/agent-docs/references/auto-exposure.md +28 -45
- package/agent-docs/references/build-profiles.md +1 -1
- package/agent-docs/references/capability-reference.md +527 -44
- package/agent-docs/references/debug-surface.md +64 -0
- package/agent-docs/references/finding-assets.md +11 -12
- package/agent-docs/references/performance-basics.md +19 -0
- package/agent-docs/references/trace-a-slow-frame.md +21 -0
- package/agent-docs/references/visual-baseline.md +23 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/scripts/reference.mjs +9 -4
- package/capabilities.json +739 -50
- package/dist/index.d.ts +40 -6
- package/dist/index.js +227 -34
- package/dist/quality.d.ts +12 -0
- package/dist/quality.js +166747 -0
- package/dist/threenative.js +60 -44
- package/dist/web-engine-gltf-loader.js +2 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
- package/dist/web-engine-mesh-bvh.js +7 -0
- package/dist/web-engine-post-effects.js +645 -19
- package/dist/web-engine-runtime.js +3528 -343
- package/package.json +19 -9
- package/template-assets/assets/bay-PROVENANCE.md +21 -0
- package/template-assets/assets/bay-ground.webp +0 -0
- package/template-assets/assets/bay-metal.webp +0 -0
- package/template-assets/assets/bay-pavement-normal.webp +0 -0
- package/template-assets/assets/bay-pavement.webp +0 -0
- package/template-assets/assets/bay-plaster-normal.webp +0 -0
- package/template-assets/assets/bay-plaster.webp +0 -0
- package/template-assets/assets/bay-wood-normal.webp +0 -0
- package/template-assets/assets/bay-wood.webp +0 -0
- package/template-assets/assets/tex-PROVENANCE.md +25 -0
- package/template-assets/assets/tex-bark-normal.webp +0 -0
- package/template-assets/assets/tex-bark.webp +0 -0
- package/template-assets/assets/tex-birch-bark.webp +0 -0
- package/template-assets/assets/tex-grass.webp +0 -0
- package/template-assets/assets/tex-planks-normal.webp +0 -0
- package/template-assets/assets/tex-planks.webp +0 -0
- package/template-assets/assets/tex-rock-normal.webp +0 -0
- package/template-assets/assets/tex-rock.webp +0 -0
- package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
- package/template-assets/assets/tex-roof-tiles.webp +0 -0
- package/template-assets/assets/tex-sand-normal.webp +0 -0
- package/template-assets/assets/tex-sand.webp +0 -0
- package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
- package/template-assets/assets/tex-stone-wall.webp +0 -0
- package/template-assets/kitExposure.ts +20 -0
- package/template-assets/patches/three@0.185.1.patch +481 -272
- package/template-assets/quality/biome.json +7 -0
- package/template-assets/quality/eslint.config.js +3 -0
- package/template-assets/realistic-ocean/README.md +113 -0
- package/template-assets/realistic-ocean/install.mjs +56 -0
- package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
- package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
- package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
- package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
- package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
- package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
- package/templates/AGENTS.md +21 -0
- package/templates/CLAUDE.md +23 -0
- package/templates/action-rpg/.codex/config.toml +6 -2
- package/templates/action-rpg/.cursor/mcp.json +8 -2
- package/templates/action-rpg/.gemini/settings.json +8 -2
- package/templates/action-rpg/.mcp.json +8 -2
- package/templates/action-rpg/.vscode/mcp.json +9 -2
- package/templates/action-rpg/.zed/settings.json +9 -2
- package/templates/action-rpg/AGENTS.md +11 -11
- package/templates/action-rpg/CLAUDE.md +11 -11
- package/templates/action-rpg/opencode.json +10 -2
- package/templates/action-rpg/package.json +15 -10
- package/templates/action-rpg/playtests/combat.playtest.json +6 -0
- package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
- package/templates/action-rpg/playtests/performance.playtest.json +1 -1
- package/templates/action-rpg/playtests/roll.playtest.json +112 -0
- package/templates/action-rpg/playtests/swing.playtest.json +55 -0
- package/templates/action-rpg/playtests/win.playtest.json +4 -4
- package/templates/action-rpg/src/entities/Fighter.ts +44 -4
- package/templates/action-rpg/src/entities/Player.ts +64 -12
- package/templates/action-rpg/src/render/atmosphere.ts +444 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
- package/templates/action-rpg/src/render/clouds.ts +605 -0
- package/templates/action-rpg/src/render/dungeon.ts +8 -6
- package/templates/action-rpg/src/render/exposure.ts +11 -109
- package/templates/action-rpg/src/render/gpuSky.ts +752 -0
- package/templates/action-rpg/src/render/lighting.ts +27 -4
- package/templates/action-rpg/src/render/materialLighting.ts +2 -11
- package/templates/action-rpg/src/render/palette.ts +1 -0
- package/templates/action-rpg/src/render/postprocessing.ts +4 -4
- package/templates/action-rpg/src/render/props.ts +10 -8
- package/templates/action-rpg/src/render/quality.ts +56 -108
- package/templates/action-rpg/src/render/sky.ts +74 -1
- package/templates/action-rpg/src/scenes/Play.ts +16 -12
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
- package/templates/action-rpg/src/ui/Hud.tsx +5 -7
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/adventure/.codex/config.toml +23 -0
- package/templates/adventure/.cursor/mcp.json +38 -0
- package/templates/adventure/.gemini/settings.json +38 -0
- package/templates/adventure/.mcp.json +38 -0
- package/templates/adventure/.vscode/mcp.json +43 -0
- package/templates/adventure/.zed/settings.json +43 -0
- package/templates/adventure/AGENTS.md +60 -0
- package/templates/adventure/CLAUDE.md +62 -0
- package/templates/adventure/index.html +14 -0
- package/templates/adventure/kit.json +8 -0
- package/templates/adventure/native-playtests/survives.playtest.json +52 -0
- package/templates/adventure/opencode.json +49 -0
- package/templates/adventure/package.json +65 -0
- package/templates/adventure/playtests/boss.playtest.json +406 -0
- package/templates/adventure/playtests/combat.playtest.json +342 -0
- package/templates/adventure/playtests/controls.playtest.json +142 -0
- package/templates/adventure/playtests/explore.playtest.json +45 -0
- package/templates/adventure/playtests/flicker.playtest.json +206 -0
- package/templates/adventure/playtests/hearts.playtest.json +171 -0
- package/templates/adventure/playtests/lockon.playtest.json +256 -0
- package/templates/adventure/playtests/look.playtest.json +72 -0
- package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
- package/templates/adventure/playtests/move.playtest.json +84 -0
- package/templates/adventure/playtests/performance.playtest.json +55 -0
- package/templates/adventure/playtests/puzzle.playtest.json +250 -0
- package/templates/adventure/playtests/stride.playtest.json +67 -0
- package/templates/adventure/playtests/survives.playtest.json +171 -0
- package/templates/adventure/playtests/thornback.playtest.json +267 -0
- package/templates/adventure/public/favicon.svg +4 -0
- package/templates/adventure/src/entities/Block.ts +114 -0
- package/templates/adventure/src/entities/Chest.ts +69 -0
- package/templates/adventure/src/entities/Door.ts +81 -0
- package/templates/adventure/src/entities/Dummy.ts +69 -0
- package/templates/adventure/src/entities/Flicker.ts +239 -0
- package/templates/adventure/src/entities/Hero.ts +561 -0
- package/templates/adventure/src/entities/LockOn.ts +180 -0
- package/templates/adventure/src/entities/Mossling.ts +249 -0
- package/templates/adventure/src/entities/Switch.ts +49 -0
- package/templates/adventure/src/entities/Thornback.ts +238 -0
- package/templates/adventure/src/entities/Warden.ts +196 -0
- package/templates/adventure/src/game.ts +65 -0
- package/templates/adventure/src/interact.ts +63 -0
- package/templates/adventure/src/level/Hollow.ts +240 -0
- package/templates/adventure/src/level/Vale.ts +383 -0
- package/templates/adventure/src/main.ts +18 -0
- package/templates/adventure/src/render/camera.ts +416 -0
- package/templates/adventure/src/render/creatures.ts +405 -0
- package/templates/adventure/src/render/effects.ts +333 -0
- package/templates/adventure/src/render/foliage.ts +1072 -0
- package/templates/adventure/src/render/hero.ts +1447 -0
- package/templates/adventure/src/render/kitExposure.ts +20 -0
- package/templates/adventure/src/render/lighting.ts +74 -0
- package/templates/adventure/src/render/loading.ts +332 -0
- package/templates/adventure/src/render/materials.ts +179 -0
- package/templates/adventure/src/render/palette.ts +137 -0
- package/templates/adventure/src/render/postprocessing.ts +70 -0
- package/templates/adventure/src/render/props.ts +383 -0
- package/templates/adventure/src/render/quality.ts +46 -0
- package/templates/adventure/src/render/sky.ts +271 -0
- package/templates/adventure/src/render/surface.ts +259 -0
- package/templates/adventure/src/render/touch-controls.ts +137 -0
- package/templates/adventure/src/scenes/Play.ts +959 -0
- package/templates/adventure/src/state.ts +113 -0
- package/templates/adventure/src/style.css +98 -0
- package/templates/adventure/src/ui/App.tsx +22 -0
- package/templates/adventure/src/ui/GameUi.tsx +20 -0
- package/templates/adventure/src/ui/Hud.tsx +70 -0
- package/templates/adventure/src/ui/Menu.tsx +15 -0
- package/templates/adventure/src/ui/main.tsx +14 -0
- package/templates/adventure/tailwind.config.ts +2 -0
- package/templates/adventure/threenative.config.ts +62 -0
- package/templates/adventure/tsconfig.json +17 -0
- package/templates/adventure/vite.config.ts +49 -0
- package/templates/collectathon/.codex/config.toml +23 -0
- package/templates/collectathon/.cursor/mcp.json +38 -0
- package/templates/collectathon/.gemini/settings.json +38 -0
- package/templates/collectathon/.mcp.json +38 -0
- package/templates/collectathon/.vscode/mcp.json +43 -0
- package/templates/collectathon/.zed/settings.json +43 -0
- package/templates/collectathon/AGENTS.md +58 -0
- package/templates/collectathon/CLAUDE.md +60 -0
- package/templates/collectathon/index.html +14 -0
- package/templates/collectathon/kit.json +8 -0
- package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
- package/templates/collectathon/opencode.json +49 -0
- package/templates/collectathon/package.json +65 -0
- package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
- package/templates/collectathon/playtests/camera.playtest.json +80 -0
- package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
- package/templates/collectathon/playtests/collect.playtest.json +196 -0
- package/templates/collectathon/playtests/combat.playtest.json +246 -0
- package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
- package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
- package/templates/collectathon/playtests/effects.playtest.json +124 -0
- package/templates/collectathon/playtests/enemies.playtest.json +295 -0
- package/templates/collectathon/playtests/explore.playtest.json +45 -0
- package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
- package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
- package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
- package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
- package/templates/collectathon/playtests/ledge.playtest.json +100 -0
- package/templates/collectathon/playtests/look.playtest.json +64 -0
- package/templates/collectathon/playtests/performance.playtest.json +55 -0
- package/templates/collectathon/playtests/stride.playtest.json +111 -0
- package/templates/collectathon/playtests/survives.playtest.json +123 -0
- package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
- package/templates/collectathon/playtests/thornback.playtest.json +157 -0
- package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
- package/templates/collectathon/playtests/win.playtest.json +166 -0
- package/templates/collectathon/public/favicon.svg +4 -0
- package/templates/collectathon/src/entities/Hero.ts +915 -0
- package/templates/collectathon/src/entities/Pickup.ts +63 -0
- package/templates/collectathon/src/entities/Walker.ts +248 -0
- package/templates/collectathon/src/game.ts +51 -0
- package/templates/collectathon/src/level/Course.ts +590 -0
- package/templates/collectathon/src/level/terrain.ts +144 -0
- package/templates/collectathon/src/main.ts +14 -0
- package/templates/collectathon/src/playtest-events.ts +15 -0
- package/templates/collectathon/src/render/camera.ts +163 -0
- package/templates/collectathon/src/render/castle.ts +408 -0
- package/templates/collectathon/src/render/effects.ts +284 -0
- package/templates/collectathon/src/render/foliage.ts +744 -0
- package/templates/collectathon/src/render/ground.ts +139 -0
- package/templates/collectathon/src/render/hero.ts +452 -0
- package/templates/collectathon/src/render/kitExposure.ts +20 -0
- package/templates/collectathon/src/render/lighting.ts +65 -0
- package/templates/collectathon/src/render/loading.ts +332 -0
- package/templates/collectathon/src/render/materials.ts +196 -0
- package/templates/collectathon/src/render/palette.ts +82 -0
- package/templates/collectathon/src/render/postprocessing.ts +79 -0
- package/templates/collectathon/src/render/props.ts +218 -0
- package/templates/collectathon/src/render/quality.ts +54 -0
- package/templates/collectathon/src/render/sky.ts +262 -0
- package/templates/collectathon/src/render/surface.ts +269 -0
- package/templates/collectathon/src/render/touch-controls.ts +179 -0
- package/templates/collectathon/src/render/touch-layout.ts +48 -0
- package/templates/collectathon/src/render/water.ts +191 -0
- package/templates/collectathon/src/scenes/Play.ts +481 -0
- package/templates/collectathon/src/state.ts +38 -0
- package/templates/collectathon/src/style.css +106 -0
- package/templates/collectathon/src/ui/App.tsx +22 -0
- package/templates/collectathon/src/ui/GameUi.tsx +20 -0
- package/templates/collectathon/src/ui/Hud.tsx +77 -0
- package/templates/collectathon/src/ui/Menu.tsx +13 -0
- package/templates/collectathon/src/ui/main.tsx +14 -0
- package/templates/collectathon/tailwind.config.ts +2 -0
- package/templates/collectathon/threenative.config.ts +62 -0
- package/templates/collectathon/tsconfig.json +17 -0
- package/templates/collectathon/vite.config.ts +49 -0
- package/templates/kart/.codex/config.toml +23 -0
- package/templates/kart/.cursor/mcp.json +38 -0
- package/templates/kart/.gemini/settings.json +38 -0
- package/templates/kart/.mcp.json +38 -0
- package/templates/kart/.vscode/mcp.json +43 -0
- package/templates/kart/.zed/settings.json +43 -0
- package/templates/kart/AGENTS.md +58 -0
- package/templates/kart/CLAUDE.md +60 -0
- package/templates/kart/index.html +14 -0
- package/templates/kart/kit.json +8 -0
- package/templates/kart/native-playtests/survives.playtest.json +65 -0
- package/templates/kart/opencode.json +49 -0
- package/templates/kart/package.json +64 -0
- package/templates/kart/playtests/drift.playtest.json +226 -0
- package/templates/kart/playtests/explore.playtest.json +45 -0
- package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
- package/templates/kart/playtests/item-key.playtest.json +108 -0
- package/templates/kart/playtests/items.playtest.json +143 -0
- package/templates/kart/playtests/lap-times.playtest.json +138 -0
- package/templates/kart/playtests/laps.playtest.json +149 -0
- package/templates/kart/playtests/performance.playtest.json +57 -0
- package/templates/kart/playtests/race.playtest.json +294 -0
- package/templates/kart/playtests/restart.playtest.json +87 -0
- package/templates/kart/playtests/rocket-start.playtest.json +56 -0
- package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
- package/templates/kart/playtests/surfaces.playtest.json +113 -0
- package/templates/kart/playtests/survives.playtest.json +116 -0
- package/templates/kart/playtests/wall.playtest.json +118 -0
- package/templates/kart/public/favicon.svg +4 -0
- package/templates/kart/src/entities/Driver.ts +123 -0
- package/templates/kart/src/entities/Items.ts +194 -0
- package/templates/kart/src/entities/Kart.ts +517 -0
- package/templates/kart/src/game.ts +45 -0
- package/templates/kart/src/main.ts +14 -0
- package/templates/kart/src/playtest-events.ts +15 -0
- package/templates/kart/src/render/camera.ts +83 -0
- package/templates/kart/src/render/course.ts +579 -0
- package/templates/kart/src/render/effects.ts +266 -0
- package/templates/kart/src/render/items.ts +163 -0
- package/templates/kart/src/render/kart.ts +256 -0
- package/templates/kart/src/render/kitExposure.ts +20 -0
- package/templates/kart/src/render/lighting.ts +58 -0
- package/templates/kart/src/render/loading.ts +332 -0
- package/templates/kart/src/render/materials.ts +119 -0
- package/templates/kart/src/render/palette.ts +74 -0
- package/templates/kart/src/render/postprocessing.ts +79 -0
- package/templates/kart/src/render/quality.ts +54 -0
- package/templates/kart/src/render/skids.ts +86 -0
- package/templates/kart/src/render/sky.ts +105 -0
- package/templates/kart/src/render/touch-controls.ts +168 -0
- package/templates/kart/src/render/touch-layout.ts +48 -0
- package/templates/kart/src/scenes/Race.ts +850 -0
- package/templates/kart/src/state.ts +53 -0
- package/templates/kart/src/style.css +106 -0
- package/templates/kart/src/track/Course.ts +276 -0
- package/templates/kart/src/track/Race.ts +133 -0
- package/templates/kart/src/ui/App.tsx +21 -0
- package/templates/kart/src/ui/GameUi.tsx +20 -0
- package/templates/kart/src/ui/Hud.tsx +172 -0
- package/templates/kart/src/ui/Menu.tsx +13 -0
- package/templates/kart/src/ui/main.tsx +14 -0
- package/templates/kart/tailwind.config.ts +2 -0
- package/templates/kart/threenative.config.ts +62 -0
- package/templates/kart/tsconfig.json +17 -0
- package/templates/kart/vite.config.ts +49 -0
- package/templates/minimal/.codex/config.toml +6 -2
- package/templates/minimal/.cursor/mcp.json +8 -2
- package/templates/minimal/.gemini/settings.json +8 -2
- package/templates/minimal/.mcp.json +8 -2
- package/templates/minimal/.vscode/mcp.json +9 -2
- package/templates/minimal/.zed/settings.json +9 -2
- package/templates/minimal/AGENTS.md +11 -13
- package/templates/minimal/CLAUDE.md +11 -13
- package/templates/minimal/opencode.json +10 -2
- package/templates/minimal/package.json +14 -9
- package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
- package/templates/minimal/playtests/jump.playtest.json +45 -0
- package/templates/minimal/playtests/play.playtest.json +1 -1
- package/templates/minimal/src/game.ts +2 -0
- package/templates/minimal/src/render/atmosphere.ts +444 -0
- package/templates/minimal/src/render/backlightMaterial.ts +49 -18
- package/templates/minimal/src/render/camera.ts +35 -4
- package/templates/minimal/src/render/clouds.ts +605 -0
- package/templates/minimal/src/render/exposure.ts +7 -111
- package/templates/minimal/src/render/gpuSky.ts +752 -0
- package/templates/minimal/src/render/lighting.ts +26 -4
- package/templates/minimal/src/render/materialLighting.ts +2 -10
- package/templates/minimal/src/render/postprocessing.ts +4 -4
- package/templates/minimal/src/render/quality.ts +10 -116
- package/templates/minimal/src/render/sky.ts +73 -1
- package/templates/minimal/src/scenes/Play.ts +18 -7
- package/templates/platformer/.codex/config.toml +6 -2
- package/templates/platformer/.cursor/mcp.json +8 -2
- package/templates/platformer/.gemini/settings.json +8 -2
- package/templates/platformer/.mcp.json +8 -2
- package/templates/platformer/.vscode/mcp.json +9 -2
- package/templates/platformer/.zed/settings.json +9 -2
- package/templates/platformer/AGENTS.md +13 -9
- package/templates/platformer/CLAUDE.md +13 -9
- package/templates/platformer/opencode.json +10 -2
- package/templates/platformer/package.json +15 -10
- package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
- package/templates/platformer/playtests/finish.playtest.json +58 -0
- package/templates/platformer/playtests/idle.playtest.json +44 -0
- package/templates/platformer/playtests/performance.playtest.json +1 -1
- package/templates/platformer/src/entities/Fox.ts +19 -6
- package/templates/platformer/src/game.ts +1 -0
- package/templates/platformer/src/level/Stage.ts +4 -1
- package/templates/platformer/src/render/backlightMaterial.ts +49 -18
- package/templates/platformer/src/render/camera.ts +30 -1
- package/templates/platformer/src/render/exposure.ts +6 -111
- package/templates/platformer/src/render/fox.ts +5 -2
- package/templates/platformer/src/render/kitExposure.ts +20 -0
- package/templates/platformer/src/render/materialLighting.ts +2 -11
- package/templates/platformer/src/render/postprocessing.ts +4 -4
- package/templates/platformer/src/render/props.ts +1 -2
- package/templates/platformer/src/render/quality.ts +10 -118
- package/templates/platformer/src/scenes/Play.ts +31 -15
- package/templates/platformer/src/ui/Menu.tsx +1 -1
- package/templates/puzzle/.codex/config.toml +6 -2
- package/templates/puzzle/.cursor/mcp.json +8 -2
- package/templates/puzzle/.gemini/settings.json +8 -2
- package/templates/puzzle/.mcp.json +8 -2
- package/templates/puzzle/.vscode/mcp.json +9 -2
- package/templates/puzzle/.zed/settings.json +9 -2
- package/templates/puzzle/AGENTS.md +14 -17
- package/templates/puzzle/CLAUDE.md +14 -17
- package/templates/puzzle/opencode.json +10 -2
- package/templates/puzzle/package.json +15 -10
- package/templates/puzzle/playtests/performance.playtest.json +1 -1
- package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
- package/templates/puzzle/src/render/exposure.ts +11 -109
- package/templates/puzzle/src/render/lighting.ts +3 -3
- package/templates/puzzle/src/render/materialLighting.ts +2 -11
- package/templates/puzzle/src/render/palette.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +4 -4
- package/templates/puzzle/src/render/quality.ts +44 -153
- package/templates/puzzle/src/render/vault.ts +18 -6
- package/templates/puzzle/src/scenes/Play.ts +6 -1
- package/templates/puzzle/src/ui/Hud.tsx +8 -43
- package/templates/racing/.codex/config.toml +6 -2
- package/templates/racing/.cursor/mcp.json +8 -2
- package/templates/racing/.gemini/settings.json +8 -2
- package/templates/racing/.mcp.json +8 -2
- package/templates/racing/.vscode/mcp.json +9 -2
- package/templates/racing/.zed/settings.json +9 -2
- package/templates/racing/AGENTS.md +10 -12
- package/templates/racing/CLAUDE.md +10 -12
- package/templates/racing/opencode.json +10 -2
- package/templates/racing/package.json +15 -10
- package/templates/racing/playtests/brake.playtest.json +54 -0
- package/templates/racing/playtests/outcome.playtest.json +19 -0
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
- package/templates/racing/src/entities/RacingCar.ts +12 -3
- package/templates/racing/src/entities/Rival.ts +11 -2
- package/templates/racing/src/render/atmosphere.ts +444 -0
- package/templates/racing/src/render/backlightMaterial.ts +49 -18
- package/templates/racing/src/render/clouds.ts +605 -0
- package/templates/racing/src/render/exposure.ts +6 -111
- package/templates/racing/src/render/gpuSky.ts +752 -0
- package/templates/racing/src/render/kitExposure.ts +20 -0
- package/templates/racing/src/render/lighting.ts +26 -4
- package/templates/racing/src/render/materialLighting.ts +2 -11
- package/templates/racing/src/render/materials.ts +2 -1
- package/templates/racing/src/render/postprocessing.ts +4 -4
- package/templates/racing/src/render/quality.ts +27 -115
- package/templates/racing/src/render/sky.ts +72 -1
- package/templates/racing/src/scenes/Race.ts +9 -7
- package/templates/racing/src/track/TrackSector.ts +5 -2
- package/templates/racing/src/ui/Hud.tsx +12 -7
- package/templates/rain/.codex/config.toml +6 -2
- package/templates/rain/.cursor/mcp.json +8 -2
- package/templates/rain/.gemini/settings.json +8 -2
- package/templates/rain/.mcp.json +8 -2
- package/templates/rain/.vscode/mcp.json +9 -2
- package/templates/rain/.zed/settings.json +9 -2
- package/templates/rain/AGENTS.md +12 -12
- package/templates/rain/CLAUDE.md +12 -12
- package/templates/rain/opencode.json +10 -2
- package/templates/rain/package.json +14 -9
- package/templates/rain/playtests/performance.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/bloom-shader.ts +1 -1
- package/templates/rain/src/render/clouds-shader.ts +2 -2
- package/templates/rain/src/render/clouds.ts +2 -1
- package/templates/rain/src/render/exposure.ts +11 -109
- package/templates/rain/src/render/post-shader.ts +7 -11
- package/templates/rain/src/render/postprocessing.ts +8 -24
- package/templates/rain/src/render/quality.ts +44 -98
- package/templates/rain/src/render/world-shader.ts +281 -97
- package/templates/rain/src/render/world.ts +82 -2
- package/templates/rain/src/style.css +1 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -2
- package/templates/rain/src/ui/Hud.tsx +1 -1
- package/templates/rain/tools/generate-shaders.mjs +2 -2
- package/templates/rain/tools/tempest-post.frag +4 -6
- package/templates/rain/tools/tempest-world.frag +80 -12
- package/templates/rts/.codex/config.toml +6 -2
- package/templates/rts/.cursor/mcp.json +8 -2
- package/templates/rts/.gemini/settings.json +8 -2
- package/templates/rts/.mcp.json +8 -2
- package/templates/rts/.vscode/mcp.json +9 -2
- package/templates/rts/.zed/settings.json +9 -2
- package/templates/rts/AGENTS.md +15 -16
- package/templates/rts/CLAUDE.md +15 -16
- package/templates/rts/opencode.json +10 -2
- package/templates/rts/package.json +14 -9
- package/templates/rts/playtests/performance.playtest.json +1 -1
- package/templates/rts/playtests/rts-attack.playtest.json +5 -0
- package/templates/rts/playtests/rts-build.playtest.json +20 -1
- package/templates/rts/playtests/rts-orders.playtest.json +1 -1
- package/templates/rts/playtests/rts-pause.playtest.json +112 -0
- package/templates/rts/playtests/rts-train.playtest.json +1 -1
- package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
- package/templates/rts/src/game.ts +29 -7
- package/templates/rts/src/render/army.ts +181 -49
- package/templates/rts/src/render/backlightMaterial.ts +49 -18
- package/templates/rts/src/render/environment.ts +276 -0
- package/templates/rts/src/render/exposure.ts +3 -65
- package/templates/rts/src/render/ground.ts +478 -0
- package/templates/rts/src/render/lighting.ts +62 -11
- package/templates/rts/src/render/materialLighting.ts +2 -11
- package/templates/rts/src/render/materials.ts +47 -118
- package/templates/rts/src/render/palette.ts +30 -13
- package/templates/rts/src/render/picking.ts +18 -0
- package/templates/rts/src/render/postprocessing.ts +4 -4
- package/templates/rts/src/render/quality.ts +64 -85
- package/templates/rts/src/render/resources.ts +21 -22
- package/templates/rts/src/render/sky.ts +9 -12
- package/templates/rts/src/render/terrain.ts +36 -11
- package/templates/rts/src/scenes/Play.ts +373 -38
- package/templates/rts/src/sim/ai.ts +0 -11
- package/templates/rts/src/state.ts +46 -0
- package/templates/rts/src/style.css +1543 -0
- package/templates/rts/src/ui/Commands.tsx +204 -107
- package/templates/rts/src/ui/GameUi.tsx +12 -5
- package/templates/rts/src/ui/Hud.tsx +611 -116
- package/templates/rts/src/ui/Minimap.tsx +103 -37
- package/templates/rts/src/ui/icons.tsx +116 -0
- package/templates/rts/src/ui/labels.ts +73 -0
- package/templates/rts/src/ui/minimapPoint.ts +30 -0
- package/templates/rts/threenative.config.ts +1 -1
- package/templates/runner/.codex/config.toml +6 -2
- package/templates/runner/.cursor/mcp.json +8 -2
- package/templates/runner/.gemini/settings.json +8 -2
- package/templates/runner/.mcp.json +8 -2
- package/templates/runner/.vscode/mcp.json +9 -2
- package/templates/runner/.zed/settings.json +9 -2
- package/templates/runner/AGENTS.md +12 -12
- package/templates/runner/CLAUDE.md +12 -12
- package/templates/runner/opencode.json +10 -2
- package/templates/runner/package.json +15 -10
- package/templates/runner/playtests/near-miss.playtest.json +48 -0
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/playtests/stride.playtest.json +27 -0
- package/templates/runner/playtests/survives.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +3 -1
- package/templates/runner/src/entities/Runner.ts +11 -5
- package/templates/runner/src/render/atmosphere.ts +444 -0
- package/templates/runner/src/render/backlightMaterial.ts +49 -18
- package/templates/runner/src/render/clouds.ts +605 -0
- package/templates/runner/src/render/exposure.ts +6 -111
- package/templates/runner/src/render/gpuSky.ts +752 -0
- package/templates/runner/src/render/kitExposure.ts +20 -0
- package/templates/runner/src/render/lighting.ts +26 -4
- package/templates/runner/src/render/materialLighting.ts +2 -11
- package/templates/runner/src/render/postprocessing.ts +4 -4
- package/templates/runner/src/render/quality.ts +26 -114
- package/templates/runner/src/render/sky.ts +73 -1
- package/templates/runner/src/scenes/Run.ts +19 -15
- package/templates/runner/src/track.ts +12 -3
- package/templates/sailing/.codex/config.toml +6 -2
- package/templates/sailing/.cursor/mcp.json +8 -2
- package/templates/sailing/.gemini/settings.json +8 -2
- package/templates/sailing/.mcp.json +8 -2
- package/templates/sailing/.vscode/mcp.json +9 -2
- package/templates/sailing/.zed/settings.json +9 -2
- package/templates/sailing/AGENTS.md +10 -11
- package/templates/sailing/CLAUDE.md +10 -11
- package/templates/sailing/opencode.json +10 -2
- package/templates/sailing/package.json +15 -10
- package/templates/sailing/playtests/fail.playtest.json +46 -5
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
- package/templates/sailing/playtests/performance.playtest.json +1 -1
- package/templates/sailing/src/game.ts +1 -0
- package/templates/sailing/src/render/backlightMaterial.ts +49 -18
- package/templates/sailing/src/render/exposure.ts +6 -111
- package/templates/sailing/src/render/kitExposure.ts +20 -0
- package/templates/sailing/src/render/materialLighting.ts +2 -11
- package/templates/sailing/src/render/ocean.ts +0 -1
- package/templates/sailing/src/render/postprocessing.ts +4 -4
- package/templates/sailing/src/render/quality.ts +31 -138
- package/templates/sailing/src/scenes/Sailing.ts +12 -4
- package/templates/sailing/src/ui/Hud.tsx +6 -2
- package/templates/sailing/src/ui/Menu.tsx +1 -1
- package/templates/shooter/.codex/config.toml +6 -2
- package/templates/shooter/.cursor/mcp.json +8 -2
- package/templates/shooter/.gemini/settings.json +8 -2
- package/templates/shooter/.mcp.json +8 -2
- package/templates/shooter/.vscode/mcp.json +9 -2
- package/templates/shooter/.zed/settings.json +9 -2
- package/templates/shooter/AGENTS.md +13 -12
- package/templates/shooter/CLAUDE.md +13 -12
- package/templates/shooter/index.html +1 -1
- package/templates/shooter/main.html +13 -0
- package/templates/shooter/opencode.json +10 -2
- package/templates/shooter/package.json +15 -10
- package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
- package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
- package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
- package/templates/shooter/playtests/performance.playtest.json +3 -3
- package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
- package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
- package/templates/shooter/src/entities/Breakables.ts +34 -10
- package/templates/shooter/src/entities/Enemy.ts +176 -54
- package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
- package/templates/shooter/src/entities/Rifle.ts +83 -9
- package/templates/shooter/src/entities/movement.ts +96 -0
- package/templates/shooter/src/render/atmosphere.ts +444 -0
- package/templates/shooter/src/render/backlightMaterial.ts +49 -18
- package/templates/shooter/src/render/camera.ts +3 -1
- package/templates/shooter/src/render/clouds.ts +605 -0
- package/templates/shooter/src/render/exposure.ts +10 -109
- package/templates/shooter/src/render/facade.ts +26 -68
- package/templates/shooter/src/render/gpuSky.ts +752 -0
- package/templates/shooter/src/render/lighting.ts +27 -4
- package/templates/shooter/src/render/materialAssignments.ts +9 -1
- package/templates/shooter/src/render/materialLighting.ts +2 -11
- package/templates/shooter/src/render/occlusion.ts +13 -4
- package/templates/shooter/src/render/palette.ts +1 -0
- package/templates/shooter/src/render/postprocessing.ts +4 -4
- package/templates/shooter/src/render/quality.ts +50 -108
- package/templates/shooter/src/render/scale.ts +0 -11
- package/templates/shooter/src/render/sky.ts +103 -2
- package/templates/shooter/src/render/surface.ts +140 -0
- package/templates/shooter/src/render/town.ts +3 -6
- package/templates/shooter/src/render/townMaterials.ts +95 -42
- package/templates/shooter/src/render/vehicles.ts +2 -0
- package/templates/shooter/src/scenes/Play.ts +83 -23
- package/templates/shooter/src/ui/Hud.tsx +268 -193
- package/templates/shooter/src/worker-page.ts +29 -0
- package/templates/shooter/src/worker.ts +5 -0
- package/templates/shooter/threenative.config.ts +3 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/.codex/config.toml +6 -2
- package/templates/snow/.cursor/mcp.json +8 -2
- package/templates/snow/.gemini/settings.json +8 -2
- package/templates/snow/.mcp.json +8 -2
- package/templates/snow/.vscode/mcp.json +9 -2
- package/templates/snow/.zed/settings.json +9 -2
- package/templates/snow/AGENTS.md +12 -10
- package/templates/snow/CLAUDE.md +12 -10
- package/templates/snow/opencode.json +10 -2
- package/templates/snow/package.json +15 -10
- package/templates/snow/playtests/performance.playtest.json +1 -1
- package/templates/snow/src/render/backlightMaterial.ts +49 -18
- package/templates/snow/src/render/exposure.ts +17 -106
- package/templates/snow/src/render/materialLighting.ts +2 -11
- package/templates/snow/src/render/postprocessing.ts +11 -5
- package/templates/snow/src/render/quality.ts +46 -126
- package/templates/snow/src/render/snowSurface.ts +32 -15
- package/templates/snow/src/scenes/Snow.ts +2 -1
- package/templates/starter/.codex/config.toml +6 -2
- package/templates/starter/.cursor/mcp.json +8 -2
- package/templates/starter/.gemini/settings.json +8 -2
- package/templates/starter/.mcp.json +8 -2
- package/templates/starter/.vscode/mcp.json +9 -2
- package/templates/starter/.zed/settings.json +9 -2
- package/templates/starter/AGENTS.md +18 -14
- package/templates/starter/CLAUDE.md +18 -14
- package/templates/starter/index.html +1 -1
- package/templates/starter/main.html +12 -0
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
- package/templates/starter/opencode.json +10 -2
- package/templates/starter/package.json +15 -10
- package/templates/starter/playtests/play.playtest.json +22 -2
- package/templates/starter/playtests/production-readiness.playtest.json +14 -0
- package/templates/starter/src/entities/Crate.ts +19 -1
- package/templates/starter/src/render/arena.ts +2 -2
- package/templates/starter/src/render/atmosphere.ts +444 -0
- package/templates/starter/src/render/backlightMaterial.ts +49 -18
- package/templates/starter/src/render/camera.ts +28 -0
- package/templates/starter/src/render/clouds.ts +605 -0
- package/templates/starter/src/render/contactShadow.ts +50 -0
- package/templates/starter/src/render/exposure.ts +9 -111
- package/templates/starter/src/render/gpuSky.ts +752 -0
- package/templates/starter/src/render/grade.ts +1 -1
- package/templates/starter/src/render/lighting.ts +34 -6
- package/templates/starter/src/render/materialLighting.ts +2 -11
- package/templates/starter/src/render/postprocessing.ts +27 -14
- package/templates/starter/src/render/quality.ts +18 -147
- package/templates/starter/src/render/sky.ts +90 -40
- package/templates/starter/src/render/temporalAA.ts +1 -1
- package/templates/starter/src/render/temporalAAStage.ts +1 -1
- package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
- package/templates/starter/src/render/temporalDetailStage.ts +106 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
- package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
- package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
- package/templates/starter/src/scenes/Play.ts +11 -8
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/worker-page.ts +29 -0
- package/templates/starter/src/worker.ts +5 -0
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/.codex/config.toml +6 -2
- package/templates/tower-defense/.cursor/mcp.json +8 -2
- package/templates/tower-defense/.gemini/settings.json +8 -2
- package/templates/tower-defense/.mcp.json +8 -2
- package/templates/tower-defense/.vscode/mcp.json +9 -2
- package/templates/tower-defense/.zed/settings.json +9 -2
- package/templates/tower-defense/AGENTS.md +10 -12
- package/templates/tower-defense/CLAUDE.md +10 -12
- package/templates/tower-defense/opencode.json +10 -2
- package/templates/tower-defense/package.json +15 -10
- package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
- package/templates/tower-defense/playtests/performance.playtest.json +1 -1
- package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
- package/templates/tower-defense/src/render/exposure.ts +11 -109
- package/templates/tower-defense/src/render/lighting.ts +4 -2
- package/templates/tower-defense/src/render/materialLighting.ts +2 -11
- package/templates/tower-defense/src/render/postprocessing.ts +4 -4
- package/templates/tower-defense/src/render/quality.ts +10 -116
- package/templates/tower-defense/src/render/sky.ts +2 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -0
- package/template-assets/autoExposure.ts +0 -225
- package/template-assets/exposureGraph.ts +0 -178
- package/template-assets/exposureReadback.ts +0 -79
- package/template-assets/worldEnvironment.ts +0 -1212
- package/templates/action-rpg/src/render/autoExposure.ts +0 -225
- package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
- package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
- package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
- package/templates/minimal/src/render/autoExposure.ts +0 -225
- package/templates/minimal/src/render/exposureGraph.ts +0 -178
- package/templates/minimal/src/render/exposureReadback.ts +0 -79
- package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
- package/templates/platformer/src/render/autoExposure.ts +0 -225
- package/templates/platformer/src/render/exposureGraph.ts +0 -178
- package/templates/platformer/src/render/exposureReadback.ts +0 -79
- package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
- package/templates/puzzle/src/render/autoExposure.ts +0 -225
- package/templates/puzzle/src/render/exposureGraph.ts +0 -178
- package/templates/puzzle/src/render/exposureReadback.ts +0 -79
- package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
- package/templates/racing/src/render/autoExposure.ts +0 -225
- package/templates/racing/src/render/exposureGraph.ts +0 -178
- package/templates/racing/src/render/exposureReadback.ts +0 -79
- package/templates/racing/src/render/worldEnvironment.ts +0 -1212
- package/templates/rain/src/render/autoExposure.ts +0 -225
- package/templates/rain/src/render/exposureGraph.ts +0 -178
- package/templates/rain/src/render/exposureReadback.ts +0 -79
- package/templates/rain/src/render/worldEnvironment.ts +0 -1212
- package/templates/rts/src/render/autoExposure.ts +0 -225
- package/templates/rts/src/render/exposureGraph.ts +0 -178
- package/templates/rts/src/render/exposureReadback.ts +0 -79
- package/templates/rts/src/render/worldEnvironment.ts +0 -1212
- package/templates/runner/src/render/autoExposure.ts +0 -225
- package/templates/runner/src/render/exposureGraph.ts +0 -178
- package/templates/runner/src/render/exposureReadback.ts +0 -79
- package/templates/runner/src/render/worldEnvironment.ts +0 -1212
- package/templates/sailing/src/render/autoExposure.ts +0 -225
- package/templates/sailing/src/render/exposureGraph.ts +0 -178
- package/templates/sailing/src/render/exposureReadback.ts +0 -79
- package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
- package/templates/shooter/src/render/autoExposure.ts +0 -225
- package/templates/shooter/src/render/exposureGraph.ts +0 -178
- package/templates/shooter/src/render/exposureReadback.ts +0 -79
- package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
- package/templates/snow/src/render/autoExposure.ts +0 -225
- package/templates/snow/src/render/exposureGraph.ts +0 -178
- package/templates/snow/src/render/exposureReadback.ts +0 -79
- package/templates/snow/src/render/worldEnvironment.ts +0 -1212
- package/templates/starter/src/render/autoExposure.ts +0 -225
- package/templates/starter/src/render/exposureGraph.ts +0 -178
- package/templates/starter/src/render/exposureReadback.ts +0 -79
- package/templates/starter/src/render/worldEnvironment.ts +0 -1212
- package/templates/tower-defense/src/render/autoExposure.ts +0 -225
- package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
- package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
- package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
|
@@ -0,0 +1,416 @@
|
|
|
1
|
+
// Generated for you. Camera framing is yours to edit.
|
|
2
|
+
//
|
|
3
|
+
// A third-person follow camera, written from `afterPhysics` in `scenes/Play.ts`, so it frames
|
|
4
|
+
// where the body ended up this step rather than where it was. It owns no target logic: it reads
|
|
5
|
+
// the lock-on's target, if there is one, and eases its yaw onto the line from that target through
|
|
6
|
+
// Wren. Unlocked, it holds its yaw (it starts looking north) until the mouse turns it or the lock
|
|
7
|
+
// button, pressed with nothing to lock, swings it behind Wren: "up" on the stick keeps its meaning until the player asks
|
|
8
|
+
// for a new one.
|
|
9
|
+
//
|
|
10
|
+
// Locked, it frames the fight the way Ocarina does: it slides over Wren's shoulder, drops,
|
|
11
|
+
// backs off for a tall or a close target, and aims part of the way toward the target, so Wren
|
|
12
|
+
// stands in the lower third and never hides what she fights. Its yaw, the one the stick reads,
|
|
13
|
+
// does not change: the shoulder offset and the aim only move the picture. Then it measures the
|
|
14
|
+
// picture: when Wren or the target would leave the frame, it turns the lens onto both of them and
|
|
15
|
+
// widens it, up to `FIT.maxFov`, until both fit.
|
|
16
|
+
//
|
|
17
|
+
// Then it checks the picture itself: while walls fill the front half of the way to Wren (a doorway
|
|
18
|
+
// behind her, the jamb of a nook she walks into), the arm shortens, so the camera follows her
|
|
19
|
+
// through instead of filming her past the stone.
|
|
20
|
+
import { Box3, MathUtils, type PerspectiveCamera, Quaternion, Vector3 } from "three";
|
|
21
|
+
|
|
22
|
+
const DISTANCE = 5.6;
|
|
23
|
+
const HEIGHT = 2.6;
|
|
24
|
+
/** Where it aims, above the body origin (Wren's waist): her shoulders. */
|
|
25
|
+
const AIM_HEIGHT = 0.9;
|
|
26
|
+
/** Yaw ease rate, per second. */
|
|
27
|
+
const YAW_RATE = 4;
|
|
28
|
+
/**
|
|
29
|
+
* Ease rate, per second, of the camera's place and of the lock's orbit into the fight framing: a
|
|
30
|
+
* lock that started on the fight line is off it within a few ticks, so Wren never hides the target.
|
|
31
|
+
*/
|
|
32
|
+
const FRAME_RATE = 10;
|
|
33
|
+
/** Distance kept in front of a wall the arm would pass through. */
|
|
34
|
+
const WALL_MARGIN = 0.35;
|
|
35
|
+
/** The most a pulled-in camera climbs above its usual height, unlocked. */
|
|
36
|
+
const MAX_CLIMB = 1.6;
|
|
37
|
+
/** The least height kept over the ground under the lens, so a slope behind Wren never swallows it. */
|
|
38
|
+
const GROUND_CLEARANCE = 0.45;
|
|
39
|
+
/** The shortest arm, in metres. */
|
|
40
|
+
const MIN_ARM = 0.6;
|
|
41
|
+
/** How much the arm shortens per try while walls clutter the view. */
|
|
42
|
+
const ARM_STEP = 0.75;
|
|
43
|
+
/**
|
|
44
|
+
* The most of the view (a 6 by 4 grid of rays) that walls in the front `reach` of the way to Wren
|
|
45
|
+
* may cover before the arm shortens: stricter than the playtests' half-way and 20%, for margin.
|
|
46
|
+
*/
|
|
47
|
+
const CLUTTER = { reach: 0.6, share: 2 / 24 };
|
|
48
|
+
const FOV = 55;
|
|
49
|
+
/** Mouse look: radians of yaw per pixel of relative movement, the same feel as Hop Garden. */
|
|
50
|
+
const LOOK_RADIANS_PER_PIXEL = 0.0035;
|
|
51
|
+
/**
|
|
52
|
+
* The fastest the view may turn, in radians per second (140°/s, about 2.3° a 60 Hz tick): a lock,
|
|
53
|
+
* a target switch or a boss charging past swings the picture no faster, so it reads instead of
|
|
54
|
+
* smearing. A snap (respawn, room change) is a cut and ignores it. So does the mouse: the cap holds
|
|
55
|
+
* back the camera's own swings, never a turn the player asked for, or the camera would orbit Wren
|
|
56
|
+
* at once while the picture lagged and she slid out of the frame.
|
|
57
|
+
*/
|
|
58
|
+
const MAX_TURN = MathUtils.degToRad(140);
|
|
59
|
+
/** Seconds after a mouse movement that the view turns as fast as the arm follows the yaw. */
|
|
60
|
+
const LOOK_HOLD = 0.6;
|
|
61
|
+
/** Wren's body around her origin (her waist), for the framing: soles to the top of her cap. */
|
|
62
|
+
const HERO = { below: 0.85, above: 0.95, radius: 0.35 };
|
|
63
|
+
/** Locked framing: both bodies stay inside `share` of the frame, the lens never wider than this. */
|
|
64
|
+
const FIT = { share: 0.8, maxFov: 75 };
|
|
65
|
+
|
|
66
|
+
/** The locked framing: every number a fight's picture depends on. */
|
|
67
|
+
const LOCK = {
|
|
68
|
+
/** Metres beside Wren, over her shoulder on the side the camera orbits to. */
|
|
69
|
+
shoulder: 0.7,
|
|
70
|
+
/**
|
|
71
|
+
* Radians the camera swings round Wren to her right while it keeps aiming down the fight: the
|
|
72
|
+
* shoulder offset alone leaves a target 3-8 m ahead behind her on screen. A far target needs
|
|
73
|
+
* `orbit`; each metre closer than `orbitFrom` adds `orbitPerMetre`, up to `orbitMax`.
|
|
74
|
+
*/
|
|
75
|
+
orbit: 0.25,
|
|
76
|
+
orbitFrom: 6,
|
|
77
|
+
orbitPerMetre: 0.11,
|
|
78
|
+
orbitMax: 0.75,
|
|
79
|
+
/**
|
|
80
|
+
* A target taller than `bigAt` metres (the Warden) swings on faster, `bigPerMetre`, up to
|
|
81
|
+
* `bigOrbitMax` (from 2.8 m in), so its chest reads beside Wren, not behind her: a sideways
|
|
82
|
+
* step or a higher camera barely moves a 9 m arm's picture. 65° is measured: a narrower orbit
|
|
83
|
+
* lets her cover over a third of the chest ring, a wider one turns the ring edge-on. A small
|
|
84
|
+
* target keeps the gentle ramp: on the steep one a bat swooping past her comes round to the
|
|
85
|
+
* lens side.
|
|
86
|
+
*/
|
|
87
|
+
bigAt: 2,
|
|
88
|
+
bigPerMetre: 0.275,
|
|
89
|
+
bigOrbitMax: MathUtils.degToRad(65),
|
|
90
|
+
/** Metres added to the arm while locked. */
|
|
91
|
+
back: 1,
|
|
92
|
+
/** Metres added when the target is closer than `closeAt`, so Wren never hides it. */
|
|
93
|
+
closeBack: 1.5,
|
|
94
|
+
closeAt: 3,
|
|
95
|
+
/** Metres added per metre the target stands taller than Wren, up to `tallMax`. */
|
|
96
|
+
tallBack: 0.8,
|
|
97
|
+
tallMax: 2,
|
|
98
|
+
/** The arm never grows past this. */
|
|
99
|
+
maxDistance: 9,
|
|
100
|
+
/** How much lower than `HEIGHT` the camera sits. */
|
|
101
|
+
drop: 0.6,
|
|
102
|
+
/** The share of the way the aim moves from Wren's shoulders toward the target's middle. */
|
|
103
|
+
aimPull: 0.45,
|
|
104
|
+
/** The steepest the camera looks down at its aim. */
|
|
105
|
+
maxPitch: MathUtils.degToRad(35),
|
|
106
|
+
/**
|
|
107
|
+
* The camera holds its yaw while the fight line stays inside this angle of it, and turns only to
|
|
108
|
+
* keep the line at the edge, as Ocarina's Z-target camera does: it never chases a target that
|
|
109
|
+
* steps or circles a little. zeldaret/oot `z_camera.c` Camera_Battle1 turns the eye only while
|
|
110
|
+
* the target sits outside `swingAngle`, here its far value, 10° + (80° - 10°) × (1.1 - 1)
|
|
111
|
+
* (`z_camera_data.inc.c` sSetNormal0ModeZTargetUnfriendlyData). A wall only pulls the arm in.
|
|
112
|
+
*/
|
|
113
|
+
cone: MathUtils.degToRad(17),
|
|
114
|
+
};
|
|
115
|
+
|
|
116
|
+
/** A ray from `from` to `to`; returns the first hit, or undefined when nothing is in the way. */
|
|
117
|
+
export type CameraBlocker = (
|
|
118
|
+
from: Vector3,
|
|
119
|
+
to: Vector3,
|
|
120
|
+
) => { readonly distance: number; readonly normal: { readonly y: number } } | undefined;
|
|
121
|
+
|
|
122
|
+
/** The locked target, as the camera frames it: its live bounds and the marker's top. */
|
|
123
|
+
export interface ILockFrame {
|
|
124
|
+
readonly bounds: Box3;
|
|
125
|
+
readonly markerTop: number;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
export interface IFollowCamera {
|
|
129
|
+
/** The yaw the camera sits at around Wren: 0 puts it south of her, looking north. */
|
|
130
|
+
readonly yaw: number;
|
|
131
|
+
/** `watch`: a body kept in the picture with nothing locked, such as a boss that just woke. */
|
|
132
|
+
update(focus: Vector3, lock: ILockFrame | undefined, dt: number, watch?: Box3): void;
|
|
133
|
+
/** Swing round to `yaw` and stay there: the target button with nothing to lock recentres. */
|
|
134
|
+
recenter(yaw: number): void;
|
|
135
|
+
/** Turn the view by a mouse movement of `dx` pixels (right turns right); the lock overrides it. */
|
|
136
|
+
look(dx: number): void;
|
|
137
|
+
/** Jump to a pose at once: after a respawn or a room change, never ease across the map. */
|
|
138
|
+
snap(focus: Vector3, yaw?: number): void;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/**
|
|
142
|
+
* `floor(x, z)` is the ground's height under the lens; the camera keeps `GROUND_CLEARANCE` over it.
|
|
143
|
+
* The default has no floor: the arm's rays alone keep it out of walls.
|
|
144
|
+
*/
|
|
145
|
+
export function setupCamera(
|
|
146
|
+
camera: PerspectiveCamera,
|
|
147
|
+
blocked: CameraBlocker,
|
|
148
|
+
floor: (x: number, z: number) => number = () => Number.NEGATIVE_INFINITY,
|
|
149
|
+
): IFollowCamera {
|
|
150
|
+
camera.fov = FOV;
|
|
151
|
+
camera.near = 0.1;
|
|
152
|
+
camera.far = 600;
|
|
153
|
+
camera.updateProjectionMatrix();
|
|
154
|
+
let yaw = 0;
|
|
155
|
+
// Unlocked, the camera holds this yaw; a lock swings it onto the target line and leaves it there.
|
|
156
|
+
let home = 0;
|
|
157
|
+
// 0 unlocked, 1 locked, eased between, so a lock glides into the fight framing.
|
|
158
|
+
let locked = 0;
|
|
159
|
+
let extra = 0;
|
|
160
|
+
let swing = LOCK.orbit;
|
|
161
|
+
// The shoulder the camera rides over, kept while a lock eases out.
|
|
162
|
+
let side = 1;
|
|
163
|
+
let watching = false;
|
|
164
|
+
// The view's orientation last tick: the next one turns from it by at most MAX_TURN.
|
|
165
|
+
const held = new Quaternion();
|
|
166
|
+
// Seconds left that the mouse has the view free of MAX_TURN.
|
|
167
|
+
let looked = 0;
|
|
168
|
+
const pivot = new Vector3();
|
|
169
|
+
const desired = new Vector3();
|
|
170
|
+
const aim = new Vector3();
|
|
171
|
+
const goalAim = new Vector3();
|
|
172
|
+
const middle = new Vector3();
|
|
173
|
+
const direction = new Vector3();
|
|
174
|
+
const forward = new Vector3();
|
|
175
|
+
const across = new Vector3();
|
|
176
|
+
const lift = new Vector3();
|
|
177
|
+
const ray = new Vector3();
|
|
178
|
+
const UP = new Vector3(0, 1, 0);
|
|
179
|
+
const heroBox = new Box3();
|
|
180
|
+
const corner = new Vector3();
|
|
181
|
+
const shift = new Vector3();
|
|
182
|
+
const goalShift = new Vector3();
|
|
183
|
+
const look = new Vector3();
|
|
184
|
+
const extent = { x0: 0, x1: 0, y0: 0, y1: 0 };
|
|
185
|
+
// Widens `extent` by a box's corners, as view-space tangents; false when one is behind the lens.
|
|
186
|
+
const measure = (box: Box3): boolean => {
|
|
187
|
+
for (let i = 0; i < 8; i += 1) {
|
|
188
|
+
corner.set(
|
|
189
|
+
i & 1 ? box.max.x : box.min.x,
|
|
190
|
+
i & 2 ? box.max.y : box.min.y,
|
|
191
|
+
i & 4 ? box.max.z : box.min.z,
|
|
192
|
+
);
|
|
193
|
+
corner.applyMatrix4(camera.matrixWorldInverse);
|
|
194
|
+
const depth = -corner.z;
|
|
195
|
+
if (depth < 0.2) return false;
|
|
196
|
+
extent.x0 = Math.min(extent.x0, corner.x / depth);
|
|
197
|
+
extent.x1 = Math.max(extent.x1, corner.x / depth);
|
|
198
|
+
extent.y0 = Math.min(extent.y0, corner.y / depth);
|
|
199
|
+
extent.y1 = Math.max(extent.y1, corner.y / depth);
|
|
200
|
+
}
|
|
201
|
+
return true;
|
|
202
|
+
};
|
|
203
|
+
// The share of the view from `desired` toward the aim that a wall or ceiling (a hit not facing
|
|
204
|
+
// up) covers near the lens: the grid `scenes/Play.ts` measures.
|
|
205
|
+
const clutter = (): number => {
|
|
206
|
+
const reach = desired.distanceTo(goalAim) * CLUTTER.reach;
|
|
207
|
+
forward.subVectors(goalAim, desired).normalize();
|
|
208
|
+
across.crossVectors(forward, UP).normalize();
|
|
209
|
+
lift.crossVectors(across, forward);
|
|
210
|
+
const tall = Math.tan(MathUtils.degToRad(camera.fov / 2));
|
|
211
|
+
let walls = 0;
|
|
212
|
+
for (let u = -0.75; u <= 0.76; u += 0.3)
|
|
213
|
+
for (let v = -0.75; v <= 0.76; v += 0.5) {
|
|
214
|
+
ray
|
|
215
|
+
.copy(forward)
|
|
216
|
+
.addScaledVector(across, u * tall * camera.aspect)
|
|
217
|
+
.addScaledVector(lift, v * tall)
|
|
218
|
+
.setLength(reach)
|
|
219
|
+
.add(desired);
|
|
220
|
+
const hit = blocked(desired, ray);
|
|
221
|
+
if (hit !== undefined && hit.normal.y < 0.7) walls += 1;
|
|
222
|
+
}
|
|
223
|
+
return walls / 24;
|
|
224
|
+
};
|
|
225
|
+
// Locked, or with a boss awake (`watch`), turn the lens onto Wren and that body and widen it
|
|
226
|
+
// until both fit; it eases at the camera's own rate, not the lock's, so a fight never opens with
|
|
227
|
+
// Wren's feet or the boss's head off the frame.
|
|
228
|
+
const frame = (focus: Vector3, box: Box3 | undefined, ease: number): void => {
|
|
229
|
+
let fov = FOV;
|
|
230
|
+
goalShift.set(0, 0, 0);
|
|
231
|
+
if (box !== undefined) {
|
|
232
|
+
camera.updateMatrixWorld();
|
|
233
|
+
heroBox.min.set(focus.x - HERO.radius, focus.y - HERO.below, focus.z - HERO.radius);
|
|
234
|
+
heroBox.max.set(focus.x + HERO.radius, focus.y + HERO.above, focus.z + HERO.radius);
|
|
235
|
+
Object.assign(extent, {
|
|
236
|
+
x0: Number.POSITIVE_INFINITY,
|
|
237
|
+
x1: Number.NEGATIVE_INFINITY,
|
|
238
|
+
y0: Number.POSITIVE_INFINITY,
|
|
239
|
+
y1: Number.NEGATIVE_INFINITY,
|
|
240
|
+
});
|
|
241
|
+
if (measure(heroBox) && measure(box)) {
|
|
242
|
+
const half = Math.max(
|
|
243
|
+
(extent.y1 - extent.y0) / 2,
|
|
244
|
+
(extent.x1 - extent.x0) / 2 / camera.aspect,
|
|
245
|
+
);
|
|
246
|
+
fov = MathUtils.clamp(MathUtils.radToDeg(2 * Math.atan(half / FIT.share)), FOV, FIT.maxFov);
|
|
247
|
+
look.set((extent.x0 + extent.x1) / 2, (extent.y0 + extent.y1) / 2, -1);
|
|
248
|
+
look.transformDirection(camera.matrixWorld).multiplyScalar(aim.distanceTo(camera.position));
|
|
249
|
+
goalShift.copy(camera.position).add(look).sub(aim);
|
|
250
|
+
} else goalShift.copy(shift);
|
|
251
|
+
}
|
|
252
|
+
shift.lerp(goalShift, ease);
|
|
253
|
+
if (Math.abs(camera.fov - fov) > 0.01) {
|
|
254
|
+
camera.fov += (fov - camera.fov) * ease;
|
|
255
|
+
camera.updateProjectionMatrix();
|
|
256
|
+
}
|
|
257
|
+
camera.lookAt(look.copy(aim).add(shift));
|
|
258
|
+
};
|
|
259
|
+
// Lays the arm out at `view` into `pivot` and `desired`; returns where a wall cuts it.
|
|
260
|
+
const arm = (
|
|
261
|
+
focus: Vector3,
|
|
262
|
+
view: number,
|
|
263
|
+
distance: number,
|
|
264
|
+
right: number,
|
|
265
|
+
): number | undefined => {
|
|
266
|
+
pivot.set(
|
|
267
|
+
focus.x + Math.cos(view) * right,
|
|
268
|
+
focus.y + AIM_HEIGHT + 0.4,
|
|
269
|
+
focus.z - Math.sin(view) * right,
|
|
270
|
+
);
|
|
271
|
+
desired.set(
|
|
272
|
+
pivot.x + Math.sin(view) * distance,
|
|
273
|
+
focus.y + HEIGHT - LOCK.drop * locked,
|
|
274
|
+
pivot.z + Math.cos(view) * distance,
|
|
275
|
+
);
|
|
276
|
+
return blocked(pivot, desired)?.distance;
|
|
277
|
+
};
|
|
278
|
+
// Puts `desired` `length` along the arm. Unlocked, a short arm climbs instead of ending at the
|
|
279
|
+
// back of her head, and a second ray keeps that climb under the ceiling. Locked, the shoulder
|
|
280
|
+
// offset already clears her head.
|
|
281
|
+
const lay = (length: number, distance: number): void => {
|
|
282
|
+
desired.copy(pivot).addScaledVector(direction, length);
|
|
283
|
+
desired.y += Math.min(MAX_CLIMB, (distance - length) * 0.5) * (1 - locked);
|
|
284
|
+
const roof = blocked(pivot, desired)?.distance;
|
|
285
|
+
if (roof !== undefined) {
|
|
286
|
+
ray.subVectors(desired, pivot).normalize();
|
|
287
|
+
desired.copy(pivot).addScaledVector(ray, Math.max(MIN_ARM, roof - WALL_MARGIN));
|
|
288
|
+
}
|
|
289
|
+
};
|
|
290
|
+
const place = (focus: Vector3, box: Box3 | undefined, ease: number, fit = ease): void => {
|
|
291
|
+
const distance = DISTANCE + extra * locked;
|
|
292
|
+
// The picture's yaw: the stick's yaw, swung right while locked.
|
|
293
|
+
const view = yaw + swing * locked;
|
|
294
|
+
const hit = arm(focus, view, distance, LOCK.shoulder * locked * side);
|
|
295
|
+
direction.subVectors(desired, pivot).normalize();
|
|
296
|
+
// Pull the arm in in front of a wall, so the camera never ends up inside one or behind it, then
|
|
297
|
+
// shorter while walls clutter the view; when no length clears it, the least cluttered one.
|
|
298
|
+
let length = hit === undefined ? distance : Math.max(MIN_ARM, hit - WALL_MARGIN);
|
|
299
|
+
let best = length;
|
|
300
|
+
let least = Number.POSITIVE_INFINITY;
|
|
301
|
+
for (;;) {
|
|
302
|
+
lay(length, distance);
|
|
303
|
+
const share = clutter();
|
|
304
|
+
if (share < least) {
|
|
305
|
+
least = share;
|
|
306
|
+
best = length;
|
|
307
|
+
}
|
|
308
|
+
if (share <= CLUTTER.share || length <= MIN_ARM) break;
|
|
309
|
+
length = Math.max(MIN_ARM, length - ARM_STEP);
|
|
310
|
+
}
|
|
311
|
+
if (best !== length) lay(best, distance);
|
|
312
|
+
aim.lerp(goalAim, ease);
|
|
313
|
+
// Locked, never steeper than LOCK.maxPitch: a steep camera loses the target off the top.
|
|
314
|
+
const run = Math.hypot(desired.x - aim.x, desired.z - aim.z);
|
|
315
|
+
const cap = aim.y + run * Math.tan(LOCK.maxPitch);
|
|
316
|
+
if (desired.y > cap) desired.y = MathUtils.lerp(desired.y, cap, locked);
|
|
317
|
+
desired.y = Math.max(desired.y, floor(desired.x, desired.z) + GROUND_CLEARANCE);
|
|
318
|
+
camera.position.lerp(desired, ease);
|
|
319
|
+
// Easing toward a pose a wall just cut short can cross that wall: then it cuts, never eases.
|
|
320
|
+
if (blocked(pivot, camera.position) !== undefined) camera.position.copy(desired);
|
|
321
|
+
const { x, z } = camera.position;
|
|
322
|
+
camera.position.y = Math.max(camera.position.y, floor(x, z) + GROUND_CLEARANCE);
|
|
323
|
+
camera.lookAt(aim);
|
|
324
|
+
frame(focus, box, fit);
|
|
325
|
+
};
|
|
326
|
+
const aimAt = (focus: Vector3, lock: ILockFrame | undefined): void => {
|
|
327
|
+
goalAim.set(focus.x, focus.y + AIM_HEIGHT, focus.z);
|
|
328
|
+
if (lock === undefined) return;
|
|
329
|
+
lock.bounds.getCenter(middle);
|
|
330
|
+
middle.y = (lock.bounds.min.y + Math.max(lock.bounds.max.y, lock.markerTop)) / 2;
|
|
331
|
+
goalAim.lerp(middle, LOCK.aimPull);
|
|
332
|
+
};
|
|
333
|
+
return {
|
|
334
|
+
get yaw(): number {
|
|
335
|
+
return yaw;
|
|
336
|
+
},
|
|
337
|
+
update(focus: Vector3, lock: ILockFrame | undefined, dt: number, watch?: Box3): void {
|
|
338
|
+
const rate = 1 - Math.exp(-YAW_RATE * dt);
|
|
339
|
+
const quick = 1 - Math.exp(-FRAME_RATE * dt);
|
|
340
|
+
if (lock !== undefined) {
|
|
341
|
+
lock.bounds.getCenter(middle);
|
|
342
|
+
const line = Math.atan2(focus.x - middle.x, focus.z - middle.z);
|
|
343
|
+
// The cone opens only on the orbit's side: a yaw that drifted across the line would bring
|
|
344
|
+
// the picture back onto it, and Wren would hide the target.
|
|
345
|
+
const off = MathUtils.euclideanModulo(yaw - line + Math.PI, Math.PI * 2) - Math.PI;
|
|
346
|
+
const big = lock.bounds.max.y - lock.bounds.min.y > LOCK.bigAt;
|
|
347
|
+
// A big target keeps orbit plus cone inside its orbit cap: the cone drifted the Warden's
|
|
348
|
+
// picture 82° round, where its chest ring turned edge-on to the lens.
|
|
349
|
+
const cone = big
|
|
350
|
+
? MathUtils.clamp(LOCK.bigOrbitMax - Math.abs(swing), 0, LOCK.cone)
|
|
351
|
+
: LOCK.cone;
|
|
352
|
+
home = line + MathUtils.clamp(off, Math.min(0, side * cone), Math.max(0, side * cone));
|
|
353
|
+
const apart = Math.hypot(focus.x - middle.x, focus.z - middle.z);
|
|
354
|
+
const tall = Math.max(lock.bounds.max.y, lock.markerTop) - (focus.y + AIM_HEIGHT + 1);
|
|
355
|
+
const goal =
|
|
356
|
+
LOCK.back +
|
|
357
|
+
(apart < LOCK.closeAt ? LOCK.closeBack : 0) +
|
|
358
|
+
MathUtils.clamp(tall * LOCK.tallBack, 0, LOCK.tallMax);
|
|
359
|
+
extra += (Math.min(goal, LOCK.maxDistance - DISTANCE) - extra) * rate;
|
|
360
|
+
// It orbits on the side of the fight line it already films from, so a new lock or a target
|
|
361
|
+
// switch never swings the picture across the line, where Wren would hide the target.
|
|
362
|
+
const onLine = MathUtils.euclideanModulo(
|
|
363
|
+
yaw + swing * locked - line + Math.PI,
|
|
364
|
+
Math.PI * 2,
|
|
365
|
+
);
|
|
366
|
+
const wantSwing =
|
|
367
|
+
Math.sign(onLine - Math.PI || 1) *
|
|
368
|
+
MathUtils.clamp(
|
|
369
|
+
LOCK.orbit + (LOCK.orbitFrom - apart) * (big ? LOCK.bigPerMetre : LOCK.orbitPerMetre),
|
|
370
|
+
LOCK.orbit,
|
|
371
|
+
big ? LOCK.bigOrbitMax : LOCK.orbitMax,
|
|
372
|
+
);
|
|
373
|
+
swing += (wantSwing - swing) * quick;
|
|
374
|
+
side = Math.sign(swing || side);
|
|
375
|
+
} else if (locked > 0) {
|
|
376
|
+
// A lock that ends leaves the picture where it is, as Ocarina's normal camera starts from
|
|
377
|
+
// the eye the Z-target camera left: the orbit folds into the yaw, so nothing swings back.
|
|
378
|
+
yaw += swing * locked;
|
|
379
|
+
home = yaw;
|
|
380
|
+
swing = 0;
|
|
381
|
+
}
|
|
382
|
+
locked += ((lock === undefined ? 0 : 1) - locked) * quick;
|
|
383
|
+
const turn = MathUtils.euclideanModulo(home - yaw + Math.PI, Math.PI * 2) - Math.PI;
|
|
384
|
+
yaw += turn * rate;
|
|
385
|
+
aimAt(focus, lock);
|
|
386
|
+
// A boss that just woke is framed at once, a reveal cut; then the fit eases as a lock's does.
|
|
387
|
+
const reveal = watch !== undefined && !watching && lock === undefined;
|
|
388
|
+
watching = watch !== undefined;
|
|
389
|
+
place(focus, lock?.bounds ?? watch, quick, reveal ? 1 : quick);
|
|
390
|
+
// A lock owns the view at once, even inside a look's hold: its swing keeps the cap.
|
|
391
|
+
if (lock !== undefined) looked = 0;
|
|
392
|
+
if (looked > 0) {
|
|
393
|
+
looked -= dt;
|
|
394
|
+
held.copy(camera.quaternion);
|
|
395
|
+
} else camera.quaternion.copy(held.rotateTowards(camera.quaternion, MAX_TURN * dt));
|
|
396
|
+
},
|
|
397
|
+
recenter(to: number): void {
|
|
398
|
+
home = to;
|
|
399
|
+
},
|
|
400
|
+
look(dx: number): void {
|
|
401
|
+
if (dx !== 0) looked = LOOK_HOLD;
|
|
402
|
+
yaw -= dx * LOOK_RADIANS_PER_PIXEL;
|
|
403
|
+
home -= dx * LOOK_RADIANS_PER_PIXEL;
|
|
404
|
+
},
|
|
405
|
+
snap(focus: Vector3, to = 0): void {
|
|
406
|
+
yaw = to;
|
|
407
|
+
home = to;
|
|
408
|
+
locked = 0;
|
|
409
|
+
aimAt(focus, undefined);
|
|
410
|
+
aim.copy(goalAim);
|
|
411
|
+
shift.set(0, 0, 0);
|
|
412
|
+
place(focus, undefined, 1);
|
|
413
|
+
held.copy(camera.quaternion);
|
|
414
|
+
},
|
|
415
|
+
};
|
|
416
|
+
}
|