ice-render 1.0.4 → 1.0.6

package/dist/types/geometry/GeoLine.d.mts

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import GeoPoint from './GeoPoint.mjs';
+/**
+ * @class GeoLine
+ * A geometrically line, invisible, no dimension, just used for mathematical operations.
+ * This implementation is improved from http://diagramo.com/ .
+ *
+ *
+ * 几何学意义上的直线，它不可见，没有宽度，用来进行数学运算。此实现从 diagramo 改进而来：http://diagramo.com/ 。
+ *
+ * @docauthor 大漠穷秋 <damoqiongqiu@126.com>
+ */
+export default class GeoLine {
+    startPoint: GeoPoint;
+    endPoint: GeoPoint;
+    constructor(startPoint: GeoPoint, endPoint: GeoPoint);
+    contains(x: number, y: number): boolean;
+}

package/dist/types/geometry/GeoLine.d.ts

@@ -1,23 +1,24 @@
-/**
- * Copyright (c) 2022 大漠穷秋.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-/**
- * @class GeoLine
- * A geometrically line, invisible, no dimension, just used for mathematical operations.
- * This implementation is improved from http://diagramo.com/ .
- *
- *
- * 几何学意义上的直线，它不可见，没有宽度，用来进行数学运算。此实现从 diagramo 改进而来：http://diagramo.com/ 。
- *
- * @docauthor 大漠穷秋 <damoqiongqiu@126.com>
- */
-export default class GeoLine {
-    constructor(startPoint: any, endPoint: any);
-    startPoint: any;
-    endPoint: any;
-    contains(x: any, y: any): boolean;
-}
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import GeoPoint from './GeoPoint';
+/**
+ * @class GeoLine
+ * A geometrically line, invisible, no dimension, just used for mathematical operations.
+ * This implementation is improved from http://diagramo.com/ .
+ *
+ *
+ * 几何学意义上的直线，它不可见，没有宽度，用来进行数学运算。此实现从 diagramo 改进而来：http://diagramo.com/ 。
+ *
+ * @docauthor 大漠穷秋 <damoqiongqiu@126.com>
+ */
+export default class GeoLine {
+    startPoint: GeoPoint;
+    endPoint: GeoPoint;
+    constructor(startPoint: GeoPoint, endPoint: GeoPoint);
+    contains(x: number, y: number): boolean;
+}

package/dist/types/geometry/GeoPoint.d.mts

@@ -0,0 +1,53 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * @class GeoPoint
+ * A geometrically point, invisible, no dimension, just used for mathematical operations.
+ * This implementation is improved from http://diagramo.com/ .
+ *
+ *
+ * 几何学意义上的点，它不可见，没有大小，用来进行数学运算。此实现从 diagramo 改进而来：http://diagramo.com/ 。
+ *
+ * @docauthor 大漠穷秋 <damoqiongqiu@126.com>
+ */
+export default class GeoPoint {
+    x: number;
+    y: number;
+    /**
+     * @constructor GeoPoint
+     */
+    constructor(x?: number, y?: number);
+    /**
+     * @method load
+     * Creates a {GeoPoint} out of JSON parsed object.
+     *
+     * 从 JSON 对象创建 {GeoPoint} 实例。
+     */
+    static load(o: any): GeoPoint;
+    /**
+     * @method cloneArray
+     * Clones an array of points.
+     *
+     * 克隆一组点。
+     */
+    static cloneArray(v: GeoPoint[]): GeoPoint[];
+    /**
+     * @method equals
+     * Tests if this point is equals to other point.
+     *
+     * 测试当前点是否与另一个点相等。
+     */
+    equals(anotherPoint: GeoPoint): boolean;
+    /**
+     * @method clone
+     * Clone current GeoPoint.
+     *
+     * 克隆当前点。
+     */
+    clone(): GeoPoint;
+}

package/dist/types/geometry/GeoPoint.d.ts

