ice-render 0.0.8 → 0.0.9

package/dist/types/graphic/shape/ICEStar.d.ts

@@ -0,0 +1,45 @@
+import ICEDotPath from '../ICEDotPath';
+/**
+ * @class ICEStar
+ *
+ * 正 N 角星
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEStar extends ICEDotPath {
+    constructor(props?: any);
+    /**
+     * @overwrite
+     * @method calcDots
+     *
+     * 计算路径上的关键点:
+     * - 默认的坐标原点是 (0,0) 位置。
+     * - 这些点没有经过 transform 矩阵变换。
+     *
+     * @returns
+     */
+    protected calcDots(): any;
+    /**
+     * @overwrite
+     * @method calcComponentParams
+     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
+     * 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
+     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * @returns
+     */
+    calcComponentParams(): {
+        width: any;
+        height: any;
+    };
+    /**
+     * @overwrite
+     * @method setState
+     * setState 仅仅修改参数，不会立即导致重新渲染，需要等待 FrameManager 调度，最小延迟时间约为 1/60=16.67 ms 。
+     *
+     * - 如果 setState 时指定了 radius 参数，则 width 会被重新计算，如果指定了 radius 参数则 height 会被重新计算。
+     * - 如果 setState 时仅仅指定 width 参数，则 radius 会被重新计算，如果仅仅指定了 height 参数，则 radius 会被重新计算。
+     * @param newState
+     */
+    setState(newState: any): void;
+}
+export default ICEStar;

package/dist/types/graphic/text/ICEText.d.ts

@@ -0,0 +1,42 @@
+import ICEComponent from '../ICEComponent';
+/**
+ * TODO:draw text along Path2D
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEText extends ICEComponent {
+    /**
+     * @cfg
+     * {
+     *   text:'文本内容',
+     *   left:0,
+     *   top:0,
+     *   style:{
+     *       fontSize:48,
+     *       fontFamily:'Arial',
+     *       fontWeight:24,
+     *   }
+     * }
+     * @param props
+     */
+    constructor(props?: any);
+    protected initEvents(): void;
+    /**
+     * @method measureText
+     *
+     * - Canvas 中没有提供原生的计算文本高度的有效方法，文本宽高的计算需要使用特殊的方法，这里使用的方法来自 https://longviewcoder.com/2021/02/11/html5-canvas-text-line-height-measurement/
+     * - 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     *
+     * FIXME:某些运行时环境可能不支持动态插入 HTML 标签，以上测量文本宽高的方法可能存在兼容性问题。
+     * FIXME:对文本位置的控制需要更精细的计算方法。
+     */
+    private measureText;
+    /**
+     * @method doRender
+     * @overwrite
+     * 文本是基于 baseline 绘制的，文本是从 y 坐标向屏幕上方绘制的，48 是文本高度，这里需要补偿文本高度。
+     * 同时把移动坐标轴原点的偏移量计算进去。
+     */
+    protected doRender(): void;
+}
+export default ICEText;

package/dist/types/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 as AnimationManager } from './animation/AnimationManager';
+export { default as ICEControlPanel } from './control-panel/ICEControlPanel';
+export { default as ICEControlPanelManager } from './control-panel/ICEControlPanelManager';
+export { default as LineControlPanel } from './control-panel/link-controls/LineControlPanel';
+export { default as ResizeControl } from './control-panel/transform-controls/ResizeControl';
+export { default as RotateControl } from './control-panel/transform-controls/RotateControl';
+export { default as TransformControlPanel } from './control-panel/transform-controls/TransformControlPanel';
+export { default as DOMEventBridge } from './event/DOMEventBridge';
+export { default as EventBus } from './event/EventBus';
+export { default as ICEEventTarget } from './event/ICEEventTarget';
+export { default as GeoLine } from './geometry/GeoLine';
+export { default as GeoPoint } from './geometry/GeoPoint';
+export { default as GeoUtil } from './geometry/GeoUtil';
+export { default as ICEBoundingBox } from './geometry/ICEBoundingBox';
+export { default as ICEMatrix } from './geometry/ICEMatrix';
+export { default as ICEGroup } from './graphic/container/ICEGroup';
+export { default as ICEComponent } from './graphic/ICEComponent';
+export { default as ICEDotPath } from './graphic/ICEDotPath';
+export { default as ICEImage } from './graphic/ICEImage';
+export { default as ICEPath } from './graphic/ICEPath';
+export { default as ICEBezier } from './graphic/line/ICEBezier';
+export { default as ICEPolyLine } from './graphic/line/ICEPolyLine';
+export { default as ICELinkHook } from './graphic/link/ICELinkHook';
+export { default as ICELinkSlot } from './graphic/link/ICELinkSlot';
+export { default as ICEVisioLink } from './graphic/link/ICEVisioLink';
+export { default as ICECircle } from './graphic/shape/ICECircle';
+export { default as ICEEllipse } from './graphic/shape/ICEEllipse';
+export { default as ICEIsogon } from './graphic/shape/ICEIsogon';
+export { default as ICERect } from './graphic/shape/ICERect';
+export { default as ICERose } from './graphic/shape/ICERose';
+export { default as ICEStar } from './graphic/shape/ICEStar';
+export { default as ICEText } from './graphic/text/ICEText';
+export { default as ICE } from './ICE';
+export { default as CanvasRenderer } from './renderer/CanvasRenderer';

