create-threenative 0.2.7 → 0.2.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -1
- package/agent-docs/references/assertion-reference.md +87 -35
- package/agent-docs/references/auto-exposure.md +57 -0
- package/agent-docs/references/capability-reference.md +1306 -62
- package/agent-docs/references/debug-surface.md +6 -0
- package/agent-docs/references/finding-assets.md +46 -10
- package/agent-docs/references/performance-basics.md +5 -4
- package/agent-docs/references/terrain-authoring.md +140 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
- package/capabilities.json +1505 -79
- package/dist/index.d.ts +28 -3
- package/dist/index.js +402 -167
- package/dist/threenative.js +989 -237
- package/dist/web-engine-buffer-geometry-utils.js +281 -0
- package/dist/web-engine-decal-geometry.js +184 -0
- package/dist/web-engine-gltf-loader.js +196 -0
- package/dist/web-engine-hdr-loader.js +190 -0
- package/dist/web-engine-lut-cube-loader.js +122 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
- package/dist/web-engine-mesh-bvh.js +32 -0
- package/dist/web-engine-post-effects.js +168 -0
- package/dist/web-engine-runtime.js +42506 -0
- package/package.json +11 -8
- package/template-assets/autoExposure.ts +225 -0
- package/template-assets/exposure.ts +111 -0
- package/template-assets/exposureGraph.ts +178 -0
- package/template-assets/exposureReadback.ts +79 -0
- package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
- package/template-assets/patches/three@0.185.1.patch +6594 -700
- package/template-assets/patches/vite@8.2.0.patch +422 -0
- package/template-assets/worldEnvironment.ts +433 -30
- package/templates/action-rpg/AGENTS.md +11 -10
- package/templates/action-rpg/CLAUDE.md +11 -10
- package/templates/action-rpg/package.json +11 -9
- package/templates/action-rpg/playtests/performance.playtest.json +7 -1
- package/templates/action-rpg/src/progress.ts +0 -4
- package/templates/action-rpg/src/render/autoExposure.ts +225 -0
- package/templates/action-rpg/src/render/backlightControls.ts +66 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
- package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
- package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
- package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
- package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
- package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
- package/templates/action-rpg/src/render/exposure.ts +111 -0
- package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
- package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
- package/templates/action-rpg/src/render/heightFog.ts +118 -0
- package/templates/action-rpg/src/render/lighting.ts +26 -1
- package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
- package/templates/action-rpg/src/render/materialLighting.ts +155 -0
- package/templates/action-rpg/src/render/postprocessing.ts +17 -2
- package/templates/action-rpg/src/render/quality.ts +61 -2
- package/templates/action-rpg/src/render/sky.ts +21 -1
- package/templates/action-rpg/src/render/vfx.ts +133 -58
- package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
- package/templates/action-rpg/src/scenes/Play.ts +81 -16
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/action-rpg/vite.config.ts +10 -2
- package/templates/minimal/AGENTS.md +9 -10
- package/templates/minimal/CLAUDE.md +9 -10
- package/templates/minimal/package.json +9 -8
- package/templates/minimal/playtests/play.playtest.json +7 -1
- package/templates/minimal/playtests/sky.playtest.json +10 -1
- package/templates/minimal/src/render/autoExposure.ts +225 -0
- package/templates/minimal/src/render/backlightControls.ts +66 -0
- package/templates/minimal/src/render/backlightMaterial.ts +147 -0
- package/templates/minimal/src/render/environmentContribution.ts +188 -0
- package/templates/minimal/src/render/environmentRadiance.ts +36 -0
- package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
- package/templates/minimal/src/render/environmentSampling.ts +193 -0
- package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
- package/templates/minimal/src/render/exposure.ts +111 -0
- package/templates/minimal/src/render/exposureGraph.ts +178 -0
- package/templates/minimal/src/render/exposureReadback.ts +79 -0
- package/templates/minimal/src/render/heightFog.ts +118 -0
- package/templates/minimal/src/render/lighting.ts +25 -1
- package/templates/minimal/src/render/materialAssignments.ts +102 -0
- package/templates/minimal/src/render/materialLighting.ts +146 -0
- package/templates/minimal/src/render/postprocessing.ts +16 -2
- package/templates/minimal/src/render/quality.ts +60 -2
- package/templates/minimal/src/render/sky.ts +21 -1
- package/templates/minimal/src/render/worldEnvironment.ts +433 -30
- package/templates/minimal/src/scenes/Play.ts +50 -1
- package/templates/minimal/vite.config.ts +10 -2
- package/templates/platformer/AGENTS.md +7 -5
- package/templates/platformer/CLAUDE.md +7 -5
- package/templates/platformer/package.json +11 -9
- package/templates/platformer/playtests/performance.playtest.json +7 -1
- package/templates/platformer/src/render/autoExposure.ts +225 -0
- package/templates/platformer/src/render/backlightControls.ts +66 -0
- package/templates/platformer/src/render/backlightMaterial.ts +147 -0
- package/templates/platformer/src/render/environmentContribution.ts +188 -0
- package/templates/platformer/src/render/environmentRadiance.ts +36 -0
- package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
- package/templates/platformer/src/render/environmentSampling.ts +193 -0
- package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
- package/templates/platformer/src/render/exposure.ts +111 -0
- package/templates/platformer/src/render/exposureGraph.ts +178 -0
- package/templates/platformer/src/render/exposureReadback.ts +79 -0
- package/templates/platformer/src/render/heightFog.ts +118 -0
- package/templates/platformer/src/render/lighting.ts +26 -1
- package/templates/platformer/src/render/materialAssignments.ts +160 -0
- package/templates/platformer/src/render/materialLighting.ts +155 -0
- package/templates/platformer/src/render/materials.ts +7 -2
- package/templates/platformer/src/render/palette.ts +3 -3
- package/templates/platformer/src/render/postprocessing.ts +17 -2
- package/templates/platformer/src/render/quality.ts +61 -2
- package/templates/platformer/src/render/sky.ts +72 -23
- package/templates/platformer/src/render/skyEnvironment.ts +50 -0
- package/templates/platformer/src/render/worldEnvironment.ts +433 -30
- package/templates/platformer/src/scenes/Play.ts +70 -6
- package/templates/platformer/vite.config.ts +10 -2
- package/templates/puzzle/AGENTS.md +10 -9
- package/templates/puzzle/CLAUDE.md +10 -9
- package/templates/puzzle/package.json +11 -9
- package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
- package/templates/puzzle/playtests/lit.playtest.json +7 -1
- package/templates/puzzle/playtests/performance.playtest.json +7 -1
- package/templates/puzzle/src/render/autoExposure.ts +225 -0
- package/templates/puzzle/src/render/backlightControls.ts +66 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
- package/templates/puzzle/src/render/environmentContribution.ts +188 -0
- package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
- package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
- package/templates/puzzle/src/render/environmentSampling.ts +193 -0
- package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
- package/templates/puzzle/src/render/exposure.ts +111 -0
- package/templates/puzzle/src/render/exposureGraph.ts +178 -0
- package/templates/puzzle/src/render/exposureReadback.ts +79 -0
- package/templates/puzzle/src/render/heightFog.ts +118 -0
- package/templates/puzzle/src/render/lighting.ts +33 -1
- package/templates/puzzle/src/render/materialAssignments.ts +160 -0
- package/templates/puzzle/src/render/materialLighting.ts +155 -0
- package/templates/puzzle/src/render/materials.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +8 -2
- package/templates/puzzle/src/render/quality.ts +62 -1
- package/templates/puzzle/src/render/sky.ts +20 -1
- package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
- package/templates/puzzle/src/scenes/Play.ts +51 -2
- package/templates/puzzle/vite.config.ts +10 -2
- package/templates/racing/AGENTS.md +8 -7
- package/templates/racing/CLAUDE.md +8 -7
- package/templates/racing/package.json +11 -9
- package/templates/racing/playtests/performance.playtest.json +7 -1
- package/templates/racing/playtests/survives.playtest.json +6 -0
- package/templates/racing/src/render/autoExposure.ts +225 -0
- package/templates/racing/src/render/backlightControls.ts +66 -0
- package/templates/racing/src/render/backlightMaterial.ts +147 -0
- package/templates/racing/src/render/environmentContribution.ts +188 -0
- package/templates/racing/src/render/environmentRadiance.ts +36 -0
- package/templates/racing/src/render/environmentSampleCache.ts +43 -0
- package/templates/racing/src/render/environmentSampling.ts +193 -0
- package/templates/racing/src/render/environmentSnapshot.ts +53 -0
- package/templates/racing/src/render/exposure.ts +111 -0
- package/templates/racing/src/render/exposureGraph.ts +178 -0
- package/templates/racing/src/render/exposureReadback.ts +79 -0
- package/templates/racing/src/render/heightFog.ts +118 -0
- package/templates/racing/src/render/lighting.ts +29 -1
- package/templates/racing/src/render/materialAssignments.ts +160 -0
- package/templates/racing/src/render/materialLighting.ts +155 -0
- package/templates/racing/src/render/palette.ts +1 -10
- package/templates/racing/src/render/postprocessing.ts +17 -2
- package/templates/racing/src/render/quality.ts +61 -2
- package/templates/racing/src/render/shapes.ts +0 -25
- package/templates/racing/src/render/sky.ts +21 -1
- package/templates/racing/src/render/worldEnvironment.ts +433 -30
- package/templates/racing/src/scenes/Race.ts +91 -3
- package/templates/racing/src/track/circuit.ts +0 -9
- package/templates/racing/vite.config.ts +10 -2
- package/templates/rain/.codex/config.toml +19 -0
- package/templates/rain/.cursor/mcp.json +32 -0
- package/templates/rain/.gemini/settings.json +32 -0
- package/templates/rain/.mcp.json +32 -0
- package/templates/rain/.vscode/mcp.json +36 -0
- package/templates/rain/.zed/settings.json +36 -0
- package/templates/rain/AGENTS.md +95 -0
- package/templates/rain/CLAUDE.md +97 -0
- package/templates/rain/assets/rain-loop.wav +0 -0
- package/templates/rain/assets/thunder.wav +0 -0
- package/templates/rain/assets/wind-loop.wav +0 -0
- package/templates/rain/index.html +18 -0
- package/templates/rain/kit.json +7 -0
- package/templates/rain/native-playtests/boot.playtest.json +23 -0
- package/templates/rain/native-playtests/lightning.playtest.json +173 -0
- package/templates/rain/opencode.json +41 -0
- package/templates/rain/package.json +59 -0
- package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
- package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
- package/templates/rain/playtests/automation.playtest.json +133 -0
- package/templates/rain/playtests/cinematic.playtest.json +59 -0
- package/templates/rain/playtests/flash.playtest.json +27 -0
- package/templates/rain/playtests/fly.playtest.json +54 -0
- package/templates/rain/playtests/lightning.playtest.json +220 -0
- package/templates/rain/playtests/loading.playtest.json +57 -0
- package/templates/rain/playtests/paused.playtest.json +59 -0
- package/templates/rain/playtests/performance.playtest.json +32 -0
- package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
- package/templates/rain/playtests/simulation.playtest.json +20 -0
- package/templates/rain/playtests/storm.playtest.json +150 -0
- package/templates/rain/playtests/survives.playtest.json +58 -0
- package/templates/rain/playtests/tiers.playtest.json +194 -0
- package/templates/rain/playtests/weather.playtest.json +77 -0
- package/templates/rain/public/favicon.svg +5 -0
- package/templates/rain/src/audio/storm.ts +314 -0
- package/templates/rain/src/game.ts +81 -0
- package/templates/rain/src/main.ts +15 -0
- package/templates/rain/src/render/autoExposure.ts +225 -0
- package/templates/rain/src/render/bloom-shader.ts +65 -0
- package/templates/rain/src/render/camera.ts +160 -0
- package/templates/rain/src/render/clouds-shader.ts +242 -0
- package/templates/rain/src/render/clouds.ts +142 -0
- package/templates/rain/src/render/exposure.ts +111 -0
- package/templates/rain/src/render/exposureGraph.ts +178 -0
- package/templates/rain/src/render/exposureReadback.ts +79 -0
- package/templates/rain/src/render/lighting.ts +39 -0
- package/templates/rain/src/render/lightning.ts +360 -0
- package/templates/rain/src/render/loading.ts +327 -0
- package/templates/rain/src/render/materials.ts +19 -0
- package/templates/rain/src/render/noise-volume.ts +159 -0
- package/templates/rain/src/render/palette.ts +18 -0
- package/templates/rain/src/render/post-shader.ts +178 -0
- package/templates/rain/src/render/postprocessing.ts +229 -0
- package/templates/rain/src/render/quality.ts +161 -0
- package/templates/rain/src/render/rain.ts +299 -0
- package/templates/rain/src/render/sky.ts +28 -0
- package/templates/rain/src/render/world-shader.ts +680 -0
- package/templates/rain/src/render/world.ts +146 -0
- package/templates/rain/src/render/worldEnvironment.ts +1212 -0
- package/templates/rain/src/scenes/Boot.ts +348 -0
- package/templates/rain/src/state.ts +261 -0
- package/templates/rain/src/style.css +1160 -0
- package/templates/rain/src/ui/App.tsx +29 -0
- package/templates/rain/src/ui/GameUi.tsx +187 -0
- package/templates/rain/src/ui/Hud.tsx +327 -0
- package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
- package/templates/rain/src/ui/Menu.tsx +370 -0
- package/templates/rain/src/ui/automation.ts +60 -0
- package/templates/rain/src/ui/main.tsx +7 -0
- package/templates/rain/src/ui/tempest.ts +149 -0
- package/templates/rain/tailwind.config.ts +2 -0
- package/templates/rain/threenative.config.ts +66 -0
- package/templates/rain/tools/generate-shaders.mjs +656 -0
- package/templates/rain/tools/make-storm-audio.mjs +387 -0
- package/templates/rain/tools/storm-dsp.mjs +177 -0
- package/templates/rain/tools/tempest-bloom.frag +10 -0
- package/templates/rain/tools/tempest-clouds.frag +86 -0
- package/templates/rain/tools/tempest-post.frag +47 -0
- package/templates/rain/tools/tempest-world.frag +210 -0
- package/templates/rain/tools/verify-noise-volume.mjs +61 -0
- package/templates/rain/tsconfig.json +17 -0
- package/templates/rain/vite.config.ts +45 -0
- package/templates/rts/AGENTS.md +10 -11
- package/templates/rts/CLAUDE.md +10 -11
- package/templates/rts/package.json +10 -8
- package/templates/rts/playtests/performance.playtest.json +7 -1
- package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-build.playtest.json +10 -1
- package/templates/rts/playtests/rts-orders.playtest.json +7 -1
- package/templates/rts/playtests/rts-train.playtest.json +10 -1
- package/templates/rts/src/render/army.ts +10 -2
- package/templates/rts/src/render/autoExposure.ts +225 -0
- package/templates/rts/src/render/backlightControls.ts +66 -0
- package/templates/rts/src/render/backlightMaterial.ts +147 -0
- package/templates/rts/src/render/environmentContribution.ts +188 -0
- package/templates/rts/src/render/environmentRadiance.ts +36 -0
- package/templates/rts/src/render/environmentSampleCache.ts +43 -0
- package/templates/rts/src/render/environmentSampling.ts +193 -0
- package/templates/rts/src/render/environmentSnapshot.ts +53 -0
- package/templates/rts/src/render/exposure.ts +111 -0
- package/templates/rts/src/render/exposureGraph.ts +178 -0
- package/templates/rts/src/render/exposureReadback.ts +79 -0
- package/templates/rts/src/render/heightFog.ts +118 -0
- package/templates/rts/src/render/lighting.ts +26 -1
- package/templates/rts/src/render/materialAssignments.ts +160 -0
- package/templates/rts/src/render/materialLighting.ts +155 -0
- package/templates/rts/src/render/postprocessing.ts +8 -2
- package/templates/rts/src/render/quality.ts +61 -2
- package/templates/rts/src/render/sky.ts +21 -1
- package/templates/rts/src/render/worldEnvironment.ts +433 -30
- package/templates/rts/src/scenes/Play.ts +54 -3
- package/templates/rts/src/sim/ai.ts +0 -1
- package/templates/rts/src/sim/terrain.ts +0 -4
- package/templates/rts/vite.config.ts +10 -2
- package/templates/runner/AGENTS.md +10 -8
- package/templates/runner/CLAUDE.md +10 -8
- package/templates/runner/package.json +11 -9
- package/templates/runner/playtests/performance.playtest.json +10 -1
- package/templates/runner/src/physics.ts +0 -1
- package/templates/runner/src/render/autoExposure.ts +225 -0
- package/templates/runner/src/render/backlightControls.ts +66 -0
- package/templates/runner/src/render/backlightMaterial.ts +147 -0
- package/templates/runner/src/render/environmentContribution.ts +188 -0
- package/templates/runner/src/render/environmentRadiance.ts +36 -0
- package/templates/runner/src/render/environmentSampleCache.ts +43 -0
- package/templates/runner/src/render/environmentSampling.ts +193 -0
- package/templates/runner/src/render/environmentSnapshot.ts +53 -0
- package/templates/runner/src/render/exposure.ts +111 -0
- package/templates/runner/src/render/exposureGraph.ts +178 -0
- package/templates/runner/src/render/exposureReadback.ts +79 -0
- package/templates/runner/src/render/heightFog.ts +118 -0
- package/templates/runner/src/render/lighting.ts +26 -1
- package/templates/runner/src/render/materialAssignments.ts +160 -0
- package/templates/runner/src/render/materialLighting.ts +155 -0
- package/templates/runner/src/render/postprocessing.ts +17 -2
- package/templates/runner/src/render/quality.ts +61 -2
- package/templates/runner/src/render/sky.ts +21 -1
- package/templates/runner/src/render/worldEnvironment.ts +433 -30
- package/templates/runner/src/scenes/Run.ts +67 -2
- package/templates/runner/threenative.config.ts +3 -0
- package/templates/runner/vite.config.ts +10 -2
- package/templates/sailing/AGENTS.md +14 -13
- package/templates/sailing/CLAUDE.md +14 -13
- package/templates/sailing/native-playtests/survives.playtest.json +7 -0
- package/templates/sailing/package.json +11 -9
- package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
- package/templates/sailing/src/entities/Ship.ts +38 -18
- package/templates/sailing/src/render/autoExposure.ts +225 -0
- package/templates/sailing/src/render/backlightControls.ts +66 -0
- package/templates/sailing/src/render/backlightMaterial.ts +147 -0
- package/templates/sailing/src/render/camera.ts +12 -4
- package/templates/sailing/src/render/environmentContribution.ts +188 -0
- package/templates/sailing/src/render/environmentRadiance.ts +36 -0
- package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
- package/templates/sailing/src/render/environmentSampling.ts +193 -0
- package/templates/sailing/src/render/environmentSetup.ts +24 -0
- package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
- package/templates/sailing/src/render/exposure.ts +111 -0
- package/templates/sailing/src/render/exposureGraph.ts +178 -0
- package/templates/sailing/src/render/exposureReadback.ts +79 -0
- package/templates/sailing/src/render/heightFog.ts +118 -0
- package/templates/sailing/src/render/lighting.ts +26 -1
- package/templates/sailing/src/render/materialAssignments.ts +160 -0
- package/templates/sailing/src/render/materialLighting.ts +155 -0
- package/templates/sailing/src/render/ocean.ts +71 -53
- package/templates/sailing/src/render/postprocessing.ts +16 -2
- package/templates/sailing/src/render/props.ts +0 -45
- package/templates/sailing/src/render/quality.ts +61 -1
- package/templates/sailing/src/render/sky.ts +21 -1
- package/templates/sailing/src/render/worldEnvironment.ts +433 -30
- package/templates/sailing/src/scenes/Boot.ts +12 -1
- package/templates/sailing/src/scenes/Sailing.ts +87 -2
- package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
- package/templates/sailing/threenative.config.ts +3 -0
- package/templates/sailing/vite.config.ts +10 -2
- package/templates/shooter/AGENTS.md +8 -6
- package/templates/shooter/CLAUDE.md +8 -6
- package/templates/shooter/package.json +11 -9
- package/templates/shooter/playtests/performance.playtest.json +7 -1
- package/templates/shooter/src/entities/Enemy.ts +0 -15
- package/templates/shooter/src/entities/Rifle.ts +38 -1
- package/templates/shooter/src/render/autoExposure.ts +225 -0
- package/templates/shooter/src/render/backlightControls.ts +66 -0
- package/templates/shooter/src/render/backlightMaterial.ts +147 -0
- package/templates/shooter/src/render/camera.ts +1 -12
- package/templates/shooter/src/render/decals.ts +299 -5
- package/templates/shooter/src/render/environmentContribution.ts +188 -0
- package/templates/shooter/src/render/environmentRadiance.ts +36 -0
- package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
- package/templates/shooter/src/render/environmentSampling.ts +193 -0
- package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
- package/templates/shooter/src/render/exposure.ts +111 -0
- package/templates/shooter/src/render/exposureGraph.ts +178 -0
- package/templates/shooter/src/render/exposureReadback.ts +79 -0
- package/templates/shooter/src/render/gunfx.ts +0 -1
- package/templates/shooter/src/render/heightFog.ts +118 -0
- package/templates/shooter/src/render/lighting.ts +26 -1
- package/templates/shooter/src/render/materialAssignments.ts +160 -0
- package/templates/shooter/src/render/materialLighting.ts +155 -0
- package/templates/shooter/src/render/postprocessing.ts +17 -2
- package/templates/shooter/src/render/quality.ts +61 -2
- package/templates/shooter/src/render/scale.ts +2 -93
- package/templates/shooter/src/render/sky.ts +21 -1
- package/templates/shooter/src/render/vehicles.ts +0 -17
- package/templates/shooter/src/render/worldEnvironment.ts +433 -30
- package/templates/shooter/src/scenes/Play.ts +64 -2
- package/templates/shooter/vite.config.ts +10 -2
- package/templates/snow/.codex/config.toml +19 -0
- package/templates/snow/.cursor/mcp.json +32 -0
- package/templates/snow/.gemini/settings.json +32 -0
- package/templates/snow/.mcp.json +32 -0
- package/templates/snow/.vscode/mcp.json +36 -0
- package/templates/snow/.zed/settings.json +36 -0
- package/templates/snow/AGENTS.md +90 -0
- package/templates/snow/CLAUDE.md +92 -0
- package/templates/snow/README.md +26 -0
- package/templates/snow/assets/crunch.wav +0 -0
- package/templates/snow/assets/wind.wav +0 -0
- package/templates/snow/index.html +12 -0
- package/templates/snow/kit.json +7 -0
- package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
- package/templates/snow/native-playtests/survives.playtest.json +47 -0
- package/templates/snow/opencode.json +41 -0
- package/templates/snow/package.json +60 -0
- package/templates/snow/playtests/footsteps.playtest.json +95 -0
- package/templates/snow/playtests/performance.playtest.json +36 -0
- package/templates/snow/playtests/snow-physics.playtest.json +154 -0
- package/templates/snow/playtests/survives.playtest.json +56 -0
- package/templates/snow/playtests/touch-controls.playtest.json +71 -0
- package/templates/snow/playtests/weather.playtest.json +119 -0
- package/templates/snow/public/favicon.svg +5 -0
- package/templates/snow/src/audio.ts +58 -0
- package/templates/snow/src/commands.ts +8 -0
- package/templates/snow/src/entities/Explorer.ts +279 -0
- package/templates/snow/src/game.ts +69 -0
- package/templates/snow/src/main.ts +15 -0
- package/templates/snow/src/render/autoExposure.ts +225 -0
- package/templates/snow/src/render/backlightControls.ts +66 -0
- package/templates/snow/src/render/backlightMaterial.ts +147 -0
- package/templates/snow/src/render/bootPrint.ts +50 -0
- package/templates/snow/src/render/camera.ts +84 -0
- package/templates/snow/src/render/environmentContribution.ts +188 -0
- package/templates/snow/src/render/environmentRadiance.ts +36 -0
- package/templates/snow/src/render/environmentSampleCache.ts +43 -0
- package/templates/snow/src/render/environmentSampling.ts +193 -0
- package/templates/snow/src/render/environmentSnapshot.ts +53 -0
- package/templates/snow/src/render/explorer.ts +321 -0
- package/templates/snow/src/render/exposure.ts +111 -0
- package/templates/snow/src/render/exposureGraph.ts +178 -0
- package/templates/snow/src/render/exposureReadback.ts +79 -0
- package/templates/snow/src/render/heightFog.ts +118 -0
- package/templates/snow/src/render/lighting.ts +82 -0
- package/templates/snow/src/render/loading.ts +325 -0
- package/templates/snow/src/render/materialAssignments.ts +160 -0
- package/templates/snow/src/render/materialLighting.ts +155 -0
- package/templates/snow/src/render/materials.ts +36 -0
- package/templates/snow/src/render/palette.ts +17 -0
- package/templates/snow/src/render/postprocessing.ts +58 -0
- package/templates/snow/src/render/props.ts +42 -0
- package/templates/snow/src/render/quality.ts +193 -0
- package/templates/snow/src/render/scenery.ts +244 -0
- package/templates/snow/src/render/sky.ts +76 -0
- package/templates/snow/src/render/snowSurface.ts +259 -0
- package/templates/snow/src/render/touch-controls.ts +143 -0
- package/templates/snow/src/render/weather.ts +279 -0
- package/templates/snow/src/render/worldEnvironment.ts +1212 -0
- package/templates/snow/src/scenes/Boot.ts +12 -0
- package/templates/snow/src/scenes/Snow.ts +663 -0
- package/templates/snow/src/state.ts +46 -0
- package/templates/snow/src/style.css +143 -0
- package/templates/snow/src/terrain.ts +64 -0
- package/templates/snow/src/ui/App.tsx +15 -0
- package/templates/snow/src/ui/Controls.tsx +322 -0
- package/templates/snow/src/ui/GameUi.tsx +354 -0
- package/templates/snow/src/ui/icons.tsx +54 -0
- package/templates/snow/src/ui/main.tsx +7 -0
- package/templates/snow/tailwind.config.ts +2 -0
- package/templates/snow/threenative.config.ts +54 -0
- package/templates/snow/tsconfig.json +17 -0
- package/templates/snow/vite.config.ts +45 -0
- package/templates/starter/AGENTS.md +11 -16
- package/templates/starter/CLAUDE.md +11 -16
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
- package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
- package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
- package/templates/starter/package.json +11 -9
- package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
- package/templates/starter/playtests/movement.playtest.json +192 -0
- package/templates/starter/playtests/play.playtest.json +18 -2
- package/templates/starter/playtests/production-readiness.playtest.json +1 -1
- package/templates/starter/public/grade.cube +735 -0
- package/templates/starter/src/entities/Crate.ts +4 -0
- package/templates/starter/src/entities/Player.ts +79 -18
- package/templates/starter/src/game.ts +1 -0
- package/templates/starter/src/render/adaptiveQuality.ts +28 -41
- package/templates/starter/src/render/autoExposure.ts +225 -0
- package/templates/starter/src/render/backlightControls.ts +66 -0
- package/templates/starter/src/render/backlightMaterial.ts +147 -0
- package/templates/starter/src/render/environmentContribution.ts +188 -0
- package/templates/starter/src/render/environmentRadiance.ts +36 -0
- package/templates/starter/src/render/environmentSampleCache.ts +43 -0
- package/templates/starter/src/render/environmentSampling.ts +193 -0
- package/templates/starter/src/render/environmentSnapshot.ts +53 -0
- package/templates/starter/src/render/exposure.ts +111 -0
- package/templates/starter/src/render/exposureGraph.ts +178 -0
- package/templates/starter/src/render/exposureReadback.ts +79 -0
- package/templates/starter/src/render/grade.ts +157 -0
- package/templates/starter/src/render/heightFog.ts +118 -0
- package/templates/starter/src/render/lighting.ts +26 -1
- package/templates/starter/src/render/materialAssignments.ts +160 -0
- package/templates/starter/src/render/materialLighting.ts +155 -0
- package/templates/starter/src/render/postprocessing.ts +84 -4
- package/templates/starter/src/render/quality.ts +80 -8
- package/templates/starter/src/render/qualityPolicy.ts +54 -0
- package/templates/starter/src/render/rendererGate.ts +36 -0
- package/templates/starter/src/render/sky.ts +23 -1
- package/templates/starter/src/render/temporalAA.ts +197 -0
- package/templates/starter/src/render/temporalAAFrame.ts +179 -0
- package/templates/starter/src/render/temporalAAHooks.ts +101 -0
- package/templates/starter/src/render/temporalAAInput.ts +56 -0
- package/templates/starter/src/render/temporalAAResolve.ts +65 -0
- package/templates/starter/src/render/temporalAAStage.ts +76 -0
- package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
- package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
- package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
- package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
- package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
- package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
- package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
- package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
- package/templates/starter/src/render/temporalResolve.ts +139 -0
- package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
- package/templates/starter/src/render/temporalResolveMath.ts +196 -0
- package/templates/starter/src/render/volumetricFog.ts +124 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
- package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
- package/templates/starter/src/render/worldEnvironment.ts +433 -30
- package/templates/starter/src/scenes/Play.ts +110 -1
- package/templates/starter/src/state.ts +1 -0
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/ui/Menu.tsx +1 -1
- package/templates/starter/tools/make-grade-lut.mjs +101 -0
- package/templates/starter/vite.config.ts +10 -2
- package/templates/tower-defense/AGENTS.md +10 -9
- package/templates/tower-defense/CLAUDE.md +10 -9
- package/templates/tower-defense/package.json +11 -9
- package/templates/tower-defense/playtests/performance.playtest.json +7 -1
- package/templates/tower-defense/src/render/autoExposure.ts +225 -0
- package/templates/tower-defense/src/render/backlightControls.ts +66 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
- package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
- package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
- package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
- package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
- package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
- package/templates/tower-defense/src/render/exposure.ts +111 -0
- package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
- package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
- package/templates/tower-defense/src/render/lighting.ts +33 -1
- package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
- package/templates/tower-defense/src/render/materialLighting.ts +155 -0
- package/templates/tower-defense/src/render/postprocessing.ts +8 -2
- package/templates/tower-defense/src/render/quality.ts +61 -2
- package/templates/tower-defense/src/render/shapes.ts +0 -3
- package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
- package/templates/tower-defense/src/scenes/Battle.ts +65 -2
- package/templates/tower-defense/vite.config.ts +10 -2
- package/templates/minimal/src/scenes/Boot.ts +0 -5
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// ThreeNative does not read this file. `sky.ts` owns the numbers; this file is the fog maths.
|
|
3
|
+
import { Color, type FogExp2, type Vector3 } from "three";
|
|
4
|
+
import {
|
|
5
|
+
cameraPosition,
|
|
6
|
+
densityFogFactor,
|
|
7
|
+
dot,
|
|
8
|
+
exp2,
|
|
9
|
+
float,
|
|
10
|
+
fog,
|
|
11
|
+
max,
|
|
12
|
+
mix,
|
|
13
|
+
positionWorld,
|
|
14
|
+
pow,
|
|
15
|
+
saturate,
|
|
16
|
+
select,
|
|
17
|
+
uniform,
|
|
18
|
+
vec3,
|
|
19
|
+
} from "three/tsl";
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Height fog, in metres, y up. Density falls off exponentially above `fogHeight`; the fog along the
|
|
23
|
+
* ray from the camera to a fragment is the closed-form integral of that density, so low ground
|
|
24
|
+
* reads hazier than a ridge at the same distance and a camera above the layer looks down through it.
|
|
25
|
+
* Every control says which way to move it.
|
|
26
|
+
*/
|
|
27
|
+
export const HEIGHT_FOG = {
|
|
28
|
+
/** Optical depth per metre at `fogHeight` (base 2). Up: thicker ground mist. */
|
|
29
|
+
density: 0.0012,
|
|
30
|
+
/** Per metre above `fogHeight`. Up: a thinner, lower layer. Down: mist climbs the hills. */
|
|
31
|
+
heightFalloff: 0.08,
|
|
32
|
+
/** World y where density equals `density`. Move it to the ground of your world. */
|
|
33
|
+
fogHeight: 0,
|
|
34
|
+
/** Floor on the height term's transparency, 0..1. Below 1 leaves a clear window in the mist. */
|
|
35
|
+
maxOpacity: 1,
|
|
36
|
+
/** Metres from the camera before the mist starts. Up: a clear foreground. */
|
|
37
|
+
startDistance: 0,
|
|
38
|
+
/** Sun lobe sharpness. Up: a tighter glow around the sun. */
|
|
39
|
+
sunExponent: 4,
|
|
40
|
+
/** Metres before sun glow starts, so nearby objects are not tinted. */
|
|
41
|
+
sunStartDistance: 100,
|
|
42
|
+
/** Metres past which the height term is off. 0 = never. Never set it inside a streaming ring. */
|
|
43
|
+
cutoffDistance: 0,
|
|
44
|
+
} as const;
|
|
45
|
+
export type HeightFogParams = { -readonly [K in keyof typeof HEIGHT_FOG]: number };
|
|
46
|
+
|
|
47
|
+
const LN2 = Math.LN2;
|
|
48
|
+
|
|
49
|
+
// Camera density term, clamped so exp2 stays finite (Unreal clamps the exponent at -127).
|
|
50
|
+
const clampExponent = (x: number): number => Math.min(127, Math.max(-127, x));
|
|
51
|
+
|
|
52
|
+
/** `density` times the integral of 2^(-k t) over [a, b]; k is the ray's slope times `falloff`. */
|
|
53
|
+
function segment(density: number, k: number, a: number, b: number): number {
|
|
54
|
+
if (b <= a) return 0;
|
|
55
|
+
if (Math.abs(k * b) < 0.01) return density * (b - a - 0.5 * LN2 * k * (b * b - a * a));
|
|
56
|
+
return (density * (2 ** (-k * a) - 2 ** (-k * b))) / (k * LN2);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
function rayTerms(p: HeightFogParams, cameraY: number, fragmentY: number, length: number) {
|
|
60
|
+
const camera = p.density * 2 ** clampExponent(-p.heightFalloff * (cameraY - p.fogHeight));
|
|
61
|
+
const k = length > 0 ? (p.heightFalloff * (fragmentY - cameraY)) / length : 0;
|
|
62
|
+
return { camera, k };
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** Base-2 optical depth (transmittance is 2^-depth) of the mist between the camera and a fragment. */
|
|
66
|
+
export function heightFogDepth(
|
|
67
|
+
p: HeightFogParams,
|
|
68
|
+
cameraY: number,
|
|
69
|
+
fragmentY: number,
|
|
70
|
+
length: number,
|
|
71
|
+
): number {
|
|
72
|
+
if (p.cutoffDistance > 0 && length > p.cutoffDistance) return 0;
|
|
73
|
+
const { camera, k } = rayTerms(p, cameraY, fragmentY, length);
|
|
74
|
+
return segment(camera, k, p.startDistance, length);
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
const SUN_COLOUR = new Color(0xfff1d6);
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* `T_distance x T_height`, on `scene.fogNode`: three applies it to every material where `scene.fog`
|
|
81
|
+
* would be. The distance term reads the live `FogExp2`, so changing its colour or density at runtime
|
|
82
|
+
* still works. It is never more transparent than that term alone, so wherever the distance term
|
|
83
|
+
* reaches 0 the frame stays fully fogged. Pass `sun` for a glow toward it past `sunStartDistance`.
|
|
84
|
+
*/
|
|
85
|
+
export function heightFogNode(distanceFog: FogExp2, p: HeightFogParams, sun?: Vector3) {
|
|
86
|
+
const color = uniform(new Color());
|
|
87
|
+
color.onRenderUpdate(() => color.value.copy(distanceFog.color));
|
|
88
|
+
const density = uniform(0);
|
|
89
|
+
density.onRenderUpdate(() => {
|
|
90
|
+
density.value = distanceFog.density;
|
|
91
|
+
});
|
|
92
|
+
// Density at the camera, once per frame instead of once per fragment.
|
|
93
|
+
const cameraDensity = uniform(0);
|
|
94
|
+
cameraDensity.onRenderUpdate(({ camera }) => {
|
|
95
|
+
const y = camera?.matrixWorld.elements[13] ?? 0;
|
|
96
|
+
cameraDensity.value = p.density * 2 ** clampExponent(-p.heightFalloff * (y - p.fogHeight));
|
|
97
|
+
});
|
|
98
|
+
const ray = positionWorld.sub(cameraPosition);
|
|
99
|
+
const length = ray.length().max(1e-4);
|
|
100
|
+
const k = float(p.heightFalloff).mul(positionWorld.y.sub(cameraPosition.y)).div(length);
|
|
101
|
+
const integral = (a: number) => {
|
|
102
|
+
const b = max(length, a);
|
|
103
|
+
const curved = cameraDensity
|
|
104
|
+
.mul(exp2(k.mul(a).negate()).sub(exp2(k.mul(b).negate())))
|
|
105
|
+
.div(k.mul(LN2));
|
|
106
|
+
return select(k.mul(b).abs().lessThan(0.01), cameraDensity.mul(b.sub(a)), curved);
|
|
107
|
+
};
|
|
108
|
+
const cut = p.cutoffDistance > 0 ? select(length.greaterThan(p.cutoffDistance), 0, 1) : float(1);
|
|
109
|
+
const heightT = max(exp2(integral(p.startDistance).mul(cut).negate()), 1 - p.maxOpacity);
|
|
110
|
+
const opacity = densityFogFactor(density).oneMinus().mul(heightT).oneMinus();
|
|
111
|
+
if (sun === undefined) return fog(color, opacity);
|
|
112
|
+
const lobe = pow(saturate(dot(ray.div(length), vec3(sun.x, sun.y, sun.z))), p.sunExponent);
|
|
113
|
+
const glow = float(1)
|
|
114
|
+
.sub(exp2(integral(Math.max(p.sunStartDistance, p.startDistance)).negate()))
|
|
115
|
+
.mul(lobe)
|
|
116
|
+
.mul(p.maxOpacity);
|
|
117
|
+
return fog(mix(color, vec3(SUN_COLOUR.r, SUN_COLOUR.g, SUN_COLOUR.b), glow), opacity);
|
|
118
|
+
}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js; tune the sun and fill for your snow.
|
|
2
|
+
import {
|
|
3
|
+
Color,
|
|
4
|
+
DirectionalLight,
|
|
5
|
+
HemisphereLight,
|
|
6
|
+
PCFSoftShadowMap,
|
|
7
|
+
type Scene,
|
|
8
|
+
Vector3,
|
|
9
|
+
} from "three";
|
|
10
|
+
import { palette } from "./palette.js";
|
|
11
|
+
|
|
12
|
+
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
13
|
+
|
|
14
|
+
export interface ISnowLights {
|
|
15
|
+
/** Follow `target` with the shadow frustum and dim everything for a storm. */
|
|
16
|
+
update(target: { readonly x: number; readonly z: number }, storm: number): void;
|
|
17
|
+
readonly sun: DirectionalLight;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
export function setupLighting(scene: Scene, renderer: ShadowRenderer): ISnowLights {
|
|
21
|
+
renderer.shadowMap.enabled = true;
|
|
22
|
+
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
23
|
+
// Bright sky above, a cool grey bounce from the snow below.
|
|
24
|
+
const sky = new HemisphereLight(0xdbeeff, 0x7d8e9c, 2.2);
|
|
25
|
+
scene.add(sky);
|
|
26
|
+
|
|
27
|
+
// A low warm sun, so footprints throw shadows into their own floors.
|
|
28
|
+
const sun = new DirectionalLight(0xffead1, 3.3);
|
|
29
|
+
sun.position.set(-22, 30, -20);
|
|
30
|
+
sun.castShadow = true;
|
|
31
|
+
sun.shadow.mapSize.set(2048, 2048);
|
|
32
|
+
sun.shadow.camera.left = -19;
|
|
33
|
+
sun.shadow.camera.right = 19;
|
|
34
|
+
sun.shadow.camera.top = 19;
|
|
35
|
+
sun.shadow.camera.bottom = -19;
|
|
36
|
+
sun.shadow.camera.near = 0.1;
|
|
37
|
+
sun.shadow.camera.far = 100;
|
|
38
|
+
sun.shadow.bias = -0.0002;
|
|
39
|
+
sun.shadow.normalBias = 0.028;
|
|
40
|
+
scene.add(sun, sun.target);
|
|
41
|
+
|
|
42
|
+
// A cool fill from the camera side keeps the shadowed faces of the forest from going black.
|
|
43
|
+
const fill = new DirectionalLight(palette.skyLow, 0.45);
|
|
44
|
+
fill.position.set(8, 6, 15);
|
|
45
|
+
scene.add(fill);
|
|
46
|
+
|
|
47
|
+
return {
|
|
48
|
+
sun,
|
|
49
|
+
update(target, storm) {
|
|
50
|
+
sun.position.set(target.x - 22, 30, target.z - 20);
|
|
51
|
+
sun.target.position.set(target.x, 0, target.z);
|
|
52
|
+
sun.target.updateMatrixWorld();
|
|
53
|
+
sun.intensity = 3.3 - storm * 2.9;
|
|
54
|
+
sky.intensity = 2.2 - storm * 0.55;
|
|
55
|
+
},
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** Material conventions are game-owned; each scene gets independent mutable controls. */
|
|
60
|
+
export interface ILightingConvention {
|
|
61
|
+
rimGain: number;
|
|
62
|
+
fillGain: number;
|
|
63
|
+
fillColor: Color;
|
|
64
|
+
fillDirection: Vector3;
|
|
65
|
+
fillAngularSize: number;
|
|
66
|
+
darkThreshold: number;
|
|
67
|
+
maxSourceTexels: number;
|
|
68
|
+
}
|
|
69
|
+
export function createLightingConvention(
|
|
70
|
+
overrides: Partial<ILightingConvention> = {},
|
|
71
|
+
): ILightingConvention {
|
|
72
|
+
return {
|
|
73
|
+
rimGain: 0.12,
|
|
74
|
+
fillGain: 0, // Existing hemisphere and camera fill own the storm response.
|
|
75
|
+
fillColor: new Color(0x667b9d),
|
|
76
|
+
fillDirection: new Vector3(0, 1, 1).normalize(),
|
|
77
|
+
fillAngularSize: 0.7,
|
|
78
|
+
darkThreshold: 0.001,
|
|
79
|
+
maxSourceTexels: 65536,
|
|
80
|
+
...overrides,
|
|
81
|
+
};
|
|
82
|
+
}
|
|
@@ -0,0 +1,325 @@
|
|
|
1
|
+
import {
|
|
2
|
+
type Camera,
|
|
3
|
+
CanvasTexture,
|
|
4
|
+
ClampToEdgeWrapping,
|
|
5
|
+
Mesh,
|
|
6
|
+
MeshBasicMaterial,
|
|
7
|
+
type OrthographicCamera,
|
|
8
|
+
PlaneGeometry,
|
|
9
|
+
type Scene,
|
|
10
|
+
type Texture,
|
|
11
|
+
} from "three";
|
|
12
|
+
import { palette } from "./palette.js";
|
|
13
|
+
|
|
14
|
+
/* BEGIN THREENATIVE LOADING APPEARANCE */
|
|
15
|
+
/** Sailing keeps its own sea composition; all behavior is authored here. */
|
|
16
|
+
export const loading = {
|
|
17
|
+
backgroundColor: palette.skyLow,
|
|
18
|
+
backgroundImage: undefined as string | undefined,
|
|
19
|
+
enabled: true,
|
|
20
|
+
fillImage: undefined as string | undefined,
|
|
21
|
+
logoImage: undefined as string | undefined,
|
|
22
|
+
progressColor: palette.accent,
|
|
23
|
+
showStatus: false,
|
|
24
|
+
trackColor: palette.skyHigh,
|
|
25
|
+
bar: { anchorX: 0.5, anchorY: 0.7, height: 9, maxWidth: 560, minWidth: 1, width: 0.64 },
|
|
26
|
+
} as const;
|
|
27
|
+
/* END THREENATIVE LOADING APPEARANCE */
|
|
28
|
+
|
|
29
|
+
interface ILoadingHost {
|
|
30
|
+
readonly assets?: { texture(path: string): Promise<Texture> };
|
|
31
|
+
readonly camera: Camera;
|
|
32
|
+
readonly canvasLayer: {
|
|
33
|
+
readonly camera: OrthographicCamera;
|
|
34
|
+
readonly scene: Scene;
|
|
35
|
+
opaque: boolean;
|
|
36
|
+
};
|
|
37
|
+
readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
|
|
38
|
+
readonly scene: Scene;
|
|
39
|
+
readonly startup: {
|
|
40
|
+
readonly progress: number;
|
|
41
|
+
readonly warmup?: { readonly status: "complete" | "incomplete" | "unavailable" };
|
|
42
|
+
whenReady(): Promise<void>;
|
|
43
|
+
};
|
|
44
|
+
readonly viewport?: {
|
|
45
|
+
readonly safeArea: { height: number; width: number; x: number; y: number };
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
interface ILoadingController {
|
|
50
|
+
update(): void;
|
|
51
|
+
finish(): void;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function noOp(layer: ILoadingHost["canvasLayer"]): ILoadingController {
|
|
55
|
+
layer.opaque = false;
|
|
56
|
+
return { finish: () => undefined, update: () => undefined };
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
function meshFor(
|
|
60
|
+
layer: ILoadingHost["canvasLayer"],
|
|
61
|
+
material: MeshBasicMaterial,
|
|
62
|
+
renderOrder: number,
|
|
63
|
+
): Mesh<PlaneGeometry, MeshBasicMaterial> {
|
|
64
|
+
const mesh = new Mesh(new PlaneGeometry(1, 1), material);
|
|
65
|
+
mesh.frustumCulled = false;
|
|
66
|
+
mesh.renderOrder = renderOrder;
|
|
67
|
+
layer.scene.add(mesh);
|
|
68
|
+
return mesh;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function imageAspect(texture: Texture | null | undefined): number {
|
|
72
|
+
const image = texture?.image as { height?: number; width?: number } | undefined;
|
|
73
|
+
const width = image?.width ?? 1;
|
|
74
|
+
const height = image?.height ?? 1;
|
|
75
|
+
return width > 0 && height > 0 ? width / height : 1;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function configureTexture(texture: Texture): void {
|
|
79
|
+
texture.wrapS = ClampToEdgeWrapping;
|
|
80
|
+
texture.wrapT = ClampToEdgeWrapping;
|
|
81
|
+
texture.needsUpdate = true;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
function setFillUv(geometry: PlaneGeometry, progress: number, base: readonly number[]): void {
|
|
85
|
+
const uv = geometry.getAttribute("uv");
|
|
86
|
+
for (let index = 0; index < uv.count; index += 1) uv.setX(index, (base[index] ?? 0) * progress);
|
|
87
|
+
uv.needsUpdate = true;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
function coverUv(
|
|
91
|
+
geometry: PlaneGeometry,
|
|
92
|
+
texture: Texture,
|
|
93
|
+
width: number,
|
|
94
|
+
height: number,
|
|
95
|
+
baseU: readonly number[],
|
|
96
|
+
baseV: readonly number[],
|
|
97
|
+
): void {
|
|
98
|
+
const imageRatio = imageAspect(texture);
|
|
99
|
+
const boxRatio = width / Math.max(1, height);
|
|
100
|
+
const visibleU = imageRatio > boxRatio ? boxRatio / imageRatio : 1;
|
|
101
|
+
const visibleV = imageRatio < boxRatio ? imageRatio / boxRatio : 1;
|
|
102
|
+
const offsetU = (1 - visibleU) / 2;
|
|
103
|
+
const offsetV = (1 - visibleV) / 2;
|
|
104
|
+
const uv = geometry.getAttribute("uv");
|
|
105
|
+
for (let index = 0; index < uv.count; index += 1) {
|
|
106
|
+
uv.setX(index, offsetU + (baseU[index] ?? 0) * visibleU);
|
|
107
|
+
uv.setY(index, offsetV + (baseV[index] ?? 0) * visibleV);
|
|
108
|
+
}
|
|
109
|
+
uv.needsUpdate = true;
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
function statusMesh(
|
|
113
|
+
layer: ILoadingHost["canvasLayer"],
|
|
114
|
+
):
|
|
115
|
+
| { mesh: Mesh<PlaneGeometry, MeshBasicMaterial>; texture: Texture; update(value: number): void }
|
|
116
|
+
| undefined {
|
|
117
|
+
if (!loading.showStatus || typeof document === "undefined") return undefined;
|
|
118
|
+
const canvas = document.createElement("canvas");
|
|
119
|
+
canvas.width = 180;
|
|
120
|
+
canvas.height = 48;
|
|
121
|
+
const context = canvas.getContext("2d");
|
|
122
|
+
if (context === null) return undefined;
|
|
123
|
+
const texture = new CanvasTexture(canvas);
|
|
124
|
+
const mesh = meshFor(
|
|
125
|
+
layer,
|
|
126
|
+
new MeshBasicMaterial({ depthTest: false, depthWrite: false, map: texture, transparent: true }),
|
|
127
|
+
4,
|
|
128
|
+
);
|
|
129
|
+
const update = (value: number): void => {
|
|
130
|
+
context.clearRect(0, 0, canvas.width, canvas.height);
|
|
131
|
+
context.fillStyle = "#ffffff";
|
|
132
|
+
context.font = "700 20px monospace";
|
|
133
|
+
context.textAlign = "center";
|
|
134
|
+
context.textBaseline = "middle";
|
|
135
|
+
context.fillText(`${Math.round(value * 100)}%`, canvas.width / 2, canvas.height / 2);
|
|
136
|
+
texture.needsUpdate = true;
|
|
137
|
+
};
|
|
138
|
+
update(0);
|
|
139
|
+
return { mesh, texture, update };
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
export function createLoadingScreen(host: ILoadingHost): ILoadingController {
|
|
143
|
+
const layer = host.canvasLayer;
|
|
144
|
+
if (!loading.enabled) return noOp(layer);
|
|
145
|
+
const camera = layer.camera;
|
|
146
|
+
const backdrop = meshFor(
|
|
147
|
+
layer,
|
|
148
|
+
new MeshBasicMaterial({ color: loading.backgroundColor, depthTest: false, depthWrite: false }),
|
|
149
|
+
0,
|
|
150
|
+
);
|
|
151
|
+
const track = meshFor(
|
|
152
|
+
layer,
|
|
153
|
+
new MeshBasicMaterial({ color: loading.trackColor, depthTest: false, depthWrite: false }),
|
|
154
|
+
1,
|
|
155
|
+
);
|
|
156
|
+
const fill = meshFor(
|
|
157
|
+
layer,
|
|
158
|
+
new MeshBasicMaterial({ color: loading.progressColor, depthTest: false, depthWrite: false }),
|
|
159
|
+
2,
|
|
160
|
+
);
|
|
161
|
+
const fillBaseU = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
|
|
162
|
+
fill.geometry.getAttribute("uv").getX(index),
|
|
163
|
+
);
|
|
164
|
+
const fillBaseV = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
|
|
165
|
+
fill.geometry.getAttribute("uv").getY(index),
|
|
166
|
+
);
|
|
167
|
+
const logo =
|
|
168
|
+
loading.logoImage === undefined
|
|
169
|
+
? undefined
|
|
170
|
+
: meshFor(
|
|
171
|
+
layer,
|
|
172
|
+
new MeshBasicMaterial({
|
|
173
|
+
color: 0xffffff,
|
|
174
|
+
depthTest: false,
|
|
175
|
+
depthWrite: false,
|
|
176
|
+
transparent: true,
|
|
177
|
+
}),
|
|
178
|
+
3,
|
|
179
|
+
);
|
|
180
|
+
const status = statusMesh(layer);
|
|
181
|
+
const parts = [
|
|
182
|
+
backdrop,
|
|
183
|
+
track,
|
|
184
|
+
fill,
|
|
185
|
+
...(logo === undefined ? [] : [logo]),
|
|
186
|
+
...(status === undefined ? [] : [status.mesh]),
|
|
187
|
+
];
|
|
188
|
+
const ownedTextures = new Set<Texture>(status === undefined ? [] : [status.texture]);
|
|
189
|
+
let width = 1;
|
|
190
|
+
let height = 1;
|
|
191
|
+
let barWidth = 1;
|
|
192
|
+
let barHeight: number = loading.bar.height;
|
|
193
|
+
let barX = 0;
|
|
194
|
+
let barY = 0;
|
|
195
|
+
let progress = 0;
|
|
196
|
+
let done = false;
|
|
197
|
+
let backdropTexture: Texture | undefined;
|
|
198
|
+
|
|
199
|
+
const layout = (): void => {
|
|
200
|
+
width = Math.max(1, camera.right - camera.left);
|
|
201
|
+
height = Math.max(1, camera.top - camera.bottom);
|
|
202
|
+
const safe = host.viewport?.safeArea ?? { height, width, x: 0, y: 0 };
|
|
203
|
+
const safeWidth = Math.max(1, Math.min(width, safe.width));
|
|
204
|
+
const safeHeight = Math.max(1, Math.min(height, safe.height));
|
|
205
|
+
const safeX = Math.max(0, Math.min(width - safeWidth, safe.x));
|
|
206
|
+
const safeY = Math.max(0, Math.min(height - safeHeight, safe.y));
|
|
207
|
+
barWidth = Math.max(2, Math.min(loading.bar.maxWidth, safeWidth * loading.bar.width));
|
|
208
|
+
barHeight = Math.max(2, Math.min(loading.bar.height, safeHeight * 0.05));
|
|
209
|
+
barX = safeX + safeWidth * loading.bar.anchorX;
|
|
210
|
+
barY = safeY + safeHeight * loading.bar.anchorY;
|
|
211
|
+
const worldX = (screenX: number): number => camera.left + screenX;
|
|
212
|
+
const worldY = (screenY: number): number => camera.top - screenY;
|
|
213
|
+
const visibleWidth = Math.max(loading.bar.minWidth, barWidth * progress);
|
|
214
|
+
backdrop.scale.set(width, height, 1);
|
|
215
|
+
backdrop.position.set(worldX(width / 2), worldY(height / 2), 0);
|
|
216
|
+
track.scale.set(barWidth, barHeight, 1);
|
|
217
|
+
track.position.set(worldX(barX), worldY(barY), 0);
|
|
218
|
+
fill.scale.set(visibleWidth, barHeight, 1);
|
|
219
|
+
fill.position.set(worldX(barX - barWidth / 2 + visibleWidth / 2), worldY(barY), 0);
|
|
220
|
+
if (logo?.visible) {
|
|
221
|
+
const logoWidth = Math.min(safeWidth * 0.42, 280);
|
|
222
|
+
logo.scale.set(
|
|
223
|
+
logoWidth,
|
|
224
|
+
Math.min(logoWidth / imageAspect(logo.material.map), safeHeight * 0.22),
|
|
225
|
+
1,
|
|
226
|
+
);
|
|
227
|
+
logo.position.set(worldX(barX), worldY(Math.max(safeY, barY - safeHeight * 0.2)), 0);
|
|
228
|
+
}
|
|
229
|
+
if (status !== undefined) {
|
|
230
|
+
status.mesh.scale.set(Math.min(180, safeWidth * 0.32), 48, 1);
|
|
231
|
+
status.mesh.position.set(worldX(barX), worldY(Math.min(height, barY + barHeight * 2.5)), 0);
|
|
232
|
+
}
|
|
233
|
+
if (backdropTexture !== undefined)
|
|
234
|
+
coverUv(backdrop.geometry, backdropTexture, width, height, fillBaseU, fillBaseV);
|
|
235
|
+
};
|
|
236
|
+
|
|
237
|
+
const updateProgress = (value: number): void => {
|
|
238
|
+
const bounded = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
|
|
239
|
+
// A missing or incomplete backend observation cannot prove that all first-use work is done.
|
|
240
|
+
// Keep the bar visibly indeterminate until readiness removes the cover; never turn unknown
|
|
241
|
+
// coverage into a false 100% claim.
|
|
242
|
+
const observationUnknown =
|
|
243
|
+
host.startup.warmup !== undefined && host.startup.warmup.status !== "complete";
|
|
244
|
+
progress = observationUnknown ? Math.min(0.9, bounded) : bounded;
|
|
245
|
+
setFillUv(fill.geometry, progress, fillBaseU);
|
|
246
|
+
status?.update(progress);
|
|
247
|
+
layout();
|
|
248
|
+
};
|
|
249
|
+
|
|
250
|
+
const attachTexture = (mesh: Mesh<PlaneGeometry, MeshBasicMaterial>, texture: Texture): void => {
|
|
251
|
+
if (done) return;
|
|
252
|
+
configureTexture(texture);
|
|
253
|
+
mesh.material.map = texture;
|
|
254
|
+
mesh.material.color.set(0xffffff);
|
|
255
|
+
mesh.material.needsUpdate = true;
|
|
256
|
+
ownedTextures.add(texture);
|
|
257
|
+
if (mesh === backdrop) backdropTexture = texture;
|
|
258
|
+
layout();
|
|
259
|
+
updateProgress(progress);
|
|
260
|
+
};
|
|
261
|
+
|
|
262
|
+
const load = (source: string | undefined, mesh: Mesh<PlaneGeometry, MeshBasicMaterial>): void => {
|
|
263
|
+
if (source === undefined || host.assets === undefined) return;
|
|
264
|
+
void host.assets
|
|
265
|
+
.texture(source)
|
|
266
|
+
.then((texture) => attachTexture(mesh, texture))
|
|
267
|
+
.catch(() => undefined);
|
|
268
|
+
};
|
|
269
|
+
load(loading.backgroundImage, backdrop);
|
|
270
|
+
load(loading.fillImage, fill);
|
|
271
|
+
if (logo !== undefined && loading.logoImage !== undefined && host.assets !== undefined) {
|
|
272
|
+
void host.assets
|
|
273
|
+
.texture(loading.logoImage)
|
|
274
|
+
.then((texture) => {
|
|
275
|
+
if (done) return;
|
|
276
|
+
configureTexture(texture);
|
|
277
|
+
logo.material.map = texture;
|
|
278
|
+
logo.material.needsUpdate = true;
|
|
279
|
+
logo.visible = true;
|
|
280
|
+
ownedTextures.add(texture);
|
|
281
|
+
layout();
|
|
282
|
+
})
|
|
283
|
+
.catch(() => undefined);
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
layer.opaque = true;
|
|
287
|
+
layout();
|
|
288
|
+
updateProgress(0);
|
|
289
|
+
|
|
290
|
+
const finish = (): void => {
|
|
291
|
+
if (done) return;
|
|
292
|
+
done = true;
|
|
293
|
+
for (const mesh of parts) {
|
|
294
|
+
mesh.removeFromParent();
|
|
295
|
+
mesh.geometry.dispose();
|
|
296
|
+
mesh.material.dispose();
|
|
297
|
+
}
|
|
298
|
+
for (const texture of ownedTextures) texture.dispose();
|
|
299
|
+
layer.opaque = false;
|
|
300
|
+
};
|
|
301
|
+
|
|
302
|
+
void (async () => {
|
|
303
|
+
await host.startup.whenReady();
|
|
304
|
+
if (done) return;
|
|
305
|
+
// Prewarm the world's shaders, but do not wait for them here. `whenReady()` already means the
|
|
306
|
+
// world is safe to show, and compiling a lit, post-processed scene takes far longer than the
|
|
307
|
+
// launch window: hold the screen for it and a playtest — which advances a fixed step as fast
|
|
308
|
+
// as the machine allows — runs an entire scenario behind the launch screen, so every capture
|
|
309
|
+
// photographs the loading bar instead of the game. The prewarm still happens; it no longer
|
|
310
|
+
// decides when the player sees the world.
|
|
311
|
+
try {
|
|
312
|
+
void host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
|
|
313
|
+
} catch {
|
|
314
|
+
// A renderer without compileAsync is not a reason to keep the world hidden.
|
|
315
|
+
}
|
|
316
|
+
finish();
|
|
317
|
+
})();
|
|
318
|
+
|
|
319
|
+
return {
|
|
320
|
+
finish,
|
|
321
|
+
update(): void {
|
|
322
|
+
if (!done) updateProgress(host.startup.progress);
|
|
323
|
+
},
|
|
324
|
+
};
|
|
325
|
+
}
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
// Generated for you. Own converted materials; preserve borrowed and authored assignments.
|
|
2
|
+
import { Material, Mesh, MeshStandardMaterial, type Object3D, type Scene } from "three";
|
|
3
|
+
import { type IBacklightControls, backlightMaterial } from "./backlightMaterial.js";
|
|
4
|
+
interface IMaterialAssignment {
|
|
5
|
+
readonly mesh: Mesh;
|
|
6
|
+
readonly original: Mesh["material"];
|
|
7
|
+
applied?: Mesh["material"];
|
|
8
|
+
slots?: readonly Material[];
|
|
9
|
+
readonly owned: Set<MeshStandardMaterial>;
|
|
10
|
+
readonly exclusions: string[];
|
|
11
|
+
}
|
|
12
|
+
export function createMaterialAssignments(scene: Scene, controls: IBacklightControls) {
|
|
13
|
+
const assignments = new Map<Mesh, IMaterialAssignment>();
|
|
14
|
+
const references = new Map<MeshStandardMaterial, number>();
|
|
15
|
+
let enabled = false;
|
|
16
|
+
let disposed = false;
|
|
17
|
+
const converted = new Map<MeshStandardMaterial, ReturnType<typeof backlightMaterial>>();
|
|
18
|
+
const originalOf = new Map<Material, MeshStandardMaterial>();
|
|
19
|
+
function enroll(root: Object3D): void {
|
|
20
|
+
if (disposed) return;
|
|
21
|
+
root.traverse((object) => {
|
|
22
|
+
if (!(object instanceof Mesh) || assignments.has(object)) return;
|
|
23
|
+
const assignment: IMaterialAssignment = {
|
|
24
|
+
mesh: object,
|
|
25
|
+
original: object.material,
|
|
26
|
+
owned: new Set(),
|
|
27
|
+
exclusions: [],
|
|
28
|
+
};
|
|
29
|
+
assignments.set(object, assignment);
|
|
30
|
+
assignment.exclusions.push(...excludedSlots(object));
|
|
31
|
+
if (enabled) applyAssignment(assignment);
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
function release(root: Object3D): void {
|
|
35
|
+
root.traverse((object) => {
|
|
36
|
+
if (!(object instanceof Mesh)) return;
|
|
37
|
+
const assignment = assignments.get(object);
|
|
38
|
+
if (assignment === undefined) return;
|
|
39
|
+
restore(assignment);
|
|
40
|
+
assignments.delete(object);
|
|
41
|
+
for (const source of assignment.owned) releaseConversion(source);
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
function excludedSlots(mesh: Mesh): string[] {
|
|
45
|
+
const slots = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
|
|
46
|
+
return slots.flatMap((material) => {
|
|
47
|
+
const reason = unsupported(material);
|
|
48
|
+
return reason === undefined
|
|
49
|
+
? []
|
|
50
|
+
: [`${mesh.name || mesh.type}:${material.name || material.type}:${reason}`];
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
function releaseConversion(source: MeshStandardMaterial): void {
|
|
54
|
+
const remaining = (references.get(source) ?? 1) - 1;
|
|
55
|
+
if (remaining > 0) {
|
|
56
|
+
references.set(source, remaining);
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
const material = converted.get(source);
|
|
60
|
+
if (material !== undefined) {
|
|
61
|
+
material.dispose();
|
|
62
|
+
originalOf.delete(material);
|
|
63
|
+
}
|
|
64
|
+
references.delete(source);
|
|
65
|
+
converted.delete(source);
|
|
66
|
+
}
|
|
67
|
+
function unsupported(material: Material): string | undefined {
|
|
68
|
+
if (!(material instanceof MeshStandardMaterial) || material.type !== "MeshStandardMaterial")
|
|
69
|
+
return "unsupported material type";
|
|
70
|
+
if (
|
|
71
|
+
material.onBeforeCompile !== Material.prototype.onBeforeCompile ||
|
|
72
|
+
material.customProgramCacheKey !== Material.prototype.customProgramCacheKey
|
|
73
|
+
)
|
|
74
|
+
return "custom shader requires separate qualification";
|
|
75
|
+
return undefined;
|
|
76
|
+
}
|
|
77
|
+
function convert(material: Material, assignment: IMaterialAssignment): Material {
|
|
78
|
+
if (unsupported(material) !== undefined) return material;
|
|
79
|
+
const standard = material as MeshStandardMaterial;
|
|
80
|
+
let owned = converted.get(standard);
|
|
81
|
+
if (owned === undefined) {
|
|
82
|
+
owned = backlightMaterial(standard, controls);
|
|
83
|
+
converted.set(standard, owned);
|
|
84
|
+
originalOf.set(owned, standard);
|
|
85
|
+
}
|
|
86
|
+
if (!assignment.owned.has(standard)) {
|
|
87
|
+
assignment.owned.add(standard);
|
|
88
|
+
references.set(standard, (references.get(standard) ?? 0) + 1);
|
|
89
|
+
}
|
|
90
|
+
return owned;
|
|
91
|
+
}
|
|
92
|
+
function restore(assignment: IMaterialAssignment): void {
|
|
93
|
+
const current = assignment.mesh.material;
|
|
94
|
+
if (current === assignment.applied) {
|
|
95
|
+
const unchanged =
|
|
96
|
+
!Array.isArray(current) ||
|
|
97
|
+
(current.length === assignment.slots?.length &&
|
|
98
|
+
current.every((material, index) => material === assignment.slots?.[index]));
|
|
99
|
+
if (unchanged) {
|
|
100
|
+
assignment.mesh.material = assignment.original;
|
|
101
|
+
return;
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
// Preserve authored array edits/replacements, but never leave an owned conversion attached.
|
|
105
|
+
if (Array.isArray(current)) {
|
|
106
|
+
const restored = current.map((material) => originalOf.get(material) ?? material);
|
|
107
|
+
if (restored.some((material, index) => material !== current[index]))
|
|
108
|
+
assignment.mesh.material = restored;
|
|
109
|
+
} else assignment.mesh.material = originalOf.get(current) ?? current;
|
|
110
|
+
}
|
|
111
|
+
function applyAssignment(assignment: IMaterialAssignment): void {
|
|
112
|
+
// The game's later material override wins; never overwrite it on a tier recovery.
|
|
113
|
+
if (assignment.mesh.material !== assignment.original) return;
|
|
114
|
+
if (Array.isArray(assignment.original)) {
|
|
115
|
+
// Borrowed arrays may be edited in place during a fallback. Read their current slots.
|
|
116
|
+
const slots = assignment.original.map((material) => convert(material, assignment));
|
|
117
|
+
assignment.applied = slots.some(
|
|
118
|
+
(material, index) => material !== (assignment.original as Material[])[index],
|
|
119
|
+
)
|
|
120
|
+
? slots
|
|
121
|
+
: assignment.original;
|
|
122
|
+
assignment.slots = [...slots];
|
|
123
|
+
} else if (assignment.applied === undefined) {
|
|
124
|
+
assignment.applied = convert(assignment.original, assignment);
|
|
125
|
+
}
|
|
126
|
+
assignment.mesh.material = assignment.applied;
|
|
127
|
+
}
|
|
128
|
+
enroll(scene);
|
|
129
|
+
return {
|
|
130
|
+
enroll,
|
|
131
|
+
release,
|
|
132
|
+
setEnabled(requested: boolean): void {
|
|
133
|
+
if (disposed) return;
|
|
134
|
+
enabled = requested;
|
|
135
|
+
for (const assignment of assignments.values()) {
|
|
136
|
+
if (enabled) applyAssignment(assignment);
|
|
137
|
+
else restore(assignment);
|
|
138
|
+
}
|
|
139
|
+
},
|
|
140
|
+
debug: () => ({
|
|
141
|
+
convertedMaterials: converted.size,
|
|
142
|
+
enrolledMeshes: assignments.size,
|
|
143
|
+
excludedSlots: [...assignments.values()].reduce(
|
|
144
|
+
(sum, value) => sum + value.exclusions.length,
|
|
145
|
+
0,
|
|
146
|
+
),
|
|
147
|
+
exclusions: [...assignments.values()].flatMap((value) => value.exclusions),
|
|
148
|
+
}),
|
|
149
|
+
dispose(): void {
|
|
150
|
+
if (disposed) return;
|
|
151
|
+
disposed = true;
|
|
152
|
+
for (const assignment of assignments.values()) restore(assignment);
|
|
153
|
+
assignments.clear();
|
|
154
|
+
references.clear();
|
|
155
|
+
for (const material of converted.values()) material.dispose();
|
|
156
|
+
converted.clear();
|
|
157
|
+
originalOf.clear();
|
|
158
|
+
},
|
|
159
|
+
};
|
|
160
|
+
}
|