Class ColorLayer<UserData>

A layer that produces color images, such as vector data, or satellite imagery.

Index

Constructors

constructor

Accessors

brightness colorimetry composer contrast elevationRange loading opacity progress ready saturation visible

Constructors

constructor

new ColorLayer<UserData>(options): ColorLayer<UserData>
Creates a color layer. See the example for more information on layer creation.
Type Parameters
- UserData extends LayerUserData = LayerUserData
Parameters
- options: ColorLayerOptions
  
  The layer options.
Returns ColorLayer<UserData>
Overrides Layer.constructor
- Defined in core/layer/ColorLayer.ts:72

Properties

`Private` _colorimetry

_colorimetry: ColorimetryOptions = ...

`Protected` _composer

_composer: LayerComposer

`Private` _elevationRange

_elevationRange: ElevationRange

`Private` _opacity

_opacity: number

`Protected` `Readonly` _queue

_queue: RequestQueue

backgroundColor

backgroundColor: Color

`Readonly` colorMap

colorMap: ColorMap

The colormap of this layer

`Readonly` computeMinMax

computeMinMax: boolean

disposed

disposed: boolean

`Readonly` extent

extent: Extent

The extent of this layer

frozen

frozen: boolean = false

Disables automatic updates of this layer. Useful for debugging purposes.

`Readonly` id

id: string

The unique identifier of this layer.

`Readonly` interpretation

interpretation: Interpretation

`Readonly` isColorLayer

isColorLayer: boolean = true

Read-only flag to check if a given object is of type ColorLayer.

`Readonly` isLayer

isLayer: boolean = true

Read-only flag to check if a given object is of type Layer.

`Readonly` isPickableFeatures

isPickableFeatures: true = true

`Readonly` name

name: string

Optional name of this layer.

`Readonly` noDataOptions

noDataOptions: NoDataOptions

`Readonly` resolutionFactor

resolutionFactor: number

The resolution factor applied to the textures generated by this layer.

`Readonly` showTileBorders

showTileBorders: boolean

`Readonly` source

source: ImageSource

The source of this layer

type

type: string

`Readonly` userData

userData: UserData

An object that can be used to store custom data about the Layer.

Accessors

brightness

get brightness(): number
Gets or sets the brightness of this layer.

Returns number
- Defined in core/layer/ColorLayer.ts:118
set brightness(v): void
Parameters
- v: number
Returns void
- Defined in core/layer/ColorLayer.ts:122

colorimetry

get colorimetry(): ColorimetryOptions
Gets the colorimetry parameters of this layer.

Returns ColorimetryOptions
- Defined in core/layer/ColorLayer.ts:111

composer

get composer(): Readonly<LayerComposer>
Returns Readonly<LayerComposer>
Inherited from Layer.composer
- Defined in core/layer/Layer.ts:1088

contrast

get contrast(): number
Gets or sets the contrast of this layer.

Returns number
- Defined in core/layer/ColorLayer.ts:132
set contrast(v): void
Parameters
- v: number
Returns void
- Defined in core/layer/ColorLayer.ts:136

elevationRange

get elevationRange(): ElevationRange
Gets the elevation range of this layer, if any.

Returns ElevationRange
- Defined in core/layer/ColorLayer.ts:82
set elevationRange(range): void
Sets the elevation range of this layer. Setting it to null removes the elevation range.
Parameters
- range: ElevationRange
Returns void
- Defined in core/layer/ColorLayer.ts:89

loading

get loading(): boolean
Gets whether the object is currently performing an asynchronous operation.

Returns boolean
Inherited from Layer.loading
- Defined in core/layer/Layer.ts:444

opacity

get opacity(): number
Gets or sets the opacity of this layer.

Returns number
- Defined in core/layer/ColorLayer.ts:97
set opacity(v): void
Parameters
- v: number
Returns void
- Defined in core/layer/ColorLayer.ts:101

progress

get progress(): number
Returns the percentage of progress, in normalized value (i.e in the [0, 1] range), of the asynchronous operations that are scheduled to run on this object. 1 means that all operations have finished.

