# MapGISGeojsonLayer

#### new Cesium.MapGISGeojsonLayer(imageryProvider, options)
MapGIS/Geojson/MapGISGeojsonLayer.js 136

An imagery layer that displays tiled image data from a single imagery provider on a `Globe`.

Name | Type | Description
--- | --- | ---
`imageryProvider` | ImageryProvider | The imagery provider to use.

`options`

Object

optional Object with the following properties:

Name | Type | Default | Description
--- | --- | --- | ---
`rectangle` | Rectangle | `imageryProvider.rectangle` | optional The rectangle of the layer. This rectangle can limit the visible portion of the imagery provider.

`alpha`

Number | function

`1.0`

optional The alpha blending value of this layer, from 0.0 to 1.0. This can either be a simple number or a function with the signature `function(frameState, layer, x, y, level)`. The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the alpha is required, and it is expected to return the alpha value to use for the tile.

`nightAlpha`

Number | function

`1.0`

optional The alpha blending value of this layer on the night side of the globe, from 0.0 to 1.0. This can either be a simple number or a function with the signature `function(frameState, layer, x, y, level)`. The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the alpha is required, and it is expected to return the alpha value to use for the tile. This only takes effect when `enableLighting` is `true`.

`dayAlpha`

Number | function

`1.0`

optional The alpha blending value of this layer on the day side of the globe, from 0.0 to 1.0. This can either be a simple number or a function with the signature `function(frameState, layer, x, y, level)`. The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the alpha is required, and it is expected to return the alpha value to use for the tile. This only takes effect when `enableLighting` is `true`.

`brightness`

Number | function

`1.0`

optional The brightness of this layer. 1.0 uses the unmodified imagery color. Less than 1.0 makes the imagery darker while greater than 1.0 makes it brighter. This can either be a simple number or a function with the signature `function(frameState, layer, x, y, level)`. The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the brightness is required, and it is expected to return the brightness value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.

`contrast`

Number | function

`1.0`

optional The contrast of this layer. 1.0 uses the unmodified imagery color. Less than 1.0 reduces the contrast while greater than 1.0 increases it. This can either be a simple number or a function with the signature `function(frameState, layer, x, y, level)`. The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the contrast is required, and it is expected to return the contrast value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.

`hue`

Number | function

`0.0`

optional The hue of this layer. 0.0 uses the unmodified imagery color. This can either be a simple number or a function with the signature `function(frameState, layer, x, y, level)`. The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the hue is required, and it is expected to return the contrast value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.

`saturation`

Number | function

`1.0`

optional The saturation of this layer. 1.0 uses the unmodified imagery color. Less than 1.0 reduces the saturation while greater than 1.0 increases it. This can either be a simple number or a function with the signature `function(frameState, layer, x, y, level)`. The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the saturation is required, and it is expected to return the contrast value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.

`gamma`

Number | function

`1.0`

optional The gamma correction to apply to this layer. 1.0 uses the unmodified imagery color. This can either be a simple number or a function with the signature `function(frameState, layer, x, y, level)`. The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the gamma is required, and it is expected to return the gamma value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.

