[feature] 新增符号类 Polygon、ImagePolygon

MyShallowTime · MyShallowTime · commit 1ec6397d21f2 · 2023-03-17T15:10:22.000+08:00
review by zhaoq
diff --git a/src/common/commontypes/symbol/DefaultValue.js b/src/common/commontypes/symbol/DefaultValue.js
@@ -15,4 +15,9 @@ export const POINT_DEFAULT_VALUE = {
 export const IMAGE_POINT_DEFAULT_VALUE = {
     rotate: COMMON_DEFAULT_VALUE.rotate,
     translate: COMMON_DEFAULT_VALUE.translate
+}
+
+export const POLYGON_DEFAULT_VALUE = {
+    color: COMMON_DEFAULT_VALUE.color,
+    opacity: COMMON_DEFAULT_VALUE.opacity
 }
diff --git a/src/common/commontypes/symbol/ImagePolygon.js b/src/common/commontypes/symbol/ImagePolygon.js
@@ -0,0 +1,73 @@
+/* Copyright© 2000 - 2022 SuperMap Software Co.Ltd. All rights reserved.
+* This program are made available under the terms of the Apache License, Version 2.0
+* which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
+import { Polygon } from './Polygon';
+import {Util} from '../Util';
+
+/**
+ * @class ImagePolygonSymbol
+ * @aliasclass Symbol.ImagePolygon
+ * @classdesc 图片面符号类。
+ * @category BaseTypes Symbol
+ * @extends {Polygon}
+ * @param {string} image - 符号图片。
+ * @param {string} [type = 'ImagePolygon'] - 符号类型。
+ * @example
+ * const symbol = new ImagePolygonSymbol({
+ *      image: "xx.png"
+ * });
+ * @usage
+ */
+export class ImagePolygon extends Polygon {
+
+    constructor(option) {
+        super(option);
+        const { image, color } = option ?? {};
+
+        /**
+         * @member {string} ImagePolygonSymbol.prototype.image
+         * @description 符号图片， 必选参数。
+         */
+        this.image = image;
+
+        /**
+         * @member {string} PolygonSymbol.prototype.color
+         * @description 符号颜色，如果为undefined，显示图片自身颜色。
+         */
+        this.color = color;
+
+        /**
+         * @member {string} ImagePolygonSymbol.prototype.type
+         * @description  面符号的类型。
+         */
+        this.type = "ImagePolygon";
+        this.CLASS_NAME = "SuperMap.Symbol.ImagePolygon";
+    }
+
+    /**
+     * @function ImagePolygonSymbol.prototype.clone
+     * @description 克隆符号。
+     * @returns {ImagePolygonSymbol} 克隆后的符号。
+     */
+    clone(obj) {
+        if (obj == null) {
+            obj = new ImagePolygon({
+                image: this.image
+            });
+        }
+
+        // catch any randomly tagged-on properties
+        Util.applyDefaults(obj, this);
+
+        return obj;
+    }
+
+    /**
+     * @function ImagePolygonSymbol.prototype.destroy
+     * @description 释放符号资源。
+     */
+    destroy() {
+        this.image = null;
+        super.destroy();
+    }
+}
diff --git a/src/common/commontypes/symbol/Polygon.js b/src/common/commontypes/symbol/Polygon.js
@@ -0,0 +1,72 @@
+/* Copyright© 2000 - 2022 SuperMap Software Co.Ltd. All rights reserved.
+* This program are made available under the terms of the Apache License, Version 2.0
+* which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
+import {Symbol} from '../Symbol';
+import {Util} from '../Util';
+import { POLYGON_DEFAULT_VALUE } from './DefaultValue';
+
+/**
+ * @class PolygonSymbol
+ * @aliasclass Symbol.Polygon
+ * @classdesc 面符号类。
+ * @category BaseTypes Symbol
+ * @extends {Symbol}
+ * @param {string} [color = "#000"] - 符号颜色。
+ * @param {number} [opacity = 1] - 符号透明度。
+ * @param {string} [type = 'Polygon'] - 符号类型。
+ * @example
+ * const symbol = new PolygonSymbol();
+ * @usage
+ */
+export class Polygon extends Symbol {
+
+    constructor(option) {
+        super();
+        const { color, opacity } = option ?? {};
+
+        /**
+         * @member {string} PolygonSymbol.prototype.color
+         * @description 面符号的颜色，默认值："#000"。
+         */
+        this.color = color ?? POLYGON_DEFAULT_VALUE.color;
+
+        /**
+         * @member {number} PolygonSymbol.prototype.opacity
+         * @description 面符号的透明度，默认值：1
+         */
+        this.opacity = opacity ?? POLYGON_DEFAULT_VALUE.opacity;
+
+        /**
+         * @member {string} PolygonSymbol.prototype.type
+         * @description 面符号的类型。
+         */
+        this.type = "Polygon";
+        this.CLASS_NAME = "SuperMap.Symbol.Polygon";
+    }
+
+    /**
+     * @function PolygonSymbol.prototype.clone
+     * @description 克隆面符号。
+     * @returns {PolygonSymbol} 克隆后的面符号。
+     */
+    clone(obj) {
+        if (obj == null) {
+            obj = new Polygon();
+        }
+
+        // catch any randomly tagged-on properties
+        Util.applyDefaults(obj, this);
+
+        return obj;
+    }
+
+    /**
+     * @function PolygonSymbol.prototype.destroy
+     * @description 释放面符号的资源。
+     */
+    destroy() {
+        this.color = null;
+        this.opacity = null;
+        super.destroy();
+    }
+}
