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

Synopsis

grabColor [-hsvValue] [-rgbValue]

grabColor is undoable, NOT queryable, and NOT editable.

This command changes the cursor and enters a modal state which will be exited by pressing a mouse button. The color component values of the pixel below the cursor at the time of the button press are returned.

Return value

float[]

Three float values representing the color components of the pixel below the cursor. If no flags are specified then the default is to return the red, green and blue color components.

Flags

hsvValue, rgbValue
Long name (short name) Argument types Properties
-rgbValue(-rgb) create
The 3 returned float values will specify the red, green and blue color components.
-hsvValue(-hsv) create
The 3 returned float values will specify the hue, saturation and value color components.

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

grabColor;
grabColor -hsv;
float $color[] = `grabColor -rgbValue`;