plotboilerplate 1.12.10 → 1.16.0

package/src/esm/utils/io/FileDrop.js.map

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

package/src/ts/BezierPath.ts

@@ -20,7 +20,10 @@
  * @modified 2020-07-24 Added the getClosestT(Vertex) function.
  * @modified 2020-12-29 Constructor is now private (no explicit use intended).
  * @modified 2021-05-25 Added BezierPath.fromReducedList( Array<number> ).
- * @version 2.3.1
+ * @modified 2022-01-31 Added `BezierPath.getEvenDistributionVertices(number)`.
+ * @modified 2022-02-02 Added the `destroy` method.
+ * @modified 2022-02-02 Cleared the `toSVGString` function (deprecated). Use `drawutilssvg` instead.
+ * @version 2.5.0
  *
  * @file BezierPath
  * @public
@@ -96,6 +99,14 @@ export class BezierPath implements SVGSerializable {
    */
   bezierCurves: Array<CubicBezierCurve>;
 
+  /**
+   * @member {boolean}
+   * @memberof BezierPath
+   * @type {boolean}
+   * @instance
+   */
+  isDestroyed: boolean;
+
   // +---------------------------------------------------------------------------------
   // | These constants equal the values from CubicBezierCurve.
   // +-------------------------------
@@ -529,6 +540,38 @@ export class BezierPath implements SVGSerializable {
     return this;
   }
 
+  /**
+   * Scale the whole bezier path by the given uniform factor.
+   *
+   * @method scale
+   * @param {Vertex} anchor - The scale origin to scale from.
+   * @param {number} scaleFactor - The scalar to be multiplied with.
+   * @instance
+   * @memberof BezierPath
+   * @return {BezierPath} this for chaining.
+   **/
+  scale(anchor: Vertex, scaleFactor: number): BezierPath {
+    // var scaleFactors : XYCoords = { x : scaleFactor, y : scaleFactor };
+    // for (var i = 0; i < this.bezierCurves.length; i++) {
+    //   var curve = this.bezierCurves[i];
+    //   curve.getStartPoint().scale(scaleFactor, anchor);
+    //   curve.getStartControlPoint().scale(scaleFactor, anchor);
+    //   curve.getEndControlPoint().scale(scaleFactor, anchor);
+    //   // Do NOT scale the end point here!
+    //   // Don't forget that the curves are connected and on curve's end point
+    //   // the the successor's start point (same instance)!
+    // }
+
+    // // Finally move the last end point (was not scaled yet)
+    // if (this.bezierCurves.length > 0 && !this.adjustCircular) {
+    //   this.bezierCurves[this.bezierCurves.length - 1].getEndPoint().scale(scaleFactor, anchor);
+    // }
+
+    // this.updateArcLengths();
+    // return this;
+    return this.scaleXY({ x: scaleFactor, y: scaleFactor }, anchor);
+  }
+
   /**
    * Scale the whole bezier path by the given (x,y)-factors.
    *
@@ -539,12 +582,12 @@ export class BezierPath implements SVGSerializable {
    * @memberof BezierPath
    * @return {BezierPath} this for chaining.
    **/
-  scale(anchor: Vertex, scaling: number): BezierPath {
+  scaleXY(scaleFactors: XYCoords, anchor?: XYCoords): BezierPath {
     for (var i = 0; i < this.bezierCurves.length; i++) {
       var curve = this.bezierCurves[i];
-      curve.getStartPoint().scale(scaling, anchor);
-      curve.getStartControlPoint().scale(scaling, anchor);
-      curve.getEndControlPoint().scale(scaling, anchor);
+      curve.getStartPoint().scaleXY(scaleFactors, anchor);
+      curve.getStartControlPoint().scaleXY(scaleFactors, anchor);
+      curve.getEndControlPoint().scaleXY(scaleFactors, anchor);
       // Do NOT scale the end point here!
       // Don't forget that the curves are connected and on curve's end point
       // the the successor's start point (same instance)!
@@ -552,7 +595,7 @@ export class BezierPath implements SVGSerializable {
 
     // Finally move the last end point (was not scaled yet)
     if (this.bezierCurves.length > 0 && !this.adjustCircular) {
-      this.bezierCurves[this.bezierCurves.length - 1].getEndPoint().scale(scaling, anchor);
+      this.bezierCurves[this.bezierCurves.length - 1].getEndPoint().scaleXY(scaleFactors, anchor);
     }
 
     this.updateArcLengths();
@@ -1022,6 +1065,64 @@ export class BezierPath implements SVGSerializable {
     return new Bounds(min, max);
   }
 
+  /**
+   * Get n 'equally' distributed vertices along this Bézier path.
+   *
+   * As the changing curvature of the B slines makes prediction of distances difficult, the
+   * returned vertices' distances are only relatively equal:
+   *  - the distance grows where curvature is large.
+   *  - the distance shrinks where curvature is small.
+   *
+   * Only the distance mean of all consecutive is 1/n-th of the total arc length.
+   *
+   * Usually this approximation is good enough for most use cases.
+   *
+   * @param {number} pointCount - (must be at least 2) The number of desired points (start and end point included).
+   * @return {Array<Vertex>}
+   */
+  getEvenDistributionVertices(pointCount: number): Array<Vertex> {
+    if (pointCount < 2) {
+      throw new Error("pointCount must be larger than one; is " + pointCount + ".");
+    }
+
+    const result: Array<Vertex> = [];
+    if (this.bezierCurves.length === 0) {
+      return result;
+    }
+
+    // Fetch and add the start point from the source polygon
+    var polygonPoint = new Vertex(this.bezierCurves[0].startPoint);
+    result.push(polygonPoint);
+    // if (this.bezierCurves.length === 1) {
+    //   return result;
+    // }
+
+    const perimeter: number = this.totalArcLength;
+    const stepSize: number = perimeter / (pointCount - 1);
+    const n: number = this.bezierCurves.length;
+
+    let curveIndex: number = 0;
+    let segmentLength: number = this.bezierCurves[0].arcLength;
+    let curSegmentU: number = stepSize;
+    let i: number = 1;
+    while (i < pointCount && curveIndex < n) {
+      // Check if next eq point is inside this segment
+      if (curSegmentU < segmentLength) {
+        var newPoint = this.bezierCurves[curveIndex].getPoint(curSegmentU);
+        result.push(newPoint);
+        curSegmentU += stepSize;
+        i++;
+      } else {
+        curveIndex++;
+        curSegmentU = curSegmentU - segmentLength;
+        segmentLength = curveIndex < n ? this.bezierCurves[curveIndex].arcLength : 0;
+      }
+    }
+
+    result.push(new Vertex(this.bezierCurves[n - 1].endPoint));
+    return result;
+  }
+
   /**
    * Clone this BezierPath (deep clone).
    *
@@ -1075,17 +1176,33 @@ export class BezierPath implements SVGSerializable {
    * @return {string} The SVG string.
    **/
   toSVGString(options: { className?: string }): string {
-    options = options || {};
-    var buffer: Array<string> = [];
-    buffer.push("<path");
-    if (options.className) buffer.push(' class="' + options.className + '"');
-    buffer.push(' d="');
-    for (var c = 0; c < this.bezierCurves.length; c++) {
-      if (c > 0) buffer.push(" ");
-      buffer.push(this.bezierCurves[c].toSVGPathData());
+    // options = options || {};
+    // var buffer: Array<string> = [];
+    // buffer.push("<path");
+    // if (options.className) buffer.push(' class="' + options.className + '"');
+    // buffer.push(' d="');
+    // for (var c = 0; c < this.bezierCurves.length; c++) {
+    //   if (c > 0) buffer.push(" ");
+    //   buffer.push(this.bezierCurves[c].toSVGPathData());
+    // }
+    // buffer.push('" />');
+    // return buffer.join("");
+    console.warn(
+      "[Deprecation] Warning: the BezierPath.toSVGString method is deprecated and does not return and valid SVG data any more. Please use `drawutilssvg` instead."
+    );
+    return "";
+  }
+
+  /**
+   * This function should invalidate any installed listeners and invalidate this object.
+   * After calling this function the object might not hold valid data any more and
+   * should not be used.
+   */
+  destroy() {
+    for (var i = 0; i < this.bezierCurves.length; i++) {
+      this.bezierCurves[i].destroy();
     }
-    buffer.push('" />');
-    return buffer.join("");
+    this.isDestroyed = true;
   }
 
   /**

package/src/ts/Circle.ts

@@ -7,10 +7,11 @@
  * @modified 2020-09-07 Changed the vertAt function by switching sin and cos! The old version did not return the correct vertex (by angle) accoring to the assumed circle math.
  * @modified 2020-10-16 Added the containsCircle(...) function.
  * @modified 2021-01-20 Added UID.
- * @version  1.2.0
+ * @modified 2022-02-02 Added the `destroy` method.
+ * @modified 2022-02-02 Cleared the `toSVGString` function (deprecated). Use `drawutilssvg` instead.
+ * @version  1.3.0
  **/
 
-
 import { Line } from "./Line";
 import { UIDGenerator } from "./UIDGenerator";
 import { Vector } from "./Vector";
@@ -18,214 +19,226 @@ import { VertTuple } from "./VertTuple";
 import { Vertex } from "./Vertex";
 import { SVGSerializable, UID } from "./interfaces";
 
-
 /**
  * @classdesc A simple circle: center point and radius.
  *
  * @requires Line
  * @requires Vector
- * @requires VertTuple 
+ * @requires VertTuple
  * @requires Vertex
  * @requires SVGSerializale
  * @requires UID
  * @requires UIDGenerator
  **/
 export class Circle implements SVGSerializable {
-
-    /** 
-     * Required to generate proper CSS classes and other class related IDs.
-     **/
-    readonly className : string = "Circle";
-    
-    /**
-     * The UID of this drawable object.
-     *
-     * @member {UID}
-     * @memberof Circle
-     * @instance
-     * @readonly 
-     */
-    readonly uid : UID;
-    
-    
-    /** 
-     * @member {Vertex} 
-     * @memberof Circle
-     * @instance
-     */
-    center:Vertex;
-
-    /**	
-     * @member {number} 
-     * @memberof Circle
-     * @instance
-     */
-    radius:number;
-
-
-    /**
-     * Create a new circle with given center point and radius.
-     *
-     * @constructor
-     * @name Circle
-     * @param {Vertex} center - The center point of the circle.
-     * @param {number} radius - The radius of the circle.
-     */
-    constructor( center:Vertex, radius:number ) {
-	this.uid = UIDGenerator.next();
-	this.center = center;
-	this.radius = radius;
-    };
-
-
-    /**
-     * Check if the given circle is fully contained inside this circle.
-     *
-     * @method containsCircle
-     * @param {Circle} circle - The circle to check if it is contained in this circle.
-     * @instance
-     * @memberof Circle
-     * @return {boolean} `true` if any only if the given circle is completely inside this circle.
-     */
-    containsCircle( circle:Circle ) : boolean {
-	return this.center.distance(circle.center) + circle.radius < this.radius;
-    };
-
-
-    /**
-     * Calculate the distance from this circle to the given line.
-     *
-     * * If the line does not intersect this ciecle then the returned 
-     *   value will be the minimal distance.
-     * * If the line goes through this circle then the returned value 
-     *   will be max inner distance and it will be negative.
-     *
-     * @method lineDistance
-     * @param {Line} line - The line to measure the distance to.
-     * @return {number} The minimal distance from the outline of this circle to the given line.
-     * @instance
-     * @memberof Circle
-     */
-    lineDistance( line:VertTuple<any> ) : number {
-	const closestPointOnLine : Vertex = line.getClosestPoint( this.center );
-	return closestPointOnLine.distance( this.center ) - this.radius;
-    };
-
-    /**
-     * Get the vertex on the this circle for the given angle.
-     *
-     * @method vertAt
-     * @param {number} angle - The angle (in radians) to use.
-     * @return {Vertex} The vertex (point) at the given angle.
-     * @instance
-     * @memberof Circle
-     **/
-    vertAt( angle: number ) : Vertex {
-	// Find the point on the circle respective the angle. Then move relative to center.
-	return Circle.circleUtils.vertAt( angle, this.radius ).add( this.center );
-    };
-    
-
-    /**
-     * Get a tangent line of this circle for a given angle.
-     *
-     * Point a of the returned line is located on the circle, the length equals the radius.
-     *
-     * @method tangentAt
-     * @instance
-     * @param {number} angle - The angle (in radians) to use.
-     * @return {Line} The tangent line.
-     * @memberof Circle
-     **/
-    tangentAt( angle: number ) : Vector {
-	const pointA : Vertex = Circle.circleUtils.vertAt( angle, this.radius );
-	// Construct the perpendicular of the line in point a. Then move relative to center.
-	return (new Vector( pointA, new Vertex(0,0) ).add( this.center ) as Vector).perp() as Vector;
-    };
-
-    /**
-     * Calculate the intersection points (if exists) with the given circle.
-     *
-     * @method circleIntersection
-     * @instance
-     * @memberof Circle
-     * @param {Circle} circle 
-     * @return {Line|null} The intersection points (as a line) or null if the two circles do not intersect.
-     **/
-    circleIntersection( circle:Circle ) : Line | null {
-	// Circles do not intersect at all?
-	if( this.center.distance(circle.center) > this.radius+circle.radius ) {
-	    return null;
-	}
-	// One circle is fully inside the other?
-	if( this.center.distance(circle.center) < Math.abs(this.radius-circle.radius) ) {
-	    return null;
-	}
-	// Based on the C++ implementation by Robert King
-	//    https://stackoverflow.com/questions/3349125/circle-circle-intersection-points
-	// and the 'Circles and spheres' article by Paul Bourke.
-	//    http://paulbourke.net/geometry/circlesphere/
-	//
-	// This is the original C++ implementation:
-	//
-	// pair<Point, Point> intersections(Circle c) {
-        //    Point P0(x, y);
-        //    Point P1(c.x, c.y);
-        //    float d, a, h;
-        //    d = P0.distance(P1);
-        //    a = (r*r - c.r*c.r + d*d)/(2*d);
-        //    h = sqrt(r*r - a*a);
-        //    Point P2 = P1.sub(P0).scale(a/d).add(P0);
-        //    float x3, y3, x4, y4;
-        //    x3 = P2.x + h*(P1.y - P0.y)/d;
-        //    y3 = P2.y - h*(P1.x - P0.x)/d;
-        //    x4 = P2.x - h*(P1.y - P0.y)/d;
-        //    y4 = P2.y + h*(P1.x - P0.x)/d;
-        //    return pair<Point, Point>(Point(x3, y3), Point(x4, y4));
-        // } 
-	var p0 = this.center;
-	var p1 = circle.center;
-	var d = p0.distance(p1);
-	var a = (this.radius*this.radius - circle.radius*circle.radius + d*d)/(2*d);
-	var h = Math.sqrt( this.radius*this.radius - a*a );
-	var p2 = p1.clone().scale(a/d,p0); 
-	var x3 = p2.x + h*(p1.y - p0.y)/d;
-	var y3 = p2.y - h*(p1.x - p0.x)/d;
-        var x4 = p2.x - h*(p1.y - p0.y)/d;
-        var y4 = p2.y + h*(p1.x - p0.x)/d;
-	return new Line( new Vertex(x3,y3), new Vertex(x4,y4) );
-    };
-
-   /**
-     * Create an SVG representation of this circle.
-     *
-     * @deprecated DEPRECATION Please use the drawutilssvg library and an XMLSerializer instead.
-     * @method toSVGString
-     * @param {object=} options - An optional set of options, like 'className'.
-     * @return {string} A string representing the SVG code for this vertex.
-     * @instance
-     * @memberof Circle
-     */
-    toSVGString( options:{className?:string } ) {
-	options = options || {};
-	var buffer : Array<string> = [];
-	buffer.push( '<circle' );
-	if( options.className )
-	    buffer.push( ' class="' + options.className + '"' );
-	buffer.push( ' cx="' + this.center.x + '"' );
-	buffer.push( ' cy="' + this.center.y + '"' );
-	buffer.push( ' r="' + this.radius + '"' );
-	buffer.push( ' />' );
-	return buffer.join('');
-    };
-
-    static circleUtils = {
-	vertAt : (angle:number,radius:number) => {
-	    /* return new Vertex( Math.sin(angle) * radius,
+  /**
+   * Required to generate proper CSS classes and other class related IDs.
+   **/
+  readonly className: string = "Circle";
+
+  /**
+   * The UID of this drawable object.
+   *
+   * @member {UID}
+   * @memberof Circle
+   * @instance
+   * @readonly
+   */
+  readonly uid: UID;
+
+  /**
+   * @member {Vertex}
+   * @memberof Circle
+   * @instance
+   */
+  center: Vertex;
+
+  /**
+   * @member {number}
+   * @memberof Circle
+   * @instance
+   */
+  radius: number;
+
+  /**
+   * @member isDestroyed
+   * @memberof CubicBezierCurve
+   * @type {boolean}
+   * @instance
+   */
+  isDestroyed: boolean;
+
+  /**
+   * Create a new circle with given center point and radius.
+   *
+   * @constructor
+   * @name Circle
+   * @param {Vertex} center - The center point of the circle.
+   * @param {number} radius - The radius of the circle.
+   */
+  constructor(center: Vertex, radius: number) {
+    this.uid = UIDGenerator.next();
+    this.center = center;
+    this.radius = radius;
+  }
+
+  /**
+   * Check if the given circle is fully contained inside this circle.
+   *
+   * @method containsCircle
+   * @param {Circle} circle - The circle to check if it is contained in this circle.
+   * @instance
+   * @memberof Circle
+   * @return {boolean} `true` if any only if the given circle is completely inside this circle.
+   */
+  containsCircle(circle: Circle): boolean {
+    return this.center.distance(circle.center) + circle.radius < this.radius;
+  }
+
+  /**
+   * Calculate the distance from this circle to the given line.
+   *
+   * * If the line does not intersect this ciecle then the returned
+   *   value will be the minimal distance.
+   * * If the line goes through this circle then the returned value
+   *   will be max inner distance and it will be negative.
+   *
+   * @method lineDistance
+   * @param {Line} line - The line to measure the distance to.
+   * @return {number} The minimal distance from the outline of this circle to the given line.
+   * @instance
+   * @memberof Circle
+   */
+  lineDistance(line: VertTuple<any>): number {
+    const closestPointOnLine: Vertex = line.getClosestPoint(this.center);
+    return closestPointOnLine.distance(this.center) - this.radius;
+  }
+
+  /**
+   * Get the vertex on the this circle for the given angle.
+   *
+   * @method vertAt
+   * @param {number} angle - The angle (in radians) to use.
+   * @return {Vertex} The vertex (point) at the given angle.
+   * @instance
+   * @memberof Circle
+   **/
+  vertAt(angle: number): Vertex {
+    // Find the point on the circle respective the angle. Then move relative to center.
+    return Circle.circleUtils.vertAt(angle, this.radius).add(this.center);
+  }
+
+  /**
+   * Get a tangent line of this circle for a given angle.
+   *
+   * Point a of the returned line is located on the circle, the length equals the radius.
+   *
+   * @method tangentAt
+   * @instance
+   * @param {number} angle - The angle (in radians) to use.
+   * @return {Line} The tangent line.
+   * @memberof Circle
+   **/
+  tangentAt(angle: number): Vector {
+    const pointA: Vertex = Circle.circleUtils.vertAt(angle, this.radius);
+    // Construct the perpendicular of the line in point a. Then move relative to center.
+    return (new Vector(pointA, new Vertex(0, 0)).add(this.center) as Vector).perp() as Vector;
+  }
+
+  /**
+   * Calculate the intersection points (if exists) with the given circle.
+   *
+   * @method circleIntersection
+   * @instance
+   * @memberof Circle
+   * @param {Circle} circle
+   * @return {Line|null} The intersection points (as a line) or null if the two circles do not intersect.
+   **/
+  circleIntersection(circle: Circle): Line | null {
+    // Circles do not intersect at all?
+    if (this.center.distance(circle.center) > this.radius + circle.radius) {
+      return null;
+    }
+    // One circle is fully inside the other?
+    if (this.center.distance(circle.center) < Math.abs(this.radius - circle.radius)) {
+      return null;
+    }
+    // Based on the C++ implementation by Robert King
+    //    https://stackoverflow.com/questions/3349125/circle-circle-intersection-points
+    // and the 'Circles and spheres' article by Paul Bourke.
+    //    http://paulbourke.net/geometry/circlesphere/
+    //
+    // This is the original C++ implementation:
+    //
+    // pair<Point, Point> intersections(Circle c) {
+    //    Point P0(x, y);
+    //    Point P1(c.x, c.y);
+    //    float d, a, h;
+    //    d = P0.distance(P1);
+    //    a = (r*r - c.r*c.r + d*d)/(2*d);
+    //    h = sqrt(r*r - a*a);
+    //    Point P2 = P1.sub(P0).scale(a/d).add(P0);
+    //    float x3, y3, x4, y4;
+    //    x3 = P2.x + h*(P1.y - P0.y)/d;
+    //    y3 = P2.y - h*(P1.x - P0.x)/d;
+    //    x4 = P2.x - h*(P1.y - P0.y)/d;
+    //    y4 = P2.y + h*(P1.x - P0.x)/d;
+    //    return pair<Point, Point>(Point(x3, y3), Point(x4, y4));
+    // }
+    var p0 = this.center;
+    var p1 = circle.center;
+    var d = p0.distance(p1);
+    var a = (this.radius * this.radius - circle.radius * circle.radius + d * d) / (2 * d);
+    var h = Math.sqrt(this.radius * this.radius - a * a);
+    var p2 = p1.clone().scale(a / d, p0);
+    var x3 = p2.x + (h * (p1.y - p0.y)) / d;
+    var y3 = p2.y - (h * (p1.x - p0.x)) / d;
+    var x4 = p2.x - (h * (p1.y - p0.y)) / d;
+    var y4 = p2.y + (h * (p1.x - p0.x)) / d;
+    return new Line(new Vertex(x3, y3), new Vertex(x4, y4));
+  }
+
+  /**
+   * Create an SVG representation of this circle.
+   *
+   * @deprecated DEPRECATION Please use the drawutilssvg library and an XMLSerializer instead.
+   * @method toSVGString
+   * @param {object=} options - An optional set of options, like 'className'.
+   * @return {string} A string representing the SVG code for this vertex.
+   * @instance
+   * @memberof Circle
+   */
+  toSVGString(options: { className?: string }) {
+    // options = options || {};
+    // var buffer: Array<string> = [];
+    // buffer.push("<circle");
+    // if (options.className) buffer.push(' class="' + options.className + '"');
+    // buffer.push(' cx="' + this.center.x + '"');
+    // buffer.push(' cy="' + this.center.y + '"');
+    // buffer.push(' r="' + this.radius + '"');
+    // buffer.push(" />");
+    // return buffer.join("");
+    console.warn(
+      "[Deprecation] Warning: the Circle.toSVGString method is deprecated and does not return and valid SVG data any more. Please use `drawutilssvg` instead."
+    );
+    return "";
+  }
+
+  /**
+   * This function should invalidate any installed listeners and invalidate this object.
+   * After calling this function the object might not hold valid data any more and
+   * should not be used.
+   */
+  destroy() {
+    this.center.destroy();
+    this.isDestroyed = true;
+  }
+
+  static circleUtils = {
+    vertAt: (angle: number, radius: number) => {
+      /* return new Vertex( Math.sin(angle) * radius,
 			       Math.cos(angle) * radius ); */
-	    return new Vertex( Math.cos(angle) * radius,
-			       Math.sin(angle) * radius );
-	}
-    };
-    
+      return new Vertex(Math.cos(angle) * radius, Math.sin(angle) * radius);
+    }
+  };
 } // END class