plotboilerplate 1.27.1 → 1.28.0

package/src/_esm/src/ts/utils/datastructures/GirihTile.js

@@ -0,0 +1,286 @@
+/**
+ * @author   Ikaros Kappler
+ * @date     2013-11-27
+ * @modified 2014-04-05 Ikaros Kappler (member array outerTilePolygons added).
+ * @modified 2015-03-19 Ikaros Kappler (added toSVG()).
+ * @modified 2020-10-30 Refactored the this super class to work with PlotBoilerplate.
+ * @modified 2020-11-11 Ported the class from vanilla JS to TypeScript.
+ * @version  2.0.1-alpha
+ * @name GirihTile
+ **/
+import { Bounds } from "../../Bounds";
+import { Line } from "../../Line";
+import { Polygon } from "../../Polygon";
+import { Vertex } from "../../Vertex";
+export var TileType;
+(function (TileType) {
+    TileType["UNKNOWN"] = "UNKNOWN";
+    TileType["DECAGON"] = "DECAGON";
+    TileType["PENTAGON"] = "PENTAGON";
+    TileType["IRREGULAR_HEXAGON"] = "IRREGULAR_HEXAGON";
+    TileType["RHOMBUS"] = "RHOMBUS";
+    TileType["BOW_TIE"] = "BOW_TIE";
+    // This is not part of the actual girih tile set!
+    TileType["PENROSE_RHOMBUS"] = "PENROSE_RHOMBUS";
+})(TileType || (TileType = {}));
+/**
+ * @classdesc This is a general tile superclass. All other tile classes extends this one.
+ *
+ * Rule:
+ *  * the outer and the inner sub polygons must be inside the main polygon's bounds.
+ *
+ * @requires Bounds
+ * @requires Polyon
+ * @requires Vertex
+ * @requires XYCoords
+ */
+export class GirihTile extends Polygon {
+    /**
+     * @constructor
+     * @memberof GirihTile
+     * @abstract class
+     * @param {Vertex} position   - The position of the tile.
+     * @param {number} edgeLength - The edge length (default is GirihTile.DEFAULT_EDGE_LENGTH).
+     * @param {TileType} tileType - One of `TileType.*` enum members.
+     **/
+    constructor(position, edgeLength, tileType) {
+        super([], false); // vertices, isOpen
+        if (typeof edgeLength === "undefined")
+            edgeLength = GirihTile.DEFAULT_EDGE_LENGTH;
+        if (typeof tileType == "undefined")
+            tileType = TileType.UNKNOWN;
+        this.edgeLength = edgeLength;
+        this.position = position;
+        this.rotation = 0.0; // angle;
+        this.symmetry = 10;
+        this.uniqueSymmetries = 10;
+        // An array of polygons.
+        // The inner tile polygons are those that do not share edges with the outer
+        // tile bounds (vertices are OK).
+        this.innerTilePolygons = [];
+        // A second array of polygons.
+        // The outer tile polygons are those that make up the whole tile area
+        // _together with the inner tile polygons (!)_; the union of the
+        // inner tile polygons and the outer tile polygons covers exactly
+        // the whole tile polygon.
+        // The intersection of both sets is empty.
+        // Outer tile polygon share at least one (partial) edge with the complete
+        // tile polygon (length > 0).
+        this.outerTilePolygons = [];
+        // this.imageProperties      = null;
+        this.textureSource = new Bounds(new Vertex(), new Vertex());
+        this.tileType = tileType;
+    }
+    /**
+     * Move this tile around (together will all inner polygons).
+     * As this function overrides Polygon.move(...), the returned
+     * instance (this) must be of type `Polygon`.
+     *
+     * @name move
+     * @instance
+     * @override
+     * @memberof GirihTile
+     * @param {XYCoords} amount
+     * @return {Polygon} this
+     */
+    move(amount) {
+        super.move.call(this, amount);
+        for (var i in this.innerTilePolygons)
+            this.innerTilePolygons[i].move(amount);
+        for (var i in this.outerTilePolygons)
+            this.outerTilePolygons[i].move(amount);
+        this.position.add(amount);
+        return this;
+    }
+    /**
+     * Find the adjacent tile (given by the template tile)
+     * Note that the tile itself will be modified (rotated and moved to the correct position).
+     *
+     * @name findAdjacentTilePosition
+     * @memberof GirihTile
+     * @instance
+     * @param {number} edgeIndex - The edge number of the you you want to find adjacency for.
+     * @param {Polygon} tile - The polygon (or tile) you want to find adjacency for at the specified edge.
+     * @return {IAdjacency|null} Adjacency information or null if the passed tile does not match.
+     */
+    findAdjacentTilePosition(edgeIndex, tile) {
+        const edgeA = new Line(this.vertices[edgeIndex % this.vertices.length], this.vertices[(edgeIndex + 1) % this.vertices.length]);
+        // Find adjacent edge
+        for (var i = 0; i < tile.vertices.length; i++) {
+            const edgeB = new Line(tile.vertices[i % tile.vertices.length].clone(), tile.vertices[(i + 1) % tile.vertices.length].clone());
+            // Goal: edgeA.a==edgeB.b && edgeA.b==edgeB.a
+            // So move edgeB
+            const offset = edgeB.b.difference(edgeA.a);
+            edgeB.add(offset);
+            if (edgeB.a.distance(edgeA.b) < GirihTile.epsilon) {
+                return { edgeIndex: i, offset: offset };
+            }
+        }
+        return null;
+    }
+    /**
+     * Find all possible adjacent tile positions (and rotations) for `neighbourTile`.
+     *
+     * @name transformTileToAdjacencies
+     * @memberof GirihTile
+     * @instance
+     * @param {number} baseEdgeIndex - The edge number of the you you want to find adjacencies for.
+     * @param {GirihTile} neighbourTile - The polygon (or tile) you want to find adjacencies for at the specified edge.
+     * @return {IAdjacency|null} Adjacency information or null if the passed tile does not match.
+     */
+    transformTileToAdjacencies(baseEdgeIndex, neighbourTile) {
+        // Find a rotation for that tile to match
+        let i = 0;
+        const foundAlignments = [];
+        let positionedTile = null;
+        while (i < neighbourTile.uniqueSymmetries) {
+            positionedTile = this.transformTilePositionToAdjacency(baseEdgeIndex, neighbourTile);
+            if (positionedTile != null) {
+                positionedTile = positionedTile.clone();
+                foundAlignments.push(positionedTile);
+            }
+            neighbourTile.rotate((Math.PI * 2) / neighbourTile.symmetry);
+            i++;
+        }
+        return foundAlignments;
+    }
+    /**
+     * Apply adjacent tile position to `neighbourTile`.
+     *
+     * @name transformTilePositionToAdjacencies
+     * @memberof GirihTile
+     * @instance
+     * @param {number} baseEdgeIndex - The edge number of the you you want to apply adjacent position for.
+     * @param {Polygon} neighbourTile - The polygon (or tile) you want to find adjacency for at the specified edge.
+     * @return {Polygon|null} the passed tile itself if adjacency was found, null otherwise.
+     */
+    transformTilePositionToAdjacency(baseEdgeIndex, neighbourTile) {
+        // Find the position for that tile to match (might not exist)
+        // { edgeIndex:number, offset:XYCoords }
+        var adjacency = this.findAdjacentTilePosition(baseEdgeIndex, neighbourTile);
+        if (adjacency != null) {
+            neighbourTile.move(adjacency.offset);
+            return neighbourTile;
+        }
+        return null;
+    }
+    /**
+     * Get the inner tile polygon at the given index.
+     * This function applies MOD to the index.
+     *
+     * @name getInnerTilePolygonAt
+     * @instance
+     * @memberof GirihTile
+     * @param {number} index
+     * @return {Polygon} The sub polygon (inner tile) at the given index.
+     **/
+    getInnerTilePolygonAt(index) {
+        if (index < 0)
+            return this.innerTilePolygons[this.innerTilePolygons.length - (Math.abs(index) % this.innerTilePolygons.length)];
+        else
+            return this.innerTilePolygons[index % this.innerTilePolygons.length];
+    }
+    /**
+     * Get the outer tile polygon at the given index.
+     * This function applies MOD to the index.
+     *
+     * @name getOuterTilePolygonAt
+     * @instance
+     * @memberof GirihTile
+     * @param {number} index
+     * @return {Polygon} The sub polygon (outer tile) at the given index.
+     **/
+    getOuterTilePolygonAt(index) {
+        if (index < 0)
+            return this.outerTilePolygons[this.outerTilePolygons.length - (Math.abs(index) % this.outerTilePolygons.length)];
+        else
+            return this.outerTilePolygons[index % this.outerTilePolygons.length];
+    }
+    /**
+     * Rotate this tile
+     * Note: this function behaves a bitdifferent than the genuine Polygon.rotate function!
+     *       Polygon has the default center of rotation at (0,0).
+     *       The GirihTile rotates around its center (position) by default.
+     *
+     * @name rotate
+     * @instance
+     * @memberof GirihTile
+     * @param {number} angle - The angle to use for rotation.
+     * @param {Vertex?} center - The center of rotation (default is this.position).
+     * @return {Polygon} this
+     **/
+    rotate(angle, center) {
+        if (typeof center === "undefined")
+            center = this.position;
+        super.rotate(angle, center);
+        for (var i in this.innerTilePolygons) {
+            this.innerTilePolygons[i].rotate(angle, center);
+        }
+        for (var i in this.outerTilePolygons) {
+            this.outerTilePolygons[i].rotate(angle, center);
+        }
+        this.rotation += angle;
+        return this;
+    }
+    /**
+     * This function locates the closest tile edge (polygon edge)
+     * to the passed point.
+     *
+     * Currently the edge distance to a point is measured by the
+     * euclidian distance from the edge's middle point.
+     *
+     * Idea: move this function to Polygon?
+     *
+     * @name locateEdgeAtPoint
+     * @instance
+     * @memberof GirihTile
+     * @param {XYCoords} point     - The point to detect the closest edge for.
+     * @param {number}   tolerance - The tolerance (=max distance) the detected edge
+     *                               must be inside.
+     * @return {nmber} the edge index (index of the starting vertex, so [index,index+1] is the edge ) or -1 if not found.
+     **/
+    locateEdgeAtPoint(point, tolerance) {
+        if (this.vertices.length == 0)
+            return -1;
+        const middle = new Vertex(0, 0);
+        let tmpDistance = 0;
+        let resultDistance = tolerance * 2; // definitely outside the tolerance :)
+        let resultIndex = -1;
+        for (var i = 0; i < this.vertices.length; i++) {
+            const vertI = this.getVertexAt(i);
+            const vertJ = this.getVertexAt(i + 1);
+            // Create a point in the middle of the edge
+            middle.x = vertI.x + (vertJ.x - vertI.x) / 2.0;
+            middle.y = vertI.y + (vertJ.y - vertI.y) / 2.0;
+            tmpDistance = middle.distance(point);
+            if (tmpDistance <= tolerance && (resultIndex == -1 || tmpDistance < resultDistance)) {
+                resultDistance = tmpDistance;
+                resultIndex = i;
+            }
+        }
+        return resultIndex;
+    }
+} // END class
+/**
+ * An epsilon to use for detecting adjacent edges. 0.001 seems to be a good value.
+ * Adjust if needed.
+ *
+ * @name epsilon
+ * @member {number}
+ * @memberof GirihTile
+ * @type {number}
+ * @static
+ */
+GirihTile.epsilon = 0.001;
+/**
+ * The default edge length.
+ *
+ * @name DEFAULT_EDGE_LENGTH
+ * @member {number}
+ * @memberof GirihTile
+ * @type {number}
+ * @readonly
+ * @static
+ */
+GirihTile.DEFAULT_EDGE_LENGTH = 58;
+//# sourceMappingURL=GirihTile.js.map