Returns number
Inherited from Layer.progress
- Defined in core/layer/Layer.ts:448

ready

get ready(): boolean
Returns boolean
Inherited from Layer.ready
- Defined in core/layer/Layer.ts:336

saturation

get saturation(): number
Gets or sets the saturation of this layer.

Returns number
- Defined in core/layer/ColorLayer.ts:146
set saturation(v): void
Parameters
- v: number
Returns void
- Defined in core/layer/ColorLayer.ts:150

visible

get visible(): boolean
Gets or sets the visibility of this layer.

Returns boolean
Inherited from Layer.visible
- Defined in core/layer/Layer.ts:433
set visible(v): void
Parameters
- v: boolean
Returns void
Inherited from Layer.visible
- Defined in core/layer/Layer.ts:437

Methods

addEventListener

addEventListener<T>(type, listener): void
Adds a listener to an event type.
Type Parameters
- T extends keyof ColorLayerEvents
Parameters
- type: T
  
  The type of event to listen to.
- listener: EventListener<(ColorLayerEvents & LayerEvents)[T], T, ColorLayer<UserData>>
  
  The function that gets called when the event is fired.
Returns void
Inherited from Layer.addEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:52
addEventListener<T>(type, listener): void
Type Parameters
- T extends string
Parameters
- type: T
- listener: EventListener<{}, T, ColorLayer<UserData>>
Returns void
Inherited from Layer.addEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:56

`Protected` adjustExtent

adjustExtent(extent): Extent
Parameters
- extent: Extent
Returns Extent
Inherited from Layer.adjustExtent
- Defined in core/layer/Layer.ts:725

`Protected` adjustExtentAndPixelSize

adjustExtentAndPixelSize(originalExtent, originalWidth, originalHeight): {
    extent: Extent;
    height: number;
    width: number;
}
Adjusts the extent to avoid visual artifacts.
Parameters
- originalExtent: Extent
  
  The original extent.
- originalWidth: number
  
  The width, in pixels, of the original extent.
- originalHeight: number
  
  The height, in pixels, of the original extent.
Returns {
    extent: Extent;
    height: number;
    width: number;
}
And object containing the adjusted extent, as well as adjusted pixel size.
- extent: Extent
- height: number
- width: number
Inherited from Layer.adjustExtentAndPixelSize
- Defined in core/layer/Layer.ts:738

`Protected` applyDefaultTexture

applyDefaultTexture(target): void
Parameters
- target: Target
  
  The target.
Returns void
Inherited from Layer.applyDefaultTexture
- Defined in core/layer/Layer.ts:813

`Protected` applyEmptyTextureToNode

applyEmptyTextureToNode(node): void
Parameters
- node: Node
Returns void
Overrides Layer.applyEmptyTextureToNode
- Defined in core/layer/ColorLayer.ts:210

`Protected` applyTextureToNode

applyTextureToNode(result, node): void
Parameters
- result: TextureAndPitch
- node: Node
Returns void
Overrides Layer.applyTextureToNode
- Defined in core/layer/ColorLayer.ts:206

`Protected` canFetchImages

canFetchImages(target): boolean
Parameters
- target: Target
Returns boolean
Overrides Layer.canFetchImages
- Defined in core/layer/ColorLayer.ts:188

clear

clear(): void
Resets all render targets to a blank state and repaint all the targets.

Returns void
Inherited from Layer.clear
- Defined in core/layer/Layer.ts:413

contains

contains(extent): boolean
Parameters
- extent: Extent
  
  The extent to test.
Returns boolean
true if this layer contains the specified extent, false otherwise.
Inherited from Layer.contains
- Defined in core/layer/Layer.ts:1022

dispatchEvent

dispatchEvent<T>(event): void
Fire an event type.
Type Parameters
- T extends keyof ColorLayerEvents
Parameters
- event: BaseEvent<T> & (ColorLayerEvents & LayerEvents)[T]
  
  The event that gets fired.
