@umicat/three-sdk 0.8.1 → 0.8.2

package/dist/SceneLoader3D.js

@@ -211,6 +211,42 @@ export async function loadScene3D(scene3d, manifest, opts = {}) {
             bodies.set(e.id, body);
         }
     }
+    // Fit every shadow-casting directional light to the scene it is lighting.
+    //
+    // three.js defaults a directional light's shadow camera to an orthographic
+    // box of +-5 units, and nothing warns when a scene is larger: shadows simply
+    // stop at an invisible square edge, which reads as a strange dark patch in
+    // the middle of the ground rather than as a setting. A board 13 units across
+    // hits it immediately.
+    {
+        const bounds = new THREE.Box3();
+        for (const o of entities.values())
+            bounds.expandByObject(o);
+        if (!bounds.isEmpty()) {
+            const size = bounds.getSize(new THREE.Vector3());
+            const centre = bounds.getCenter(new THREE.Vector3());
+            const radius = Math.max(size.x, size.z) * 0.62 + 1;
+            for (const l of scene.children) {
+                const d = l;
+                if (!d.isDirectionalLight || !d.castShadow)
+                    continue;
+                const c = d.shadow.camera;
+                c.left = -radius;
+                c.right = radius;
+                c.top = radius;
+                c.bottom = -radius;
+                c.near = 0.1;
+                c.far = d.position.length() + radius * 2 + size.y;
+                c.updateProjectionMatrix();
+                // The light points at the scene, not at the origin — an offset scene
+                // would otherwise be lit from the side of a box centred somewhere else.
+                d.target.position.copy(centre);
+                scene.add(d.target);
+                d.shadow.mapSize.set(2048, 2048);
+                d.shadow.bias = -0.0012;
+            }
+        }
+    }
     const camera = new THREE.PerspectiveCamera(scene3d.camera?.fov ?? 55, 1, 0.1, 500);
     const camOffset = toVec(scene3d.camera?.offset ?? { x: 0, y: 4, z: 8 });
     camera.position.copy(camOffset);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/three-sdk",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Three.js runtime for Umicat games: the scene3d design format, its loader with physics, a kinematic character controller, and the Umicat platform via @umicat/platform-sdk.",
   "type": "module",
   "main": "dist/index.js",