`splitDirection` | ImagerySplitDirection | function | `ImagerySplitDirection.NONE` | optional The `ImagerySplitDirection` split to apply to this layer.
`minificationFilter` | TextureMinificationFilter | `TextureMinificationFilter.LINEAR` | optional The texture minification filter to apply to this layer. Possible values are `TextureMinificationFilter.LINEAR` and `TextureMinificationFilter.NEAREST`.
`magnificationFilter` | TextureMagnificationFilter | `TextureMagnificationFilter.LINEAR` | optional The texture minification filter to apply to this layer. Possible values are `TextureMagnificationFilter.LINEAR` and `TextureMagnificationFilter.NEAREST`.
`show` | Boolean | `true` | optional True if the layer is shown; otherwise, false.
`maximumAnisotropy` | Number | `maximum supported` | optional The maximum anisotropy level to use for texture filtering. If this parameter is not specified, the maximum anisotropy supported by the WebGL stack will be used. Larger values make the imagery look better in horizon views.
`minimumTerrainLevel` | Number |  | optional The minimum terrain level-of-detail at which to show this imagery layer, or undefined to show it at all levels. Level zero is the least-detailed level.
`maximumTerrainLevel` | Number |  | optional The maximum terrain level-of-detail at which to show this imagery layer, or undefined to show it at all levels. Level zero is the least-detailed level.
`cutoutRectangle` | Rectangle |  | optional Cartographic rectangle for cutting out a portion of this MapGISGeojsonLayer.
`colorToAlpha` | Color |  | optional Color to be used as alpha.
`colorToAlphaThreshold` | Number | `0.004` | optional Threshold for color-to-alpha.

### Members

#### static Cesium.MapGISGeojsonLayer.DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 474

This value is used as the default threshold for color-to-alpha if one is not provided during construction or by the imagery provider.

Default Value: `0.004`

#### static Cesium.MapGISGeojsonLayer.DEFAULT_BRIGHTNESS : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 414

This value is used as the default brightness for the imagery layer if one is not provided during construction or by the imagery provider. This value does not modify the brightness of the imagery.

Default Value: `1.0`

#### static Cesium.MapGISGeojsonLayer.DEFAULT_CONTRAST : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 421

This value is used as the default contrast for the imagery layer if one is not provided during construction or by the imagery provider. This value does not modify the contrast of the imagery.

Default Value: `1.0`

#### static Cesium.MapGISGeojsonLayer.DEFAULT_GAMMA : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 442

This value is used as the default gamma for the imagery layer if one is not provided during construction or by the imagery provider. This value does not modify the gamma of the imagery.

Default Value: `1.0`

#### static Cesium.MapGISGeojsonLayer.DEFAULT_HUE : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 428

This value is used as the default hue for the imagery layer if one is not provided during construction or by the imagery provider. This value does not modify the hue of the imagery.

Default Value: `0.0`

#### static Cesium.MapGISGeojsonLayer.DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter
MapGIS/Geojson/MapGISGeojsonLayer.js 466

This value is used as the default texture magnification filter for the imagery layer if one is not provided during construction or by the imagery provider.

Default Value: `TextureMagnificationFilter.LINEAR`

#### static Cesium.MapGISGeojsonLayer.DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter
MapGIS/Geojson/MapGISGeojsonLayer.js 458

This value is used as the default texture minification filter for the imagery layer if one is not provided during construction or by the imagery provider.

Default Value: `TextureMinificationFilter.LINEAR`

#### static Cesium.MapGISGeojsonLayer.DEFAULT_SATURATION : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 435

This value is used as the default saturation for the imagery layer if one is not provided during construction or by the imagery provider. This value does not modify the saturation of the imagery.

Default Value: `1.0`

#### static Cesium.MapGISGeojsonLayer.DEFAULT_SPLIT : ImagerySplitDirection
MapGIS/Geojson/MapGISGeojsonLayer.js 450

This value is used as the default split for the imagery layer if one is not provided during construction or by the imagery provider.

Default Value: `ImagerySplitDirection.NONE`

#### alpha : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 148

The alpha blending value of this layer, with 0.0 representing fully transparent and 1.0 representing fully opaque.

Default Value: `1.0`

#### brightness : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 175

The brightness of this layer. 1.0 uses the unmodified imagery color. Less than 1.0 makes the imagery darker while greater than 1.0 makes it brighter.

Default Value: ``MapGISGeojsonLayer.DEFAULT_BRIGHTNESS``

#### colorToAlpha : Color
MapGIS/Geojson/MapGISGeojsonLayer.js 288

Color value that should be set to transparent.

#### colorToAlphaThreshold : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 295

Normalized (0-1) threshold for color-to-alpha.

#### contrast : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 184

The contrast of this layer. 1.0 uses the unmodified imagery color. Less than 1.0 reduces the contrast while greater than 1.0 increases it.

Default Value: ``MapGISGeojsonLayer.DEFAULT_CONTRAST``

#### cutoutRectangle : Rectangle
MapGIS/Geojson/MapGISGeojsonLayer.js 281

Rectangle cutout in this layer of imagery.

#### dayAlpha : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 166

The alpha blending value of this layer on the day side of the globe, with 0.0 representing fully transparent and 1.0 representing fully opaque. This only takes effect when `Globe#enableLighting` is `true`.

Default Value: `1.0`

#### gamma : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 209

The gamma correction to apply to this layer. 1.0 uses the unmodified imagery color.

Default Value: ``MapGISGeojsonLayer.DEFAULT_GAMMA``

#### hue : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 192

The hue of this layer in radians. 0.0 uses the unmodified imagery color.

Default Value: ``MapGISGeojsonLayer.DEFAULT_HUE``

#### readonly imageryProvider : ImageryProvider
MapGIS/Geojson/MapGISGeojsonLayer.js 351

Gets the imagery provider for this layer.

#### magnificationFilter : TextureMagnificationFilter
MapGIS/Geojson/MapGISGeojsonLayer.js 243

The `TextureMagnificationFilter` to apply to this layer. Possible values are `TextureMagnificationFilter.LINEAR` (the default) and `TextureMagnificationFilter.NEAREST`. To take effect, this property must be set immediately after adding the imagery layer. Once a texture is loaded it won't be possible to change the texture filter used.

Default Value: ``MapGISGeojsonLayer.DEFAULT_MAGNIFICATION_FILTER``

#### minificationFilter : TextureMinificationFilter
MapGIS/Geojson/MapGISGeojsonLayer.js 230

The `TextureMinificationFilter` to apply to this layer. Possible values are `TextureMinificationFilter.LINEAR` (the default) and `TextureMinificationFilter.NEAREST`. To take effect, this property must be set immediately after adding the imagery layer. Once a texture is loaded it won't be possible to change the texture filter used.

Default Value: ``MapGISGeojsonLayer.DEFAULT_MINIFICATION_FILTER``

#### nightAlpha : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 157

The alpha blending value of this layer on the night side of the globe, with 0.0 representing fully transparent and 1.0 representing fully opaque. This only takes effect when `Globe#enableLighting` is `true`.

Default Value: `1.0`

#### readonly rectangle : Rectangle
MapGIS/Geojson/MapGISGeojsonLayer.js 364

Gets the rectangle of this layer. If this rectangle is smaller than the rectangle of the `ImageryProvider`, only a portion of the imagery provider is shown.

#### saturation : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 201

The saturation of this layer. 1.0 uses the unmodified imagery color. Less than 1.0 reduces the saturation while greater than 1.0 increases it.

Default Value: ``MapGISGeojsonLayer.DEFAULT_SATURATION``

#### show : Boolean
MapGIS/Geojson/MapGISGeojsonLayer.js 251

Determines if this layer is shown.

Default Value: `true`

#### splitDirection : ImagerySplitDirection
MapGIS/Geojson/MapGISGeojsonLayer.js 217

The `ImagerySplitDirection` to apply to this layer.

Default Value: ``MapGISGeojsonLayer.DEFAULT_SPLIT``

#### translucency : Number
MapGIS/Geojson/MapGISGeojsonLayer.js 391

透明度属性

### Methods

#### destroy()
MapGIS/Geojson/MapGISGeojsonLayer.js 519

Destroys the WebGL resources held by this object. Destroying an object allows for deterministic release of WebGL resources, instead of relying on the garbage collector to destroy this object.
Once an object is destroyed, it should not be used; calling any function other than `isDestroyed` will result in a `DeveloperError` exception. Therefore, assign the return value (`undefined`) to the object as done in the example.

