plotboilerplate 1.27.1 → 1.28.0

package/src/_esm/utils/parsers/STLParser.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Refactored 3daddict's js-stl-parser.
+ *
+ * Found at
+ *   https://github.com/3daddict/js-stl-parser/blob/master/index.js
+ *
+ * Refactored by Ikaros Kappler
+ *
+ * @date     2021-04-16
+ * @modified 2024-03-09 Added type checks for Typescript 5 compatibility.
+ * @version  0.0.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STLParser = void 0;
+class Vertex {
+    constructor(x, y, z) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+}
+// Vertex Holder
+class VertexHolder {
+    constructor(vertex1, vertex2, vertex3) {
+        this.vert1 = vertex1;
+        this.vert2 = vertex2;
+        this.vert3 = vertex3;
+    }
+}
+// transforming a Node.js Buffer into a V8 array buffer
+const _toArrayBuffer = (buffer) => {
+    const ab = new ArrayBuffer(buffer.length);
+    const view = new Uint8Array(ab);
+    for (var i = 0; i < buffer.length; ++i) {
+        view[i] = buffer.charCodeAt(i);
+    }
+    return ab;
+};
+/**
+ * @classdesc STLParser
+ */
+class STLParser {
+    /**
+     * Create a new STLParser with the given callback fuction for facets.
+     *
+     * @param {function} handleFacet function(x,y,z)
+     * @constructor
+     * */
+    constructor(handleFacet) {
+        this.handleFacet = handleFacet;
+    }
+    /**
+     * Parse an stl string (ASCII).
+     * @name _parseSTLString
+     * @method _parseSTLString
+     * @memberof STLParser
+     * @param {string} stl
+     * @private
+     */
+    _parseSTLString(stl) {
+        // yes, this is the regular expression, matching the vertexes
+        // it was kind of tricky but it is fast and does the job
+        const vertexes = stl.match(/facet\s+normal\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+outer\s+loop\s+vertex\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+vertex\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+vertex\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+endloop\s+endfacet/g);
+        if (!vertexes) {
+            throw "[STLParser] Failed to parse STL input; regex could not match.";
+        }
+        ;
+        const _handleFacet = this.handleFacet;
+        vertexes.forEach((vert) => {
+            const preVertexHolder = new VertexHolder();
+            const vertValues = vert
+                .match(/vertex\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s+([-+]?\b(?:[0-9]*\.)?[0-9]+(?:[eE][-+]?[0-9]+)?\b)\s/g);
+            if (!vertValues) {
+                console.warn("[STLParser] Could not parse vertex values.", vertValues);
+            }
+            else {
+                vertValues.forEach((vertex, i) => {
+                    const tempVertex = vertex.replace("vertex", "").match(/[-+]?[0-9]*\.?[0-9]+/g);
+                    if (!tempVertex) {
+                        console.warn("[STLParser] Failed to parse vertex value.", tempVertex);
+                    }
+                    else {
+                        const preVertex = new Vertex(Number(tempVertex[0]), Number(tempVertex[1]), Number(tempVertex[2]));
+                        // preVertexHolder["vert" + (i + 1)] = preVertex;
+                        switch (i) {
+                            case 0:
+                                preVertexHolder.vert1 = preVertex;
+                                break;
+                            case 1:
+                                preVertexHolder.vert2 = preVertex;
+                                break;
+                            case 2:
+                                preVertexHolder.vert3 = preVertex;
+                                break;
+                            default: console.warn("[STLParse] Warning, vertex component index unexpeced.", i);
+                        }
+                    }
+                });
+            }
+            if (preVertexHolder.vert1 && preVertexHolder.vert2 && preVertexHolder.vert3) {
+                _handleFacet(preVertexHolder.vert1, preVertexHolder.vert2, preVertexHolder.vert3);
+            }
+            else {
+                console.warn("[STLParse] Warning, cannot add vertex to mesh. vertex not fully defined.");
+            }
+        });
+    }
+    /**
+     * Parse binary STL data.
+     * @param {ArrayBuffer} buf
+     */
+    _parseSTLBinary(buf) {
+        // parsing an STL Binary File
+        // (borrowed some code from here: https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/STLLoader.js)
+        const headerLength = 80;
+        const dataOffset = 84;
+        const faceLength = 12 * 4 + 2;
+        const le = true; // is little-endian
+        const dvTriangleCount = new DataView(buf, headerLength, 4);
+        const numTriangles = dvTriangleCount.getUint32(0, le);
+        for (var i = 0; i < numTriangles; i++) {
+            const dv = new DataView(buf, dataOffset + i * faceLength, faceLength);
+            const normal = new Vertex(dv.getFloat32(0, le), dv.getFloat32(4, le), dv.getFloat32(8, le));
+            const vertHolder = new VertexHolder();
+            for (var v = 3; v < 12; v += 3) {
+                var vert = new Vertex(dv.getFloat32(v * 4, le), dv.getFloat32((v + 1) * 4, le), dv.getFloat32((v + 2) * 4, le));
+                // vertHolder["vert" + v / 3] = vert;
+                const vIndex = v / 3;
+                switch (vIndex) {
+                    case 1:
+                        vertHolder.vert1 = vert;
+                        break;
+                    case 2:
+                        vertHolder.vert2 = vert;
+                        break;
+                    case 3:
+                        vertHolder.vert3 = vert;
+                        break;
+                    default: console.warn("[STLParser] Warning, binary vertex component index unexpeced.", vIndex);
+                }
+            }
+            if (vertHolder.vert1 && vertHolder.vert2 && vertHolder.vert3) {
+                this.handleFacet(vertHolder.vert1, vertHolder.vert2, vertHolder.vert3, normal);
+            }
+            else {
+                console.warn("[STLParser] Warning, cannot add binary vertex to mesh. vertex not fully defined.");
+            }
+        }
+    }
+    /**
+     * Parse any, binary or ascii, STL data.
+     *
+     * @name parse
+     * @method parse
+     * @member
+     * @memberof STLParser
+     * @param {ArrayBstringuffer} binaryOrAsciiString
+     * @returns
+     */
+    parse(binaryOrAsciiString) {
+        var isAscii = true;
+        for (var i = 0, len = binaryOrAsciiString.length; i < len && isAscii; i++) {
+            if (binaryOrAsciiString.charCodeAt(i) > 127) {
+                isAscii = false;
+                break;
+            }
+        }
+        if (isAscii) {
+            this._parseSTLString(binaryOrAsciiString.toString());
+        }
+        else {
+            const buffer = _toArrayBuffer(binaryOrAsciiString);
+            this._parseSTLBinary(buffer);
+        }
+    }
+}
+exports.STLParser = STLParser;
+//# sourceMappingURL=STLParser.js.map

package/src/_esm/utils/parsers/STLParser.js.map

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

package/src/_esm/utils/parsers/svg/parseSVGPathData.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Parse SVG path data strings and convert to PlotBoilerplate path objects.
+ *
+ * As this parser function does not detect all possible path data strings it should cover the most daily use-cases.
+ *
+ * For more insight see
+ *    https://www.w3.org/TR/SVG/paths.html
+ *
+ * @author  Ikaros Kappler
+ * @date    2022-11-06
+ * @modified 2022-12-21 (winter solstice) Porting this to Typescript.
+ * @modified 2023-01-17 Handling multiple parameter sets now.
+ * @version 0.0.2-alpha
+ **/
+import { CubicBezierCurve } from "../../../CubicBezierCurve";
+import { Line } from "../../../Line";
+/**
+ * Transform the given path data (translate and scale. rotating is not intended here).
+ *
+ * @date 2022-11-06
+ *
+ * @name parseSVGPathData
+ * @static
+ * @param {string} data - The data to parse.
+ * @return An array of straight line segments (Line) or curve segments (CubicBezierCurve) representing the path.
+ */
+export declare const parseSVGPathData: (dataString: string) => Array<Line | CubicBezierCurve> | null;