package/dist/types/persistence/Deserializer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @class Deserializer
+ *
+ * 把 JSON 字符串反解析成图形。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+export default class Deserializer {
+    private ice;
+    constructor(ice: any);
+    fromJSON(jsonStr: string): void;
+    private decodeRecursively;
+}

package/dist/types/persistence/Serializer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @class Serializer
+ *
+ * 把图形序列化成 JSON 字符串。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+export default class Serializer {
+    private ice;
+    constructor(ice: any);
+    /**
+     * 把对象序列化成 JSON 字符串：
+     * - 容器型组件需要负责子节点的序列化操作
+     * - 如果组件不需要序列化，需要返回 null
+     * @returns JSONObject
+     */
+    toJSON(): string;
+    private encodeRecursively;
+}

package/dist/types/renderer/CanvasRenderer.d.ts

@@ -0,0 +1,24 @@
+import ICEEventTarget from '../event/ICEEventTarget';
+import ICE from '../ICE';
+/**
+ * @class CanvasRenderer
+ *
+ * Canvas 渲染器
+ *
+ * - 一个 ICE 实例上，只能有一个渲染器实例。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class CanvasRenderer extends ICEEventTarget {
+    private ice;
+    private stopped;
+    private componentQueue;
+    private toolsQueue;
+    constructor(ice: ICE);
+    start(): this;
+    stop(): this;
+    private frameEvtHandler;
+    private refreshQueue;
+    private doRender;
+}
+export default CanvasRenderer;

package/dist/types/util/ImageCache.d.ts

@@ -0,0 +1,17 @@
+import ICE from '../ICE';
+/**
+ * @class ImageCache
+ * 图片缓存类
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+export default class ImageCache {
+    private ice;
+    static readonly CACHE_SIZE = 100;
+    imageCache: Map<any, any>;
+    constructor(ice: ICE);
+    setImage(url: string): {
+        loaded: boolean;
+        image: any;
+    };
+    private loaded;
+}

package/dist/types/util/data-util.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 按照指定的路径获取 Object 上的值
+ * @param {*} object
+ * @param {*} path
+ * @returns
+ */
+export function getVal(object: any, path: any): any;
+/**
+ * @method flattenTree
+ *
+ * 把 tree 形结构拉平成数组结构。
+ *
+ * @param result
+ * @param childNodes
+ * @param level
+ * @param pid
+ * @returns
+ */
+export function flattenTree(result?: any[], childNodes?: any[], level?: number, pid?: any): any[];

package/dist/types/util/gl-matrix-skew.d.ts

@@ -0,0 +1,14 @@
+/**
+ * !gl-matrix 的当前版本中没有提供 skew 函数，需要手动合 https://github.com/toji/gl-matrix/pull/293
+ * @see https://github.com/talltyler/gl-matrix/commit/7c408d649073f6240f4694041ceb2af5f5284658
+ */
+/**
+ * Skew (shear) a mat2d by the given angle
+ *
+ * @param {mat2d} out the receiving matrix
+ * @param {mat2d} a the matrix to skew
+ * @param {Number} rad the angle to skew the matrix by
+ * @param {Number} rad the angle to skew the matrix by
+ * @returns {mat2d} out
+ */
+export function skew(out: mat2d, a: mat2d, radX: any, radY: any): mat2d;

package/dist/types/util/uuid.d.ts

@@ -0,0 +1 @@
+export function uuid(): any;

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-render",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "A canvas engine for interactive graphics.",
   "repository": "https://gitee.com/ice-render/ice-render",
   "browser": "dist/index.umd.js",
@@ -9,10 +9,7 @@
   "module": "dist/index.js",
   "types": "dist/types/index.d.ts",
   "files": [
-    "dist/*.js",
-    "dist/*.map",
-    "dist/**/*.js",
-    "dist/**/*.map"
+    "dist/**/*"
   ],
   "scripts": {
     "start": "rollup -c -w  --environment NODE_ENV:development",