@@ -1,66 +1,53 @@
-/**
- * Copyright (c) 2022 大漠穷秋.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-/**
- * @class GeoPoint
- * A geometrically point, invisible, no dimension, just used for mathematical operations.
- * This implementation is improved from http://diagramo.com/ .
- *
- *
- * 几何学意义上的点，它不可见，没有大小，用来进行数学运算。此实现从 diagramo 改进而来：http://diagramo.com/ 。
- *
- * @docauthor 大漠穷秋 <damoqiongqiu@126.com>
- */
-export default class GeoPoint {
-    /**
-     *
-     * @method load
-     * Creates a {GeoPoint} out of JSON parsed object.
-     *
-     *
-     * 从 JSON 对象创建 {GeoPoint} 实例。
-     * @param {Object} o the JSON parsed object
-     * @return {GeoPoint} a newly constructed GeoPoint
-     */
-    static load(o: any): GeoPoint;
-    /**
-     *
-     * @method cloneArray
-     * Clones an array of points.
-     *
-     *
-     * 克隆一组点。
-     * @param {Array} v - the array of {GeoPoint}s
-     * @return an {Array} of {GeoPoint}s
-     */
-    static cloneArray(v: any[]): any[];
-    /**
-     * @constructor GeoPoint
-     * @param {*} x
-     * @param {*} y
-     */
-    constructor(x?: any, y?: any);
-    x: any;
-    y: any;
-    /**
-     * @method equals
-     * Tests if this point is equals to other point.
-     *
-     *
-     * 测试当前点是否与另一个点相等。
-     * @param {GeoPoint} anotherPoint - the other point
-     */
-    equals(anotherPoint: GeoPoint): boolean;
-    /**
-     * @method clone
-     * Clone current GeoPoint.
-     *
-     *
-     * 克隆当前点。
-     */
-    clone(): GeoPoint;
-}
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * @class GeoPoint
+ * A geometrically point, invisible, no dimension, just used for mathematical operations.
+ * This implementation is improved from http://diagramo.com/ .
+ *
+ *
+ * 几何学意义上的点，它不可见，没有大小，用来进行数学运算。此实现从 diagramo 改进而来：http://diagramo.com/ 。
+ *
+ * @docauthor 大漠穷秋 <damoqiongqiu@126.com>
+ */
+export default class GeoPoint {
+    x: number;
+    y: number;
+    /**
+     * @constructor GeoPoint
+     */
+    constructor(x?: number, y?: number);
+    /**
+     * @method load
+     * Creates a {GeoPoint} out of JSON parsed object.
+     *
+     * 从 JSON 对象创建 {GeoPoint} 实例。
+     */
+    static load(o: any): GeoPoint;
+    /**
+     * @method cloneArray
+     * Clones an array of points.
+     *
+     * 克隆一组点。
+     */
+    static cloneArray(v: GeoPoint[]): GeoPoint[];
+    /**
+     * @method equals
+     * Tests if this point is equals to other point.
+     *
+     * 测试当前点是否与另一个点相等。
+     */
+    equals(anotherPoint: GeoPoint): boolean;
+    /**
+     * @method clone
+     * Clone current GeoPoint.
+     *
+     * 克隆当前点。
+     */
+    clone(): GeoPoint;
+}

package/dist/types/geometry/GeoUtil.d.mts

@@ -0,0 +1,73 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export default class GeoUtil {
+    constructor();
+    /**
+     * 点是否在多边形内部（射线法）。
+     *
+     * 点集类图元（星形 / 正N边形 / 玫瑰）的精确命中判定用的就是它；上提为公共 API 后，
+     * 应用层做自己的命中/碰撞判定时不必再抄一遍。
+     *
+     * 边界约定：不做特殊判定，按射线法自身的**半开**约定处理 —— 落在边/顶点上的点结果取决于
+     * 该边与射线的相对方向（例如正方形左下角顶点会判为「在内」）。需要「边界算命中」的语义时，
+     * 调用方应另外用 `distanceToPolyline` 判一次距离。
+     *
+     * @param x 待判定点的 x（与 polygon 同一坐标系）
+     * @param y 待判定点的 y
+     * @param polygon 顶点数组 [[x,y], ...]，按顺序首尾相连（自动闭合，无需重复首点）
+     */
+    static pointInPolygon(x: number, y: number, polygon: Array<[number, number]>): boolean;
+    /**
+     * 点到**线段**的最短距离（注意不是到直线的距离：投影落在端点外时取端点距离）。
+     */
+    static distanceToSegment(px: number, py: number, ax: number, ay: number, bx: number, by: number): number;
+    /**
+     * 点到折线（多段线）的最短距离。
+     * 折线类图元的命中判定就是「距离 ≤ 阈值」，此前这段逻辑内联在图元里。
+     */
+    static distanceToPolyline(points: Array<[number, number]>, px: number, py: number): number;
+    /**
+     * 沿折线等距采样 `count + 1` 个点（含首尾）。
+     *
+     * 用途：把曲线/折线离散成均匀点集（例如贝塞尔采样后写回 `state.points` 供包围盒与命中使用），
+     * 或者做路径动画的关键点。零长度段会被跳过，不会产生 NaN。
+     */
+    static samplePolyline(points: Array<[number, number]>, count: number): Array<[number, number]>;
+    /**
+     * 两条线段是否相交（含相触）。返回交点或 null。
+     * 用参数方程求解，平行/共线时返回 null（不做重叠区间的特殊处理）。
+     */
+    static segmentIntersect(a1: [number, number], a2: [number, number], b1: [number, number], b2: [number, number]): [number, number] | null;
+    /**
+     *
+     * 已知向量原点和向量坐标值，求向量相对于 X 轴正向的旋转角度。
+     *
+     * 两个点需要处于同一个坐标系中。
+     *
+     * rotateAngle 的数值范围限定在 [0,360] 度之间，闭区间。
+     *
+     * @param x
+     * @param y
+     * @param originX
+     * @param originY
+     * @returns
+     */
+    static calcRotateAngle(x: any, y: any, originX: any, originY: any): number;
+    /**
+     * 从变换矩阵计算旋转角度。
+     * @param matrix
+     * @returns 角度
+     */
+    static calcRotateAngleFromMatrix(matrix: any): number;
+    /**
+     * 从变换矩阵计算缩放参数。
+     * @param matrix
+     * @returns 缩放数组
+     */
+    static calcScaleFromMatrix(matrix: any): Array<number>;
+}

