@vertexvis/geometry 0.24.5-canary.6 → 1.0.0-testing.1

package/dist/plane.d.ts

@@ -1,51 +1,51 @@
-import * as Line3 from './line3';
-import * as Vector3 from './vector3';
-/**
- * A two dimensional surface in 3D space that extends indefinitely. Represented
- * as a direction normal and distance.
- */
-export interface Plane {
-    normal: Vector3.Vector3;
-    constant: number;
-}
-/**
- * Creates a new plane. Defaults to a normal of `[0,0,0]` and constant of `0`.
- *
- * @param values Values to assign to the plane.
- * @returns A new plane.
- */
-export declare function create(values?: Partial<Plane>): Plane;
-/**
- * Creates a plane from a normal and an arbitrary point on a plane.
- *
- * @param normal A normal.
- * @param point A point on the plane.
- * @returns A new plane.
- */
-export declare function fromNormalAndCoplanarPoint(normal: Vector3.Vector3, point: Vector3.Vector3): Plane;
-/**
- * Returns the perpendicular distance from the plane to the given point.
- *
- * @param plane The plane.
- * @param point The point to calculate distance from `plane`.
- * @returns A distance.
- */
-export declare function distanceToPoint(plane: Plane, point: Vector3.Vector3): number;
-/**
- * Returns the point where the line intersects with this plane. If the line does
- * not intersect, then `undefined` is returned. If the line is on the plane,
- * then the starting point of the line is returned.
- *
- * @param plane The plane to intersect.
- * @param line The line to intersect.
- * @returns An intersecting point on the plane and line.
- */
-export declare function intersectLine(plane: Plane, line: Line3.Line3): Vector3.Vector3 | undefined;
-/**
- * Projects the given `point` onto the given `plane`.
- *
- * @param plane The plane to project onto.
- * @param point The point to project.
- * @returns The projected point.
- */
-export declare function projectPoint(plane: Plane, point: Vector3.Vector3): Vector3.Vector3;
+import * as Line3 from './line3';
+import * as Vector3 from './vector3';
+/**
+ * A two dimensional surface in 3D space that extends indefinitely. Represented
+ * as a direction normal and distance.
+ */
+export interface Plane {
+    normal: Vector3.Vector3;
+    constant: number;
+}
+/**
+ * Creates a new plane. Defaults to a normal of `[0,0,0]` and constant of `0`.
+ *
+ * @param values Values to assign to the plane.
+ * @returns A new plane.
+ */
+export declare function create(values?: Partial<Plane>): Plane;
+/**
+ * Creates a plane from a normal and an arbitrary point on a plane.
+ *
+ * @param normal A normal.
+ * @param point A point on the plane.
+ * @returns A new plane.
+ */
+export declare function fromNormalAndCoplanarPoint(normal: Vector3.Vector3, point: Vector3.Vector3): Plane;
+/**
+ * Returns the perpendicular distance from the plane to the given point.
+ *
+ * @param plane The plane.
+ * @param point The point to calculate distance from `plane`.
+ * @returns A distance.
+ */
+export declare function distanceToPoint(plane: Plane, point: Vector3.Vector3): number;
+/**
+ * Returns the point where the line intersects with this plane. If the line does
+ * not intersect, then `undefined` is returned. If the line is on the plane,
+ * then the starting point of the line is returned.
+ *
+ * @param plane The plane to intersect.
+ * @param line The line to intersect.
+ * @returns An intersecting point on the plane and line.
+ */
+export declare function intersectLine(plane: Plane, line: Line3.Line3): Vector3.Vector3 | undefined;
+/**
+ * Projects the given `point` onto the given `plane`.
+ *
+ * @param plane The plane to project onto.
+ * @param point The point to project.
+ * @returns The projected point.
+ */
+export declare function projectPoint(plane: Plane, point: Vector3.Vector3): Vector3.Vector3;

package/dist/point.d.ts

