栅格Tile瓦片图层 基类
| 参数名称 | 类型 | 描述信息 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
可选
参数对象，包括以下：
|
- Cesium.UrlTemplateImageryProvider
- Cesium.ImageryLayer
参考:
继承
成员(属性)
透明度，同opacity。从0.0到1.0。
-
默认值:
1.0
指定时间范围内显示该对象 [提示：仅部分子类实现，非所有对象都支持]
- 继承自:
使用示例:
// 普通传值方式，多个【建议】
layer.availability = [
{ start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false },
{ start: "2017-08-25 09:00:00", duration: 10 } //支持不配置stop，直接配置duration秒数时长
]
// 也支持相对时间的 秒数 传值（相对于map.clock.startTime）
layer.availability = [
{ start: 0, stop: 10, isStartIncluded: true, isStopIncluded: false },
{ start:30, duration: 10 } //支持不配置stop，直接配置duration秒数时长
]
// 普通传值方式，单个
layer.availability = { start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false }
// cesium原生写法, 多个
layer.availability = new Cesium.TimeIntervalCollection([
new Cesium.TimeInterval({
start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
isStartIncluded: true,
isStopIncluded: false
}),
])
// cesium原生写法,单个
layer.availability = new Cesium.TimeInterval({
start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
isStartIncluded: true,
isStopIncluded: false
})亮度，取值范围：0.0-1.0。
-
默认值:
1.0
对比度。 1.0使用未修改的图像颜色，小于1.0会降低对比度，而大于1.0则会提高对比度。
-
默认值:
1.0
readonly crs : CRS|string
layer/tileLayer/BaseTileLayer.js 157
坐标系
设置事件的启用和禁用状态
伽马校正值。 1.0使用未修改的图像颜色。
-
默认值:
1.0
是否可以调整透明度
- 继承自:
是否可以调整图层顺序（在同类型图层间）
色调。 0.0 时未修改的图像颜色。
-
默认值:
0.0
对象的id标识
- 继承自:
瓦片图层对应的内部ImageryProvider对象
是否已添加到地图
- 继承自:
是否已经销毁了
- 继承自:
是否Mars3D内部的私有对象，如标绘拖拽点等
- 继承自:
当前是否为瓦片图层
瓦片图层对应的内部ImageryLayer对象
名称
- 继承自:
透明度，取值范围：0.0-1.0
- 继承自:
当前类的构造参数
- 继承自:
对象的pid标识
- 继承自:
readonly readyPromise : Promise.<(BaseLayer|object)>
layer/BaseLayer.js 188
获取图层完成解析加载完成的Promise承诺, 等价于load事件(区别在于load事件必须在load完成前绑定才能监听)。
- 继承自:
使用示例:
tiles3dLayer.readyPromise.then(function(layer) {
console.log("load完成", layer)
})瓦片数据范围
饱和度。 1.0使用未修改的图像颜色，小于1.0会降低饱和度，而大于1.0则会增加饱和度。
-
默认值:
1.0
显示隐藏状态
- 继承自:
卷帘对比时，设置所在的屏幕，NONE时不分屏
readonly state : State
layer/BaseLayer.js 143
当前对象的状态
- 继承自:
取当前subdomains配置的随机1个值，用于URL模板中用于 {s} 占位符的子域
图层中统一的url模版，比如可以将服务url前缀统一使用模板，方便修改或动态配置。
图层类型
- 继承自:
图层顺序，数字大的在上面。（当hasZIndex为true时）
方法
async abstract _createImageryProvider(options) → Promise.<(Cesium.UrlTemplateImageryProvider|*)>
layer/tileLayer/BaseTileLayer.js 410
创建瓦片图层对应的ImageryProvider对象
| 参数名称 | 类型 | 默认值 | 描述信息 |
|---|---|---|---|
options |
object |
{}
|
可选
参数对象，具体每类瓦片图层都不一样。 |
返回值:
创建完成的 ImageryProvider 对象
对象添加到地图前创建一些对象的钩子方法， 只会调用一次
返回值:
无
addEventParent(obj) → BaseClass
core/BaseClass.js 307
添加抛出事件到父类，它将接收传播的事件
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
obj |
object |
父类对象 |
返回值:
当前对象本身,可以链式调用
addTo(map) → BaseLayer
layer/BaseLayer.js 406
添加到地图上，同 map.addThing
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
map |
Map |
地图对象 |
返回值:
当前对象本身，可以链式调用
- 继承自:
绑定鼠标移入或单击后的 对象高亮
| 参数名称 | 类型 | 描述信息 | ||||||
|---|---|---|---|---|---|---|---|---|
options |
object |
可选
高亮的样式，具体见各
|
返回值:
无
清除已选中的高亮，原有style的配置项需要与highlightStyle配置有一一对应关系，否则无法清除
返回值:
无
销毁当前对象
| 参数名称 | 类型 | 默认值 | 描述信息 |
|---|---|---|---|
noDel |
boolean |
false
|
可选
false:会自动delete释放所有属性，true：不delete绑定的变量 |
返回值:
无
- 继承自:
fire(type, data, propagate) → BaseClass
core/BaseClass.js 203
触发指定类型的事件。
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
type |
EventType | string |
事件类型 |
data |
object |
可选
传输的数据或对象，可在事件回调方法中event对象中获取进行使用 |
propagate |
BaseClass |
可选
将事件传播给父类 (用addEventParent设置) |
返回值:
当前对象本身,可以链式调用
- 继承自:
飞行定位至图层数据所在的视角
| 参数名称 | 类型 | 默认值 | 描述信息 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
{}
|
可选
参数对象:
|
返回值:
如果飞行成功则解析为true的承诺，如果当前未在场景中可视化目标或取消飞行，则为false的Promise
- 继承自:
获取时间范围的简单对象数组（转为相对map.clock.startTime的相对数字）
返回值:
时间对象列表
获取指定时间下的时序对应的 显示隐藏 状态
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
time |
Cesium.JulianDate |
指定时间 |
返回值:
显示隐藏 状态
获取当前对象真实实际的显示状态
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
time |
Cesium.JulianDate |
当前时间 |
返回值:
真实的实时显示状态，当时序范围外，被聚合时返回的是false
是否绑定了抛出事件到指定父类
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
obj |
object |
父类对象 |
返回值:
是否绑定了抛出事件
是否有绑定指定的事件
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
type |
EventType | string |
事件类型 |
propagate |
BaseClass |
可选
是否判断指定的父类 (用addEventParent设置的) |
返回值:
是否存在
- 继承自:
off(types, fn, context) → BaseClass
core/BaseClass.js 95
解除绑定指定类型事件监听器
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
types |
EventType | string | Array.<EventType> |
可选
事件类型,未传值时解绑所有事件 |
fn |
function |
可选
绑定的监听器回调方法,未传值时解绑所有指定类型对应事件，特殊说明：map.on监听的Cesium相关原生事件时必须传入该参数 |
context |
object |
可选
侦听器的上下文(this关键字将指向的对象)。 |
返回值:
当前对象本身,可以链式调用
- 继承自:
on(types, fn, context) → BaseClass
core/BaseClass.js 61
绑定指定类型事件监听器, 支持在监听中调用 event.stopPropagation(); 阻止事件冒泡
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
types |
EventType | string | Array.<EventType> | Array.<string> | object |
事件类型 |
fn |
function |
绑定的监听器回调方法 |
context |
object |
可选
侦听器的上下文(this关键字将指向的对象)。 |
返回值:
当前对象本身,可以链式调用
- 继承自:
once(types, fn, context) → BaseClass
core/BaseClass.js 284
绑定一次性执行的指定类型事件监听器 与on类似，监听器只会被触发一次，然后被删除。
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
types |
EventType | string | Array.<EventType> |
事件类型 |
fn |
function |
绑定的监听器回调方法 |
context |
object |
可选
侦听器的上下文(this关键字将指向的对象)。 |
返回值:
当前对象本身,可以链式调用
- 继承自:
高亮对象。
| 参数名称 | 类型 | 默认值 | 描述信息 |
|---|---|---|---|
highlightStyle |
object |
可选
高亮的样式，具体见各 |
|
closeLast |
boolean |
true
|
可选
是否清除地图上上一次的高亮对象 |
返回值:
无
重新加载图层
返回值:
无
从地图上移除，同map.removeThing
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
destroy |
boolean |
可选
是否调用destroy释放 |
返回值:
无
- 继承自:
removeEventParent(obj) → BaseClass
core/BaseClass.js 320
移除抛出事件到父类
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
obj |
object |
父类对象 |
返回值:
当前对象本身,可以链式调用
设置透明度
| 参数名称 | 类型 | 描述信息 |
|---|---|---|
value |
number |
透明度 |
返回值:
无
setOptions(options, funOptions) → BaseLayer
layer/BaseLayer.js 641
更新图层参数
| 参数名称 | 类型 | 描述信息 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
与类的构造方法参数相同 |
||||||||
funOptions |
object |
可选
方法参数
|
返回值:
当前对象本身，可以链式调用
- 继承自:
将当前图层在map中层级进行 置底(只对同类型图层间有效)
返回值:
无
将图层转为Json简单对象，用于存储后再传参加载
返回值:
Json简单对象
- 继承自:
将当前图层在map中层级进行 置顶(只对同类型图层间有效)。
返回值:
无
解绑鼠标移入或单击后的高亮处理
返回值:
无
定义的类型
当前栅格瓦片图层支持的EventType事件类型
属性:
| 属性名称 | 类型 | 描述信息 |
|---|---|---|
add |
string | 添加对象 |
remove |
string | 移除对象 |
show |
string | 显示了对象 |
hide |
string | 隐藏了对象 |
load |
string | 瓦片图层初始化完成 |
addTile |
string | 栅格瓦片图层，开始加载瓦片 |
addTileSuccess |
string | 栅格瓦片图层，加载瓦片完成 |
addTileError |
string | 栅格瓦片图层，加载瓦片出错了 |
click |
string | 鼠标单击事件【WMS等动态服务enablePickFeatures:true时,支持单击获取对应的矢量对象】 |
popupOpen |
string | 当存在popup时，popup弹窗打开后 |
popupClose |
string | 当存在popup时，popup弹窗关闭 |
highlightOpen |
string | highlight高亮后 |
highlightClose |
string | highlight关闭后 |
使用示例:
//绑定监听事件
layer.on(mars3d.EventType.addTile, function (event) {
console.log('addTile', event)
})