plotboilerplate 1.24.0 → 1.26.0

package/src/esm/utils/algorithms/pixelCornersToRoundPaths.js

@@ -0,0 +1,266 @@
+/**
+ * A script to convert any boolean matrix to rounded paths.
+ *
+ * @author  Ikaros Kappler
+ * @date    2025-10-17 (ported to Typescript from a demo-script)
+ * @version 1.0.0
+ */
+import { Bounds } from "../../Bounds";
+import { DataGrid2dArrayMatrix } from "../datastructures/DataGrid2dArrayMatrix";
+const LEFT_BORDER = 0;
+const TOP_BORDER = 1;
+const RIGHT_BORDER = 2;
+const BOTTOM_BORDER = 3;
+/**
+ * Computes an array of paths from the given boolean matrix.
+ *
+ * @param {DataGrid2dArrayMatrix<boolean>} matrix
+ * @param {PixelCornerPathOptions} options
+ * @returns
+ */
+export const pixelCornersToRoundPaths = (matrix, options) => {
+    const paths = [];
+    const visitedLeftBorderMatrix = new DataGrid2dArrayMatrix(matrix.xSegmentCount, matrix.ySegmentCount, false);
+    const origin = options && options.origin ? options.origin : { x: 0, y: 0 };
+    const squareSize = options && typeof options.squareSize === "number" ? options.squareSize : 10;
+    const gapSize = options && typeof options.gapSize === "number" ? options.gapSize : 2;
+    const curveFactor = options && typeof options.curveFactor === "number" ? options.curveFactor : 0.666;
+    // Find an unvisited pixel with a free left neighbour
+    const condition = (value, x, y, _matrix) => {
+        return (value === true &&
+            visitedLeftBorderMatrix.get(x, y) === false &&
+            // is left neighbour free?
+            (x - 1 < 0 || _matrix.get(x - 1, y) === false));
+    };
+    // Just to be sure the while loop terminates after a maximum number of iterations.
+    const safetyLimit = matrix.xSegmentCount * matrix.ySegmentCount + 1;
+    // The next unvisited pixel position.
+    var nonVisitedPosition;
+    var i = 0;
+    while ((nonVisitedPosition = matrix.find(condition)) && i++ < safetyLimit) {
+        // console.log("nonVisitedPosition", nonVisitedPosition);
+        // Condition: if a point was found then its left neighbour is empty.
+        //            So by this the current pixel's left bound is definitely a path start.
+        const squareBox = getSquareBox(origin, squareSize, gapSize, nonVisitedPosition.xIndex, nonVisitedPosition.yIndex);
+        const west = squareBox.getWestPoint();
+        // A starting point was found: Initialize the next path.
+        var pathData = [
+            // Start point
+            "M",
+            west.x,
+            west.y
+        ];
+        // Now from this point starting (left pixel corner) construct the next sequence of path commands.
+        __constructPath(pathData, matrix, visitedLeftBorderMatrix, nonVisitedPosition, LEFT_BORDER, origin, squareSize, gapSize, curveFactor);
+        paths.push(pathData);
+        // console.log("pathData", pathData);
+    }
+    return paths;
+};
+/**
+ * Construct a bounding box representing the visual square bounds for the given pixel.
+ *
+ * @param {XYCoords} origin - The origin to build the paths from (upper left corner of the graphics).
+ * @param {number} squareSize - The number of pixels to use to represent a pixel square.
+ * @param {number} gapSize - The number of pixels to use for gaps between squares.
+ * @param {number} x - The x position inside the data grid (matrix offset).
+ * @param {number} y - They  position inside the data grid (matrix offset).
+ * @returns
+ */
+const getSquareBox = (origin, squareSize, gapSize, x, y) => {
+    return new Bounds({
+        x: origin.x + x * (squareSize + gapSize),
+        y: origin.y + y * (squareSize + gapSize)
+    }, {
+        x: origin.x + x * (squareSize + gapSize) + squareSize,
+        y: origin.y + y * (squareSize + gapSize) + squareSize
+    });
+};
+/**
+ * Lerp between these two numbers using the passed lerp amount (usually a value in 0.0-1.0).
+ *
+ * @param {number} a
+ * @param {number} b
+ * @param {number} lerpFactor
+ * @returns {number}
+ */
+const lerp = (a, b, lerpFactor) => {
+    return a + (b - a) * lerpFactor;
+};
+/**
+ * Construct a path command for a cubic Bézier curve.
+ *
+ * @param {SVGPathParams} pathData
+ * @param {XYCoords} start
+ * @param {XYCoords} controlA
+ * @param {XYCoords} controlB
+ * @param {XYCoords} end
+ * @param {number} curveFactor
+ */
+const addRoundCorner = (pathData, start, controlA, controlB, end, curveFactor) => {
+    pathData.push("C", lerp(start.x, controlA.x, curveFactor), lerp(start.y, controlA.y, curveFactor), lerp(end.x, controlB.x, curveFactor), lerp(end.y, controlB.y, curveFactor), end.x, end.y);
+};
+/**
+ * Construct a new path command for a straight line.
+ *
+ * @param {SVGPathParams} pathData
+ * @param {XYCoords} target
+ */
+const addStraightLine = (pathData, target) => {
+    pathData.push("L", target.x, target.y);
+};
+/**
+ * A helper function for constructing the next path, beginning at the passed matrix position.
+ *
+ * Note the path will be created at the left border of the given 'pixel', constructe
+ * in clockwise order.
+ *
+ * @param {SVGPathParams} pathData
+ * @param {DataGrid2dArrayMatrix<boolean>} matrix - The data matrix to use.
+ * @param {DataGrid2dArrayMatrix<boolean>} visitedLeftBordersMatrix - A helper matrix to keep track of visited pixels.
+ * @param {RasterPosition} startingPosition
+ * @param {number} startingBorderDirection
+ * @param {XYCoords} origin
+ * @param {number} squareSize
+ * @param {number} gapSize
+ * @param {number} curveFactor
+ */
+const __constructPath = (pathData, matrix, visitedLeftBordersMatrix, startingPosition, startingBorderDirection, origin, squareSize, gapSize, curveFactor) => {
+    // Pre: position's neighbour pixel at ehe given border direction is unset.
+    var isPathComplete = false;
+    const maxInterations = matrix.xSegmentCount * matrix.ySegmentCount * 4 + 1;
+    var i = 0;
+    var position = startingPosition;
+    var borderDirection = startingBorderDirection;
+    while (!isPathComplete && i++ < maxInterations) {
+        var x = position.xIndex;
+        var y = position.yIndex;
+        // console.log("x", x, "y", y, "borderDirection", borderDirection);
+        // Get the pixel's box bounds.
+        const squareBox = getSquareBox(origin, squareSize, gapSize, x, y);
+        // Find next step when walking 'clockwise'
+        if (borderDirection === LEFT_BORDER) {
+            // Only track visits on left borders. By this we can detect non-visited holes :)
+            visitedLeftBordersMatrix.set(x, y, true);
+            // We want to expand the left border
+            const west = squareBox.getWestPoint();
+            // Pixel in the north?
+            if (y - 1 < 0 || matrix.get(x, y - 1) === false) {
+                // Northwise pixel is empty
+                //  -> construct round corner to right
+                addRoundCorner(pathData, west, squareBox.getNorthWestPoint(), squareBox.getNorthWestPoint(), squareBox.getNorthPoint(), curveFactor);
+                borderDirection = TOP_BORDER;
+                // Keep pixel position unchanged
+            }
+            else if (x - 1 >= 0 && matrix.get(x - 1, y - 1) === true) {
+                // Top neighbour pixel is set AND top-left pixel is set too.
+                // -> construct rounded edge to top-left.
+                const squareBoxNW = getSquareBox(origin, squareSize, gapSize, x - 1, y - 1);
+                addRoundCorner(pathData, west, squareBox.getNorthWestPoint(), squareBoxNW.getSouthEastPoint(), squareBoxNW.getSouthPoint(), curveFactor);
+                borderDirection = BOTTOM_BORDER;
+                position = { xIndex: x - 1, yIndex: y - 1 };
+            }
+            else {
+                // Straight to top
+                const squareBoxN = getSquareBox(origin, squareSize, gapSize, x, y - 1);
+                addStraightLine(pathData, squareBoxN.getWestPoint());
+                position = { xIndex: x, yIndex: y - 1 };
+                // Keep borderDirection: LEFT_BORDER
+                // isPathComplete = true; // TODO
+            }
+        }
+        else if (borderDirection === TOP_BORDER) {
+            // North pixel is definitely empty.
+            const north = squareBox.getNorthPoint();
+            if (x + 1 >= matrix.xSegmentCount || matrix.get(x + 1, y) === false) {
+                // Top border and right pixel is empty
+                //  --> create rounded corner to right south
+                addRoundCorner(pathData, north, squareBox.getNorthEastPoint(), squareBox.getNorthEastPoint(), squareBox.getEastPoint(), curveFactor);
+                borderDirection = RIGHT_BORDER;
+                // Keep pixel position unchanged
+            }
+            else if (y - 1 < 0 || matrix.get(x + 1, y - 1) === false) {
+                // Top border and right pixel is set, and north-east pixel is clear.
+                // -> linear path to right
+                const squareBoxE = getSquareBox(origin, squareSize, gapSize, x + 1, y);
+                addStraightLine(pathData, squareBoxE.getNorthPoint());
+                position = { xIndex: x + 1, yIndex: y };
+                // Keep borderDirection TOP
+            }
+            else {
+                // Last case: right neighbour is set and north-east pixel is set
+                //-> construct a rounded corner to east-north.
+                const squareBoxNE = getSquareBox(origin, squareSize, gapSize, x + 1, y - 1);
+                addRoundCorner(pathData, north, squareBox.getNorthEastPoint(), squareBoxNE.getSouthWestPoint(), squareBoxNE.getWestPoint(), curveFactor);
+                borderDirection = LEFT_BORDER;
+                position = { xIndex: x + 1, yIndex: y - 1 };
+                // isPathComplete = true; // TODO!!!
+            }
+        }
+        else if (borderDirection === RIGHT_BORDER) {
+            // East pixel is definitely empty.
+            var east = squareBox.getEastPoint();
+            if (y + 1 >= matrix.ySegmentCount || matrix.get(x, y + 1) === false) {
+                // South pixel is empty.
+                // -> construct rounded corner to south-east
+                addRoundCorner(pathData, east, squareBox.getSouthEastPoint(), squareBox.getSouthEastPoint(), squareBox.getSouthPoint(), curveFactor);
+                borderDirection = BOTTOM_BORDER;
+                // Keep pixel position unchanged
+            }
+            else if (x + 1 < matrix.xSegmentCount && y + 1 < matrix.ySegmentCount && matrix.get(x + 1, y + 1) === true) {
+                // South pixel is set AND right lower pixel is set, too.
+                // -> construct round corner to south-east.
+                const squareBoxSE = getSquareBox(origin, squareSize, gapSize, x + 1, y + 1);
+                addRoundCorner(pathData, east, squareBox.getSouthEastPoint(), squareBoxSE.getNorthWestPoint(), squareBoxSE.getNorthPoint(), curveFactor);
+                borderDirection = TOP_BORDER;
+                position = { xIndex: x + 1, yIndex: y + 1 };
+            }
+            else {
+                // South pixel is set and south-east pixel is clear.
+                // -> construct linear connection to south
+                const squareBoxS = getSquareBox(origin, squareSize, gapSize, x, y + 1);
+                addStraightLine(pathData, squareBoxS.getEastPoint());
+                position = { xIndex: x, yIndex: y + 1 };
+                // Keep borderDirection RIGHT
+            }
+        }
+        else if (borderDirection === BOTTOM_BORDER) {
+            // Pre: south pixel is definitely empty
+            const south = squareBox.getSouthPoint();
+            if (x - 1 < 0 || matrix.get(x - 1, y) === false) {
+                // Left pixel is empty
+                // -> construct round corner to west-north
+                addRoundCorner(pathData, south, squareBox.getSouthWestPoint(), squareBox.getSouthWestPoint(), squareBox.getWestPoint(), curveFactor);
+                borderDirection = LEFT_BORDER;
+            }
+            else if (x - 1 >= 0 && y + 1 < matrix.ySegmentCount && matrix.get(x - 1, y + 1) === true) {
+                // Left pixel AND left lower pixel are set
+                // -> construct rounded edge to south-west
+                const squareBoxSW = getSquareBox(origin, squareSize, gapSize, x - 1, y + 1);
+                addRoundCorner(pathData, south, squareBox.getSouthWestPoint(), squareBoxSW.getNorthEastPoint(), squareBoxSW.getEastPoint(), curveFactor);
+                borderDirection = RIGHT_BORDER;
+                position = { xIndex: x - 1, yIndex: y + 1 };
+            }
+            else {
+                // Left pixel is set AND south pixel is empty
+                // -> construct linear edge to left neighbour.
+                const squareBoxW = getSquareBox(origin, squareSize, gapSize, x - 1, y);
+                addStraightLine(pathData, squareBoxW.getSouthPoint());
+                position = { xIndex: x - 1, yIndex: y };
+                // Keep borderDirection BOTTOM
+            }
+        }
+        else {
+            console.warn(`[Error] Cannot construct full rounded path; 'borderDirection' has wrong value (${borderDirection}).`);
+            isPathComplete = true;
+        }
+        // End condition reached?
+        if (startingPosition.xIndex === position.xIndex &&
+            startingPosition.yIndex === position.yIndex &&
+            startingBorderDirection === borderDirection) {
+            pathData.push("Z");
+            isPathComplete = true;
+        }
+    }
+};
+//# sourceMappingURL=pixelCornersToRoundPaths.js.map

