@umicat/three-sdk 0.8.4 → 0.8.5

package/dist/SceneLoader3D.js

@@ -132,7 +132,7 @@ export async function loadScene3D(scene3d, manifest, opts = {}) {
                 const mesh = o;
                 if (!mesh.isMesh)
                     return;
-                mesh.castShadow = true;
+                mesh.castShadow = e.castShadow !== false;
                 mesh.receiveShadow = true;
                 // A SkinnedMesh's bounding sphere is computed from the BIND pose and
                 // does not follow the bones. Once the object moves, three.js culls it
@@ -242,7 +242,14 @@ export async function loadScene3D(scene3d, manifest, opts = {}) {
                 // 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);
+                // Sized for the DEVICE, not for the desktop it was written on. A
+                // 2048 map is four megapixels of extra render target every frame, and
+                // a phone is already drawing at 2x for its screen — that combination
+                // took a board from smooth on a laptop to visibly dropping frames on
+                // an iPhone while looking identical in a screenshot.
+                const dense = typeof window !== 'undefined' && (window.devicePixelRatio ?? 1) > 2;
+                const map = dense ? 512 : 1024;
+                d.shadow.mapSize.set(map, map);
                 d.shadow.bias = -0.0012;
             }
         }

package/dist/scene3d.d.ts

@@ -83,6 +83,15 @@ export interface Entity3D {
     /** Free-form, read by game code. The 2D SDK's `properties` equivalent. */
     properties?: Record<string, unknown>;
     visible?: boolean;
+    /**
+     * Whether this entity casts a shadow. Defaults to true.
+     *
+     * Set it false for ground: a flat tile casting onto the flat tile beside it
+     * produces nothing anyone can see and costs a full extra draw of that mesh
+     * every frame. A board made of 144 tiles was drawing 288 times for 144
+     * tiles' worth of picture.
+     */
+    castShadow?: boolean;
 }
 /**
  * Semantic clip name → the clip actually inside the model.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/three-sdk",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "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",