ColorSet – amCharts 4 Documentation

Type class

Represents a set of colors. Can also generate colors according to set rules.

Click here for color-related info

Sources

ColorSet can be used (imported) via one of the following packages.

/**
 * --------------------------------------------------------
 * Import from: "core.ts"
 * Use like: am4core.ColorSet
 * --------------------------------------------------------
 */
import * as am4core from "@amcharts/amcharts4/core";

/**
 * --------------------------------------------------------
 * Include via: <script src="core.js"></script>
 * Access items like: am4.ColorSet
 * --------------------------------------------------------
 */

Inheritance

ColorSet extends BaseObject.

ColorSet is not extended by any other symbol.

Properties

baseColor #	Type `Color` Default `new Color({ r: 103, g: 183, b: 220` `})` A base color. If there are no colors pre-set in the color list, ColorSet will use this color as a base when generating new ones, applying `stepOptions` and `passOptions` to this base color.
clonedFrom #	Type `$type.Optional` < `this` > Inherited from `BaseObject` Reference to the original object this object was cloned from. We need to keep this so we can disassociate it from source object when this object is disposed.
config #	Type `object` Inherited from `BaseObject` Use this property to set JSON-based config. When set, triggers processing routine, which will go through all properties, and try to apply values, create instances, etc. Use this with caution, as it is a time-consuming process. It's used for initialchart setup only, not routine operations.
currentStep #	Type `number` Sets current color iteration. You can use this property to skip some colors from iteration. E.g. setting it to `10` will skip first ten colors. Please note that the number is zero-based.
id #	Type `$type.Optional` < `string` > Inherited from `BaseObject` Sets the user-defined id of the element.
list #	Type `Color[]` Sets a list of pre-defined colors to use for the iterator. Returns current list of colors. If there are none, a new list of colors is generated, based on various ColorSet settings.
maxLightness #	Type `number` Default `0.9` Do not let the "lightness" of generated color to get above this threshold.
minColors #	Type `number` Default `20` A number of colors to generate in one "pass". This setting can be automatically overridden, if ColorSet has a list of pre-set colors. In such case ColorSet will generate exactly the same number of colors with each pass as there were colors in original set.
minLightness #	Type `number` Default `0.2` Do not let the "lightness" of generated color to fall below this threshold.
reuse #	Type `boolean` Default `false` Re-use same colors in the pre-set list, when ColorSet runs out of colors, rather than start generating new ones.
saturation #	Type `number` Default `1` Saturation of colors. This will change saturation of all colors of color set. It is recommended to set this in theme, as changing it at run time won't make the items to redraw and change color.
shuffle #	Type `boolean` Default `false` Randomly shuffle generated colors.
startIndex #	Type `number` Default `0` If set to non-zero value, the ColorSet will start iterating colors from that particular index, not the first color in the list. @since 4.4.9
step #	Type `number` Default `1` An index increment to use when iterating through color list. Default is 1, which means returning each and every color. Setting it to a bigger number will make ColorSet `next()` iterator skip some colors. E.g. setting to 2, will return every second color in the list. This is useful, when the color list has colors that are too close each other for contrast. However, having bigger number will mean that `next()` iterator will go through the list quicker, and the generator will kick sooner.
stepOptions #	Type `Partial` < `IColorSetStepOptions` > Modifications to apply with each new generated color.
uid #	Type `string` Inherited from `BaseObject` Returns object's internal unique ID.
wrap #	Type `boolean` Default `true` When colors are generated, based on `stepOptions`, each generated color gets either lighter or darker. If this is set to `true`, color generator will switch to opposing spectrum when reaching `minLightness` or `maxLightness`. E.g. if we start off with a red color, then gradually generate lighter colors through rose shades, then switch back to dark red and gradually increase the lightness of it until it reaches the starting red. If set to `false` it will stop there and cap lightness at whatever level we hit `minLightness` or `maxLightness`, which may result in a number of the same colors.
There are 4 inherited items currently hidden from this list.

Methods

clone( cloneId?: `string` ) #	Returns `this` Inherited from `BaseObject` Makes a copy of this object and returns the clone. Try to avoid cloning complex objects like chart, create new instances if you need them.
constructor() #	Returns `ColorSet` Constructor
copyFrom( object: `this` ) #	Returns `void` Inherited from `BaseObject` Copies all properties and related data from different element.
dispose() #	Returns `void` Inherited from `BaseObject` Destroys this object and all related data.
generate( count: `number` ) #	Returns `void` Generates colors based on the various ColorSet settings.
getCurrentThemes() #	Returns `ITheme[]` Inherited from `BaseObject` Returns a list of themes that should be applied to this element. It could either be a list of themes set explicitly on this element, or system-wide.
getIndex( i: `number` ) #	Returns `Color` Returns a color at specific index in the list.
isDisposed() #	Returns `boolean` Inherited from `BaseObject` Returns if this object has been already been disposed.
next() #	Returns `Color` Returns next color in the list using internal iterator counter. If `step` is set to something other than 1, it may return other color than exact next one in the list.
reset() #	Returns `void` Resets internal iterator. Calling `next()` after this will return the very first color in the color list, even if it was already returned before.
There are 5 inherited items currently hidden from this list.

clone(

cloneId?: string

)

Returns this

Inherited from BaseObject

Makes a copy of this object and returns the clone. Try to avoid cloning complex objects like chart, create new instances if you need them.

constructor()

Returns ColorSet

Constructor

copyFrom(

object: this

)

Returns void

Inherited from BaseObject

Copies all properties and related data from different element.

dispose()

Returns void

Inherited from BaseObject

Destroys this object and all related data.

generate(

count: number

)

Returns void

Generates colors based on the various ColorSet settings.

getCurrentThemes()

Returns ITheme[]

Inherited from BaseObject

Returns a list of themes that should be applied to this element. It could either be a list of themes set explicitly on this element, or system-wide.

getIndex(

i: number

)

Returns Color

Returns a color at specific index in the list.

isDisposed()

Returns boolean

Inherited from BaseObject

Returns if this object has been already been disposed.

next()

Returns Color

Returns next color in the list using internal iterator counter.

If step is set to something other than 1, it may return other color than exact next one in the list.

reset()

Returns void

Resets internal iterator.

Calling next() after this will return the very first color in the color list, even if it was already returned before.

There are 5 inherited items currently hidden from this list.

Events

ColorSet does not have any events.

Adapters

ColorSet does not have any adapters.