Last updated

API / geotoolkit / contour / util / ColorMap / ColorMap

Class: ColorMap

util.ColorMap.ColorMap

Define a colormap

Hierarchy

Table of contents

Constructors
Methods
Css Properties
Name Type Description
binsnumberNumber of bins
maxnumber
maxnumberEnd value for the scale
maxvaluenumberThe max value to use
minnumber
minnumberStart value for the scale
minvaluenumberThe min value to use
namestringThe scale name
reversedbooleanBoolean to define the sorting direction
scaleKnownScales
scaleKnownScalesA predefined set of colors

Contents

Constructors

new ColorMap(bins, name, minValue, maxValue)

new ColorMap(bins?, name?, minValue?, maxValue?)

Parameters

Name Type Description
Optional binsnumber | number[] | OptionsThe number of bins or options object
Optional namestringThe scale name.
Optional minValuenumberThe min value to use.
Optional maxValuenumberThe max value to use.

Overrides

DiscreteGradientColorProvider.constructor

Methods

addColor

addColor(value, color): ColorMap

Add color to the collection Compatibility: old JSON format {'value': 0, 'red': 255, 'green': 255, 'blue': 255, 'alpha': 1} is supported, but new parameter list is recommended

Parameters

Name Type Description
valuenumberindex of this color on the colorbar
colorstring | RgbaColorCSS color string or RgbaColor object

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.addColor

addColor(json): ColorMap

Deprecated

Parameters

Name Type
jsonObject
Optional json.alphanumber
Optional json.bluenumber
json.colorstring | RgbaColor
Optional json.greennumber
Optional json.rednumber
json.valuenumber

Returns

ColorMap

Inherited from

DiscreteGradientColorProvider.addColor


clone

clone(): ColorProvider

Returns clone of color provider

Returns

ColorProvider

Inherited from

DiscreteGradientColorProvider.clone


copyConstructor

Protected copyConstructor(src): ColorMap

Copy constructor

Parameters

Name Type Description
srcColorProviderSource to copy from

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.copyConstructor


dispose

dispose(): void

Dispose.

Returns

void

Inherited from

DiscreteGradientColorProvider.dispose


exportToImage

exportToImage(width, height, isVertical, surface?): Surface

returns surface that represents color map

Parameters

Name Type Description
widthnumberThe image width
heightnumberThe image height
isVerticalbooleanTrue if image is oriented vertically
Optional surfaceSurfaceoutput surface

Returns

Surface

surface The canvas surface

Inherited from

DiscreteGradientColorProvider.exportToImage


getClassName

getClassName(): string

Returns

string

Inherited from

DiscreteGradientColorProvider.getClassName


getColor

getColor(value): RgbaColor

Return color for the current value

Parameters

Name Type Description
valuenumbervalue

Returns

RgbaColor

color

Inherited from

DiscreteGradientColorProvider.getColor


getColorNumber

getColorNumber(): number

Returns how many colors can be provided

Returns

number

Inherited from

DiscreteGradientColorProvider.getColorNumber


getColors

getColors(): RgbaColor[]

Returns

RgbaColor[]

an array of the colors

Inherited from

DiscreteGradientColorProvider.getColors


getColorsProperties

Protected getColorsProperties(): ColorsOptions

Returns colors and values to be serialized

Returns

ColorsOptions

colors and values

Inherited from

DiscreteGradientColorProvider.getColorsProperties


getDataMaxValue

Protected getDataMaxValue(): number

Returns the maximum data value set in this collection

Returns

number

Inherited from

DiscreteGradientColorProvider.getDataMaxValue


getDataMinValue

Protected getDataMinValue(): number

Returns the minimum data value set in this collection

Returns

number

Inherited from

DiscreteGradientColorProvider.getDataMinValue


getMaxValue

getMaxValue(): number

Returns the maximum value set in this collection

Returns

number

Inherited from

DiscreteGradientColorProvider.getMaxValue


getMinValue

getMinValue(): number

Returns minimum value set in the collection

Returns

number

Inherited from

DiscreteGradientColorProvider.getMinValue


getNamedColor

getNamedColor(colorName): string | NamedColorValue

Returns known color value

Parameters

Name Type Description
colorNamestringcolor name, if not specified then returns list of known colors

Returns

string | NamedColorValue

color

Inherited from

DiscreteGradientColorProvider.getNamedColor


getNamedColors

getNamedColors(): NamedColor[]

Returns known colors

Returns

NamedColor[]

array of color pair

Inherited from

DiscreteGradientColorProvider.getNamedColors


getProperties

getProperties(): OptionsOut

get properties of the object

Returns

OptionsOut

color provider properties

Overrides

DiscreteGradientColorProvider.getProperties


getRaster

getRaster(xMin?, yMin?, xMax?, yMax?): Raster

Returns a new instance of Raster

Parameters

Name Type Description
Optional xMinnumberx Min position to get color
Optional yMinnumbery Min position to get color
Optional xMaxnumberx Max position to get color
Optional yMaxnumbery Max position to get color

Returns

Raster

Inherited from

DiscreteGradientColorProvider.getRaster


getScale

getScale(): KnownScales

Returns

KnownScales

scale scale being used

Inherited from

DiscreteGradientColorProvider.getScale


getStopPoints

getStopPoints(): { color: string ; value: number }[]

Returns

{ color: string ; value: number }[]

an array of the {color,values} couples

Inherited from

DiscreteGradientColorProvider.getStopPoints


getValues

getValues(): number[]

Always return a reference to sorted array of values. Don't change this array.

Returns

number[]

an array of the values

Inherited from

DiscreteGradientColorProvider.getValues


hasEventListener

hasEventListener(type, callback?): boolean

Check if a list of event listeners for this type contains this listener