package/dist/types/geometry/GeoUtil.d.ts

@@ -1,37 +1,73 @@
-/**
- * Copyright (c) 2022 大漠穷秋.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-export default class GeoUtil {
-    constructor();
-    /**
-     *
-     * 已知向量原点和向量坐标值，求向量相对于 X 轴正向的旋转角度。
-     *
-     * 两个点需要处于同一个坐标系中。
-     *
-     * rotateAngle 的数值范围限定在 [0,360] 度之间，闭区间。
-     *
-     * @param x
-     * @param y
-     * @param originX
-     * @param originY
-     * @returns
-     */
-    static calcRotateAngle(x: any, y: any, originX: any, originY: any): number;
-    /**
-     * 从变换矩阵计算旋转角度。
-     * @param matrix
-     * @returns 角度
-     */
-    static calcRotateAngleFromMatrix(matrix: any): number;
-    /**
-     * 从变换矩阵计算缩放参数。
-     * @param matrix
-     * @returns 缩放数组
-     */
-    static calcScaleFromMatrix(matrix: any): Array<number>;
-}
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export default class GeoUtil {
+    constructor();
+    /**
+     * 点是否在多边形内部（射线法）。
+     *
+     * 点集类图元（星形 / 正N边形 / 玫瑰）的精确命中判定用的就是它；上提为公共 API 后，
+     * 应用层做自己的命中/碰撞判定时不必再抄一遍。
+     *
+     * 边界约定：不做特殊判定，按射线法自身的**半开**约定处理 —— 落在边/顶点上的点结果取决于
+     * 该边与射线的相对方向（例如正方形左下角顶点会判为「在内」）。需要「边界算命中」的语义时，
+     * 调用方应另外用 `distanceToPolyline` 判一次距离。
+     *
+     * @param x 待判定点的 x（与 polygon 同一坐标系）
+     * @param y 待判定点的 y
+     * @param polygon 顶点数组 [[x,y], ...]，按顺序首尾相连（自动闭合，无需重复首点）
+     */
+    static pointInPolygon(x: number, y: number, polygon: Array<[number, number]>): boolean;
+    /**
+     * 点到**线段**的最短距离（注意不是到直线的距离：投影落在端点外时取端点距离）。
+     */
+    static distanceToSegment(px: number, py: number, ax: number, ay: number, bx: number, by: number): number;
+    /**
+     * 点到折线（多段线）的最短距离。
+     * 折线类图元的命中判定就是「距离 ≤ 阈值」，此前这段逻辑内联在图元里。
+     */
+    static distanceToPolyline(points: Array<[number, number]>, px: number, py: number): number;
+    /**
+     * 沿折线等距采样 `count + 1` 个点（含首尾）。
+     *
+     * 用途：把曲线/折线离散成均匀点集（例如贝塞尔采样后写回 `state.points` 供包围盒与命中使用），
+     * 或者做路径动画的关键点。零长度段会被跳过，不会产生 NaN。
+     */
+    static samplePolyline(points: Array<[number, number]>, count: number): Array<[number, number]>;
+    /**
+     * 两条线段是否相交（含相触）。返回交点或 null。
+     * 用参数方程求解，平行/共线时返回 null（不做重叠区间的特殊处理）。
+     */
+    static segmentIntersect(a1: [number, number], a2: [number, number], b1: [number, number], b2: [number, number]): [number, number] | null;
+    /**
+     *
+     * 已知向量原点和向量坐标值，求向量相对于 X 轴正向的旋转角度。
+     *
+     * 两个点需要处于同一个坐标系中。
+     *
+     * rotateAngle 的数值范围限定在 [0,360] 度之间，闭区间。
+     *
+     * @param x
+     * @param y
+     * @param originX
+     * @param originY
+     * @returns
+     */
+    static calcRotateAngle(x: any, y: any, originX: any, originY: any): number;
+    /**
+     * 从变换矩阵计算旋转角度。
+     * @param matrix
+     * @returns 角度
+     */
+    static calcRotateAngleFromMatrix(matrix: any): number;
+    /**
+     * 从变换矩阵计算缩放参数。
+     * @param matrix
+     * @returns 缩放数组
+     */
+    static calcScaleFromMatrix(matrix: any): Array<number>;
+}

