@immugio/three-math-extensions 0.0.16 → 0.1.0

package/CHANGELOG.md

@@ -7,7 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
-## [0.0.16](https://github.com/Immugio/three-math-extensions/compare/0.0.15...0.0.16)
+## [0.1.0](https://github.com/Immugio/three-math-extensions/compare/16.15.10...0.1.0)
+
+### Commits
+
+- Add Polygon [`629cff8`](https://github.com/Immugio/three-math-extensions/commit/629cff8ecbb963477e8ea76d7f8b16d95435cbad)
+- Vec2.fromPoint and Vec3.fromPoint should accept null [`4b871af`](https://github.com/Immugio/three-math-extensions/commit/4b871af297bdcbe8584f1e2b99d602247b77687c)
+
+## [16.15.10](https://github.com/Immugio/three-math-extensions/compare/0.0.17...16.15.10) - 2023-01-02
+
+## [0.0.17](https://github.com/Immugio/three-math-extensions/compare/0.0.16...0.0.17) - 2023-01-02
+
+### Commits
+
+- Vec2.fromPoint and Vec3.fromPoint should accept null [`4b871af`](https://github.com/Immugio/three-math-extensions/commit/4b871af297bdcbe8584f1e2b99d602247b77687c)
+
+## [0.0.16](https://github.com/Immugio/three-math-extensions/compare/0.0.15...0.0.16) - 2022-12-28
 
 ### Commits
 

package/cjs/Polygon.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Polygon = void 0;
+const Vec2_1 = require("./Vec2");
+const Size2_1 = require("./Size2");
+class Polygon {
+    contour;
+    holes;
+    constructor(contour, holes) {
+        this.contour = contour;
+        this.holes = holes;
+    }
+    static fromPoints(contour, holes) {
+        return new Polygon(contour.map(p => Vec2_1.Vec2.fromPoint(p)), holes?.map(h => h.map(p => Vec2_1.Vec2.fromPoint(p))));
+    }
+    get size() {
+        const { minX, maxX, minY, maxY } = this.boundingBox();
+        return new Size2_1.Size2(maxX - minX, maxY - minY);
+    }
+    centerOnOrigin() {
+        const center = this.center();
+        function centerPoints(points) {
+            for (const point of points) {
+                point.x -= center.x;
+                point.y -= center.y;
+            }
+        }
+        centerPoints(this.contour);
+        for (const hole of this.holes || []) {
+            centerPoints(hole);
+        }
+        return this;
+    }
+    center() {
+        const { minX, maxX, minY, maxY } = this.boundingBox();
+        const x = (maxX + minX) / 2;
+        const y = (maxY + minY) / 2;
+        return new Vec2_1.Vec2(x, y);
+    }
+    ensureLastPoint() {
+        function ensure(points) {
+            if (points[0].x !== points.at(-1).x || points[0].y !== points.at(-1).y) {
+                points.push(points[0].clone());
+            }
+        }
+        ensure(this.contour);
+        for (const hole of this.holes || []) {
+            ensure(hole);
+        }
+        return this;
+    }
+    boundingBox() {
+        let minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity;
+        for (const p of this.contour) {
+            if (minX > p.x)
+                minX = p.x;
+            if (maxX < p.x)
+                maxX = p.x;
+            if (minY > p.y)
+                minY = p.y;
+            if (maxY < p.y)
+                maxY = p.y;
+        }
+        return { minX, maxX, minY, maxY };
+    }
+    toBoundingPolygon() {
+        const bounding = this.boundingBox();
+        return new Polygon([
+            new Vec2_1.Vec2(bounding.minX, bounding.minY),
+            new Vec2_1.Vec2(bounding.maxX, bounding.minY),
+            new Vec2_1.Vec2(bounding.maxX, bounding.maxY),
+            new Vec2_1.Vec2(bounding.minX, bounding.maxY),
+        ]);
+    }
+    flip() {
+        const centerX = this.center().x;
+        this.flipSingle(centerX, this.contour);
+        this.holes?.forEach(hole => this.flipSingle(centerX, hole));
+        return this;
+    }
+    flipSingle(centerX, poly) {
+        for (const point of poly) {
+            const xDistanceToCenter = Math.abs(centerX - point.x);
+            point.x = point.x < centerX ? centerX + xDistanceToCenter : centerX - xDistanceToCenter;
+        }
+    }
+}
+exports.Polygon = Polygon;

package/cjs/Size2.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Size2 = void 0;
+class Size2 {
+    width;
+    height;
+    constructor(width, height) {
+        this.width = width;
+        this.height = height;
+    }
+}
+exports.Size2 = Size2;

package/cjs/Vec2.js

@@ -13,7 +13,7 @@ class Vec2 extends three_1.Vector2 {
      * @returns A new Vec2 instance.
      */
     static fromPoint(point) {
-        return new Vec2(point.x, point.y);
+        return new Vec2(point?.x, point?.y);
     }
     /**
      * Moves this Vec2 instance towards the target Vec2 by the given amount.

package/cjs/Vec3.js

@@ -14,7 +14,7 @@ class Vec3 extends three_1.Vector3 {
      * @returns A new Vec3 instance.
      */
     static fromPoint(point) {
-        return new Vec3(point.x, point.y, point.z);
+        return new Vec3(point?.x, point?.y, point?.z);
     }
     /**
      * Moves this Vec3 instance towards the target Vec3 by the given amount.

package/esm/Polygon.js

@@ -0,0 +1,84 @@
+import { Vec2 } from "./Vec2";
+import { Size2 } from "./Size2";
+export class Polygon {
+    contour;
+    holes;
+    constructor(contour, holes) {
+        this.contour = contour;
+        this.holes = holes;
+    }
+    static fromPoints(contour, holes) {
+        return new Polygon(contour.map(p => Vec2.fromPoint(p)), holes?.map(h => h.map(p => Vec2.fromPoint(p))));
+    }
+    get size() {
+        const { minX, maxX, minY, maxY } = this.boundingBox();
+        return new Size2(maxX - minX, maxY - minY);
+    }
+    centerOnOrigin() {
+        const center = this.center();
+        function centerPoints(points) {
+            for (const point of points) {
+                point.x -= center.x;
+                point.y -= center.y;
+            }
+        }
+        centerPoints(this.contour);
+        for (const hole of this.holes || []) {
+            centerPoints(hole);
+        }
+        return this;
+    }
+    center() {
+        const { minX, maxX, minY, maxY } = this.boundingBox();
+        const x = (maxX + minX) / 2;
+        const y = (maxY + minY) / 2;
+        return new Vec2(x, y);
+    }
+    ensureLastPoint() {
+        function ensure(points) {
+            if (points[0].x !== points.at(-1).x || points[0].y !== points.at(-1).y) {
+                points.push(points[0].clone());
+            }
+        }
+        ensure(this.contour);
+        for (const hole of this.holes || []) {
+            ensure(hole);
+        }
+        return this;
+    }
+    boundingBox() {
+        let minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity;
+        for (const p of this.contour) {
+            if (minX > p.x)
+                minX = p.x;
+            if (maxX < p.x)
+                maxX = p.x;
+            if (minY > p.y)
+                minY = p.y;
+            if (maxY < p.y)
+                maxY = p.y;
+        }
+        return { minX, maxX, minY, maxY };
+    }
+    toBoundingPolygon() {
+        const bounding = this.boundingBox();
+        return new Polygon([
+            new Vec2(bounding.minX, bounding.minY),
+            new Vec2(bounding.maxX, bounding.minY),
+            new Vec2(bounding.maxX, bounding.maxY),
+            new Vec2(bounding.minX, bounding.maxY),
+        ]);
+    }
+    flip() {
+        const centerX = this.center().x;
+        this.flipSingle(centerX, this.contour);
+        this.holes?.forEach(hole => this.flipSingle(centerX, hole));
+        return this;
+    }
+    flipSingle(centerX, poly) {
+        for (const point of poly) {
+            const xDistanceToCenter = Math.abs(centerX - point.x);
+            point.x = point.x < centerX ? centerX + xDistanceToCenter : centerX - xDistanceToCenter;
+        }
+    }
+}

package/esm/Size2.js

@@ -0,0 +1,8 @@
+export class Size2 {
+    width;
+    height;
+    constructor(width, height) {
+        this.width = width;
+        this.height = height;
+    }
+}

package/esm/Vec2.js

@@ -10,7 +10,7 @@ export class Vec2 extends Vector2 {
      * @returns A new Vec2 instance.
      */
     static fromPoint(point) {
-        return new Vec2(point.x, point.y);
+        return new Vec2(point?.x, point?.y);
     }
     /**
      * Moves this Vec2 instance towards the target Vec2 by the given amount.

package/esm/Vec3.js

@@ -11,7 +11,7 @@ export class Vec3 extends Vector3 {
      * @returns A new Vec3 instance.
      */
     static fromPoint(point) {
-        return new Vec3(point.x, point.y, point.z);
+        return new Vec3(point?.x, point?.y, point?.z);
     }
     /**
      * Moves this Vec3 instance towards the target Vec3 by the given amount.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immugio/three-math-extensions",
-  "version": "0.0.16",
+  "version": "0.1.0",
   "description": "Set of utilities for 2d and 3d line math built on top of three.js",
   "author": "Jan Mikeska <janmikeska@gmail.com>",
   "license": "ISC",

package/src/Polygon.ts

@@ -0,0 +1,99 @@
+import { Point2 } from "./Point2";
+import { Vec2 } from "./Vec2";
+import { Size2 } from "./Size2";
+
+export class Polygon {
+
+    constructor(public contour: Vec2[], public holes?: Vec2[][]) {
+    }
+
+    public static fromPoints(contour: Point2[], holes?: Point2[][]) {
+        return new Polygon(contour.map(p => Vec2.fromPoint(p)), holes?.map(h => h.map(p => Vec2.fromPoint(p))));
+    }
+
+    public get size(): Size2 {
+        const {minX, maxX, minY, maxY} = this.boundingBox();
+        return new Size2(maxX - minX, maxY - minY);
+    }
+
+    public centerOnOrigin(): Polygon {
+        const center = this.center();
+
+        function centerPoints(points: Vec2[]): void {
+            for (const point of points) {
+                point.x -= center.x;
+                point.y -= center.y;
+            }
+        }
+
+        centerPoints(this.contour);
+
+        for (const hole of this.holes || []) {
+            centerPoints(hole);
+        }
+
+        return this;
+    }
+
+    public center(): Vec2 {
+        const {minX, maxX, minY, maxY} = this.boundingBox();
+
+        const x = (maxX + minX) / 2;
+        const y = (maxY + minY) / 2;
+
+        return new Vec2(x, y);
+    }
+
+    public ensureLastPoint(): Polygon {
+        function ensure(points: Vec2[]): void {
+            if (points[0].x !== points.at(-1).x || points[0].y !== points.at(-1).y) {
+                points.push(points[0].clone());
+            }
+        }
+
+        ensure(this.contour);
+
+        for (const hole of this.holes || []) {
+            ensure(hole);
+        }
+
+        return this;
+    }
+
+    public boundingBox(): { minX: number, maxX: number, minY: number, maxY: number } {
+        let minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity;
+
+        for (const p of this.contour) {
+            if (minX > p.x) minX = p.x;
+            if (maxX < p.x) maxX = p.x;
+            if (minY > p.y) minY = p.y;
+            if (maxY < p.y) maxY = p.y;
+        }
+
+        return {minX, maxX, minY, maxY};
+    }
+
+    public toBoundingPolygon(): Polygon {
+        const bounding = this.boundingBox();
+        return new Polygon([
+            new Vec2(bounding.minX, bounding.minY),
+            new Vec2(bounding.maxX, bounding.minY),
+            new Vec2(bounding.maxX, bounding.maxY),
+            new Vec2(bounding.minX, bounding.maxY),
+        ]);
+    }
+
+    public flip(): Polygon {
+        const centerX = this.center().x;
+        this.flipSingle(centerX, this.contour);
+        this.holes?.forEach(hole => this.flipSingle(centerX, hole));
+        return this;
+    }
+
+    private flipSingle(centerX: number, poly: Vec2[]) {
+        for (const point of poly) {
+            const xDistanceToCenter = Math.abs(centerX - point.x);
+            point.x = point.x < centerX ? centerX + xDistanceToCenter : centerX - xDistanceToCenter;
+        }
+    }
+}

package/src/Size2.ts

@@ -0,0 +1,4 @@
+export class Size2 {
+    constructor(public width: number, public height: number) {
+    }
+}

package/src/Vec2.ts

@@ -13,7 +13,7 @@ export class Vec2 extends Vector2 {
      * @returns A new Vec2 instance.
      */
     public static fromPoint(point: Point2): Vec2 {
-        return new Vec2(point.x, point.y);
+        return new Vec2(point?.x, point?.y);
     }
 
     /**

package/src/Vec3.ts

@@ -15,7 +15,7 @@ export class Vec3 extends Vector3 {
      * @returns A new Vec3 instance.
      */
     public static fromPoint(point: Point3): Vec3 {
-        return new Vec3(point.x, point.y, point.z);
+        return new Vec3(point?.x, point?.y, point?.z);
     }
 
     /**

package/types/Polygon.d.ts

@@ -0,0 +1,22 @@
+import { Point2 } from "./Point2";
+import { Vec2 } from "./Vec2";
+import { Size2 } from "./Size2";
+export declare class Polygon {
+    contour: Vec2[];
+    holes?: Vec2[][];
+    constructor(contour: Vec2[], holes?: Vec2[][]);
+    static fromPoints(contour: Point2[], holes?: Point2[][]): Polygon;
+    get size(): Size2;
+    centerOnOrigin(): Polygon;
+    center(): Vec2;
+    ensureLastPoint(): Polygon;
+    boundingBox(): {
+        minX: number;
+        maxX: number;
+        minY: number;
+        maxY: number;
+    };
+    toBoundingPolygon(): Polygon;
+    flip(): Polygon;
+    private flipSingle;
+}

package/types/Size2.d.ts

@@ -0,0 +1,5 @@
+export declare class Size2 {
+    width: number;
+    height: number;
+    constructor(width: number, height: number);
+}