package/src/esm/utils/algorithms/pixelCornersToRoundPaths.js.map

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

package/src/esm/utils/datastructures/Color.d.ts

@@ -18,7 +18,12 @@
  * @modified 2022-05-11 Fixed the `interpolate` function.
  * @modified 2023-01-23 Added `Color.set(Color)` function to set all values (r,g,b,h,s,l,a) simultanoeusly.
  * @modified 2024-03-10 Fixed some NaN type check for Typescript 5 compatibility.
- * @version 0.0.13
+ * @modified 2025-08-08 Fixed an issue in the static `makeRGB` method: values in [0..1] are now correctly reconized (1.0 was excluded).
+ * @modified 2025-08-08 Added static color instances (singletons): Color.Red, Color.Gold, Color.Yellow, Color.Green, Color.LimeGreen, Color.Blue, Color.MediumBlue, Color.Purple.
+ * @modified 2025-09-01 Adding all standard web colors. Source: https://en.wikipedia.org/wiki/Web_colors
+ * @modified 2025-09-01 Modifying the `Sanitizer.RGB` helper method: recognoizing 0 to 255 as valid values (not only 1 to 255).
+ * @modified 2025-09-01 Modifying the `Color.parse` method: recognizing CSS color strings now.
+ * @version 0.0.14
  **/
 /**
  * @classdesc A color class, inspired by neolitec's Javascript class.
@@ -242,4 +247,145 @@ export declare class Color {
      * @return {Color} A clone of this color (in RGB mode).
      */
     interpolate(c: Color, t: number): Color;
