/* Copyright© 2000 - 2021 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 {SuperMap} from '../SuperMap';
import {Feature} from './Feature';
import {Util} from './Util';
/**
* @class SuperMap.Feature.Vector
* @category BaseTypes Geometry
* @classdesc 矢é‡è¦ç´ 类。该类具有 Geometry 属性å˜æ”¾å‡ 何信æ¯ï¼Œ
* attributes 属性å˜æ”¾éžå‡ 何信æ¯ï¼Œå¦å¤–还包å«äº† style 属性，用æ¥å®šä¹‰çŸ¢é‡è¦ç´ çš„æ ·å¼ï¼Œ
* å…¶ä¸ï¼Œé»˜è®¤çš„æ ·å¼åœ¨ {@link SuperMap.Feature.Vector.style} ç±»ä¸å®šä¹‰ï¼Œå¦‚æžœæ²¡æœ‰ç‰¹åˆ«çš„æŒ‡å®šå°†ä½¿ç”¨é»˜è®¤çš„æ ·å¼ã€‚
* @extends {SuperMap.Feature}
* @param {SuperMap.Geometry} geometry - 代表è¦ç´ çš„å‡ ä½•å½¢çŠ¶ã€‚
* @param {Object} [attributes] - æè¿°è¦ç´ çš„ä»»æ„çš„å¯åºåˆ—化属性，将è¦æ˜ 射到 attributes 属性ä¸çš„对象。
* @param {Object} [style] - æ ·å¼å¯¹è±¡ã€‚
* @example
* var geometry = new SuperMap.Geometry.Point(-115,10);
* var style = {
* strokeColor:"#339933",
* strokeOpacity:1,
* strokeWidth:3,
* pointRadius:6
* }
* var pointFeature = new SuperMap.Feature.Vector(geometry,null,style);
* vectorLayer.addFeatures(pointFeature);
*/
export class Vector extends Feature {
constructor(geometry, attributes, style) {
super(null, null, attributes);
/**
* @member {string} SuperMap.Feature.Vector.prototype.fid
* @description fid
*/
this.fid = null;
/**
* @member {SuperMap.Geometry} SuperMap.Feature.Vector.prototype.geometry
* @description 该属性用于å˜æ”¾å‡ 何信æ¯ã€‚
*/
this.geometry = geometry ? geometry : null;
/**
* @member {Object} SuperMap.Feature.Vector.prototype.attributes
* @description æè¿°è¦ç´ çš„ä»»æ„çš„å¯åºåˆ—化属性。
*/
this.attributes = {};
if (attributes) {
this.attributes = Util.extend(this.attributes, attributes);
}
/**
* @member {SuperMap.Bounds} SuperMap.Feature.Vector.prototype.bounds
* @description The box bounding that feature's geometry, that
* property can be set by an object when
* deserializing the feature, so in most cases it represents an
* information set by the server.
*/
this.bounds = null;
/**
* @member {string} SuperMap.Feature.Vector.prototype.state
* @description state
*/
this.state = null;
/**
* @member {Object} SuperMap.Feature.Vector.prototype.style
* @description è¦ç´ çš„æ ·å¼å±žæ€§ï¼Œåœ°å›¾æŸ¥è¯¢è¿”回的 feature çš„ style，8C å˜ä¸ºnull。
*/
this.style = style ? style : null;
/**
* @member {string} SuperMap.Feature.Vector.prototype.url
* @description å¦‚æžœè®¾ç½®äº†è¿™ä¸ªå±žæ€§ï¼Œåœ¨æ›´æ–°æˆ–è€…åˆ é™¤è¦ç´ 时需è¦è€ƒè™‘ {@link SuperMap.HTTP} 。
*/
this.url = null;
this.lonlat = null;
this.CLASS_NAME = "SuperMap.Feature.Vector";
// TRASH THIS
SuperMap.State = {
/** states */
UNKNOWN: 'Unknown',
INSERT: 'Insert',
UPDATE: 'Update',
DELETE: 'Delete'
};
Vector.style = {
'default': {
fillColor: "#ee9900",
fillOpacity: 0.4,
hoverFillColor: "white",
hoverFillOpacity: 0.8,
strokeColor: "#ee9900",
strokeOpacity: 1,
strokeWidth: 1,
strokeLinecap: "round",
strokeDashstyle: "solid",
hoverStrokeColor: "red",
hoverStrokeOpacity: 1,
hoverStrokeWidth: 0.2,
pointRadius: 6,
hoverPointRadius: 1,
hoverPointUnit: "%",
pointerEvents: "visiblePainted",
cursor: "inherit",
fontColor: "#000000",
labelAlign: "cm",
labelOutlineColor: "white",
labelOutlineWidth: 3
},
'select': {
fillColor: "blue",
fillOpacity: 0.4,
hoverFillColor: "white",
hoverFillOpacity: 0.8,
strokeColor: "blue",
strokeOpacity: 1,
strokeWidth: 2,
strokeLinecap: "round",
strokeDashstyle: "solid",
hoverStrokeColor: "red",
hoverStrokeOpacity: 1,
hoverStrokeWidth: 0.2,
pointRadius: 6,
hoverPointRadius: 1,
hoverPointUnit: "%",
pointerEvents: "visiblePainted",
cursor: "pointer",
fontColor: "#000000",
labelAlign: "cm",
labelOutlineColor: "white",
labelOutlineWidth: 3
},
'temporary': {
fillColor: "#66cccc",
fillOpacity: 0.2,
hoverFillColor: "white",
hoverFillOpacity: 0.8,
strokeColor: "#66cccc",
strokeOpacity: 1,
strokeLinecap: "round",
strokeWidth: 2,
strokeDashstyle: "solid",
hoverStrokeColor: "red",
hoverStrokeOpacity: 1,
hoverStrokeWidth: 0.2,
pointRadius: 6,
hoverPointRadius: 1,
hoverPointUnit: "%",
pointerEvents: "visiblePainted",
//cursor:"inherit",
cursor: "default",
fontColor: "#000000",
labelAlign: "cm",
labelOutlineColor: "white",
labelOutlineWidth: 3
},
'delete': {
display: "none"
}
};
}
/**
* @function SuperMap.Feature.Vector.prototype.destroy
* @description nullify references to prevent circular references and memory leaks
*/
destroy() {
if (this.layer) {
this.layer.removeFeatures(this);
this.layer = null;
}
this.geometry = null;
super.destroy();
}
/**
* @function SuperMap.Feature.Vector.prototype.clone
* @description Create a clone of this vector feature. Does not set any non-standard
* properties.
* @returns {SuperMap.Feature.Vector} An exact clone of this vector feature.
*/
clone() {
return new Vector(
this.geometry ? this.geometry.clone() : null,
this.attributes,
this.style);
}
/**
* @function SuperMap.Feature.Vector.prototype.toState
* @description 设置新状æ€ã€‚
* @param {string} state - 状æ€ã€‚
*/
toState(state) {
if (state === SuperMap.State.UPDATE) {
switch (this.state) {
case SuperMap.State.UNKNOWN:
case SuperMap.State.DELETE:
this.state = state;
break;
case SuperMap.State.UPDATE:
case SuperMap.State.INSERT:
break;
}
} else if (state === SuperMap.State.INSERT) {
switch (this.state) {
case SuperMap.State.UNKNOWN:
break;
default:
this.state = state;
break;
}
} else if (state === SuperMap.State.DELETE) {
switch (this.state) {
case SuperMap.State.INSERT:
// the feature should be destroyed
break;
case SuperMap.State.DELETE:
break;
case SuperMap.State.UNKNOWN:
case SuperMap.State.UPDATE:
this.state = state;
break;
}
} else if (state === SuperMap.State.UNKNOWN) {
this.state = state;
}
}
}
/**
*
* @typedef {Object} SuperMap.Feature.Vector.style
* @description SuperMap.features 有大é‡çš„æ ·å¼å±žæ€§ï¼Œå¦‚æžœæ²¡æœ‰ç‰¹åˆ«çš„æŒ‡å®šå°†ä½¿ç”¨é»˜è®¤çš„æ ·å¼ï¼Œ
* å¤§éƒ¨åˆ†æ ·å¼é€šè¿‡ SVG æ ‡å‡†å®šä¹‰å±žæ€§ã€‚
* - fill properties 资料介ç»ï¼š{@link http://www.w3.org/TR/SVG/painting.html#FillProperties}
* - stroke properties 资料介ç»ï¼š{@link http://www.w3.org/TR/SVG/painting.html#StrokeProperties}
* @property {boolean} [fill] - ä¸éœ€è¦å¡«å……则设置为 false。
* @property {string} [fillColor='#ee9900'] - åå…进制填充颜色。
* @property {number} [fillOpacity=0.4] - å¡«å……ä¸é€æ˜Žåº¦ã€‚
* @property {boolean} [stroke] - ä¸éœ€è¦æ边则设为 false。
* @property {string} [strokeColor='#ee9900'] - åå…进制æ边颜色。
* @property {number} [strokeOpacity=0.4] - æ边的ä¸é€æ˜Žåº¦(0-1)。
* @property {number} [strokeWidth=1] - åƒç´ æ边宽度。
* @property {string} [strokeLinecap='round'] - strokeLinecap 有三ç§ç±»åž‹ butt，round，square。
* @property {string} [strokeDashstyle='solid'] - 有 dot，dash，dashdot，longdash，longdashdot，solid å‡ ç§æ ·å¼ã€‚
* @property {boolean} [graphic] - ä¸éœ€è¦åˆ™è®¾ç½®ä¸º false。
* @property {number} [pointRadius=6] - åƒç´ 点åŠå¾„。
* @property {string} [pointerEvents='visiblePainted'] - pointerEvents。
* @property {string} [cursor] - cursor。
* @property {boolean} [allowRotate='false'] - 是å¦å…è®¸å›¾æ ‡éšç€è¿è¡Œæ–¹å‘旋转。用于时空数æ®å›¾å±‚。
* @property {string} [externalGraphic] - 连接到用æ¥æ¸²æŸ“点的外部的图形。
* @property {number} [graphicWidth] - 外部图表的åƒç´ 宽度。
* @property {number} [graphicHeight] - 外部图表的高宽度。
* @property {number} [graphicOpacity] - 外部图表的ä¸é€æ˜Žåº¦(0-1)。
* @property {number} [graphicXOffset] - 外部图表沿ç€xæ–¹å‘çš„å移é‡ã€‚
* @property {number} [graphicYOffset] - 外部图表沿ç€yæ–¹å‘çš„åç§»é‡ Pixel。
* @property {number} [rotation] - 一个图表沿ç€å…¶ä¸å¿ƒç‚¹ï¼ˆæˆ–者å移ä¸å¿ƒæŒ‡å®šç‚¹ï¼‰åœ¨é¡ºæ—¶é’ˆæ–¹å‘旋转。
* @property {number} [graphicZIndex] - 渲染时使用的索引值。
* @property {string} [graphicName='circle'] - æ¸²æŸ“ç‚¹æ—¶å›¾æ ‡ä½¿ç”¨çš„åå—。支æŒ"circle" , "square", "star", "x", "cross", "triangle"。
* @property {string} [graphicTitle] - 外部图表的æ示框。
* @property {string} [backgroundGraphic] - 外部图表的背景。
* @property {number} [backgroundGraphicZIndex] - 背景图渲染时使用的索引值。
* @property {number} [backgroundXOffset] - 背景图在 x è½´çš„å移é‡ã€‚
* @property {number} [backgroundYOffset] - 背景图在 y è½´çš„å移é‡ã€‚
* @property {number} [backgroundHeight] - 背景图的高度。如果没有设置，将用 graphicHeight。
* @property {number} [backgroundWidth] - 背景图的宽度。如果没有设置，将用 graphicWidth。
* @property {boolean} [isUnicode=false] - 这个属性è¦é…åˆ label 属性æ¥ç”¨ï¼Œå½“为 true时，label å°±å¯ä»¥ä½¿ç”¨ unicode ç¼–ç ，
* 比如 "a" çš„ unicode åå…进制编ç 为 61，则 label 属性å¯ä»¥ä¸º "a",å…¶ä¸ "" 为å‰ç¼€ï¼Œæ ‡å¿—这个为 unicode ç¼–ç ，
* "x" 是指 16 进制,这时页é¢æ˜¾ç¤ºçš„是 "a"；当æ¤å€¼ä¸º false 的时候，label 的内容会被直接输出，
* 比如，label 为 "a"，这时页é¢æ˜¾ç¤ºçš„也是 "a"。
* @property {string} [label] - å¯é€‰çš„æ ‡ç¾æ–‡æœ¬ã€‚
* @property {string} [labelAlign='cm'] - æ ‡ç¾å¯¹é½ï¼Œæ˜¯ç”±ä¸¤ä¸ªå—符组æˆçš„å—符串，如："lt", "cm", "rb"，
* å…¶ä¸ç¬¬ä¸€ä¸ªå—符代表水平方å‘上的对é½ï¼Œ"l"=left, "c"=center, "r"=rightï¼›
* 第二个å—符代表垂直方å‘上的对é½ï¼Œ"t"=top, "m"=middle, "b"=bottom。
* @property {number} [labelXOffset] - æ ‡ç¾åœ¨ x è½´æ–¹å‘çš„å移é‡ã€‚
* @property {number} [labelYOffset] - æ ‡ç¾åœ¨ y è½´æ–¹å‘çš„å移é‡ã€‚
* @property {boolean} [labelSelect=false] - 如果设为 trueï¼Œæ ‡ç¾å¯ä»¥é€‰ç”¨ SelectFeature 或者 similar 控件。
* @property {string} [fontColor='#000000'] - æ ‡ç¾å—体颜色。
* @property {number} [fontOpacity] - æ ‡ç¾é€æ˜Žåº¦ (0-1)。
* @property {string} [fontFamily] - æ ‡ç¾çš„å—体类型。
* @property {string} [fontSize] - æ ‡ç¾çš„å—体大å°ã€‚
* @property {string} [fontStyle] - æ ‡ç¾çš„å—ä½“æ ·å¼ã€‚
* @property {string} [fontWeight] - æ ‡ç¾çš„å—体粗细。
* @property {string} [display] - 如果 display 属性设置为 “noneâ€ï¼Œç¬¦å·å°†æ²¡æœ‰ä»»ä½•æ•ˆæžœã€‚
* @example
* // label的用法如下：
* function addGeoTest(){
* var geometry = new SuperMap.Geometry.Point(105, 35);
* var pointFeature = new SuperMap.Feature.Vector(geometry);
* var styleTest = {
* label:"supermap",
* fontColor:"#0000ff",
* fontOpacity:"0.5",
* fontFamily:"隶书",
* fontSize:"8em",
* fontWeight:"bold",
* fontStyle:"italic",
* labelSelect:"true",
* }
* pointFeature.style = styleTest;
* vectorLayer.addFeatures([pointFeature]);
* }
*/
SuperMap.Feature.Vector = Vector;