ice-render 0.0.45 → 0.0.46

package/dist/types/graphic/ICEComponent.d.ts

@@ -103,9 +103,13 @@ declare abstract class ICEComponent extends ICEEventTarget {
     render(): void;
     protected applyStyleToCtx(): void;
     /**
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 此方法不能依赖原点位置和 transform 矩阵。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * @method calcComponentParams
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {

package/dist/types/graphic/ICEDotPath.d.ts

@@ -18,10 +18,14 @@ export default abstract class ICEDotPath extends ICEPath {
      */
     constructor(props: any);
     /**
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
      * @overwrite
+     * @method calcComponentParams
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {
@@ -42,7 +46,7 @@ export default abstract class ICEDotPath extends ICEPath {
      * 计算路径上的关键点:
      * - 默认的坐标原点是 (0,0) 位置。
      * - 这些点没有经过 transform 矩阵变换。
-     * this.calcComponentParams() 会依赖此方法，在计算尺寸时还没有确定原点坐标，所以 calcDots() 方法内部不能依赖原点坐标，只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - this.calcComponentParams() 会依赖此方法来计算位置和尺寸，此时还没有确定原点坐标，所以 calcDots() 方法内部不能依赖原点坐标，只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
      * @returns
      */
     protected calcDots(): any;

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

@@ -124,14 +124,15 @@ declare class ICEPolyLine extends ICEDotPath {
      */
     rmDot(index: number): boolean;
     /**
+     * @overwrite
      * @method calcComponentParams
-     *
-     * - 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * - 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
      * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
-     *
-     * @overwrite
-     * @returns {ComponentParams}
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
+     * @returns
      */
     protected calcComponentParams(): {
         width: any;

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

@@ -28,9 +28,12 @@ declare class ICEIsogon extends ICEDotPath {
     /**
      * @overwrite
      * @method calcComponentParams
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {

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

@@ -15,9 +15,12 @@ declare class ICERose extends ICEDotPath {
     /**
      * @overwrite
      * @method calcComponentParams
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {

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

@@ -22,9 +22,12 @@ declare class ICEStar extends ICEDotPath {
     /**
      * @overwrite
      * @method calcComponentParams
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 由于点状路径可能是不规则的形状，所以宽高需要手动计算，特殊形状的子类需要覆盖此方法提供自己的实现。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {

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

@@ -28,9 +28,13 @@ declare class ICEText extends ICEComponent {
     protected static arrangeParam(props: any): any;
     /**
      * @overwrite
-     * 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * 此方法不能依赖原点位置和 transform 矩阵。
-     * 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * @method calcComponentParams
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
      * @returns
      */
     protected calcComponentParams(): {

package/package.json

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