ImageryLayer

优质
小牛编辑
134浏览
2023-12-01

new LSGlobe.ImageryLayer(imageryProvider, options)

Globe上显示来自单个图像提供者的图像

NameTypeDescription
imageryProvider

ImageryProvider

要使用的映像图层
options

Object

optional
对象具有以下属性:

NameTypeDefaultDescription
rectangle

Rectangle

imageryProvider.rectangle

optional
图层的矩形范围,此矩形限制了影像可见范围
alpha

Number
|
function

1.0

optional
这个图层的alpha值从0.0到1.0.这可以是一个简单的数字,也可以是一个签名函数(frameState,layer,x,y,level)。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的alpha值,然后将返回的alpha值应用到瓦片上。
brightness

Number
|
function

1.0

optional
图层的亮度。小于1.0图层变暗,大于1.0图层变亮。这个图层的亮度值这个值可以是一个简单数字,也可以是一个签名函数(frameState,layer,x,y,level)。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的亮度值,然后将返回的亮度值应用到瓦片上。该函数每帧对每个瓦块都执行,因此它必须是快速的。
contrast

Number
|
function

1.0

optional
图层对比度。值为1.0表示使用原图;值大于1.0表示增加对比度;值小于1.0表示降低对比度。这个值可以是一个简单数字,也可以是一个签名函数(frameState,layer,x,y,level)。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的对比度,然后将返回的对比度应用到瓦片上。该函数每帧对每个瓦块都执行,因此它必须是快速的。
hue

Number
|
function

0.0

optional
图层色调。值为0.0表示使用原图颜色。这个值可以是一个简单数字,也可以是一个签名函数(frameState,layer,x,y,level)。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的图层色调,然后将返回的图层色调应用到瓦片上。该函数每帧对每个瓦块都执行,因此它必须是快速的。
saturation

Number
|
function

1.0

optional
图层饱和度。值为1.0表示使用原图;值大于1.0表示增加饱和度;值小于1.0表示降低饱和度。这个值可以是一个简单数字,也可以是一个签名函数(frameState,layer,x,y,level)。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的饱和度,然后将返回的饱和度应用到瓦片上。该函数每帧对每个瓦块都执行,因此它必须是快速的。
gamma

Number
|
function

1.0

optional
图层伽马校正。值为1.0表示使用原图。。这个值可以是一个简单数字,也可以是一个签名函数(frameState,layer,x,y,level)。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的伽马值,然后将返回的伽马值应用到瓦片上。该函数每帧对每个瓦块都执行,因此它必须是快速的。
splitDirection

ImagerySplitDirection
|
function

ImagerySplitDirection.NONE

optional
ImagerySplitDirection 分割应用于此图层
minificationFilter

TextureMinificationFilter

TextureMinificationFilter.LINEAR

optional
纹理缩小过滤器适用于此图层。可能的值是TextureMinificationFilter.LINEARTextureMinificationFilter.NEAREST
magnificationFilter

TextureMagnificationFilter

TextureMagnificationFilter.LINEAR

optional
纹理放大过滤器适用于此图层。可能的值是TextureMagnificationFilter.LINEARTextureMagnificationFilter.NEAREST
show

Boolean

true

optional
指定图层是否显示,true表示显示此图层,false表示不显示
maximumAnisotropy

Number

maximum supported

optional
用于纹理过滤的最大各向异性水平。如果没有指定此参数,将使用WebGL堆栈支持的最大各向异性。更大的值使图像在地平线上看起来效果更好
minimumTerrainLevel

Number

optional
显示该图像层的最小地形细节级别,或未定义显示该图像的所有级别。0级是最不详细的级别
maximumTerrainLevel

Number

optional
显示该图像层的最大地形细节级别,或未定义显示该图像的所有级别。0级是最不详细的级别

Members

staticLSGlobe.ImageryLayer.DEFAULT_BRIGHTNESS : Number

如果在构建过程中或图像提供商未提供此值,则此值将用作影像图层的默认亮度。 该值不会修改图像的亮度

Default Value:
1.0

staticLSGlobe.ImageryLayer.DEFAULT_CONTRAST : Number

如果在构建过程中或图像提供商未提供此值,则此值将用作影像图层的默认对比度。 该值不会修改图像的对比度

Default Value:
1.0

staticLSGlobe.ImageryLayer.DEFAULT_GAMMA : Number

如果在构建过程中或图像提供者未提供此值,则此值将用作图像层的默认灰度系数。 该值不会修改图像的灰度系数

Default Value:
1.0

staticLSGlobe.ImageryLayer.DEFAULT_HUE : Number

如果在构建过程中或图像提供者未提供此值,则此值将用作图像层的默认色调。 该值不会修改图像的色调