Returns void
Inherited from Layer.dispatchEvent
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:84

dispose

dispose(): void
Disposes the layer. This releases all resources held by this layer.

Returns void
Inherited from Layer.dispose
- Defined in core/layer/Layer.ts:1110

getExtent

getExtent(): Extent
Returns the final extent of this layer. If this layer has its own extent defined, this will be used. Otherwise, will return the source extent (if any). May return undefined if not pre-processed yet.

Returns Extent
The layer final extent.
Inherited from Layer.getExtent
- Defined in core/layer/Layer.ts:534

getRenderTargetDataType

getRenderTargetDataType(): TextureDataType
Returns TextureDataType
Overrides Layer.getRenderTargetDataType
- Defined in core/layer/ColorLayer.ts:172

getRenderTargetPixelFormat

getRenderTargetPixelFormat(): PixelFormat
Returns PixelFormat
Overrides Layer.getRenderTargetPixelFormat
- Defined in core/layer/ColorLayer.ts:183

getVectorFeaturesAtCoordinate

getVectorFeaturesAtCoordinate(coordinate, options?): Feature<Geometry>[]
Returns all features at some coordinates, with an optional hit tolerance radius.
Parameters
- coordinate: Coordinates
  
  Coordinates
- Optional options: {
      radius?: number;
      xTileRes?: number;
      yTileRes?: number;
  }
  
  Options
  - Optional radius?: number
    
    Radius in pixels. Pixels inside the radius around the given coordinates will be checked for features.
  - Optional xTileRes?: number
    
    Tile resolution (m/px) - only required if radius is greater than 0
  - Optional yTileRes?: number
    
    Tile resolution (m/px) - only required if radius is greater than 0
Returns Feature<Geometry>[]
Array of features at coordinates (can be empty)
- Defined in core/layer/ColorLayer.ts:241

getVectorFeaturesInExtent

getVectorFeaturesInExtent(extent): Feature<Geometry>[]
Get all features whose bounding box intersects the provided extent. Note that this returns an array of all features intersecting the given extent in random order (so it may include features whose geometries do not intersect the extent).
Parameters
- extent: Extent
  
  Extent
Returns Feature<Geometry>[]
Array of features intersecting the extent (can be empty)
- Defined in core/layer/ColorLayer.ts:321

hasEventListener

hasEventListener<T>(type, listener): boolean
Checks if listener is added to an event type.
Type Parameters
- T extends keyof ColorLayerEvents
Parameters
- type: T
  
  The type of event to listen to.
- listener: EventListener<(ColorLayerEvents & LayerEvents)[T], T, ColorLayer<UserData>>
  
  The function that gets called when the event is fired.
Returns boolean
Inherited from Layer.hasEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:63
hasEventListener<T>(type, listener): boolean
Type Parameters
- T extends string
Parameters
- type: T
- listener: EventListener<{}, T, ColorLayer<UserData>>
Returns boolean
Inherited from Layer.hasEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:67

loadFallbackImages

loadFallbackImages(): Promise<void>
Returns Promise<void>
Inherited from Layer.loadFallbackImages
- Defined in core/layer/Layer.ts:595

loadFallbackImagesInternal

loadFallbackImagesInternal(): Promise<void>
Returns Promise<void>
Inherited from Layer.loadFallbackImagesInternal
- Defined in core/layer/Layer.ts:540

`Protected` onInitialized

onInitialized(): Promise<void>
Called when the layer has finished initializing.

Returns Promise<void>
Inherited from Layer.onInitialized
- Defined in core/layer/Layer.ts:612

`Protected` onTextureCreated

onTextureCreated(texture): void
Parameters
- texture: Texture
Returns void
Inherited from Layer.onTextureCreated
- Defined in core/layer/Layer.ts:580

pickFeaturesFrom

pickFeaturesFrom(pickedResult, options?): VectorPickFeature[]
Given a PickResult, returns and assigns its features.

Implementations must set pickedResult.features to the returned result.
Parameters
- pickedResult: MapPickResult<unknown>
  
  Picked result
