abstract style~MarkerSymbol(options)

标记符号,也叫点符号。是Icon、IconFont、RegularShape、Circle的基类。
注意:当使用旋转功能时,出现图标被切角的情况时,请参考矢量图层的说明文档。

Summary

Methods:
getOffset

获取符号的偏移量。

getOpacity

获取符号的透明度。

getRotateWithView

获得符号是否跟着地图旋转。

getRotation

获取符号的旋转角度。单位是角度制。

setOffset

设置符号的偏移量。

setOpacity

设置透明度。

setRotation

设置旋转角度。单位是角度制。

Constructor

new abstract MarkerSymbol(options)

用于创建子类的基类,不能在程序中被实例化。

Parameters:
Name Type Description
options Object

点符号的可选属性。

Name Type Description
opacity Number

透明度 范围为[0,1]。

offset module:basetype~Offset

点符号的偏移量,单位是像素,注:offset数值太大可能存在拾取失败的情况。

rotation Number

旋转角度,单位是角度制,正常值在-360~360度之间。角度为正值进行逆时针旋转;角度为负值进行顺时针旋转。

sprite Boolean

符号是否来自雪碧图,默认为false。eg:当矢量图层使用雪碧图时,并且符号来自该雪碧图,该参数需要设置为true。

Throws:
  • 当实例化MarkerSymbol时,抛出异常:"MarkerSymbol-constructor:The MarkerSymbol is an abstract class,can not be instantiated!"。

  • 当传入的参数opacity不是0到1之间的数字,或者参数offset不是Offset对象时,抛出异常:"MarkerSymbol-contructor:the extent of the parameter 'opacity' is [0,1] and parameter 'offset' must be hmap.basetype.Offset"

Methods

getOffset() → {module:basetype~Offset}

获取符号的偏移量。

Returns:
module:basetype~Offset -

偏移量

getOpacity() → {Number}

获取符号的透明度。

Returns:
Number -

透明度

getRotateWithView() → {Boolean}

获得符号是否跟着地图旋转。

Returns:
Boolean -

如果旋转返回true;如果不旋转,返回false。

Example
let iconSymbol = new hmap.style.Icon();
let result = iconSymbol.getRotateWithView();//result=false

getRotation() → {Number}

获取符号的旋转角度。单位是角度制。

Returns:
Number -

旋转角度

setOffset(offset)

设置符号的偏移量。

Parameters:
Name Type Description
offset module:basetype~Offset

偏移量

Throws:

当参数不是Offset对象时,抛出异常:"The parameter must be a Offset"。

setOpacity(opacity)

设置透明度。

Parameters:
Name Type Description
opacity Number

透明度,透明度的范围是[0,1]。

Throws:

当参数的值不在0到1之间时,抛出异常:“MarkerSymbol-setOpacity:the extent of the parameter 'opacity' is [0,1]”。

setRotation(rotation)

设置旋转角度。单位是角度制。

Parameters:
Name Type Description
rotation Number

旋转角度