@immugio/three-math-extensions 0.2.22 → 0.2.23

package/docs/classes/Vec2.md

@@ -74,7 +74,7 @@ Adds x amount to this Vec3 instance and return this
 
 #### Defined in
 
-[src/Vec2.ts:53](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L53)
+[src/Vec2.ts:53](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L53)
 
 ___
 
@@ -96,7 +96,7 @@ Adds y amount to this Vec3 instance and return this
 
 #### Defined in
 
-[src/Vec2.ts:44](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L44)
+[src/Vec2.ts:44](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L44)
 
 ___
 
@@ -120,7 +120,7 @@ A new Vec3 instance.
 
 #### Defined in
 
-[src/Vec2.ts:78](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L78)
+[src/Vec2.ts:78](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L78)
 
 ___
 
@@ -144,7 +144,7 @@ maxDistance is the maximum distance between the two vectors within which they ar
 
 #### Defined in
 
-[src/Vec2.ts:86](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L86)
+[src/Vec2.ts:86](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L86)
 
 ___
 
@@ -169,7 +169,7 @@ This Vec2 instance.
 
 #### Defined in
 
-[src/Vec2.ts:34](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L34)
+[src/Vec2.ts:34](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L34)
 
 ___
 
@@ -192,7 +192,7 @@ check if the angle between the two vectors is close enough to 0 or 180 degrees (
 
 #### Defined in
 
-[src/Vec2.ts:107](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L107)
+[src/Vec2.ts:107](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L107)
 
 ___
 
@@ -216,7 +216,7 @@ This Vec2 instance.
 
 #### Defined in
 
-[src/Vec2.ts:63](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L63)
+[src/Vec2.ts:63](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L63)
 
 ___
 
@@ -232,7 +232,7 @@ Returns the angle between this vector and positive x-axis, the return value is b
 
 #### Defined in
 
-[src/Vec2.ts:97](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L97)
+[src/Vec2.ts:97](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L97)
 
 ___
 
@@ -256,7 +256,7 @@ A new Vec2 instance.
 
 #### Defined in
 
-[src/Vec2.ts:16](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L16)
+[src/Vec2.ts:16](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L16)
 
 ___
 
@@ -279,4 +279,4 @@ Creates a new Vec2[] array from arguments of {x, y} objects.
 
 #### Defined in
 
-[src/Vec2.ts:24](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec2.ts#L24)
+[src/Vec2.ts:24](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec2.ts#L24)

package/docs/classes/Vec3.md

@@ -78,7 +78,7 @@ Adds x amount to this Vec3 instance and return this
 
 #### Defined in
 
-[src/Vec3.ts:73](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L73)
+[src/Vec3.ts:73](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L73)
 
 ___
 
@@ -100,7 +100,7 @@ Adds y amount to this Vec3 instance and return this
 
 #### Defined in
 
-[src/Vec3.ts:64](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L64)
+[src/Vec3.ts:64](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L64)
 
 ___
 
@@ -122,7 +122,7 @@ Adds z amount to this Vec3 instance and return this
 
 #### Defined in
 
-[src/Vec3.ts:82](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L82)
+[src/Vec3.ts:82](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L82)
 
 ___
 
@@ -140,7 +140,7 @@ Vector3.clone
 
 #### Defined in
 
-[src/Vec3.ts:131](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L131)
+[src/Vec3.ts:131](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L131)
 
 ___
 
@@ -162,7 +162,7 @@ Returns a clone of the point closest to this from the given points.
 
 #### Defined in
 
-[src/Vec3.ts:91](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L91)
+[src/Vec3.ts:91](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L91)
 
 ___
 
@@ -184,7 +184,7 @@ Get distance to another vector while ignoring the y-axis.
 
 #### Defined in
 
-[src/Vec3.ts:115](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L115)
+[src/Vec3.ts:115](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L115)
 
 ___
 
@@ -208,7 +208,7 @@ maxDistance is the maximum distance between the two vectors within which they ar
 
 #### Defined in
 
-[src/Vec3.ts:123](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L123)
+[src/Vec3.ts:123](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L123)
 
 ___
 
@@ -232,7 +232,7 @@ This Vec3 instance.
 
 #### Defined in
 
-[src/Vec3.ts:51](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L51)
+[src/Vec3.ts:51](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L51)
 
 ___
 
@@ -257,7 +257,7 @@ This Vec3 instance.
 
 #### Defined in
 
-[src/Vec3.ts:35](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L35)
+[src/Vec3.ts:35](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L35)
 
 ___
 
@@ -273,7 +273,7 @@ Projects this Vec3 instance onto 2d plan. Vec3.z becomes Vec2.y and Vec3.y is ig
 
 #### Defined in
 
-[src/Vec3.ts:107](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L107)
+[src/Vec3.ts:107](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L107)
 
 ___
 
@@ -289,7 +289,7 @@ Returns a clone of this Vec3 instance with y and z swapped.
 
 #### Defined in
 
-[src/Vec3.ts:100](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L100)
+[src/Vec3.ts:100](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L100)
 
 ___
 
@@ -313,7 +313,7 @@ A new Vec3 instance.
 
 #### Defined in
 
-[src/Vec3.ts:17](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L17)
+[src/Vec3.ts:17](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L17)
 
 ___
 
@@ -335,4 +335,4 @@ Creates a new Vec3[] array from arguments of {x, y, z} objects.
 
 #### Defined in
 
-[src/Vec3.ts:25](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Vec3.ts#L25)
+[src/Vec3.ts:25](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Vec3.ts#L25)

package/docs/interfaces/Point2.md

@@ -17,7 +17,7 @@
 
 #### Defined in
 
-[src/Point2.ts:2](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Point2.ts#L2)
+[src/Point2.ts:2](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Point2.ts#L2)
 
 ___
 
@@ -27,4 +27,4 @@ ___
 
 #### Defined in
 
-[src/Point2.ts:3](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Point2.ts#L3)
+[src/Point2.ts:3](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Point2.ts#L3)

package/docs/interfaces/Point3.md

@@ -18,7 +18,7 @@
 
 #### Defined in
 
-[src/Point3.ts:2](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Point3.ts#L2)
+[src/Point3.ts:2](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Point3.ts#L2)
 
 ___
 
@@ -28,7 +28,7 @@ ___
 
 #### Defined in
 
-[src/Point3.ts:3](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Point3.ts#L3)
+[src/Point3.ts:3](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Point3.ts#L3)
 
 ___
 
@@ -38,4 +38,4 @@ ___
 
 #### Defined in
 
-[src/Point3.ts:4](https://github.com/Immugio/three-math-extensions/blob/905d178/src/Point3.ts#L4)
+[src/Point3.ts:4](https://github.com/Immugio/three-math-extensions/blob/336678b/src/Point3.ts#L4)

package/docs/modules.md

@@ -42,7 +42,7 @@
 
 #### Defined in
 
-[src/MathConstants.ts:2](https://github.com/Immugio/three-math-extensions/blob/905d178/src/MathConstants.ts#L2)
+[src/MathConstants.ts:2](https://github.com/Immugio/three-math-extensions/blob/336678b/src/MathConstants.ts#L2)
 
 ___
 
@@ -52,7 +52,7 @@ ___
 
 #### Defined in
 
-[src/MathConstants.ts:1](https://github.com/Immugio/three-math-extensions/blob/905d178/src/MathConstants.ts#L1)
+[src/MathConstants.ts:1](https://github.com/Immugio/three-math-extensions/blob/336678b/src/MathConstants.ts#L1)
 
 ___
 
@@ -73,7 +73,7 @@ ___
 
 #### Defined in
 
-[src/directions.ts:3](https://github.com/Immugio/three-math-extensions/blob/905d178/src/directions.ts#L3)
+[src/directions.ts:3](https://github.com/Immugio/three-math-extensions/blob/336678b/src/directions.ts#L3)
 
 ___
 
@@ -92,7 +92,7 @@ ___
 
 #### Defined in
 
-[src/directions2d.ts:3](https://github.com/Immugio/three-math-extensions/blob/905d178/src/directions2d.ts#L3)
+[src/directions2d.ts:3](https://github.com/Immugio/three-math-extensions/blob/336678b/src/directions2d.ts#L3)
 
 ## Functions
 
@@ -119,7 +119,7 @@ ___
 
 #### Defined in
 
-[src/isContinuousClosedShape.ts:4](https://github.com/Immugio/three-math-extensions/blob/905d178/src/isContinuousClosedShape.ts#L4)
+[src/isContinuousClosedShape.ts:4](https://github.com/Immugio/three-math-extensions/blob/336678b/src/isContinuousClosedShape.ts#L4)
 
 ___
 
@@ -140,7 +140,7 @@ ___
 
 #### Defined in
 
-[src/isPointInPolygon.ts:3](https://github.com/Immugio/three-math-extensions/blob/905d178/src/isPointInPolygon.ts#L3)
+[src/isPointInPolygon.ts:3](https://github.com/Immugio/three-math-extensions/blob/336678b/src/isPointInPolygon.ts#L3)
 
 ___
 
@@ -162,7 +162,7 @@ Normalizes an angle in degrees to the range [0, 360].
 
 #### Defined in
 
-[src/normalizeAngleDegrees.ts:5](https://github.com/Immugio/three-math-extensions/blob/905d178/src/normalizeAngleDegrees.ts#L5)
+[src/normalizeAngleDegrees.ts:5](https://github.com/Immugio/three-math-extensions/blob/336678b/src/normalizeAngleDegrees.ts#L5)
 
 ___
 
@@ -184,4 +184,4 @@ Normalize an angle in radians to the range of 0 to 2π.
 
 #### Defined in
 
-[src/normalizeAngleRadians.ts:7](https://github.com/Immugio/three-math-extensions/blob/905d178/src/normalizeAngleRadians.ts#L7)
+[src/normalizeAngleRadians.ts:7](https://github.com/Immugio/three-math-extensions/blob/336678b/src/normalizeAngleRadians.ts#L7)

package/esm/Line2D.js

@@ -1,6 +1,5 @@
-import { Vector2 } from "three";
+import { MathUtils, Vector2 } from "three";
 import { Vec2 } from "./Vec2";
-import { MathUtils } from "three";
 import { TwoPI } from "./MathConstants";
 import { Line3D } from "./Line3D";
 import { directions2d } from "./directions2d";
@@ -157,6 +156,23 @@ export class Line2D {
         const closestPointToPoint = this.closestPointToPoint(p, clampToLine, this.#target);
         return closestPointToPoint.distanceTo(p);
     }
+    /**
+     * Returns a copy of @other line, the direction of @other is reversed if needed.
+     * Returns null if lines are not parallel.
+     * @param other
+     * @param parallelTolerance
+     */
+    getParallelLineInTheSameDirection(other, parallelTolerance = 0) {
+        const direction = this.direction;
+        if (direction.angleTo(other.direction) <= parallelTolerance) {
+            return other.clone();
+        }
+        const otherLineOppositeDirection = other.clone().flip();
+        if (otherLineOppositeDirection.direction.angleTo(direction) <= parallelTolerance) {
+            return otherLineOppositeDirection;
+        }
+        return null;
+    }
     /**
      * Returns the direction of this line.
      */
@@ -168,9 +184,9 @@ export class Line2D {
      * Modifies this line.
      */
     flip() {
-        const temp = this.start.clone();
+        this.#target.copy(this.start);
         this.start.copy(this.end);
-        this.end.copy(temp);
+        this.end.copy(this.#target);
         return this;
     }
     /**

package/package.json

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

@@ -1,7 +1,6 @@
 import { Point2 } from "./Point2";
-import { Vector2 } from "three";
+import { MathUtils, Vector2 } from "three";
 import { Vec2 } from "./Vec2";
-import { MathUtils } from "three";
 import { TwoPI } from "./MathConstants";
 import { Line3D } from "./Line3D";
 import { directions2d } from "./directions2d";
@@ -183,6 +182,27 @@ export class Line2D {
         return closestPointToPoint.distanceTo(p);
     }
 
+    /**
+     * Returns a copy of @other line, the direction of @other is reversed if needed.
+     * Returns null if lines are not parallel.
+     * @param other
+     * @param parallelTolerance
+     */
+    public getParallelLineInTheSameDirection(other: Line2D, parallelTolerance: number = 0): Line2D {
+        const direction = this.direction;
+
+        if (direction.angleTo(other.direction) <= parallelTolerance) {
+            return other.clone();
+        }
+
+        const otherLineOppositeDirection = other.clone().flip();
+        if (otherLineOppositeDirection.direction.angleTo(direction) <= parallelTolerance) {
+            return otherLineOppositeDirection;
+        }
+
+        return null;
+    }
+
     /**
      * Returns the direction of this line.
      */
@@ -195,9 +215,9 @@ export class Line2D {
      * Modifies this line.
      */
     public flip(): this {
-        const temp = this.start.clone();
+        this.#target.copy(this.start);
         this.start.copy(this.end);
-        this.end.copy(temp);
+        this.end.copy(this.#target);
 
         return this;
     }

package/types/Line2D.d.ts

@@ -68,6 +68,13 @@ export declare class Line2D {
      * @param clampToLine
      */
     distanceToPoint(p: Vector2, clampToLine?: boolean): number;
+    /**
+     * Returns a copy of @other line, the direction of @other is reversed if needed.
+     * Returns null if lines are not parallel.
+     * @param other
+     * @param parallelTolerance
+     */
+    getParallelLineInTheSameDirection(other: Line2D, parallelTolerance?: number): Line2D;
     /**
      * Returns the direction of this line.
      */