package/dist/types/geometry/ICEBoundingBox.d.mts

@@ -0,0 +1,81 @@
+/**
+ * @class ICEBoundingBox 用4点法描述的边界盒子。
+ *
+ * - 边界盒子一定是矩形。
+ * - 边界盒子总是绘制在全局坐标系中。
+ * - 边界盒子总是通过自身的坐标点进行变换，而不是变换 canvas.ctx 。
+ * - 边界盒子总是通过组件的参数计算出来的，直接修改边界盒子不影响组件本身的参数。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEBoundingBox {
+    tl: number[];
+    tr: number[];
+    bl: number[];
+    br: number[];
+    tc: number[];
+    rc: number[];
+    bc: number[];
+    lc: number[];
+    center: number[];
+    constructor(props?: Array<number>);
+    /**
+     * 从指定的 top/left/width/height 构建 ICEBoundingBox。
+     * @param left
+     * @param top
+     * @param width
+     * @param height
+     * @returns
+     */
+    static fromDimension(left: any, top: any, width: any, height: any): ICEBoundingBox;
+    /**
+     * 判断指定的坐标点是否位于边界矩形内部，向右水平射线法。
+     * 这里参考了 fabricjs 的实现方式。
+     * @see http://fabricjs.com/
+     * @param point
+     * @returns
+     */
+    containsPoint(point: any): boolean;
+    /**
+     * 获取边界盒子的边所构成的线段，由于边界盒子总是被定义成 4 边形，这里直接简化处理。
+     */
+    private getBoundingLines;
+    /**
+     * 获取边界盒子 x,y 的最大和最小值
+     * @returns
+     */
+    getMinAndMaxPoint(): any;
+    /**
+     * 另一个边界盒子是否完全位于当前盒子内部（按轴对齐包围盒判定）。
+     * @param box
+     * @returns
+     */
+    containsBox(box: ICEBoundingBox): boolean;
+    /**
+     * 是否与另一个盒子存在相交的部分。
+     * @param box
+     * @returns
+     */
+    isIntersect(box: ICEBoundingBox): boolean;
+    /**
+     * @param matrix
+     * @returns A new ICEBoundingBox instance.
+     */
+    transform(matrix: any): ICEBoundingBox;
+    /**
+     * 计算两个盒子（按轴对齐包围盒）的并集，返回一个新的 ICEBoundingBox 实例。
+     * @param box
+     * @returns A new ICEBoundingBox instance.
+     */
+    union(box: ICEBoundingBox): ICEBoundingBox;
+    get width(): number;
+    get height(): number;
+    get left(): number;
+    private set left(value);
+    get top(): number;
+    private set top(value);
+    get centerX(): number;
+    get centerY(): number;
+    get centerPoint(): number[];
+}
+export default ICEBoundingBox;

package/dist/types/geometry/ICEBoundingBox.d.ts

