麻辣GIS微信平台

更多 GIS 干货

微信关注不错过

Cesium API - ImageryProvider 中文文档

本文介绍下Cesium中 ImageryProvider API的详细使用说明。

ImageryProvider API 调用方法

成员变量

获取此提供器在活跃状态下要显示的Credit。通常这是用来确认图像的来源。 在ImageryProvider#ready返回true之前,不应该调用此函数。
defaultAlpha : Number
默认的alpha混合值,0.0表示完全透明,1.0表示完全不透明。
Default Value: undefined
defaultBrightness : Number
此提供器的默认亮度值。值为1.0表示使用原图;值大于1.0时图像将变亮;值小于1.0时图像将变暗。
Default Value: undefined
defaultContrast : Number
默认的对比度。值为1.0表示使用原图;值大于1.0表示增加对比度;值小于1.0表示降低对比度。
Default Value: undefined
defaultGamma : Number
默认的伽马校正。值为1.0表示使用原图。
Default Value: undefined
defaultHue : Number
默认的色调。值为0.0表示使用原图。
Default Value: undefined
默认的纹理放大过滤器。
Default Value: undefined
默认的纹理缩小过滤器。
Default Value: undefined
defaultSaturation : Number
默认的饱和度。值为1.0表示使用原图;值大于1.0表示增加饱和度;值小于1.0表示降低饱和度。
Default Value: undefined
readonlyerrorEvent : Event
获取此提供器遇到异步错误时触发的事件。 通过订阅事件,您将收到错误通知,并可能从中恢复。事件监听器传递一个TileProviderError的实例。
readonlyhasAlphaChannel : Boolean
获取一个值,该值指示此图像提供器提供的图像是否包含alpha通道。 如果此属性为false,则alpha通道(如果存在)将被忽略。如果此属性为true,则任何没有alpha通道的图像都将被视为alpha值为1.0。 当此属性为false时,内存使用和纹理上传时间将减少。
readonlymaximumLevel : Number
获取可以请求的最大层级。在ImageryProvider#ready返回true之前,不应该调用此函数。
readonlyminimumLevel : Number
获取可以请求的最小级别。在ImageryProvider#ready返回true之前,不应该调用此函数。 通常,只有当图像的矩形足够小,使得最小级别的瓦片数量足够少时,才应该使用最小级别。 一个图像提供器如果在最小级别上有多个图像瓦片,就会导致渲染问题。
readonlyproxy : Proxy
获取此提供器使用的代理。
readonlyready : Boolean
获取一个值,该值指示提供器是否已准备好使用。
readonlyreadyPromise : Promise.<Boolean>
获取在提供器准备使用时解析为true的promise。
获取实例提供的图像的矩形(以弧度为单位)。在ImageryProvider#ready返回true之前,不应该调用此函数。
readonlytileDiscardPolicy : TileDiscardPolicy
设置瓦片的丢弃策略。如果定义,丢弃策略负责通过其shouldDiscardImage函数过滤掉"missing"瓦片。 如果此函数返回未定义,则不过滤任何瓦片。在ImageryProvider#ready返回true之前,不应该调用此函数。
readonlytileHeight : Number
获取每个瓦片的高度(以像素为单位)。在ImageryProvider#ready返回true之前,不应该调用此函数。
readonlytileWidth : Number
获取每个瓦片的宽度(以像素为单位)。在ImageryProvider#ready返回true之前,不应该调用此函数。
获取此提供器使用的切片方案。在ImageryProvider#ready返回true之前,不应该调用此函数。

内置方法

staticCesium.ImageryProvider.loadImage(imageryProvider, url)Promise.<(Image|Canvas)>|undefined
从提供的的URL加载图像。如果URL引用的服务器已经有太多的请求等待处理,那么这个函数将返回undefined,这表示稍后应该重试请求。
Name Type Description
imageryProvider ImageryProvider URL的图像提供器。
url Resource | String 图像的URL。
返回值:
对图像的promise,当图像可用时,它将解析图像; 如果有太多对服务器的活动请求,则为未定义,并且应该稍后重试请求。解析后的图像可以是Image,也可以是画布DOM对象。
getTileCredits(x, y, level)Array.<Credit>
获取当请求的瓦片被显示出来时,要显示的版权。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的层级。
返回值:
瓦片显示时要显示的版权。
异常情况:
  • DeveloperError : getTileCredits在图像提供器准备好之前不能被调用。
pickFeatures(x, y, level, longitude, latitude)Promise.<Array.<ImageryLayerFeatureInfo>>|undefined
异步地确定哪些要素(如果有的话)位于瓦片中给定的经度和纬度。 在ImageryProvider#ready返回true之前,不应该调用此函数。 这个函数是可选的,所以它可能不存在于所有的ImageryProviders上。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
longitude Number 拾取要素的经度。
latitude Number 拾取要素的纬度。
返回值:
对所选要素的promise,它将在异步拾取完成时解析。 解析后的值是ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素,则该数组可能为空。 如果不支持拾取,它也可能是未定义的。
异常情况:
  • DeveloperError : pickFeatures在图像提供器准备好之前不能被调用。
requestImage(x, y, level, request)Promise.<(Image|Canvas)>|undefined
请求给定瓦片的图像。在ImageryProvider#ready返回true之前,不应该调用此函数。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的层级。
request Request optional Request对象(仅供内部使用)。
返回值:
请求到的结果。
异常情况:
  • DeveloperError : requestImage在图像提供器准备好之前不能被调用。

其他API

Cesium中文API文档手册(v1.63.1版本)参考:《Cesium中文API文档手册(v1.63.1版本)

相关阅读

麻辣GIS-Sailor

作者:

GIS爱好者,学GIS,更爱玩GIS。

声明

1.本文所分享的所有需要用户下载使用的内容(包括但不限于软件、数据、图片)来自于网络或者麻辣GIS粉丝自行分享,版权归该下载资源的合法拥有者所有,如有侵权请第一时间联系本站删除。

2.下载内容仅限个人学习使用,请切勿用作商用等其他用途,否则后果自负。

手机阅读
公众号关注
知识星球
手机阅读
麻辣GIS微信公众号关注
最新GIS干货
关注麻辣GIS知识星球
私享圈子

留言板(小编看到第一时间回复)