Cesium API - GridImageryProvider 中文文档

new Cesium.GridImageryProvider(options)

一个ImageryProvider，它在每个瓦片上绘制一个具有可控背景和辉光的线框网格。对于自定义渲染效果或调试地形可能很有用。

Name Type Description

options

Object

optional 此对象拥有以下属性：

Name	Type	Default	Description
`tilingScheme`	TilingScheme	`new GeographicTilingScheme()`	optional 切片方案。
`ellipsoid`	Ellipsoid		optional 椭球。如果指定了tilingScheme，则将忽略此参数，而是使用切片方案的椭球体。如果未指定任何参数，则使用WGS84椭球。
`cells`	Number	`8`	optional 格网单元格数量。
`color`	Color	`Color(1.0, 1.0, 1.0, 0.4)`	optional 格网线的颜色。
`glowColor`	Color	`Color(0.0, 1.0, 0.0, 0.05)`	optional 格网线的发光颜色。
`glowWidth`	Number	`6`	optional 发光强度。
`backgroundColor`	Color	`Color(0.0, 0.5, 0.0, 0.2)`	optional 填充背景色。
`tileWidth`	Number	`256`	optional 瓦片宽。
`tileHeight`	Number	`256`	optional 瓦片高。
`canvasSize`	Number	`256`	optional 用于渲染的画布大小。

成员变量

readonlycredit : Credit

Scene/GridImageryProvider.js 227

获取版权信息。在GridImageryProvider#ready返回true之前，不应调用此函数。

readonlyerrorEvent : Event

Scene/GridImageryProvider.js 191

获取异步错误时引发的事件。

readonlyhasAlphaChannel : Boolean

Scene/GridImageryProvider.js 239

G获取影像是否有Alpha通道。

readonlymaximumLevel : Number

Scene/GridImageryProvider.js 121

获取最大级别。在GridImageryProvider#ready返回true之前，不应调用此函数。

readonlyminimumLevel : Number

Scene/GridImageryProvider.js 133

获取最小级别。在GridImageryProvider#ready返回true之前，不应调用此函数。

readonlyproxy : Proxy

Scene/GridImageryProvider.js 85

获取代理。

readonlyready : Boolean

Scene/GridImageryProvider.js 203

获取此提供器是否已经准备好。

readonlyreadyPromise : Promise.<Boolean>

Scene/GridImageryProvider.js 215

获取一个在提供器准备就绪时可以解析为true的Promise。

readonlyrectangle : Rectangle

Scene/GridImageryProvider.js 157

获取要显示的地图范围（以弧度表示）在GridImageryProvider#ready返回true之前，不应调用此函数。

readonlytileDiscardPolicy : TileDiscardPolicy

Scene/GridImageryProvider.js 170

获取瓦片忽略策略。如果未定义，则忽略策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。如果此函数返回未定义，则不过滤任何切片。在GridImageryProvider#ready返回true之前，不应调用此函数。

readonlytileHeight : Number

Scene/GridImageryProvider.js 109

获取瓦片高，在GridImageryProvider#ready返回true之前，不应调用此函数。

readonlytileWidth : Number

Scene/GridImageryProvider.js 97

获取瓦片宽，在GridImageryProvider#ready返回true之前，不应调用此函数。

readonlytilingScheme : TilingScheme

Scene/GridImageryProvider.js 145

获取切片方案。在GridImageryProvider#ready返回true之前，不应调用此函数。

内置方法

_createGridCanvas()

Scene/GridImageryProvider.js 267

使用背景和发光效果将网格渲染到画布中。

_drawGrid()

Scene/GridImageryProvider.js 249

在画布上绘制网格线。

getTileCredits(x, y, level) → Array.<Credit>

Scene/GridImageryProvider.js 316

获取当请求的瓦片被显示出来时，要显示的版权信息。

Name	Type	Description
`x`	Number	瓦片的X坐标。
`y`	Number	瓦片的Y坐标。
`level`	Number	瓦片的层级。

返回值：

返回的版权。

异常情况：

DeveloperError : 在图像提供器准备就绪之前，不得调用 getTileCredits 。

pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined

Scene/GridImageryProvider.js 348

这个图像提供器目前不支持拾取功能，所以这个函数只是返回未定义。

Name	Type	Description
`x`	Number	瓦片的X坐标。
`y`	Number	瓦片的Y坐标。
`level`	Number	瓦片的级别。
`longitude`	Number	拾取要素的经度。
`latitude`	Number	拾取要素的纬度。

返回值：

对所选要素的promise，它将在异步拾取完成时解析。解析后的值是ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素，则该数组可能为空。如果不支持拾取，它也可能是未定义的。

requestImage(x, y, level, request) → Promise.<(Image|Canvas)>|undefined

Scene/GridImageryProvider.js 332

请求给定块的瓦片。在GridImageryProvider＃ready返回true之前，不应调用此函数。

Name	Type	Description
`x`	Number	瓦片的X坐标。
`y`	Number	瓦片的Y坐标。
`level`	Number	瓦片的层级。
`request`	Request	optional Request对象（仅供内部使用）。