ice-render 0.0.25 → 0.0.28

package/dist/types/graphic/{line → link}/ICEPolyLine.d.ts

@@ -4,17 +4,15 @@ import ICEComponent from '../ICEComponent';
 import ICEDotPath from '../ICEDotPath';
 /**
  *
- * @class ICEPolyLine
- *
- * 折线
+ * @class ICEPolyLine  折线
  *
  * 基本特征：
  *
- * - ICEPolyLine 由多个点构成，如果折线上的所有点共线，则折线在外观上退化成直线。
- * - ICEPolyLine 上至少存在 2 个点，否则无法画线。如果点数恰好为 2 ，折线退化成一条直线。
- * - ICEPolyLine 以及所有子类不能进行 transform 操作。
- * - ICEPolyLine 以及所有子类的 left/top 总是被设置为 startPoint 。
- * - ICEPolyLine 以及所有子类的原点都在 startPoint 上，而不在几何中心点。
+ * - ICEPolyLine 上至少存在 2 个点，否则 ICEPolyLine 自动填充。
+ * - ICEPolyLine 由多个点构成，如果折线上的所有点共线，则折线在外观上退化成直线。如果点数恰好为 2 ，折线退化成一条直线。
+ * - ICEPolyLine 以及所有子类不能进行 transform 操作，在 ICE 中，对线条进行矩阵变换是没有意义的。
+ * - ICEPolyLine 以及所有子类的 left/top 总是被设置为第 0 个点。
+ * - ICEPolyLine 以及所有子类的原点都在第 0 个点上，而不在几何中心点，这一特性与普通的 Component 不同。
  *
  * @author 大漠穷秋<damoqiongqiu@126.com>
  */
@@ -30,14 +28,17 @@ declare class ICEPolyLine extends ICEDotPath {
     /**
      * @cfg
      * {
-     *   lineType: 'solid',         //solid, dashed
-     *   lineWidth:2,
-     *   arrowPosition: 'none',     //none, start, end ,both
+     *   lineType: 'solid',         //可能的取值：solid, dashed
+     *   arrowPosition: 'none',     //可能的取值：none, start, end ,both
      *   arrowLength: 15,           //箭头长度
      *   arrowAngel: 30,            //箭头角度
+     *   lineWidth:2,               //线条宽度
      *   closePath:false,           //连线默认不闭合路径
-     *   points:[],                 //点的坐标
-     *   links:{start:{id,position},end:{id,position}}    //如果传递了连接关系参数，则在渲染器完成一轮渲染之后，自动建立连接关系。
+     *   points:[],                 //线条上所有点的坐标
+     *   links:{                    //如果传递了连接关系参数，则在渲染器完成一轮渲染之后，会自动与指定的组件建立连接关系。
+     *     start:{id,position},
+     *     end:{id,position}
+     *   }
      * }
      *
      * @param props
@@ -113,7 +114,7 @@ declare class ICEPolyLine extends ICEDotPath {
      * @overwrite
      * @returns {ComponentParams}
      */
-    calcComponentParams(): {
+    protected calcComponentParams(): {
         width: any;
         height: any;
     };

package/dist/types/graphic/link/ICEVisioLink.d.ts

@@ -1,4 +1,4 @@
-import ICEPolyLine from '../line/ICEPolyLine';
+import ICEPolyLine from './ICEPolyLine';
 /**
  * ! FIXME: 删掉对 GeoPoint/GeoLine/GeoUtil 的依赖
  * @class ICEVisioLink

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

@@ -33,7 +33,7 @@ declare class ICEIsogon extends ICEDotPath {
      * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
      * @returns
      */
-    calcComponentParams(): {
+    protected calcComponentParams(): {
         width: any;
         height: any;
     };

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

@@ -20,7 +20,7 @@ declare class ICERose extends ICEDotPath {
      * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
      * @returns
      */
-    calcComponentParams(): {
+    protected calcComponentParams(): {
         width: any;
         height: any;
     };

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

@@ -27,7 +27,7 @@ declare class ICEStar extends ICEDotPath {
      * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
      * @returns
      */
-    calcComponentParams(): {
+    protected calcComponentParams(): {
         width: any;
         height: any;
     };

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

@@ -19,7 +19,17 @@ declare class ICEText extends ICEComponent {
      * @param props
      */
     constructor(props?: any);
-    protected initEvents(): void;
+    /**
+     * @overwrite
+     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
+     * 此方法不能依赖原点位置和 transform 矩阵。
+     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * @returns
+     */
+    protected calcComponentParams(): {
+        width: any;
+        height: any;
+    };
     /**
      * @method measureText
      *
@@ -27,7 +37,7 @@ declare class ICEText extends ICEComponent {
      * - 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
      * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
      *
-     * FIXME:这里有性能瓶颈
+     * FIXME:这里有性能瓶颈，需要进一步优化
      * FIXME:某些运行时环境可能不支持动态插入 HTML 标签，以上测量文本宽高的方法可能存在兼容性问题。
      * FIXME:对文本位置的控制需要更精细的计算方法。
      */

package/dist/types/index.d.ts

@@ -24,8 +24,8 @@ 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 ICEBezier } from './graphic/link/ICEBezier';
+export { default as ICEPolyLine } from './graphic/link/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';

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-render",
-  "version": "0.0.25",
+  "version": "0.0.28",
   "description": "A canvas engine for interactive graphics.",
   "repository": "https://gitee.com/ice-render/ice-render",
   "module": "dist/index.js",