Default Value:
0.0

staticLSGlobe.ImageryLayer.DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter

如果在构建期间或图像提供者没有提供该值,则该值将用作图像层的默认纹理放大过滤器

Default Value:
TextureMagnificationFilter.LINEAR

staticLSGlobe.ImageryLayer.DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter

如果在构建期间或图像提供者没有提供该值,则该值将用作图像层的默认纹理缩小过滤器

Default Value:
TextureMinificationFilter.LINEAR

staticLSGlobe.ImageryLayer.DEFAULT_SATURATION : Number

如果在构建过程中或图像提供者未提供此值,则此值将用作图像层的默认饱和度。 该值不会修改图像的饱和度

Default Value:
1.0

staticLSGlobe.ImageryLayer.DEFAULT_SPLIT : ImagerySplitDirection

如果在构建过程中或图像提供者未提供此值,则此值将用作图像层的默认Spliat

Default Value:
ImagerySplitDirection.NONE

alpha : Number

图层透明度值,取值范围为0.0~1.0。0.0表示完全透明;1.0表示完全不透明

Default Value:
1.0

brightness : Number

图层亮度值。值为1.0表示使用原图;值大于1.0时图像将变亮;值小于1.0时图像将变暗

Default Value:
ImageryLayer.DEFAULT_BRIGHTNESS

contrast : Number

图层对比度。值为1.0表示使用原图;值大于1.0表示增加对比度;值小于1.0表示降低对比度

Default Value:
ImageryLayer.DEFAULT_CONTRAST

gamma : Number

图层伽马校正。值为1.0表示使用原图

Default Value:
ImageryLayer.DEFAULT_GAMMA

hue : Number

图层色调。值为0.0表示使用原图

Default Value:
ImageryLayer.DEFAULT_HUE

readonlyimageryProvider : ImageryProvider

获取此图层的图像提供者

magnificationFilter : TextureMagnificationFilter

TextureMagnificationFilter应用于此图层。可能的值是TextureMagnificationFilter.LINEAR (the default)和 TextureMagnificationFilter.NEAREST.这个属性必须在添加图层之后立即设置才能生效,否则,一旦加载了纹理,就不能更改所使用的纹理过滤器

Default Value:
ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

minificationFilter : TextureMinificationFilter

TextureMinificationFilter应用于此图层。可能的值是TextureMinificationFilter.LINEAR (the default)和 TextureMinificationFilter.NEAREST.这个属性必须在添加图层之后立即设置才能生效,否则,一旦加载了纹理,就不能更改所使用的纹理过滤器

Default Value:
ImageryLayer.DEFAULT_MINIFICATION_FILTER

readonlyrectangle : Rectangle

获取此图层的矩形。如果此矩形小于ImageryProvider的矩形,则只显示图像提供者的一部分

saturation : Number

图层饱和度。值为1.0表示使用原图;值大于1.0表示增加饱和度;值小于1.0表示降低饱和度

Default Value:
ImageryLayer.DEFAULT_SATURATION

show : Boolean

指定当前图层是否显示

Default Value:
true

splitDirection : ImagerySplitDirection

指定影像图层分割方向ImagerySplitDirection,可控制影像图层仅在分割条的左边或右边区域显示

Default Value:
ImageryLayer.DEFAULT_SPLIT

Methods

destroy() → undefined

销毁这个对象所持有的WebGL资源。销毁一个对象允许WebGl资源确定性释放,而不是依赖垃圾收集器来销毁这个对象

一旦对象被销毁,就不应该再使用它。调用isDestroyed以外的任何函数都会导致 DeveloperError异常。因此,将返回值(undefined) 赋给对象,如示例所示。

Returns:
Throws:
  • DeveloperError
    : 这个对象被销毁了,也就是说,调用了destroy()

Example:
imageryLayer = imageryLayer && imageryLayer.destroy();
See:

getViewableRectangle() → Promise.<Rectangle>

获取图层的可见范围

Returns:

矩形对象,表示图层可见范围

Example:
// 放大到imageryLayer图层.imageryLayer.getViewableRectangle().then(function (rectangle) {    return camera.flyTo({        destination: rectangle    });});

isBaseLayer() → Boolean

判断该图层是否为影像图层集合ImageryLayerCollection中的基础图层。 基础图层是特殊的,它被视为具有全局矩形。

Returns:

true表示为基础图层; false则为非基础图层

isDestroyed() → Boolean

返回是否释放对象占用的资源

If this object was destroyed, it should not be used; calling any function other thanisDestroyed will result in a DeveloperError exception.

Returns:

如果资源被释放返回true,否则返回false

See: