WMS

Used to display WMS services as tile layers on the globe.

Constructor

new WMS(name, options, extra)

Parameters:
NameTypeDescription
namestring

Layer name.

optionsObject

Options:

Properties
NameTypeAttributesDefaultDescription
opacitynumber<optional>
1.0

Layer opacity.

minZoomnumber<optional>
0

Minimal visibility zoom level.

maxZoomnumber<optional>
0

Maximal visibility zoom level.

attributionstring<optional>

Layer attribution shown in the attribution area.

isBaseLayerboolean<optional>
false

Base layer flag.

visibilityboolean<optional>
true

Layer visibility.

urlstring

WMS url source.

widthnumber<optional>
256

Tile width.

heightnumber<optional>
256

Tile height.

layersstring

WMS layers string.

versionstring<optional>
"1.1.1"

WMS version.

extraObject

Extra parameters (by WMS reference or by WMS service vendors) to pass to WMS service.

Extends

Members

_id

Overrides

(protected) _pickingColor :Vec3

Layer picking color. Assign when added to the planet.

Type:

imageHeight :number

WMS tile height.

Type:
  • number

imageWidth :number

WMS tile width.

Type:
  • number

isIdle

Overrides

planet

Returns planet instance.

Overrides

Methods

(abstract, protected) _assignPlanet(planet)

Assign the planet.

Parameters:
NameTypeDescription
planetPlanet

Planet render node.

(abstract, protected) _bindPicking()

Assign picking color to the layer.

(protected) _correctFullExtent()

(abstract, protected) _createUrl(segment) → {string}

Creates query url.

Parameters:
NameTypeDescription
segmentSegment

Creates specific url for current segment.

Returns:

URL string.

Type: 
string

(protected) _getHTTPRequestString(segment) → {string}

Returns actual url query string.

Parameters:
NameTypeDescription
segmentSegment

Segment that loads image data.

Returns:

URL string.

Type: 
string

abortLoading()

Abort loading tiles.

addTo(planet)

Adds layer to the planet.

Parameters:
NameTypeDescription
planetPlanet

Adds layer to the planet.

Overrides

bringToFront()

Sets z-index to the maximum value relative to other layers on the planet.

(abstract) clear()

Clears layer material.

Overrides

flyExtent()

Fly extent.

Overrides

getAttribution() → {string}

Gets layer attribution.

Returns:

Layer attribution.

Type: 
string

getExtent() → {Extent}

Gets layer extent.

Overrides
Returns:

Layer geodetic extent.

Type: 
Extent

getExtentMerc() → {Extent}

Gets layer web-mercator extent.

Returns:

Layer extent.

Type: 
Extent

getHeight() → {number}

Gets layer height.

Overrides
Returns:
Type: 
number

getID() → {number}

Gets layer identifier.

Overrides
Returns:

Layer object id.

Type: 
number

getVisibility() → {boolean}

Gets layer visibility.

Returns:

Layer visibility.

Type: 
boolean

getZIndex() → {number}

Gets z-index.

Overrides
Returns:
Type: 
number

(abstract) hasImageryTiles() → {boolean}

Returns true if a layer has imagery tiles.

Returns:

Imagery tiles flag.

Type: 
boolean

isBaseLayer() → {boolean}

Returns true if the layer is a base.

Returns:

Base layer flag.

Type: 
boolean

isEqual(layer) → {boolean}

Compares layers instances.

Parameters:
NameTypeDescription
layerLayer

Layer instance to compare.

Overrides
Returns:

Returns true if the layer is the same instance as the input.

Type: 
boolean

(abstract) loadMaterial(material, forceLoadingopt)

Start to load tile material.

Parameters:
NameTypeAttributesDefaultDescription
materialMaterial

Loads current material.

forceLoadingboolean<optional>
false

remove() → {Layer}

Removes from planet.

Overrides
Returns:

This layer.

Type: 
Layer

setAttribution(html)

Sets layer attribution text.

Parameters:
NameTypeDescription
htmlstring

HTML string that represents layer attribution.

setBaseLayer(isBaseLayer)

Sets base layer type true.

Parameters:
NameTypeDescription
isBaseLayerboolean

setExtent(extent)

Sets visible geographical extent.

Parameters:
NameTypeDescription
extentExtent

Layer visible geographical extent.

Overrides

setHeight(height)

Sets height over the ground.

Parameters:
NameTypeDescription
heightnumber

Layer height.

Overrides

setUrl(url)

Sets imagery tiles url source template.

Parameters:
NameTypeDescription
urlstring

Url template.

Overrides
Example
http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
where {z}, {x} and {y} - replaces by current tile values, {s} - random domain.

setUrlRewriteCallback(ur)

Sets url rewrite callback, used for custom url rewriting for every tile loading.

Parameters:
NameTypeDescription
urfunction

The callback that returns tile custom created url.

setVisibility(visibility)

Sets layer visibility.

Parameters:
NameTypeDescription
visibilityboolean

Layer visibility.

setZIndex(zIndex)

Sets z-index.

Parameters:
NameTypeDescription
zIndexnumber

Layer z-index.

Overrides

viewExtent()

View extent.