@@ -1,81 +1,81 @@
-/**
- * @class ICEBoundingBox 用4点法描述的边界盒子。
- *
- * - 边界盒子一定是矩形。
- * - 边界盒子总是绘制在全局坐标系中。
- * - 边界盒子总是通过自身的坐标点进行变换，而不是变换 canvas.ctx 。
- * - 边界盒子总是通过组件的参数计算出来的，直接修改边界盒子不影响组件本身的参数。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class ICEBoundingBox {
-    tl: number[];
-    tr: number[];
-    bl: number[];
-    br: number[];
-    tc: number[];
-    rc: number[];
-    bc: number[];
-    lc: number[];
-    center: number[];
-    constructor(props?: Array<number>);
-    /**
-     * 从指定的 top/left/width/height 构建 ICEBoundingBox。
-     * @param left
-     * @param top
-     * @param width
-     * @param height
-     * @returns
-     */
-    static fromDimension(left: any, top: any, width: any, height: any): ICEBoundingBox;
-    /**
-     * 判断指定的坐标点是否位于边界矩形内部，向右水平射线法。
-     * 这里参考了 fabricjs 的实现方式。
-     * @see http://fabricjs.com/
-     * @param point
-     * @returns
-     */
-    containsPoint(point: any): boolean;
-    /**
-     * 获取边界盒子的边所构成的线段，由于边界盒子总是被定义成 4 边形，这里直接简化处理。
-     */
-    private getBoundingLines;
-    /**
-     * 获取边界盒子 x,y 的最大和最小值
-     * @returns
-     */
-    getMinAndMaxPoint(): any;
-    /**
-     * FIXME:需要实现
-     * 另一个边界盒子是否完全位于当前盒子内部。
-     * @param box
-     * @returns
-     */
-    containsBox(box: ICEBoundingBox): boolean;
-    /**
-     * 是否与另一个盒子存在相交的部分。
-     * @param box
-     * @returns
-     */
-    isIntersect(box: ICEBoundingBox): boolean;
-    /**
-     * @param matrix
-     * @returns A new ICEBoundingBox instance.
-     */
-    transform(matrix: any): ICEBoundingBox;
-    /**
-     * @param box
-     * @returns A new ICEBoundingBox instance.
-     */
-    union(box: ICEBoundingBox): ICEBoundingBox;
-    get width(): number;
-    get height(): number;
-    get left(): number;
-    private set left(value);
-    get top(): number;
-    private set top(value);
-    get centerX(): number;
-    get centerY(): number;
-    get centerPoint(): number[];
-}
-export default ICEBoundingBox;
+/**
+ * @class ICEBoundingBox 用4点法描述的边界盒子。
+ *
+ * - 边界盒子一定是矩形。
+ * - 边界盒子总是绘制在全局坐标系中。
+ * - 边界盒子总是通过自身的坐标点进行变换，而不是变换 canvas.ctx 。
+ * - 边界盒子总是通过组件的参数计算出来的，直接修改边界盒子不影响组件本身的参数。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEBoundingBox {
+    tl: number[];
+    tr: number[];
+    bl: number[];
+    br: number[];
+    tc: number[];
+    rc: number[];
+    bc: number[];
+    lc: number[];
+    center: number[];
+    constructor(props?: Array<number>);
+    /**
+     * 从指定的 top/left/width/height 构建 ICEBoundingBox。
+     * @param left
+     * @param top
+     * @param width
+     * @param height
+     * @returns
+     */
+    static fromDimension(left: any, top: any, width: any, height: any): ICEBoundingBox;
+    /**
+     * 判断指定的坐标点是否位于边界矩形内部，向右水平射线法。
+     * 这里参考了 fabricjs 的实现方式。
+     * @see http://fabricjs.com/
+     * @param point
+     * @returns
+     */
+    containsPoint(point: any): boolean;
+    /**
+     * 获取边界盒子的边所构成的线段，由于边界盒子总是被定义成 4 边形，这里直接简化处理。
+     */
+    private getBoundingLines;
+    /**
+     * 获取边界盒子 x,y 的最大和最小值
+     * @returns
+     */
+    getMinAndMaxPoint(): any;
+    /**
+     * 另一个边界盒子是否完全位于当前盒子内部（按轴对齐包围盒判定）。
+     * @param box
+     * @returns
+     */
+    containsBox(box: ICEBoundingBox): boolean;
+    /**
+     * 是否与另一个盒子存在相交的部分。
+     * @param box
+     * @returns
+     */
+    isIntersect(box: ICEBoundingBox): boolean;
+    /**
+     * @param matrix
+     * @returns A new ICEBoundingBox instance.
+     */
+    transform(matrix: any): ICEBoundingBox;
+    /**
+     * 计算两个盒子（按轴对齐包围盒）的并集，返回一个新的 ICEBoundingBox 实例。
+     * @param box
+     * @returns A new ICEBoundingBox instance.
+     */
+    union(box: ICEBoundingBox): ICEBoundingBox;
+    get width(): number;
+    get height(): number;
+    get left(): number;
+    private set left(value);
+    get top(): number;
+    private set top(value);
+    get centerX(): number;
+    get centerY(): number;
+    get centerPoint(): number[];
+}
+export default ICEBoundingBox;