Class ColorMap

Represents a 1D color gradient bounded by a min and max values.

Whenever a color map is associated with a grayscale texture, the color intensity of the texture is used a a parameter to sample the color gradient.

Important: since this color map owns a texture, it is disposable. Don't forget to call dispose() to free texture memory, when you're finished using the colormap.

The mode property describes how the intensity of the pixel is interpreted:

Elevation simply takes the intensity value of the pixel, Slope gets the slope of the pixel (assuming it is an elevation texture), and Aspect gets the aspect (orientation from the north) of the pixel (assuming it is an elevation texture).

The min and max properties describe how the colormap is applied relative to the intensity of the sampled pixel.

Pixel intensities outside of those bounds will take the color of the bound that is the closest (i.e if the intensity is greater than max, the color will be the rightmost color of the color ramp).

The colors property takes an array of colors. To create this array, you can use libraries such as colormap or chroma-js to generate the color ramp.

To obtain a "discrete" color map, you should use a small number of colors in the ramp. Conversely, to obtain a "linear", continuous color map, you should use a high number of colors, typically 256 values.

Example

// Create a color map for elevations between 0 and 2500 meters.
const colors = makeColorRamp(); // Use whatever library to generate the ramp.
const colorMap = new ColorMap(colors, 0, 2500, ColorMapMode.Elevation);

const texture = colorMap.getTexture();

// Disable the color map.
colorMap.active = false;

// When finished with this color map, dispose it.
colorMap.dispose();

Hierarchy (view full)

EventDispatcher<ColorMapEvents>
- ColorMap

Index

Constructors

constructor

new ColorMap(colors, min, max, mode?): ColorMap
Creates an instance of ColorMap.
Parameters
- colors: Color[]
  The colors of this color map.
- min: number
  The lower bound of the color map range.
- max: number
  The upper bound of the color map range.
- mode: ColorMapMode = ColorMapMode.Elevation
  The mode of the color map.
Returns ColorMap
Overrides EventDispatcher.constructor
- Defined in core/layer/ColorMap.ts:77

Accessors

active

get active(): boolean
Enables or disables the color map.

Returns boolean
- Defined in core/layer/ColorMap.ts:127
set active(v): void
Parameters
- v: boolean
Returns void
- Defined in core/layer/ColorMap.ts:131

colors

get colors(): Color[]
Gets or sets the colors of the color map.

Note: if there is already an array defined in the opacity property, and this array does not have the same length as the new color array, then it will be removed.

Returns Color[]
- Defined in core/layer/ColorMap.ts:172
set colors(v): void
Parameters
- v: Color[]
Returns void
- Defined in core/layer/ColorMap.ts:176

max

get max(): number
Gets or sets the upper bound of the color map range.

Returns number
- Defined in core/layer/ColorMap.ts:155
set max(v): void
Parameters
- v: number
Returns void
- Defined in core/layer/ColorMap.ts:159

min

get min(): number
Gets or sets the lower bound of the color map range.

Returns number
- Defined in core/layer/ColorMap.ts:141
set min(v): void
Parameters
- v: number
Returns void
- Defined in core/layer/ColorMap.ts:145

mode

get mode(): ColorMapMode

Gets or sets the color map mode.

Returns ColorMapMode

Example

// Start with an elevation gradient, ranging from 100 to 1500 meters.
const colorMap = new ColorMap(colors, 100, 1500, ColorMapMode.Elevation);

// Change mode to slope, and set min and max to 0-90 degrees.
colorMap.mode = ColorMapMode.Slope;
colorMap.min = 0;
colorMap.max = 90;

set mode(v): void
Parameters
- v: ColorMapMode
Returns void
- Defined in core/layer/ColorMap.ts:113

opacity

get opacity(): null | number[]
Gets or sets the opacity values of the color map.

Note: if the provided array does not have the same length as the colors array, an exception is raised.

Returns null | number[]
Default Value
```
null
```
- Defined in core/layer/ColorMap.ts:196
set opacity(v): void
Parameters
- v: null | number[]
Returns void
- Defined in core/layer/ColorMap.ts:200

Methods

addEventListener

addEventListener<T>(type, listener): void
Adds a listener to an event type.
Type Parameters
- T extends "updated"
Parameters
- type: T
  The type of event to listen to.
- listener: EventListener<ColorMapEvents[T], T, ColorMap>
  The function that gets called when the event is fired.
Returns void
Inherited from EventDispatcher.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, ColorMap>
Returns void
Inherited from EventDispatcher.addEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:56

dispatchEvent

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

dispose

dispose(): void
Disposes the texture owned by this color map.

Returns void
- Defined in core/layer/ColorMap.ts:272

getTexture

getTexture(): DataTexture
Returns a 1D texture containing the colors of this color map.

Returns DataTexture
The resulting texture.
- Defined in core/layer/ColorMap.ts:250

hasEventListener

hasEventListener<T>(type, listener): boolean
Checks if listener is added to an event type.
Type Parameters
- T extends "updated"
Parameters
- type: T
  The type of event to listen to.
- listener: EventListener<ColorMapEvents[T], T, ColorMap>
  The function that gets called when the event is fired.
Returns boolean
Inherited from EventDispatcher.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, ColorMap>
Returns boolean
Inherited from EventDispatcher.hasEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:67

removeEventListener

removeEventListener<T>(type, listener): void
Removes a listener from an event type.
Type Parameters
- T extends "updated"
Parameters
- type: T
  The type of the listener that gets removed.
- listener: EventListener<ColorMapEvents[T], T, ColorMap>
  The listener function that gets removed.
Returns void
Inherited from EventDispatcher.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, ColorMap>
Returns void
Inherited from EventDispatcher.removeEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:78

sample

sample(value): Color
Samples the colormap for the given value.
Parameters
- value: number
  The value to sample.
Returns Color
The color at the specified value.
- Defined in core/layer/ColorMap.ts:216

sampleOpacity

sampleOpacity(value): number
Samples the transparency for the given value.
Parameters
- value: number
  The value to sample.
Returns number
The color at the specified value.
- Defined in core/layer/ColorMap.ts:231

Class ColorMap

Example

Hierarchy (view full)

Index

Constructors

Accessors

Methods

Constructors

constructor

Parameters

Returns ColorMap

Accessors

active

Returns boolean

Parameters

Returns void

colors

Returns Color[]

Parameters

Returns void

max

Returns number

Parameters

Returns void

min

Returns number

Parameters

Returns void

mode

Returns ColorMapMode

Example

Parameters

Returns void

opacity

Returns null | number[]

Default Value

Parameters

Returns void

Methods

addEventListener

Type Parameters

Parameters

Returns void

Type Parameters

Parameters

Returns void

dispatchEvent

Type Parameters

Parameters

Returns void

dispose

Returns void

getTexture

Returns DataTexture

hasEventListener

Type Parameters

Parameters

Returns boolean

Type Parameters

Parameters

Returns boolean

removeEventListener

Type Parameters

Parameters

Returns void

Type Parameters

Parameters

Returns void

sample

Parameters

Returns Color

sampleOpacity

Parameters

Returns number

Settings

On This Page