@immugio/three-math-extensions 0.2.37 → 0.3.0

package/CHANGELOG.md

@@ -7,7 +7,19 @@ 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.37](https://github.com/Immugio/three-math-extensions/compare/0.2.36...0.2.37)
+## [0.3.0](https://github.com/Immugio/three-math-extensions/compare/0.2.38...0.3.0)
+
+### Commits
+
+- Add Line2D.split [`8f218fb`](https://github.com/Immugio/three-math-extensions/commit/8f218fb6d8682e65f1da49c9084d56ec3e9a68b7)
+
+## [0.2.38](https://github.com/Immugio/three-math-extensions/compare/0.2.37...0.2.38) - 2024-12-09
+
+### Commits
+
+- Improve Polygon.offsetContour algorithm [`60a28f8`](https://github.com/Immugio/three-math-extensions/commit/60a28f84bd5561b9bb5934561b7bb92f06861a53)
+
+## [0.2.37](https://github.com/Immugio/three-math-extensions/compare/0.2.36...0.2.37) - 2024-12-05
 
 ### Commits
 

package/cjs/Line2D.js

@@ -96,8 +96,7 @@ class Line2D {
     * Modifies this line.
     */
     moveStartPoint(amount) {
-        const p1 = this.movePointOnThisLine(this.start, amount);
-        this.start.copy(p1);
+        this.start.add(this.direction.multiplyScalar(-amount));
         return this;
     }
     /**
@@ -105,16 +104,9 @@ class Line2D {
      * Modifies this line.
      */
     moveEndPoint(amount) {
-        const p2 = this.movePointOnThisLine(this.end, amount);
-        this.end.copy(p2);
+        this.end.add(this.direction.multiplyScalar(amount));
         return this;
     }
-    movePointOnThisLine(point, amount) {
-        const vec = new three_1.Vector2(this.center.x - point.x, this.center.y - point.y);
-        const length = vec.length();
-        vec.normalize().multiplyScalar(length + amount);
-        return new Vec2_1.Vec2(this.center.x - vec.x, this.center.y - vec.y);
-    }
     /**
      * Set the length of this line. Center and direction remain unchanged.
      * Modifies this line.
@@ -419,6 +411,17 @@ class Line2D {
         result.push(source);
         return result;
     }
+    split(segmentsCount) {
+        const result = [];
+        const segmentLength = this.length / segmentsCount;
+        for (let i = 0; i < segmentsCount; i++) {
+            const line = this.clone();
+            line.moveStartPoint(-i * segmentLength);
+            line.moveEndPoint(-(segmentsCount - i - 1) * segmentLength);
+            result.push(line);
+        }
+        return result;
+    }
     /**
      * Returns the closest point on the line to the given point.
      * @param point

package/cjs/Polygon.js

@@ -152,8 +152,17 @@ class Polygon {
             console.error("The contour should be closed");
             return this;
         }
-        for (let i = 0; i < this.contour.length - 1; i++) {
-            this.translateContourLine(i, offset);
+        const lines = Line2D_1.Line2D
+            .fromPolygon(this.contour)
+            .map(line => line.translateLeft(offset));
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const next = lines[(i + 1) % lines.length];
+            line.extendToOrTrimAtIntersection(next);
+            next.extendToOrTrimAtIntersection(line);
+        }
+        for (let i = 0; i < this.contour.length; i++) {
+            this.contour[i].copy(lines[i % lines.length].start);
         }
         return this;
     }

package/esm/Line2D.js

@@ -1,4 +1,4 @@
-import { MathUtils, Vector2 } from "three";
+import { MathUtils } from "three";
 import { Vec2 } from "./Vec2";
 import { TwoPI } from "./MathConstants";
 import { Line3D } from "./Line3D";
@@ -93,8 +93,7 @@ export class Line2D {
     * Modifies this line.
     */
     moveStartPoint(amount) {
-        const p1 = this.movePointOnThisLine(this.start, amount);
-        this.start.copy(p1);
+        this.start.add(this.direction.multiplyScalar(-amount));
         return this;
     }
     /**
@@ -102,16 +101,9 @@ export class Line2D {
      * Modifies this line.
      */
     moveEndPoint(amount) {
-        const p2 = this.movePointOnThisLine(this.end, amount);
-        this.end.copy(p2);
+        this.end.add(this.direction.multiplyScalar(amount));
         return this;
     }
-    movePointOnThisLine(point, amount) {
-        const vec = new Vector2(this.center.x - point.x, this.center.y - point.y);
-        const length = vec.length();
-        vec.normalize().multiplyScalar(length + amount);
-        return new Vec2(this.center.x - vec.x, this.center.y - vec.y);
-    }
     /**
      * Set the length of this line. Center and direction remain unchanged.
      * Modifies this line.
@@ -416,6 +408,17 @@ export class Line2D {
         result.push(source);
         return result;
     }
+    split(segmentsCount) {
+        const result = [];
+        const segmentLength = this.length / segmentsCount;
+        for (let i = 0; i < segmentsCount; i++) {
+            const line = this.clone();
+            line.moveStartPoint(-i * segmentLength);
+            line.moveEndPoint(-(segmentsCount - i - 1) * segmentLength);
+            result.push(line);
+        }
+        return result;
+    }
     /**
      * Returns the closest point on the line to the given point.
      * @param point

package/esm/Polygon.js

@@ -149,8 +149,17 @@ export class Polygon {
             console.error("The contour should be closed");
             return this;
         }
-        for (let i = 0; i < this.contour.length - 1; i++) {
-            this.translateContourLine(i, offset);
+        const lines = Line2D
+            .fromPolygon(this.contour)
+            .map(line => line.translateLeft(offset));
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const next = lines[(i + 1) % lines.length];
+            line.extendToOrTrimAtIntersection(next);
+            next.extendToOrTrimAtIntersection(line);
+        }
+        for (let i = 0; i < this.contour.length; i++) {
+            this.contour[i].copy(lines[i % lines.length].start);
         }
         return this;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immugio/three-math-extensions",
-  "version": "0.2.37",
+  "version": "0.3.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/Line2D.ts

@@ -107,9 +107,7 @@ export class Line2D {
     * Modifies this line.
     */
     public moveStartPoint(amount: number): this {
-        const p1 = this.movePointOnThisLine(this.start, amount);
-        this.start.copy(p1);
-
+        this.start.add(this.direction.multiplyScalar(-amount));
         return this;
     }
 
@@ -118,20 +116,10 @@ export class Line2D {
      * Modifies this line.
      */
     public moveEndPoint(amount: number): this {
-        const p2 = this.movePointOnThisLine(this.end, amount);
-        this.end.copy(p2);
-
+        this.end.add(this.direction.multiplyScalar(amount));
         return this;
     }
 
-    private movePointOnThisLine(point: Point2, amount: number): Vec2 {
-        const vec = new Vector2(this.center.x - point.x, this.center.y - point.y);
-        const length = vec.length();
-        vec.normalize().multiplyScalar(length + amount);
-
-        return new Vec2(this.center.x - vec.x,this.center.y - vec.y);
-    }
-
     /**
      * Set the length of this line. Center and direction remain unchanged.
      * Modifies this line.
@@ -490,6 +478,18 @@ export class Line2D {
         return result;
     }
 
+    public split(segmentsCount: number): Line2D[] {
+        const result: Line2D[] = [];
+        const segmentLength = this.length / segmentsCount;
+        for (let i = 0; i < segmentsCount; i++) {
+            const line = this.clone();
+            line.moveStartPoint(-i * segmentLength);
+            line.moveEndPoint(-(segmentsCount - i - 1) * segmentLength);
+            result.push(line);
+        }
+        return result;
+    }
+
     /**
      * Returns the closest point on the line to the given point.
      * @param point

package/src/Polygon.ts

@@ -180,9 +180,21 @@ export class Polygon {
             return this;
         }
 
-        for (let i = 0; i < this.contour.length - 1; i++) {
-            this.translateContourLine(i, offset);
+        const lines = Line2D
+            .fromPolygon(this.contour)
+            .map(line => line.translateLeft(offset));
+
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const next = lines[(i + 1) % lines.length];
+            line.extendToOrTrimAtIntersection(next);
+            next.extendToOrTrimAtIntersection(line);
         }
+
+        for (let i = 0; i < this.contour.length; i++) {
+            this.contour[i].copy(lines[i % lines.length].start);
+        }
+
         return this;
     }
 

package/types/Line2D.d.ts

@@ -38,7 +38,6 @@ export declare class Line2D {
      * Modifies this line.
      */
     moveEndPoint(amount: number): this;
-    private movePointOnThisLine;
     /**
      * Set the length of this line. Center and direction remain unchanged.
      * Modifies this line.
@@ -177,6 +176,7 @@ export declare class Line2D {
      * @param maxSegmentLength number
      */
     chunk(maxSegmentLength: number): Line2D[];
+    split(segmentsCount: number): Line2D[];
     /**
      * Returns the closest point on the line to the given point.
      * @param point