ImageLayer - YouScene Documentation

ImageLayer

影像图层

new YS.ImageLayer(options, global)

影像图层

Name Type Description

options

Object

对象有下面这些属性:

Name	Type	Default	Description
`id`	String		optional 唯一标识
`name`	String		optional 名称
`rectangle`	Object		optional 范围{west, south, east, north}
`category`	String		optional 图层分组
`url`	String		url
`fileExtension`	String		optional 文件类型
`numberOfLevelZeroTilesX`	Number	`1`	optional 0级切片X
`numberOfLevelZeroTilesY`	Number	`1`	optional 0级切片Y
`tileWidth`	Number	`256`	optional 切片像素宽
`tileHeight`	Number	`256`	optional 切片像素高
`minimumLevel`	Number		optional 最小级数
`maximumLevel`	Number		optional 最大级数
`isAddTree`	Boolean		optional 是否在图层树上显示
`treeIcon`	String		optional 图层树上显示的图标，默认不显示
`isQuery`	Boolean		optional 是否支持空间查询
`visible`	Boolean		optional 是否可见
`insertPosition`	String		optional 图层加载的层级(不设置时默认加到最顶层)
`webMercator`	Boolean	`true`	optional 是否是墨卡托投影坐标,不是则用经度度投影
`queryField`	String		optional 是否自定义空间查询主字段
`textureFilter`	TextureFilter	`TextureFilter.LINEAR`	optional 是否自定义空间查询主字段
`splitDirection`	String		optional 卷帘方向['NONE': 不使用卷帘， 'LEFT': 左侧卷帘， 'RIGHT': 右侧卷帘]

global Object 三维球对象（YouScene.earth）

Implements:

AbstractLayer

Example:

youScene.layers.addImageLayer({
         id: 'imageLayer',
         url: 'http://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}.png',
         name: 'imageLayer',
         category: 'imageLayer',
         isAddTree: true,
         webMercator: true
     });

Demo:

http://ys.infoearth.com:9090/Sandcastle/index.html#name=ImageLayer

See:

Members

fileExtension : String

获取或设置文件类型

insertPosition : Number

获取或设置影像图层加载的层级

insertPosition : Number

获取或设置影像图层加载的层级

isQuery : Boolean

获取或设置是否支持空间查询

Default Value: false

See:

ImageLayer#queryField

layerName : String

获取或设置图层名称

Default Value: "ImageLayer"

maximumLevel : Number

获取或设置最大级数

minimumLevel : Number

获取或设置最小级数

numberOfLevelZeroTilesX : Number

获取或设置0级切片X

numberOfLevelZeroTilesY : Number

获取或设置0级切片Y

queryField : String

获取自定义空间查询主字段

See:

ImageLayer#isQuery

rectangle : Object

获取或设置范围

Implements:

AbstractLayer#rectangle

shpField : String

获取自定义空间查询主字段

Deprecated: 请使用queryField属性

splitDirection : String

获取或设置卷帘的方向 [LEFT, NONE, RIGHT]其中一种

readonlytextureFilter : TextureFilter

获取纹理采样方式

readonlytileHeight : Number

获取切片高度

readonlytileWidth : Number

获取切片宽度

url : String

获取或设置url

Methods

addLayer(global, pos)

添加图层

Name	Type	Description
`global`	Object	三维球对象（YouScene.earth）
`pos`	Number	optional 图层添加的位置，默认添加到最后，即叠加到最上面

Implements:

AbstractLayer#addLayer

blackMarble(global)

卷帘对比

Name	Type	Description
`global`	Object	三维球对象（YouScene.earth）

destroy()

销毁

Implements:

AbstractLayer#destroy

flickerLayer()

图层闪烁

getColorValue() → object

获取当前图层的色彩值

Returns:

colorValue 色彩值对象

getPosition() → Number

获取当前图层的索引

Returns:

返回当前图层的索引，找不到返回-1

moveDown()

将当前图层在叠加关系上向下移动

moveToBottom()

将当前图层移到最底下

moveToTop()

将当前图层移到最顶上，避免被其他影像图层遮盖

moveUp()

将当前图层在叠加关系上向上移动

removeBlackMarble()

取消卷帘对比

setColorValue(colorValue)

透明度调整

Name Type Description

colorValue

object

色彩值对象包含下面这些属性:

Name	Type	Description
`alpha`	number	optional 透明度范围(0 ~ 1)
`brightness`	number	optional 亮度范围(0 ~ 3)
`contrast`	number	optional 对比度范围(0 ~ 3)
`saturation`	number	optional 饱和度范围(0 ~ 3)
`gamma`	number	optional 色阶范围(0 ~ 3)

Events

colorChange

色彩变化事件

Name	Type	Description
`name`	String	色彩的名称
`data`	String	色彩当前的值

readyEvent

影像图层创建成功

Name	Type	Description
`layer`	ImageLayer	影像图层