@logomarks/core 0.1.11 → 0.2.1

package/src/util/vec.js

@@ -0,0 +1,61 @@
+/**
+ * Small vector helpers several part families share (the Logomarks tools had a copy in each of the ink-trap, tech,
+ * echo and plane parts), each written once here so they all draw with the same arithmetic.
+ */
+import { rect } from '../geometry/index.js';
+
+/**
+ * a − b, in 2D.
+ *
+ * @param {readonly number[]} a The point.
+ * @param {readonly number[]} b The point taken away.
+ * @returns {import('../geometry/types.js').Point} The difference.
+ */
+export const sub = (a, b) => [a[0] - b[0], a[1] - b[1]];
+
+/**
+ * a + b, in 2D.
+ *
+ * @param {readonly number[]} a The point.
+ * @param {readonly number[]} b The point added.
+ * @returns {import('../geometry/types.js').Point} The sum.
+ */
+export const add = (a, b) => [a[0] + b[0], a[1] + b[1]];
+
+/**
+ * a scaled by k, in 2D.
+ *
+ * @param {readonly number[]} a The vector.
+ * @param {number} k The factor.
+ * @returns {import('../geometry/types.js').Point} The scaled vector.
+ */
+export const mul = (a, k) => [a[0] * k, a[1] * k];
+
+/**
+ * The cross product of two 3D vectors.
+ *
+ * @param {readonly number[]} a The first.
+ * @param {readonly number[]} b The second.
+ * @returns {import('../geometry/types.js').Point3} a × b.
+ */
+export const cross3 = (a, b) => [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
+
+/**
+ * A ring's signed area by the shoelace sum, added up point by point (positive when it runs clockwise on screen, y
+ * down). The geometry kit's signedArea() sums the same terms in another order, so the two can differ in the last bit.
+ *
+ * @param {readonly (readonly number[])[]} r The ring.
+ * @returns {number} The area, signed.
+ */
+export const shoelace = (r) => r.reduce((s, p, i) => { const q = r[(i + 1) % r.length]; return s + p[0] * q[1] - q[0] * p[1]; }, 0) / 2;
+
+/**
+ * A rectangle from its corners (x0, y0) and (x1, y1).
+ *
+ * @param {number} x0 Left.
+ * @param {number} y0 Top.
+ * @param {number} x1 Right.
+ * @param {number} y1 Bottom.
+ * @returns {import('../geometry/types.js').Polygon} The rectangle.
+ */
+export const box = (x0, y0, x1, y1) => rect(x0, y0, x1 - x0, y1 - y0);