类:图标

ol/style/Icon~图标


import Icon from 'ol/style/Icon.js';

设置矢量要素的图标样式。

new Icon(options)

Name Type 描述
anchor Array.<number> (defaults to [0.5, 0.5])

锚点的默认值是图标中心。

anchorOrigin IconOrigin (defaults to 'top-left')

锚点起源:bottom-left, bottom-right, top-left或者top-right.

anchorXUnits IconAnchorUnits (defaults to 'fraction')

锚点x值的指定单位。值为'fraction'表示 x 值为图标的一个分数。值为'pixels'指示以像素为单位的x值。

anchorYUnits IconAnchorUnits (defaults to 'fraction')

锚点 y 值的单位。值为'fraction'表示 y 值占图标的比例。值为'pixels'指示 y 值(以像素为单位)。

color Color | string | undefined

图标的着色颜色。若未指定,图标将保持原样。

crossOrigin null | string | undefined

crossOrigin 表示已加载图像的属性。请注意,您必须提供 crossOrigin;若要通过 Canvas 渲染器访问像素数据,请使用此值。详细信息(https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image)。

img HTMLImageElement | HTMLCanvasElement | OffscreenCanvas | ImageBitmap | undefined

用于图标的图像对象。

displacement Array.<number> (defaults to [0, 0])

图标偏移量(以像素为单位)。正值将使图标向右和向上偏移。

opacity number (defaults to 1)

图标透明度

width number | undefined

图标的宽度(像素)。该参数不能与以下属性同时使用。scale.

height number | undefined

图标高度(像素值)。不可与以下属性同时使用scale.

scale number | Size (defaults to 1)

比例.

rotateWithView boolean (defaults to false)

图标是否随视图旋转?

rotation number (defaults to 0)

以弧度为单位的旋转(顺时针为正)。

offset Array.<number> (defaults to [0, 0])

偏移量,连同sizeoffsetOrigin定义从原始(精灵)图像中使用的子矩形。

offsetOrigin IconOrigin (defaults to 'top-left')

偏移量的来源:bottom-left, bottom-right, top-lefttop-right.

size Size | undefined

图标尺寸(像素)。配合使用。offset定义从原始(精灵)图像中使用的子矩形。

src string | undefined

图像源URI

declutterMode DeclutterMode | undefined

去重模式。

继承

方法

克隆样式。底层的 Image/HTMLCanvasElement 不会被克隆。

返回:
克隆的样式。

getAnchor(){Array.<number>}

获取以像素为单位的锚点。锚点确定了符号化器的中心点。

返回:
锚点。

获取图标颜色。

返回:
颜色。

获取形状的整理模式

返回:
几何形状的整理模式

getDisplacement(){Array.<number>} inherited

获取形状的位移

返回:
图形中心偏移

getHeight(){number}

获取图标高度(以像素为单位)。若图标尚未加载,则返回 undefined。

返回:
图标高度(像素)。

getImage(pixelRatio){HTMLImageElement | HTMLCanvasElement | OffscreenCanvas | ImageBitmap}

获取图像图标。

Name Type 描述
pixelRatio number

设备像素比

返回:
图像或Canvas元素。若图标样式配置了 src,或 img 未加载,则返回 ImageBitmap

getOpacity(){number} inherited

获取符号化器的不透明度。

返回:
不透明度。

getOrigin(){Array.<number>}

获取符号化器的原点。

返回:
原点。

getPixelRatio(pixelRatio){number}

获取像素比率。

Name Type 描述
pixelRatio number

设备像素比。

返回:
图像的像素比率。

getRotateWithView(){boolean} inherited

确定符号化器是否随地图旋转。

返回:
随地图旋转。

getRotation(){number} inherited

获取符号化器的旋转。

返回:
旋转.

getScale(){number | Size} inherited

获取符号化器的缩放比例。

返回:
比例.

获取图标的尺寸(以像素为单位)。

返回:
图像尺寸。

getSrc(){string | undefined}

获取图片 URL。

返回:
图像源。

getWidth(){number}

获取图标的宽度(像素)。若图标图像尚未加载,则返回 undefined。

返回:
图标宽度(像素)。

加载尚未加载的URI。在渲染具有图标样式的要素时,矢量渲染器会自动调用此方法。然而,您也可能需要手动调用此方法以进行预加载或其他操作。

setAnchor(anchor)

设置锚点。锚点确定符号化器的中心点。

Name Type 描述
anchor Array.<number>

锚点。

setDisplacement(displacement) inherited

设置位移。

Name Type 描述
displacement Array.<number>

位移.

setOpacity(opacity) inherited

设置不透明度。

Name Type 描述
opacity number

不透明度。

setRotateWithView(rotateWithView) inherited

设置样式是否随视图旋转。

Name Type 描述
rotateWithView boolean

随地图旋转。

setRotation(rotation) inherited

设置旋转。

Name Type 描述
rotation number

旋转.

setScale(scale)

设置比例尺。

Name Type 描述
scale number | Size

比例.

setSrc(src)

设置图像URI

Name Type 描述
src string

图像源URI