package/src/_esm/src/ts/utils/datastructures/GirihTile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GirihTile.js","sourceRoot":"","sources":["../../../../../ts/utils/datastructures/GirihTile.ts"],"names":[],"mappings":"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"}

package/src/_esm/src/ts/utils/datastructures/Matrix4x4.d.ts

@@ -0,0 +1,244 @@
+/**
+ * This file defines a Matrix4x4 class for 3d transformations.
+ *
+ * [ xx xy yz xw
+ *   yx yy yz yw
+ *   zx zy zz zw
+ *   wx wy wz ww ]
+ *
+ * Original class found at
+ *    https://www.migenius.com/articles/3d-transformations-part1-matrices
+ * by Paul Arden
+ *
+ * @file Matrix4x4.js
+ */
+interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+interface Vec4 extends Vec3 {
+    w: number;
+}
+interface IMatrix4x4 {
+    xx: number;
+    xy: number;
+    xz: number;
+    xw: number;
+    yx: number;
+    yy: number;
+    yz: number;
+    yw: number;
+    zx: number;
+    zy: number;
+    zz: number;
+    zw: number;
+    wx: number;
+    wy: number;
+    wz: number;
+    ww: number;
+}
+export declare class Matrix4x4 {
+    /**
+     * xx component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    xx: number;
+    /**
+     * xy component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    xy: number;
+    /**
+     * xz component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    xz: number;
+    /**
+     * xw component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    xw: number;
+    /**
+     * yx component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    yx: number;
+    /**
+     * yy component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    yy: number;
+    /**
+     * yz component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    yz: number;
+    /**
+     * yw component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    yw: number;
+    /**
+     * zx component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    zx: number;
+    /**
+     * zy component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    zy: number;
+    /**
+     * zz component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    zz: number;
+    /**
+     * zw component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    zw: number;
+    /**
+     * wx component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    wx: number;
+    /**
+     * wy component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    wy: number;
+    /**
+     * wz component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    wz: number;
+    /**
+     * ww component of the matrix.
+     * @type {Number}
+     * @private
+     */
+    ww: number;
+    /**
+     * Generic class for representing 4x4 matrices.
+     * @constructor
+     * @param {Object} matrix - An object with the initial values for the Matrix4x4.
+     * Can be either an Object or Matrix4x4.
+     */
+    constructor(matrix?: Matrix4x4);
+    /**
+     * Set matrix components from object
+     * @param {Object} mat - Object with each component of the matrix, all components must be present.
+     * @public
+     */
+    setFromObject(mat: Matrix4x4 | IMatrix4x4): void;
+    apply4(vec4: Vec4): Vec4;
+    apply3(vec3: Vec3): Vec3;
+    /**
+     * Set all matrix components to 0.
+     * @public
+     */
+    clear(): void;
+    /**
+     * Set matrix to the identity matrix.
+     * @public
+     */
+    setIdentity(): Matrix4x4;
+    /**
+     * Sets this matrix to a rotation matrix.
+     * @param {Vec3} axis - The vector to rotate around.
+     * @param {Number} angle - The angle to rotate in radians.
+     * @public
+     */
+    setRotation(axis: Vec3, angle: number): Matrix4x4;
+    /**
+     * Sets this matrix to a rotation matrix.
+     * @param {Number} x - Scaling factor in the x axis.
+     * @param {Number} y - Scaling factor in the y axis.
+     * @param {Number} z - Scaling factor in the z axis.
+     * @public
+     */
+    setScaling(x: number, y: number, z: number): Matrix4x4;
+    /**
+     * Sets the translation elements of this matrix while leaving the
+     * rest of the matrix untouched.
+     * @param {Number} x - Translation amount in the x axis.
+     * @param {Number} y - Translation amount in the y axis.
+     * @param {Number} z - Translation amount in the z axis.
+     */
+    setTranslation(x: number, y: number, z: number): Matrix4x4;
+    /**
+     * Sets this matrix to the dot product between this matrix and the
+     * matrix specified by rhs.
+     * @param {Matrix4x4} matrix - The matrix on the right hand side of the dot product.
+     */
+    multiply(matrix: Matrix4x4): Matrix4x4;
+    /**
+     * Create the rotation matrix from the given axis and angle.
+     *
+     * @param {Vec3} axis - The axis to rotate around.
+     * @param {number} angle - The angle to use for rotation (in radians).
+     * @returns Matrix4x4
+     */
+    static makeRotationMatrix(axis: Vec3, angle: number): Matrix4x4;
+    /**
+     * Create the scaling matrix from the given x-, y- and z- scaling factors (use 1.0 for no scaling).
+     *
+     * @param {number} scaleX - The x scaling factor.
+     * @param {number} scaleY - The y scaling factor.
+     * @param {number} scaleZ - The z scaling factor.
+     * @returns Matrix4x4
+     */
+    static makeScalingMatrix(scaleX: number, scaleY: number, scaleZ: number): Matrix4x4;
+    /**
+     * Create the translation matrix from the given x-, y- and z- translation amounts (use 0.0 for no translation).
+     *
+     * @param {number} translateX - The x translation amount.
+     * @param {number} translateY - The y translation amount.
+     * @param {number} translateZ - The z translation amount.
+     * @returns Matrix4x4
+     */
+    static makeTranslationMatrix(translateX: number, translateY: number, translateZ: number): Matrix4x4;
+    /**
+     * Create a full transform matrix from the rotation, scaling and translation params.
+     *
+     * @param {number} rotateX - The rotation angle around the x axis.
+     * @param {number} rotateY - The rotation angle around the y axis.
+     * @param {number} rotateZ - The rotation angle around the z axis.
+     * @param {number} scaleX - The x scaling factor.
+     * @param {number} scaleY - The y scaling factor.
+     * @param {number} scaleZ - The z scaling factor.
+     * @param {number} translateX - The x translation amount.
+     * @param {number} translateY - The y translation amount.
+     * @param {number} translateZ - The z translation amount.
+     * @returns Matrix4x4
+     */
+    static makeTransformationMatrix(rotateX: number, rotateY: number, rotateZ: number, scaleX: number, scaleY: number, scaleZ: number, translateX: number, translateY: number, translateZ: number): Matrix4x4;
+    /**
+     * Returns a deep copy of this matrix.
+     * @return {Matrix4x4} A deep copy of this matrix.
+     */
+    clone(): Matrix4x4;
+    /**
+     * Returns a pretty print string representation of the matrix.
+     * @return {String} Pretty printed string of the matrix.
+     */
+    toJSON(): string;
+}
+export {};