##### Throws:

- DeveloperError : This object was destroyed, i.e., destroy() was called.

##### Example:

    MapGISGeojsonLayer = MapGISGeojsonLayer && MapGISGeojsonLayer.destroy();

##### See:

- MapGISGeojsonLayer#isDestroyed

#### getAllFeatures()
MapGIS/Geojson/MapGISGeojsonLayer.js 902

获取该图层所有原始矢量数据

##### Example:

    var MapGISGeojsonLayer=Cesium.viewer.imageryLayers.addVectorProvider(new MapGISVectorProvider(options));
           MapGISGeojsonLayer.getAllFeatures().then(function(data){
               doSomething(data);
           })

#### getVectorById(id) → object|undefined
MapGIS/Geojson/MapGISGeojsonLayer.js 930

根据id获取绘制矢量数据的相关对象

Name | Type | Description
--- | --- | ---
`id` | Number | 矢量数据的id

##### Returns:

由一个GeometryInstance和一个Primitive组成的对象，若查找不到则返回undefined

##### Example:

    var mapGisVectorLayer = webGlobe.appendMapGISVectorLayer('http://localhost:6163/igs/rest/mrms/docs/二维矢量',options);
    var vectorObject = VectorLayers[2].getVectorById(192);
    var vectorPrimitive = vectorObject.primitive;
    var vectorGeometryInstance = vectorObject.geometryInstance;

#### getVectorOutlineById(id) → object
MapGIS/Geojson/MapGISGeojsonLayer.js 976

根据id获取绘制矢量数据边框线的GeometryInstance与所属的Primitive

Name | Type | Description
--- | --- | ---
`id` | Number | 矢量数据的id

##### Returns:

由一个GeometryInstance和一个Primitive组成的对象，若查找不到则返回undefined

##### Example:

    var mapGisVectorLayer = webGlobe.appendMapGISVectorLayer('http://localhost:6163/igs/rest/mrms/docs/二维矢量',options);
    var vectorOutlineObject = VectorLayers[2].getVectorOutlineById(192);
    var vectorOutlinePrimitive = vectorObject.primitive;
    var vectorOutlineGeometryInstance = vectorObject.geometryInstance;

#### getViewableRectangle() → Promise.<Rectangle>
MapGIS/Geojson/MapGISGeojsonLayer.js 542

Computes the intersection of this layer's rectangle with the imagery provider's availability rectangle, producing the overall bounds of imagery that can be produced by this layer.

##### Returns:

A promise to a rectangle which defines the overall bounds of imagery that can be produced by this layer.

##### Example:

    // Zoom to an imagery layer.
    MapGISGeojsonLayer.getViewableRectangle().then(function (rectangle) {
        return camera.flyTo({
            destination: rectangle
        });
    });

#### isBaseLayer() → Boolean
MapGIS/Geojson/MapGISGeojsonLayer.js 485

Gets a value indicating whether this layer is the base layer in the `ImageryLayerCollection`. The base layer is the one that underlies all others. It is special in that it is treated as if it has global rectangle, even if it actually does not, by stretching the texels at the edges over the entire globe.

##### Returns:

true if this is the base layer; otherwise, false.

#### isDestroyed() → Boolean
MapGIS/Geojson/MapGISGeojsonLayer.js 499

Returns true if this object was destroyed; otherwise, false.
If this object was destroyed, it should not be used; calling any function other than `isDestroyed` will result in a `DeveloperError` exception.

##### Returns:

True if this object was destroyed; otherwise, false.

##### See:

- MapGISGeojsonLayer#destroy

#### updatePrimitive(primitive)
MapGIS/Geojson/MapGISGeojsonLayer.js 998

更新发生更改的Primitive，供updateVectorById，removeVectorById使用

Name | Type | Description
--- | --- | ---
`primitive` | Primitive | 进行更新的Primitive