- Optional options: PickOptions
  
  Options
Returns VectorPickFeature[]
Features
Implementation of PickableFeatures.pickFeaturesFrom
- Defined in core/layer/ColorLayer.ts:214

postUpdate

postUpdate(): void
Returns void
Inherited from Layer.postUpdate
- Defined in core/layer/Layer.ts:1077

registerNode

registerNode(node, extent): void
Parameters
- node: Node
- extent: Extent
Returns void
Overrides Layer.registerNode
- Defined in core/layer/ColorLayer.ts:192

removeEventListener

removeEventListener<T>(type, listener): void
Removes a listener from an event type.
Type Parameters
- T extends keyof ColorLayerEvents
Parameters
- type: T
  
  The type of the listener that gets removed.
- listener: EventListener<(ColorLayerEvents & LayerEvents)[T], T, ColorLayer<UserData>>
  
  The listener function that gets removed.
Returns void
Inherited from Layer.removeEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:74
removeEventListener<T>(type, listener): void
Type Parameters
- T extends string
Parameters
- type: T
- listener: EventListener<{}, T, ColorLayer<UserData>>
Returns void
Inherited from Layer.removeEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:78

unregisterNode

unregisterNode(node): void
Removes the node from this layer.
Parameters
- node: Node
  
  The disposed node.
Returns void
Overrides Layer.unregisterNode
- Defined in core/layer/ColorLayer.ts:196

update

update(context, node): void
Updates the provided node with content from this layer.
Parameters
- context: Context
  
  the context
- node: Node
  
  the node to update
Returns void
Inherited from Layer.update
- Defined in core/layer/Layer.ts:942

`Protected` updateMaterial

updateMaterial(material): void
Parameters
- material: NodeMaterial
Returns void
Overrides Layer.updateMaterial
- Defined in core/layer/ColorLayer.ts:157

Class ColorLayer<UserData>

Type Parameters

UserData extends LayerUserData = LayerUserData

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

UserData extends LayerUserData = LayerUserData

Parameters

options: ColorLayerOptions

Returns ColorLayer<UserData>

Properties

Private _colorimetry

Protected _composer

Private _elevationRange

Private _opacity

Protected Readonly _queue

backgroundColor

Readonly colorMap

Readonly computeMinMax

disposed

Readonly extent

frozen

Readonly id

Readonly interpretation

Readonly isColorLayer

Readonly isLayer

Readonly isPickableFeatures

Readonly name

Readonly noDataOptions

Readonly resolutionFactor

Readonly showTileBorders

Readonly source

type

Readonly userData

Accessors

brightness

Returns number

Parameters

v: number

Returns void

colorimetry

Returns ColorimetryOptions

composer

Returns Readonly<LayerComposer>

contrast

Returns number

Parameters

v: number

Returns void

elevationRange

Returns ElevationRange

Parameters

range: ElevationRange

Returns void

loading

Returns boolean

opacity

Returns number

Parameters

v: number

Returns void

progress

Returns number

ready

Returns boolean

saturation

Returns number

Parameters

v: number

Returns void

visible

Returns boolean

Parameters

`Private` _colorimetry

`Protected` _composer

`Private` _elevationRange

`Private` _opacity

`Protected` `Readonly` _queue

`Readonly` colorMap

`Readonly` computeMinMax

`Readonly` extent

`Readonly` id

`Readonly` interpretation

`Readonly` isColorLayer

`Readonly` isLayer

`Readonly` isPickableFeatures

`Readonly` name

`Readonly` noDataOptions

`Readonly` resolutionFactor

`Readonly` showTileBorders

`Readonly` source

`Readonly` userData

`Protected` adjustExtent

`Protected` adjustExtentAndPixelSize

Returns {
extent: Extent;
height: number;
width: number;
}

`Protected` applyDefaultTexture

`Protected` applyEmptyTextureToNode

`Protected` applyTextureToNode

`Protected` canFetchImages

`Optional` options: {
radius?: number;
xTileRes?: number;
yTileRes?: number;
}