+    static MediumVioletRed: Color;
+    static DeepPink: Color;
+    static PaleVioletRed: Color;
+    static HotPink: Color;
+    static LightPink: Color;
+    static Pink: Color;
+    static DarkRed: Color;
+    static Red: Color;
+    static Firebrick: Color;
+    static Crimson: Color;
+    static IndianRed: Color;
+    static LightCoral: Color;
+    static Salmon: Color;
+    static DarkSalmon: Color;
+    static LightSalmon: Color;
+    static OrangeRed: Color;
+    static Tomato: Color;
+    static DarkOrange: Color;
+    static Coral: Color;
+    static Orange: Color;
+    static DarkKhaki: Color;
+    static Gold: Color;
+    static Khaki: Color;
+    static PeachPuff: Color;
+    static Yellow: Color;
+    static PaleGoldenrod: Color;
+    static Moccasin: Color;
+    static PapayaWhip: Color;
+    static LightGoldenrodYellow: Color;
+    static LemonChiffon: Color;
+    static LightYellow: Color;
+    static Maroon: Color;
+    static Brown: Color;
+    static SaddleBrown: Color;
+    static Sienna: Color;
+    static Chocolate: Color;
+    static DarkGoldenrod: Color;
+    static Peru: Color;
+    static RosyBrown: Color;
+    static Goldenrod: Color;
+    static SandyBrown: Color;
+    static Tan: Color;
+    static Burlywood: Color;
+    static Wheat: Color;
+    static NavajoWhite: Color;
+    static Bisque: Color;
+    static BlanchedAlmond: Color;
+    static Cornsilk: Color;
+    static Indigo: Color;
+    static Purple: Color;
+    static DarkMagenta: Color;
+    static DarkViolet: Color;
+    static DarkSlateBlue: Color;
+    static BlueViolet: Color;
+    static DarkOrchid: Color;
+    static Fuchsia: Color;
+    static Magenta: Color;
+    static SlateBlue: Color;
+    static MediumSlateBlue: Color;
+    static MediumOrchid: Color;
+    static MediumPurple: Color;
+    static Orchid: Color;
+    static Violet: Color;
+    static Plum: Color;
+    static Thistle: Color;
+    static Lavender: Color;
+    static MidnightBlue: Color;
+    static Navy: Color;
+    static DarkBlue: Color;
+    static MediumBlue: Color;
+    static Blue: Color;
+    static RoyalBlue: Color;
+    static SteelBlue: Color;
+    static DodgerBlue: Color;
+    static DeepSkyBlue: Color;
+    static CornflowerBlue: Color;
+    static SkyBlue: Color;
+    static LightSkyBlue: Color;
+    static LightSteelBlue: Color;
+    static LightBlue: Color;
+    static PowderBlue: Color;
+    static Teal: Color;
+    static DarkCyan: Color;
+    static LightSeaGreen: Color;
+    static CadetBlue: Color;
+    static DarkTurquoise: Color;
+    static MediumTurquoise: Color;
+    static Turquoise: Color;
+    static Aqua: Color;
+    static Cyan: Color;
+    static Aquamarine: Color;
+    static PaleTurquoise: Color;
+    static LightCyan: Color;
+    static DarkGreen: Color;
+    static Green: Color;
+    static DarkOliveGreen: Color;
+    static ForestGreen: Color;
+    static SeaGreen: Color;
+    static Olive: Color;
+    static OliveDrab: Color;
+    static MediumSeaGreen: Color;
+    static LimeGreen: Color;
+    static Lime: Color;
+    static SpringGreen: Color;
+    static MediumSpringGreen: Color;
+    static DarkSeaGreen: Color;
+    static MediumAquamarine: Color;
+    static YellowGreen: Color;
+    static LawnGreen: Color;
+    static Chartreuse: Color;
+    static LightGreen: Color;
+    static GreenYellow: Color;
+    static PaleGreen: Color;
+    static MistyRose: Color;
+    static AntiqueWhite: Color;
+    static Linen: Color;
+    static Beige: Color;
+    static WhiteSmoke: Color;
+    static LavenderBlush: Color;
+    static OldLace: Color;
+    static AliceBlue: Color;
+    static Seashell: Color;
+    static GhostWhite: Color;
+    static Honeydew: Color;
+    static FloralWhite: Color;
+    static Azure: Color;
+    static MintCream: Color;
+    static Snow: Color;
+    static Ivory: Color;
+    static White: Color;
+    static Black: Color;
+    static DarkSlateGray: Color;
+    static DimGray: Color;
+    static SlateGray: Color;
+    static Gray: Color;
+    static LightSlateGray: Color;
+    static DarkGray: Color;
+    static Silver: Color;
+    static LightGray: Color;
+    static Gainsboro: Color;
+    static CSS_COLORS: Record<string, Color>;
 }