Parameters

Name Type Description
typestringtype of event or property
Optional callbackFunctionto be called, if null, check if any callback is registered

Returns

boolean

Inherited from

DiscreteGradientColorProvider.hasEventListener


hasNamedColor

hasNamedColor(colorName): boolean

Check if specified named color exists

Parameters

Name Type Description
colorNamestringcolor name

Returns

boolean

true if color exists

Inherited from

DiscreteGradientColorProvider.hasNamedColor


invalidate

invalidate(): ColorMap

Invalidate Default ColorProvider and notify visuals for update

Returns

ColorMap

Inherited from

DiscreteGradientColorProvider.invalidate


isDisposed

isDisposed(): boolean

Returns whether this object has been disposed

Returns

boolean

Inherited from

DiscreteGradientColorProvider.isDisposed


isNotificationEnabled

isNotificationEnabled(): boolean

Return state of notification

Returns

boolean

current notification state

Inherited from

DiscreteGradientColorProvider.isNotificationEnabled


isReversed

isReversed(): boolean

return true if the min / max is reversed

Returns

boolean

Inherited from

DiscreteGradientColorProvider.isReversed


isSilent

isSilent(): boolean

Return true if the event dispatcher doesn't notify any events

Returns

boolean

Inherited from

DiscreteGradientColorProvider.isSilent


notify

notify<E>(type, source, args?): ColorMap

Notify listeners

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEevent types
sourceColorProviderof the event
Optional argsEventMap[E]arguments of the event

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.notify


off

off<E>(type?, callback?): ColorMap

Detach listener on event. Calling .off() with no arguments removes all attached listeners. Calling .off(type) with no callback removes all attached listeners for specific type.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
Optional typeEtype of the event
Optional callback(eventType: E, sender: ColorMap, args: EventMap[E]) => voidfunction to be called

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.off


on

on<E>(type, callback): ColorMap

Attach listener on event that will be called whenever the specified event is delivered to the target

If the callback function is already in the list of event listeners for this target, the function is not added a second time.

If a particular anonymous function is in the list of event listeners registered for a certain target, and then later in the code, an identical anonymous function is given in an "on" call, the second function will also be added to the list of event listeners for that target.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEtype of event or property
callback(eventType: E, sender: ColorMap, args: EventMap[E]) => voidto be called

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.on


removeColor

removeColor(value): ColorMap

Remove color from the collection

Parameters

Name Type Description
valuenumbervalue to remove color

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.removeColor


reverse

reverse(): ColorMap

reverse the axis

Returns

ColorMap

Inherited from

DiscreteGradientColorProvider.reverse


scaleTo

scaleTo(start, end): ColorMap

set the min/max of the color provider, interpolating all values on the way.

Throws

if start or end is NaN

Parameters

Name Type Description
startnumberStart value to use
endnumberEnd value to use

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.scaleTo


setColorNumber

setColorNumber(colorNumber): ColorMap

Sets how many colors can be provided

Parameters

Name Type Description
colorNumbernumbernumber of colors that can be provided

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.setColorNumber


setColors

setColors(values, colors?): ColorMap

Parameters

Name Type Description
valuesColorsnew values
Optional colors(string | RgbaColor)[]new colors

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.setColors


setNamedColor

setNamedColor(colorName, colorValue): ColorMap

Set color value

Example

import {KnownColors} from '@int/geotoolkit/util/ColorProvider';
colorProvider.setNamedColor(KnownColors.NaN, { // set color for NaN values
'title': 'absent', // title to use when displaying, e.g. by ColorBar shape
'enabled': true, // enable state (default is not false)
'value': 'black' // color to use for NaNs
});

Example

// use 'red' color for values greater than maxValue (default '+∞' title is used)
colorProvider.setNamedColor(KnownColors.PositiveInfinity, 'red');

Parameters

Name Type Description
colorNamestringcolor name
colorValuestring | NamedColorValuecolor or title/value settings object

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.setNamedColor


setNotification

setNotification(enable, force?): ColorMap

Enable / disable notification

Parameters

Name Type Description
enablebooleanenable or disable notifications
Optional forcebooleantrue if parent should be invalidated immediately

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.setNotification


setProperties

setProperties(properties?): ColorMap

set Properties of the object

Parameters

Name Type Description
Optional propertiesOptionscolor provider properties

Returns

ColorMap

this

Overrides

DiscreteGradientColorProvider.setProperties


setScale

setScale(scale, min?, max?): ColorMap

Replace all colors in the collection by this scale

Parameters

Name Type Description
scalestringScale to use
Optional minnumberMinimum to use
Optional maxnumberMaximum to use

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.setScale


setSilent

setSilent(bool): ColorMap

Set silent mode

Parameters

Name Type Description
boolbooleanflag to enable silent mode

Returns

ColorMap

this

Inherited from

DiscreteGradientColorProvider.setSilent


fromObject

Static fromObject(object): DiscreteGradientColorProvider

Create or get DiscreteGradientColorProvider from an object

Parameters

Name Type Description
objectDiscreteGradientColorProvider | Optionsgradient provider properties or instance

Returns

DiscreteGradientColorProvider

provider

Inherited from

DiscreteGradientColorProvider.fromObject


getClassName

Static getClassName(): string

Returns

string

Inherited from

DiscreteGradientColorProvider.getClassName


getColorProviderType

Static getColorProviderType(objectType?): ClassType<any>

Return ColorProvider constructor from the object class name or type.

Deprecated

since 4.1 Use ColorProvider implementation directly

Parameters

Name Type Description
Optional objectTypestringColorProvider class name

Returns

ClassType<any>

ColorProvider constructor

Inherited from

DiscreteGradientColorProvider.getColorProviderType