ColorPicker¶
Inherits: BoxContainer < Container < Control < CanvasItem < Node < Object
Color picker control.
Description¶
Control node displaying a color picker widget. It's useful for selecting a color from an RGB/RGBA colorspace.
Properties¶
|
||
|
||
|
||
|
||
|
||
|
||
|
Methods¶
void |
add_preset ( Color color ) |
void |
erase_preset ( Color color ) |
get_presets ( ) const |
Theme Properties¶
add_preset |
||
color_hue |
||
color_sample |
||
h_width |
30 |
|
label_width |
10 |
|
margin |
4 |
|
overbright_indicator |
||
preset_bg |
||
screen_picker |
||
sv_height |
256 |
|
sv_width |
256 |
Signals¶
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¶
Color color
Default |
|
Setter |
set_pick_color(value) |
Getter |
get_pick_color() |
The currently selected color.
bool deferred_mode
Default |
|
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).
bool edit_alpha
Default |
|
Setter |
set_edit_alpha(value) |
Getter |
is_editing_alpha() |
If true
, shows an alpha channel slider (transparency).
bool hsv_mode
Default |
|
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 |
|
Setter |
set_presets_enabled(value) |
Getter |
are_presets_enabled() |
If true
, the "add preset" button is enabled.
bool presets_visible
Default |
|
Setter |
set_presets_visible(value) |
Getter |
are_presets_visible() |
If true
, saved color presets are visible.
bool raw_mode
Default |
|
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.
PoolColorArray get_presets ( ) const
Returns the list of colors in the presets of the color picker.