Inherits: BoxContainer < Container < Control < CanvasItem < Node < Object

Color picker control.


Control node displaying a color picker widget. It's useful for selecting a color from an RGB/RGBA colorspace.


Color color Color( 1, 1, 1, 1 )
bool deferred_mode false
bool edit_alpha true
bool hsv_mode false
bool presets_enabled true
bool presets_visible true
bool raw_mode false


void add_preset ( Color color )
void erase_preset ( Color color )
PoolColorArray get_presets ( ) const

Theme Properties

Texture add_preset  
Texture color_hue  
Texture color_sample  
int h_width 30
int label_width 10
int margin 4
Texture overbright_indicator  
Texture preset_bg  
Texture screen_picker  
int sv_height 256
int sv_width 256


  • color_changed ( Color color )

Emitted when the color is changed.

  • preset_added ( Color color )

Emitted when a preset is added.

  • preset_removed ( Color color )

Emitted when a preset is removed.

Property Descriptions

Default Color( 1, 1, 1, 1 )
Setter set_pick_color(value)
Getter get_pick_color()

The currently selected color.

  • bool deferred_mode
Default false
Setter set_deferred_mode(value)
Getter is_deferred_mode()

If true, the color will apply only after the user releases the mouse button, otherwise it will apply immediately even in mouse motion event (which can cause performance issues).

Default true
Setter set_edit_alpha(value)
Getter is_editing_alpha()

If true, shows an alpha channel slider (transparency).

Default false
Setter set_hsv_mode(value)
Getter is_hsv_mode()

If true, allows editing the color with Hue/Saturation/Value sliders.

Note: Cannot be enabled if raw mode is on.

  • bool presets_enabled
Default true
Setter set_presets_enabled(value)
Getter are_presets_enabled()

If true, the "add preset" button is enabled.

  • bool presets_visible
Default true
Setter set_presets_visible(value)
Getter are_presets_visible()

If true, saved color presets are visible.

Default false
Setter set_raw_mode(value)
Getter is_raw_mode()

If true, allows the color R, G, B component values to go beyond 1.0, which can be used for certain special operations that require it (like tinting without darkening or rendering sprites in HDR).

Note: Cannot be enabled if HSV mode is on.

Method Descriptions

  • void add_preset ( Color color )

Adds the given color to a list of color presets. The presets are displayed in the color picker and the user will be able to select them.

Note: the presets list is only for this color picker.

  • void erase_preset ( Color color )

Removes the given color from the list of color presets of this color picker.

Returns the list of colors in the presets of the color picker.