Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

colorIndex [-active] [-dormant] [-hueSaturationValue] [-resetToFactory] [-resetToSaved] [-userColor] int [float float float]

colorIndex is undoable, queryable, and NOT editable.

The index specifies a color index in the color palette. The r, g, and b values (between 0-1) specify the RGB values (or the HSV values if the -hsv flag is used) for the color.

Return value

intReturns 1 on success.

In query mode, return type is based on queried flag.

Flags

active, dormant, hueSaturationValue, resetToFactory, resetToSaved, userColor
Long name (short name) Argument types Properties
-active(-atv)
2024
 create
Combined with query mode, with given index, query the active color palette.
-dormant(-dor)
2024
 create
Combined with query mode, with given index, query the dormant color palette.
-hueSaturationValue(-hsv) createquery
Indicates that rgb values are really hsv values. Upon query, returns the HSV valuses as an array of 3 floats.
-resetToFactory(-rf) create
Resets all color index palette entries to their factory defaults.
-resetToSaved(-rs) create
Resets all color palette entries to their saved values.
-userColor(-uc)
2024
 create
Combined with query mode, with given index, query the user color palette.
Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

// Set the first entry in the color palette to have RGB values 1 0 0 - red.
colorIndex 1 1 0 0;

// Set the first entry in the color palette to have HSV values 360 1 1 - red.
colorIndex -hsv 1 360 0 0;

// Return the RGB color values of the first entry of the color palette.
colorIndex -q 1;

// Return the HSV color values of the first entry of the color palette.
colorIndex -q -hsv 1;