@immugio/three-math-extensions 0.2.23 → 0.2.24

package/CHANGELOG.md

@@ -7,7 +7,13 @@ 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.2.23](https://github.com/Immugio/three-math-extensions/compare/0.2.22...0.2.23)
+## [0.2.24](https://github.com/Immugio/three-math-extensions/compare/0.2.23...0.2.24)
+
+### Commits
+
+- Add Polygon.containsPoint and Polygon.perimeter [`9bdf2dd`](https://github.com/Immugio/three-math-extensions/commit/9bdf2ddb5823878b5d41dadf14a225f7a1f0fd8f)
+
+## [0.2.23](https://github.com/Immugio/three-math-extensions/compare/0.2.22...0.2.23) - 2024-04-16
 
 ### Commits
 

package/cjs/Polygon.js

@@ -4,6 +4,8 @@ exports.Polygon = void 0;
 const Vec2_1 = require("./Vec2");
 const Rectangle_1 = require("./Rectangle");
 const BoundingBox_1 = require("./BoundingBox");
+const polygonPerimeter_1 = require("./polygonPerimeter");
+const isPointInPolygon_1 = require("./isPointInPolygon");
 class Polygon {
     contour;
     holes;
@@ -87,6 +89,12 @@ class Polygon {
         this.holes?.forEach(hole => this.flipSingle(centerX, hole));
         return this;
     }
+    perimeter() {
+        return (0, polygonPerimeter_1.polygonPerimeter)(this.contour);
+    }
+    containsPoint(point) {
+        return (0, isPointInPolygon_1.isPointInPolygon)(this.contour, point) && (this.holes || []).every(hole => !(0, isPointInPolygon_1.isPointInPolygon)(hole, point));
+    }
     flipSingle(centerX, poly) {
         for (const point of poly) {
             const xDistanceToCenter = Math.abs(centerX - point.x);

package/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isContinuousClosedShape = exports.directions2d = exports.directions = exports.isPointInPolygon = exports.HalfPI = exports.TwoPI = exports.normalizeAngleRadians = exports.normalizeAngleDegrees = exports.Rectangle = exports.BoundingBox = exports.Polygon = exports.Size2 = exports.Line3D = exports.Line2D = exports.Vec3 = exports.Vec2 = void 0;
+exports.polygonPerimeter = exports.isContinuousClosedShape = exports.directions2d = exports.directions = exports.isPointInPolygon = exports.HalfPI = exports.TwoPI = exports.normalizeAngleRadians = exports.normalizeAngleDegrees = exports.Rectangle = exports.BoundingBox = exports.Polygon = exports.Size2 = exports.Line3D = exports.Line2D = exports.Vec3 = exports.Vec2 = void 0;
 var Vec2_1 = require("./Vec2");
 Object.defineProperty(exports, "Vec2", { enumerable: true, get: function () { return Vec2_1.Vec2; } });
 var Vec3_1 = require("./Vec3");
@@ -32,3 +32,5 @@ var directions2d_1 = require("./directions2d");
 Object.defineProperty(exports, "directions2d", { enumerable: true, get: function () { return directions2d_1.directions2d; } });
 var isContinuousClosedShape_1 = require("./isContinuousClosedShape");
 Object.defineProperty(exports, "isContinuousClosedShape", { enumerable: true, get: function () { return isContinuousClosedShape_1.isContinuousClosedShape; } });
+var polygonPerimeter_1 = require("./polygonPerimeter");
+Object.defineProperty(exports, "polygonPerimeter", { enumerable: true, get: function () { return polygonPerimeter_1.polygonPerimeter; } });

package/cjs/polygonPerimeter.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.polygonPerimeter = void 0;
+function polygonPerimeter(polygon, forceClosedPolygon = false) {
+    if (forceClosedPolygon && !polygon[0].equals(polygon.at(-1))) {
+        polygon = [...polygon];
+        polygon.push(polygon[0].clone());
+    }
+    let length = 0;
+    for (let i = 0; i < polygon.length - 1; i++) {
+        length += polygon[i].distanceTo(polygon[i + 1]);
+    }
+    return length;
+}
+exports.polygonPerimeter = polygonPerimeter;

package/esm/Polygon.js

@@ -1,6 +1,8 @@
 import { Vec2 } from "./Vec2";
 import { Rectangle } from "./Rectangle";
 import { BoundingBox } from "./BoundingBox";
+import { polygonPerimeter } from "./polygonPerimeter";
+import { isPointInPolygon } from "./isPointInPolygon";
 export class Polygon {
     contour;
     holes;
@@ -84,6 +86,12 @@ export class Polygon {
         this.holes?.forEach(hole => this.flipSingle(centerX, hole));
         return this;
     }
+    perimeter() {
+        return polygonPerimeter(this.contour);
+    }
+    containsPoint(point) {
+        return isPointInPolygon(this.contour, point) && (this.holes || []).every(hole => !isPointInPolygon(hole, point));
+    }
     flipSingle(centerX, poly) {
         for (const point of poly) {
             const xDistanceToCenter = Math.abs(centerX - point.x);

package/esm/index.js

@@ -13,3 +13,4 @@ export { isPointInPolygon } from "./isPointInPolygon";
 export { directions } from "./directions";
 export { directions2d } from "./directions2d";
 export { isContinuousClosedShape } from "./isContinuousClosedShape";
+export { polygonPerimeter } from "./polygonPerimeter";

package/esm/polygonPerimeter.js

@@ -0,0 +1,11 @@
+export function polygonPerimeter(polygon, forceClosedPolygon = false) {
+    if (forceClosedPolygon && !polygon[0].equals(polygon.at(-1))) {
+        polygon = [...polygon];
+        polygon.push(polygon[0].clone());
+    }
+    let length = 0;
+    for (let i = 0; i < polygon.length - 1; i++) {
+        length += polygon[i].distanceTo(polygon[i + 1]);
+    }
+    return length;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immugio/three-math-extensions",
-  "version": "0.2.23",
+  "version": "0.2.24",
   "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

@@ -2,6 +2,8 @@
 import { Vec2 } from "./Vec2";
 import { Rectangle } from "./Rectangle";
 import { BoundingBox } from "./BoundingBox";
+import { polygonPerimeter } from "./polygonPerimeter";
+import { isPointInPolygon } from "./isPointInPolygon";
 
 export class Polygon {
 
@@ -100,6 +102,14 @@ export class Polygon {
         return this;
     }
 
+    public perimeter(): number {
+        return polygonPerimeter(this.contour);
+    }
+
+    public containsPoint(point: Vec2): boolean {
+        return isPointInPolygon(this.contour, point) && (this.holes || []).every(hole => !isPointInPolygon(hole, point));
+    }
+
     private flipSingle(centerX: number, poly: Vec2[]) {
         for (const point of poly) {
             const xDistanceToCenter = Math.abs(centerX - point.x);

package/src/index.ts

@@ -14,4 +14,5 @@ export { Point3 } from "./Point3";
 export { isPointInPolygon } from "./isPointInPolygon";
 export { directions } from "./directions";
 export { directions2d } from "./directions2d";
-export { isContinuousClosedShape } from "./isContinuousClosedShape";
+export { isContinuousClosedShape } from "./isContinuousClosedShape";
+export { polygonPerimeter } from "./polygonPerimeter";

package/src/polygonPerimeter.ts

@@ -0,0 +1,14 @@
+import { Vec2 } from "./Vec2";
+
+export function polygonPerimeter(polygon: Vec2[], forceClosedPolygon: boolean = false): number {
+    if (forceClosedPolygon && !polygon[0].equals(polygon.at(-1))) {
+        polygon = [...polygon];
+        polygon.push(polygon[0].clone());
+    }
+
+    let length = 0;
+    for (let i = 0; i < polygon.length - 1; i++) {
+        length += polygon[i].distanceTo(polygon[i + 1]);
+    }
+    return length;
+}

package/types/Polygon.d.ts

@@ -15,6 +15,8 @@ export declare class Polygon {
     boundingBox(): BoundingBox;
     toBoundingPolygon(): Polygon;
     flip(): Polygon;
+    perimeter(): number;
+    containsPoint(point: Vec2): boolean;
     private flipSingle;
     toRectangle(): Rectangle;
     clone(): Polygon;

package/types/index.d.ts

@@ -15,3 +15,4 @@ export { isPointInPolygon } from "./isPointInPolygon";
 export { directions } from "./directions";
 export { directions2d } from "./directions2d";
 export { isContinuousClosedShape } from "./isContinuousClosedShape";
+export { polygonPerimeter } from "./polygonPerimeter";

package/types/polygonPerimeter.d.ts

@@ -0,0 +1,2 @@
+import { Vec2 } from "./Vec2";
+export declare function polygonPerimeter(polygon: Vec2[], forceClosedPolygon?: boolean): number;