@immugio/three-math-extensions 0.2.17 → 0.2.19

package/CHANGELOG.md

@@ -7,7 +7,7 @@ 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.17](https://github.com/Immugio/three-math-extensions/compare/16.15.10...0.2.17)
+## [0.2.19](https://github.com/Immugio/three-math-extensions/compare/16.15.10...0.2.19)
 
 ### Commits
 
@@ -27,6 +27,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 - Line2D.isCloserToHorizontal [`b6f1429`](https://github.com/Immugio/three-math-extensions/commit/b6f14292d1d2765f7314c45e4c74be91280ac764)
 - Add Vec2.angleTo and tests [`dcf1e53`](https://github.com/Immugio/three-math-extensions/commit/dcf1e531aecf8c115f323e14e5e44059e5c5d15c)
 - Add Vec2.signedAngle [`863c8f2`](https://github.com/Immugio/three-math-extensions/commit/863c8f27f11288cbda535e21bb688206259269ed)
+- Add parallelism check to Line2D [`18064ee`](https://github.com/Immugio/three-math-extensions/commit/18064ee35a28e2c4d656f3dfb543b545044167dd)
 - Add Vec2.fromPoints to accept multiple points [`a261402`](https://github.com/Immugio/three-math-extensions/commit/a2614027cf5fb8263189b48f7e0bb9a23a552c15)
 - Add Vec2.parallelTo [`989874d`](https://github.com/Immugio/three-math-extensions/commit/989874dcfe122d3ee84d8d56d79cb88e4e441736)
 - Line2D.intersect - enable line segments intersection only [`1f1470e`](https://github.com/Immugio/three-math-extensions/commit/1f1470e1cf00118e643f5c44a135e0baf6b76d41)
@@ -35,6 +36,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 - Add functionality for incrementing x, y, z coordinates [`b292dcc`](https://github.com/Immugio/three-math-extensions/commit/b292dcc4e8f7f0f2a63e1810c482d96ca6bebebe)
 - Add Line3D.index [`7ed13d2`](https://github.com/Immugio/three-math-extensions/commit/7ed13d213748056c9dafd86288c3bcec9a28d1ba)
 - Polygon from bounding size [`eae6701`](https://github.com/Immugio/three-math-extensions/commit/eae67012f57f426f8b5259b765000447ce06d608)
+- Add Vec3.fromPoints [`62684d7`](https://github.com/Immugio/three-math-extensions/commit/62684d7f6dc1318d345ed74288bb6afd5394e1d3)
 - Line2D and Line3D to return this instead of specific type [`761ef6a`](https://github.com/Immugio/three-math-extensions/commit/761ef6a9d8cc4e35120b666576794e521aa3b991)
 - Line2D.in3DSpace added [`a6ce0ec`](https://github.com/Immugio/three-math-extensions/commit/a6ce0ecb67f5c7b2a75fcc283c28af626153a4af)
 - Line3D.connectsTo added [`6d2cfa0`](https://github.com/Immugio/three-math-extensions/commit/6d2cfa0f5335c665f325a694a32c57b574ec326d)
@@ -49,7 +51,19 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 - Documentation update [`d5c7a07`](https://github.com/Immugio/three-math-extensions/commit/d5c7a0765f6097f5d3a3be01967d4059f19682fb)
 - Excluded files from build [`ec70614`](https://github.com/Immugio/three-math-extensions/commit/ec70614bc7df7a98f854c7a6693365118e04faf7)
 
-## [16.15.10](https://github.com/Immugio/three-math-extensions/compare/0.2.16...16.15.10) - 2023-01-02
+## [16.15.10](https://github.com/Immugio/three-math-extensions/compare/0.2.18...16.15.10) - 2023-01-02
+
+## [0.2.18](https://github.com/Immugio/three-math-extensions/compare/0.2.17...0.2.18) - 2024-02-08
+
+### Commits
+
+- Add parallelism check to Line2D [`18064ee`](https://github.com/Immugio/three-math-extensions/commit/18064ee35a28e2c4d656f3dfb543b545044167dd)
+
+## [0.2.17](https://github.com/Immugio/three-math-extensions/compare/0.2.16...0.2.17) - 2023-12-26
+
+### Commits
+
+- Packages update [`c2ef857`](https://github.com/Immugio/three-math-extensions/commit/c2ef857c01792e64c1558424fdd2f401f72720d0)
 
 ## [0.2.16](https://github.com/Immugio/three-math-extensions/compare/0.2.15...0.2.16) - 2023-11-21
 

package/cjs/Line2D.js

@@ -80,6 +80,16 @@ class Line2D {
         this.moveEndPoint(amount / 2);
         return this;
     }
+    isParallelTo(other, angleTolerance = Number.EPSILON) {
+        const direction = this.direction;
+        const otherDirection = other.direction;
+        const angle = direction.angleTo(otherDirection);
+        if (angle <= angleTolerance) {
+            return true;
+        }
+        const opposite = direction.angleTo(otherDirection.negate());
+        return opposite <= angleTolerance;
+    }
     /*
     * Moves start point on the line by the given amount. Plus values move the point further away from the center.
     * Modifies this line.

package/cjs/Line3D.js

@@ -282,16 +282,16 @@ class Line3D extends three_1.Line3 {
     /**
      * Check if @other is parallel to this line.
      * @param other
-     * @param tolerance
+     * @param angleTolerance
      */
-    isParallelTo(other, tolerance = Number.EPSILON) {
+    isParallelTo(other, angleTolerance = Number.EPSILON) {
         const direction = this.direction;
         const otherDirection = other.direction;
-        const areTheSameDirection = direction.manhattanDistanceTo(otherDirection) <= tolerance;
+        const areTheSameDirection = direction.angleTo(otherDirection) <= angleTolerance;
         if (areTheSameDirection) {
             return true;
         }
-        return direction.negate().manhattanDistanceTo(otherDirection) < tolerance;
+        return direction.negate().angleTo(otherDirection) < angleTolerance;
     }
     /*
     * Extends or reduces the line to the given length while keeping the center of the line constant.

package/cjs/Vec3.js

@@ -16,6 +16,13 @@ class Vec3 extends three_1.Vector3 {
     static fromPoint(point) {
         return new Vec3(point?.x, point?.y, point?.z);
     }
+    /**
+     * Creates a new Vec3[] array from arguments of {x, y, z} objects.
+     * @param points - The ...{x, y, z} instances.
+     */
+    static fromPoints(...points) {
+        return points?.map(p => Vec3.fromPoint(p)) ?? [];
+    }
     /**
      * Moves this Vec3 instance towards the target Vec3 by the given amount.
      * @param target - The target Vec3.

package/esm/Line2D.js

@@ -77,6 +77,16 @@ export class Line2D {
         this.moveEndPoint(amount / 2);
         return this;
     }
+    isParallelTo(other, angleTolerance = Number.EPSILON) {
+        const direction = this.direction;
+        const otherDirection = other.direction;
+        const angle = direction.angleTo(otherDirection);
+        if (angle <= angleTolerance) {
+            return true;
+        }
+        const opposite = direction.angleTo(otherDirection.negate());
+        return opposite <= angleTolerance;
+    }
     /*
     * Moves start point on the line by the given amount. Plus values move the point further away from the center.
     * Modifies this line.

package/esm/Line3D.js

@@ -279,16 +279,16 @@ export class Line3D extends Line3 {
     /**
      * Check if @other is parallel to this line.
      * @param other
-     * @param tolerance
+     * @param angleTolerance
      */
-    isParallelTo(other, tolerance = Number.EPSILON) {
+    isParallelTo(other, angleTolerance = Number.EPSILON) {
         const direction = this.direction;
         const otherDirection = other.direction;
-        const areTheSameDirection = direction.manhattanDistanceTo(otherDirection) <= tolerance;
+        const areTheSameDirection = direction.angleTo(otherDirection) <= angleTolerance;
         if (areTheSameDirection) {
             return true;
         }
-        return direction.negate().manhattanDistanceTo(otherDirection) < tolerance;
+        return direction.negate().angleTo(otherDirection) < angleTolerance;
     }
     /*
     * Extends or reduces the line to the given length while keeping the center of the line constant.

package/esm/Vec3.js

@@ -13,6 +13,13 @@ export class Vec3 extends Vector3 {
     static fromPoint(point) {
         return new Vec3(point?.x, point?.y, point?.z);
     }
+    /**
+     * Creates a new Vec3[] array from arguments of {x, y, z} objects.
+     * @param points - The ...{x, y, z} instances.
+     */
+    static fromPoints(...points) {
+        return points?.map(p => Vec3.fromPoint(p)) ?? [];
+    }
     /**
      * Moves this Vec3 instance towards the target Vec3 by the given amount.
      * @param target - The target Vec3.

package/package.json

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

@@ -4,7 +4,7 @@ import { Vec2 } from "./Vec2";
 import { MathUtils } from "three";
 import { TwoPI } from "./MathConstants";
 import { Line3D } from "./Line3D";
-import {directions2d} from "./directions2d";
+import { directions2d } from "./directions2d";
 
 const _startP = /*@__PURE__*/ new Vec2();
 const _startEnd = /*@__PURE__*/ new Vec2();
@@ -87,6 +87,19 @@ export class Line2D {
         return this;
     }
 
+    public isParallelTo(other: Line2D, angleTolerance: number = Number.EPSILON): boolean {
+        const direction = this.direction;
+        const otherDirection = other.direction;
+
+        const angle = direction.angleTo(otherDirection);
+        if (angle <= angleTolerance) {
+            return true;
+        }
+
+        const opposite = direction.angleTo(otherDirection.negate());
+        return opposite <= angleTolerance;
+    }
+
     /*
     * Moves start point on the line by the given amount. Plus values move the point further away from the center.
     * Modifies this line.

package/src/Line3D.ts

@@ -339,18 +339,18 @@ export class Line3D extends Line3 {
     /**
      * Check if @other is parallel to this line.
      * @param other
-     * @param tolerance
+     * @param angleTolerance
      */
-    public isParallelTo(other: Line3D, tolerance: number = Number.EPSILON): boolean {
+    public isParallelTo(other: Line3D, angleTolerance: number = Number.EPSILON): boolean {
         const direction = this.direction;
         const otherDirection = other.direction;
 
-        const areTheSameDirection = direction.manhattanDistanceTo(otherDirection) <= tolerance;
+        const areTheSameDirection = direction.angleTo(otherDirection) <= angleTolerance;
         if (areTheSameDirection) {
             return true;
         }
 
-        return direction.negate().manhattanDistanceTo(otherDirection) < tolerance;
+        return direction.negate().angleTo(otherDirection) < angleTolerance;
     }
 
     /*

package/src/Vec3.ts

@@ -18,6 +18,14 @@ export class Vec3 extends Vector3 {
         return new Vec3(point?.x, point?.y, point?.z);
     }
 
+    /**
+     * Creates a new Vec3[] array from arguments of {x, y, z} objects.
+     * @param points - The ...{x, y, z} instances.
+     */
+    public static fromPoints(...points: Point3[]): Vec3[] {
+        return points?.map(p => Vec3.fromPoint(p)) ?? [];
+    }
+
     /**
      * Moves this Vec3 instance towards the target Vec3 by the given amount.
      * @param target - The target Vec3.

package/types/Line2D.d.ts

@@ -30,6 +30,7 @@ export declare class Line2D {
      */
     setCenter(value: Point2): this;
     resize(amount: number): this;
+    isParallelTo(other: Line2D, angleTolerance?: number): boolean;
     moveStartPoint(amount: number): this;
     /**
      * Moves end point on the line by the given amount. Plus values move the point further away from the center.

package/types/Line3D.d.ts

@@ -109,9 +109,9 @@ export declare class Line3D extends Line3 {
     /**
      * Check if @other is parallel to this line.
      * @param other
-     * @param tolerance
+     * @param angleTolerance
      */
-    isParallelTo(other: Line3D, tolerance?: number): boolean;
+    isParallelTo(other: Line3D, angleTolerance?: number): boolean;
     resize(amount: number): this;
     moveStartPoint(amount: number): this;
     moveEndPoint(amount: number): this;

package/types/Vec3.d.ts

@@ -12,6 +12,11 @@ export declare class Vec3 extends Vector3 {
      * @returns A new Vec3 instance.
      */
     static fromPoint(point: Point3): Vec3;
+    /**
+     * Creates a new Vec3[] array from arguments of {x, y, z} objects.
+     * @param points - The ...{x, y, z} instances.
+     */
+    static fromPoints(...points: Point3[]): Vec3[];
     /**
      * Moves this Vec3 instance towards the target Vec3 by the given amount.
      * @param target - The target Vec3.