@@ -1,80 +1,80 @@
-import * as Angle from './angle';
-/**
- * A `Point` represents a cartesian coordinate with a horizontal and vertical
- * position or length.
- */
-export interface Point {
-    x: number;
-    y: number;
-}
-/**
- * Returns a new `Point` with the given horizontal and vertical position.
- */
-export declare function create(x?: number, y?: number): Point;
-/**
- * Converts a polar coordinate (length and angle) into a Cartesian coordinate.
- */
-export declare function polar(length: number, radians: Angle.Angle): Point;
-/**
- * Returns the distance between two points.
- */
-export declare function distance(a: Point, b: Point): number;
-/**
- * Returns a new `Point` where `b` is subtracted from `a`.
- */
-export declare function subtract(a: Point, b: Point): Point;
-/**
- * Returns a new `Point` where `b` is added to `a`.
- */
-export declare function add(a: Point, b: Point): Point;
-/**
- * Returns `true` if the `x` and `y` positions of `a` and `b` are equal.
- */
-export declare function isEqual(a: Point, b: Point): boolean;
-/**
- * Performs a linear interpolation between `a` and `b` and returns the result.
- * The value of `t` is clamped between `[0, 1]`.
- *
- * @param a The start value.
- * @param b The end value.
- * @param t A value between 0 and 1.
- * @returns A point between `a` and `b`.
- */
-export declare function lerp(a: Point, b: Point, t: number): Point;
-/**
- * Returns a new `Point` where `x` and `y` are inverted.
- */
-export declare function negate(pt: Point): Point;
-/**
- * Returns a new `Point` where `x` and `y` are multiplied by the given scale
- * factors.
- */
-export declare function scale(pt: Point, scaleX: number, scaleY: number): Point;
-/**
- * Returns a new `Point` where `x` and `y` are multiplied by the given scale
- * factor.
- */
-export declare function scaleProportional(pt: Point, scale: number): Point;
-/**
- * Returns the magnitude of a point.
- */
-export declare function magnitude(pt: Point): number;
-/**
- * Transforms a vector into the corresponding normal (unit) vector.
- */
-export declare function normalizeVector(pt: Point): Point;
-/**
- * Returns a new normal (unit) vector pointing between the two given points.
- */
-export declare function normalDirectionVector(ptA: Point, ptB: Point): Point;
-/**
- * Returns a vector orthogonal to the vector between the two given points.
- */
-export declare function orthogonalVector(ptA: Point, ptB: Point): Point;
-/**
- * Parses a JSON string representation of a Point and returns an object.
- *
- * @param json A JSON string, either in the form `[x,y]` or `{"x": 0, "y": 0}`
- * @returns A parsed Point.
- */
-export declare function fromJson(json: string): Point;
+import * as Angle from './angle';
+/**
+ * A `Point` represents a cartesian coordinate with a horizontal and vertical
+ * position or length.
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Returns a new `Point` with the given horizontal and vertical position.
+ */
+export declare function create(x?: number, y?: number): Point;
+/**
+ * Converts a polar coordinate (length and angle) into a Cartesian coordinate.
+ */
+export declare function polar(length: number, radians: Angle.Angle): Point;
+/**
+ * Returns the distance between two points.
+ */
+export declare function distance(a: Point, b: Point): number;
+/**
+ * Returns a new `Point` where `b` is subtracted from `a`.
+ */
+export declare function subtract(a: Point, b: Point): Point;
+/**
+ * Returns a new `Point` where `b` is added to `a`.
+ */
+export declare function add(a: Point, b: Point): Point;
+/**
+ * Returns `true` if the `x` and `y` positions of `a` and `b` are equal.
+ */
+export declare function isEqual(a: Point, b: Point): boolean;
+/**
+ * Performs a linear interpolation between `a` and `b` and returns the result.
+ * The value of `t` is clamped between `[0, 1]`.
+ *
+ * @param a The start value.
+ * @param b The end value.
+ * @param t A value between 0 and 1.
+ * @returns A point between `a` and `b`.
+ */
+export declare function lerp(a: Point, b: Point, t: number): Point;
+/**
+ * Returns a new `Point` where `x` and `y` are inverted.
+ */
+export declare function negate(pt: Point): Point;
+/**
+ * Returns a new `Point` where `x` and `y` are multiplied by the given scale
+ * factors.
+ */
+export declare function scale(pt: Point, scaleX: number, scaleY: number): Point;
+/**
+ * Returns a new `Point` where `x` and `y` are multiplied by the given scale
+ * factor.
+ */
+export declare function scaleProportional(pt: Point, scale: number): Point;
+/**
+ * Returns the magnitude of a point.
+ */
+export declare function magnitude(pt: Point): number;
+/**
+ * Transforms a vector into the corresponding normal (unit) vector.
+ */
+export declare function normalizeVector(pt: Point): Point;
+/**
+ * Returns a new normal (unit) vector pointing between the two given points.
+ */
+export declare function normalDirectionVector(ptA: Point, ptB: Point): Point;
+/**
+ * Returns a vector orthogonal to the vector between the two given points.
+ */
+export declare function orthogonalVector(ptA: Point, ptB: Point): Point;
+/**
+ * Parses a JSON string representation of a Point and returns an object.
+ *
+ * @param json A JSON string, either in the form `[x,y]` or `{"x": 0, "y": 0}`
+ * @returns A parsed Point.
+ */
+export declare function fromJson(json: string): Point;

