Last updated

API / geotoolkit / util / LogColorProvider / LogColorProvider

Class: LogColorProvider

util.LogColorProvider.LogColorProvider

Creates a representation of Log color provider

Example

// Log Color Provider emulates logarithmic behavior
const logCP = new LogColorProvider({
'values' : [  1  ,    10  ,   100   ,  300 ,    1000  ],
'colors' : ['orange', 'yellow', 'blue', 'green', 'gray'],
'bins': 16
});

Hierarchy

Table of contents

Constructors
Methods
Css Properties
Name Type Description
binsnumberNumber of bins
maxnumber
maxnumberEnd value for the scale
minnumber
minnumberStart value for the scale
reversedbooleanBoolean to define the sorting direction
scaleKnownScales
scaleKnownScalesA predefined set of colors
styleDisplayStyleDisplay style

Contents

Constructors

new LogColorProvider(values, colors, bins)

new LogColorProvider(values?, colors?, bins?)

Creates color provider

Parameters

Name Type Description
Optional valuesnumber[] | Optionslist of values
Optional colors(string | RgbaColor)[]list of colors
Optional binsnumbernumber of bins

Overrides

DiscreteGradientColorProvider.constructor

Methods

addColor

addColor(value, color): LogColorProvider

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

LogColorProvider

this

Inherited from

DiscreteGradientColorProvider.addColor

addColor(json): LogColorProvider

Deprecated

Parameters

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

Returns

LogColorProvider

Inherited from

DiscreteGradientColorProvider.addColor


clone

clone(): ColorProvider

Returns clone of color provider

Returns

ColorProvider

Inherited from

DiscreteGradientColorProvider.clone


copyConstructor

Protected copyConstructor(src): LogColorProvider

Copy constructor

Parameters

Name Type Description
srcColorProviderSource to copy from

Returns

LogColorProvider

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

Overrides

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


getDisplayStyle

getDisplayStyle(): DisplayStyle

Returns

DisplayStyle

display style.


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

Gets all the properties pertaining to this object

Returns

OptionsOut

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

Invalidate Default ColorProvider and notify visuals for update

Returns

LogColorProvider

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


logToVal

logToVal(t): number

convert logarithmic t to value v

Parameters

Name Type Description
tnumberlogarithmic value

Returns

number


notify

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

Notify listeners

Type parameters

NameType
Eextends string

Parameters

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

Returns

LogColorProvider

this

Inherited from

DiscreteGradientColorProvider.notify


off

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

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: LogColorProvider, args: EventMap[E]) => voidfunction to be called

Returns

LogColorProvider

this

Inherited from

DiscreteGradientColorProvider.off


on

on<E>(type, callback): LogColorProvider

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: LogColorProvider, args: EventMap[E]) => voidto be called

Returns

LogColorProvider

this

Inherited from

DiscreteGradientColorProvider.on


removeColor

removeColor(value): LogColorProvider

Remove color from the collection

Parameters

Name Type Description
valuenumbervalue to remove color

Returns

LogColorProvider

this

Inherited from

DiscreteGradientColorProvider.removeColor


reverse

reverse(): LogColorProvider

reverse the axis

Returns

LogColorProvider

Inherited from

DiscreteGradientColorProvider.reverse


scaleTo

scaleTo(start, end, logValue?): LogColorProvider

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

Parameters

Name Type Description
startnumberStart value to use
endnumberEnd value to use
Optional logValuebooleanapply scale for logarithm of values

Returns

LogColorProvider

this

Overrides

DiscreteGradientColorProvider.scaleTo


setColorNumber

setColorNumber(colorNumber): LogColorProvider

Sets how many colors can be provided

Parameters

Name Type Description
colorNumbernumbernumber of colors that can be provided

Returns

LogColorProvider

this

Inherited from

DiscreteGradientColorProvider.setColorNumber


setColors

setColors(values, colors): LogColorProvider

Replace all colors in the collection by this set

Parameters

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

Returns

LogColorProvider

this

Overrides

DiscreteGradientColorProvider.setColors


setDisplayStyle

setDisplayStyle(style): LogColorProvider

Method used to set graphical representation of LogColorProvider in a fillStyle

Parameters

Name Type Description
styleDisplayStyledisplay style

Returns

LogColorProvider

this


setNamedColor

setNamedColor(colorName, colorValue): LogColorProvider

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

LogColorProvider

this

Inherited from

DiscreteGradientColorProvider.setNamedColor


setNotification

setNotification(enable, force?): LogColorProvider

Enable / disable notification

Parameters

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

Returns

LogColorProvider

this

Inherited from

DiscreteGradientColorProvider.setNotification


setProperties

setProperties(properties?): LogColorProvider

set Properties of the object

Parameters

Name Type Description
Optional propertiesOptionsproperties

Returns

LogColorProvider

this

Overrides

DiscreteGradientColorProvider.setProperties


setScale

setScale(scale, min?, max?, logValue?): LogColorProvider

Replace all colors in the collection by this scale

Parameters

Name Type Description
scalestring | { logValue?: boolean ; max: number ; min: number ; values: number[] }Scale to Use
Optional minnumberMinimum to Use
Optional maxnumberMaximum to Use
Optional logValuebooleanapply scale for logarithm of values

Returns

LogColorProvider

this

Overrides

DiscreteGradientColorProvider.setScale


setSilent

setSilent(bool): LogColorProvider

Set silent mode

Parameters

Name Type Description
boolbooleanflag to enable silent mode

Returns

LogColorProvider

this

Inherited from

DiscreteGradientColorProvider.setSilent


valToLog

valToLog(v): number

convert value v to logarithmic t

Parameters

Name Type Description
vnumbervalue

Returns

number


fromObject

Static fromObject(object): LogColorProvider

Create or get LogColorProvider from an object

Parameters

Name Type Description
objectanyobject to create from

Returns

LogColorProvider

provider

Overrides

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