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 that displayed in the attribution area on the screen.

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:
  • 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()

Set zIndex to the maximal value depend on 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() → {string}

Gets layer identifier.

Overrides
Returns:
  • Layer object id.
Type: 
string

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 layers is the same instance of 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 code that represents layer attribution, it could be just a text.

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.