castle-web-cli 0.4.84 → 0.4.85

package/kits/physics-2d/engine/spriteGeometry.js

@@ -0,0 +1,32 @@
+// Shared sprite-to-Layout geometry. Lives in engine/ (not behaviors/) so both
+// Sprite.jsx (rendering) and the Collider rect logic (engine/collider.js) can
+// use the same math without behaviors/ <-> engine/ import cycles.
+
+// Destination rect for a draw mode: the Layout box for `stretch`/`tile`, or an
+// aspect-ratio-preserving centered rect for `fit` and `cover`:
+//   - `fit` (CSS object-fit: contain): the largest rect with the art's aspect
+//     ratio that fits INSIDE the box -- letterboxed sides just aren't drawn.
+//   - `cover` (CSS object-fit: cover): the smallest rect with the art's aspect
+//     ratio that fully COVERS the box -- the overflow is cropped by the caller
+//     clipping to the Layout box (see Sprite.draw).
+// `artSize` only needs `.width`/`.height` -- a rendered canvas or a sprite's
+// `.resolution` both work.
+export function spriteDestRect(mode, layout, artSize) {
+  if (mode !== 'fit' && mode !== 'cover') return layout;
+  const aspect = artSize.width / artSize.height;
+  let width = layout.width;
+  let height = width / aspect;
+  // `fit` shrinks until the art fits inside the box; `cover` grows until it
+  // fills the box. The comparison flips between the two.
+  const overflows = mode === 'fit' ? height > layout.height : height < layout.height;
+  if (overflows) {
+    height = layout.height;
+    width = height * aspect;
+  }
+  return {
+    x: layout.x + (layout.width - width) / 2,
+    y: layout.y + (layout.height - height) / 2,
+    width,
+    height,
+  };
+}