package/dist/quaternion.d.ts

@@ -1,65 +1,65 @@
-import * as Euler from './euler';
-import * as Matrix4 from './matrix4';
-import * as Vector3 from './vector3';
-/**
- * A type that represents a
- * [quaternion](http://en.wikipedia.org/wiki/Quaternion). Quaternions are used
- * in 3D graphics to represent
- * [rotations](https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation).
- */
-export interface Quaternion {
-    x: number;
-    y: number;
-    z: number;
-    w: number;
-}
-/**
- * An array representation of a `Quaternion`.
- */
-export declare type QuaternionAsArray = [x: number, y: number, z: number, w: number];
-/**
- * Returns a new quaternion. If `value` is undefined, then `{x: 0, y: 0, z: 0,
- * w: 1}` is returned.
- */
-export declare function create(value?: Partial<Quaternion>): Quaternion;
-/**
- * Parses a JSON string representation of a `Quaternion`.
- *
- * @param json A JSON string either in the form of `[x, y, z, w]` or `{"x": 0, "y": 0, "z": 0, "w": 0}`.
- * @returns A parsed `Quaternion`.
- */
-export declare function fromJson(json: string): Quaternion;
-/**
- * Returns a quaternion with that will have a magnitude of 1.
- */
-export declare function normalize(q: Quaternion): Quaternion;
-/**
- * Returns the magnitude of the provided quaternion.
- */
-export declare function magnitude(q: Quaternion): number;
-/**
- * Returns a quaternion where each component is multiplied by the `scalar`.
- */
-export declare function scale(scalar: number, q: Quaternion): Quaternion;
-/**
- * Creates a `Quaternion` that is rotated the given radians around an axis.
- *
- * @param axis The axis to rotate around.
- * @param radians The rotation, in radians.
- * @returns A rotated quaternion.
- */
-export declare function fromAxisAngle(axis: Vector3.Vector3, radians: number): Quaternion;
-/**
- * Returns a quaternion using the upper 3x3 of a pure rotation matrix
- * (unscaled).
- */
-export declare function fromMatrixRotation(matrix: Matrix4.Matrix4): Quaternion;
-export declare function fromEuler(euler: Euler.Euler): Quaternion;
-/**
- * Multiplies `a` x `b` and returns a new quaternion with the result.
- */
-export declare function multiply(a: Quaternion, b: Quaternion): Quaternion;
-/**
- * Type guard that checks if the given type is a Quaternion.
- */
-export declare function isType(obj: unknown): obj is Quaternion;
+import * as Euler from './euler';
+import * as Matrix4 from './matrix4';
+import * as Vector3 from './vector3';
+/**
+ * A type that represents a
+ * [quaternion](http://en.wikipedia.org/wiki/Quaternion). Quaternions are used
+ * in 3D graphics to represent
+ * [rotations](https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation).
+ */
+export interface Quaternion {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+/**
+ * An array representation of a `Quaternion`.
+ */
+export type QuaternionAsArray = [x: number, y: number, z: number, w: number];
+/**
+ * Returns a new quaternion. If `value` is undefined, then `{x: 0, y: 0, z: 0,
+ * w: 1}` is returned.
+ */
+export declare function create(value?: Partial<Quaternion>): Quaternion;
+/**
+ * Parses a JSON string representation of a `Quaternion`.
+ *
+ * @param json A JSON string either in the form of `[x, y, z, w]` or `{"x": 0, "y": 0, "z": 0, "w": 0}`.
+ * @returns A parsed `Quaternion`.
+ */
+export declare function fromJson(json: string): Quaternion;
+/**
+ * Returns a quaternion with that will have a magnitude of 1.
+ */
+export declare function normalize(q: Quaternion): Quaternion;
+/**
+ * Returns the magnitude of the provided quaternion.
+ */
+export declare function magnitude(q: Quaternion): number;
+/**
+ * Returns a quaternion where each component is multiplied by the `scalar`.
+ */
+export declare function scale(scalar: number, q: Quaternion): Quaternion;
+/**
+ * Creates a `Quaternion` that is rotated the given radians around an axis.
+ *
+ * @param axis The axis to rotate around.
+ * @param radians The rotation, in radians.
+ * @returns A rotated quaternion.
+ */
+export declare function fromAxisAngle(axis: Vector3.Vector3, radians: number): Quaternion;
+/**
+ * Returns a quaternion using the upper 3x3 of a pure rotation matrix
+ * (unscaled).
+ */
+export declare function fromMatrixRotation(matrix: Matrix4.Matrix4): Quaternion;
+export declare function fromEuler(euler: Euler.Euler): Quaternion;
+/**
+ * Multiplies `a` x `b` and returns a new quaternion with the result.
+ */
+export declare function multiply(a: Quaternion, b: Quaternion): Quaternion;
+/**
+ * Type guard that checks if the given type is a Quaternion.
+ */
+export declare function isType(obj: unknown): obj is Quaternion;

package/dist/ray.d.ts

@@ -1,52 +1,52 @@
-import * as Plane from './plane';
-import * as Vector3 from './vector3';
-/**
- * A `Ray` represents an infinite line starting at `origin` and going in
- * `direction`.
- */
-export interface Ray {
-    /**
-     * The origin point of the ray.
-     */
-    origin: Vector3.Vector3;
-    /**
-     * A normal that describes the direction of the ray from origin.
-     */
-    direction: Vector3.Vector3;
-}
-/**
- * Creates a new ray with the given values, or using default values if none are
- * provided. The direction defaults to `{x: 0, y: 0, z: -1}` if undefined.
- *
- * @param value The values of the ray.
- * @returns A new ray.
- */
-export declare function create(value?: Partial<Ray>): Ray;
-/**
- * Returns a point at the given distance along this ray.
- *
- * @param ray The ray to get the point on.
- * @param distance A distance from origin along the ray's direction.
- * @returns A point on the ray.
- */
-export declare function at(ray: Ray, distance: number): Vector3.Vector3;
-/**
- * Computes the distance of the `ray`s origin to the given `plane`. Returns a
- * distance of 0 if the ray is coplanar and returns `undefined` if the ray does
- * not intersect with the plane.
- *
- * @param ray The ray to get the distance for.
- * @param plane The plane to compute the distance to.
- * @returns The distance to the plane, or `undefined` if it cannot be computed.
- */
-export declare function distanceToPlane(ray: Ray, plane: Plane.Plane): number | undefined;
-/**
- * Computes the intersection point of the given `ray` to the given `plane`. If
- * the ray does not intersect with the plane, then `undefined` is returned.
- *
- * @param ray The ray to intersect.
- * @param plane The plane to intersect with.
- * @returns The intersection point, or `undefined` if the ray does not
- * intersect.
- */
-export declare function intersectPlane(ray: Ray, plane: Plane.Plane): Vector3.Vector3 | undefined;
+import * as Plane from './plane';
+import * as Vector3 from './vector3';
+/**
+ * A `Ray` represents an infinite line starting at `origin` and going in
+ * `direction`.
+ */
+export interface Ray {
+    /**
+     * The origin point of the ray.
+     */
+    origin: Vector3.Vector3;
+    /**
+     * A normal that describes the direction of the ray from origin.
+     */
+    direction: Vector3.Vector3;
+}
+/**
+ * Creates a new ray with the given values, or using default values if none are
+ * provided. The direction defaults to `{x: 0, y: 0, z: -1}` if undefined.
+ *
+ * @param value The values of the ray.
+ * @returns A new ray.
+ */
+export declare function create(value?: Partial<Ray>): Ray;
+/**
+ * Returns a point at the given distance along this ray.
+ *
+ * @param ray The ray to get the point on.
+ * @param distance A distance from origin along the ray's direction.
+ * @returns A point on the ray.
+ */
+export declare function at(ray: Ray, distance: number): Vector3.Vector3;
+/**
+ * Computes the distance of the `ray`s origin to the given `plane`. Returns a
+ * distance of 0 if the ray is coplanar and returns `undefined` if the ray does
+ * not intersect with the plane.
+ *
+ * @param ray The ray to get the distance for.
+ * @param plane The plane to compute the distance to.
+ * @returns The distance to the plane, or `undefined` if it cannot be computed.
+ */
+export declare function distanceToPlane(ray: Ray, plane: Plane.Plane): number | undefined;
+/**
+ * Computes the intersection point of the given `ray` to the given `plane`. If
+ * the ray does not intersect with the plane, then `undefined` is returned.
+ *
+ * @param ray The ray to intersect.
+ * @param plane The plane to intersect with.
+ * @returns The intersection point, or `undefined` if the ray does not
+ * intersect.
+ */
+export declare function intersectPlane(ray: Ray, plane: Plane.Plane): Vector3.Vector3 | undefined;