Class: IGSImageryLayer

IGSImageryLayer

new IGSImageryLayer(options)

document/layer/igserver/IGSImageryLayer.js, line 8

IGS 影像服务图层。

用于加载 ImageServer 发布的栅格影像,并统一管理波段组合、重采样方式、 栅格函数、服务能力和服务端返回的栅格元信息。适用于按当前视图范围动态请求整幅影像或切换不同影像显示方案的场景。

Name Type Default Description
options Object {} 可选

构造参数。

Name Type Default Description
url String 可选

ImageServer 服务地址,格式通常为 http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/ImageServer

bandIds Array.<Number> 可选

波段编号数组。可用于指定输出波段或调整波段组合顺序。

capabilities Object 可选

服务能力描述对象。

format String 可选

导出图片格式,支持 PNGJPGMIXED 等服务支持的格式。

interpolation RasterInterpolationType 可选

重采样方式;未指定时使用服务默认值。

rasterFunction RasterFunction | null 可选

栅格函数配置,例如 ndvihillshade

serviceRasterInfo RasterInfo | null 可选

栅格元信息对象。

clippingArea Polygon | Extent | Circle | MultiPolygon | null null 可选

图层空间裁剪范围。

renderMode String 'tile' 可选

影像展现方式。image 表示按当前视图请求单张影像,tile 表示按瓦片方式平铺加载。

imageWidth Number 512 可选

单次请求影像宽度,仅在 renderModetile 时生效。

imageHeight Number 512 可选

单次请求影像高度,仅在 renderModetile 时生效。

Example

创建 IGS 影像服务图层

// ES5 引入方式
const { IGSImageryLayer } = zondy.layer

// ES6 引入方式
import { IGSImageryLayer } from '@mapgis/webclient-common'

const layer = new IGSImageryLayer({
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/ImageServer'
})

Extends

Members

bandIdsArray.<Number> null

波段号,如果有多个波段,可以指定要导出的单个波段,也可以通过指定波段编号来更改波段组合。例如[0,1,2]

clippingAreaPolygon Extent Circle MultiPolygon null

空间裁剪范围

elevationInfoElevationInfo

高程模式参数。仅支持 ElevationMode.onTheScene 和 ElevationMode.onTheGround 两种模式。

formatString

返回图片格式,支持PNG/JPG/MIXED,默认PNG

imageHeightNumber

影像的高度,仅在renderMode为'tile'时生效。

imageMaxHeightNumber

表示服务导出的图像的最大高度

imageMaxWidthNumber

表示服务导出的图像的最大宽度

imageWidthNumber

影像的宽度,仅在renderMode为'tile'时生效。

重采样方式,支持NearestNeighbor/BilinearInterpolation,默认数据本身的重采样方式

rasterFunctionRasterFunction null

栅格数据处理渲染规则,支持ndvi、hillshade,NDVI应用于多光谱影像数据,HILLSHADE应用于DEM高程数据。

renderModeString

渲染模式,影像的展现形式。可选'tile' 、 'image'。默认为'image'。 当选项为'image'时,加载影像会请求一张覆盖当前屏幕的图像。当选项为'tile'时,加载影像时以瓦片的方式平铺。

serviceRasterInfoRasterInfo

栅格信息

typeLayerType

图层类型

urlString

服务地址

Methods

clone(){IGSImageryLayer}

document/layer/igserver/IGSImageryLayer.js, line 173

克隆当前 IGS 影像图层。

会基于当前实例的公开配置创建一个新的图层对象,适用于复制影像显示方案。

Returns:
Type Description
IGSImageryLayer 克隆后的 IGS 影像图层实例。

inherited toJSON(){Object}

document/layer/baseLayer/ImageryLayer.js, line 313

导出为 JSON 配置。

返回当前影像服务图层的可序列化配置,包括影像格式、波段组合、裁剪范围和栅格处理规则等信息。

Returns:
Type Description
Object 图层配置对象。

IGSImageryLayer.fromJSON(json){IGSImageryLayer}

document/layer/igserver/IGSImageryLayer.js, line 159

通过 JSON 配置恢复 IGS 影像图层实例。

适用于从持久化配置中恢复影像图层对象,通常与 toJSON 配套使用。

Name Type Default Description
json Object {} 可选

图层配置对象。

Returns:
Type Description
IGSImageryLayer 新的 IGS 影像图层实例。