2017-09-12 20:42:36 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
2020-02-01 01:03:48 +00:00
<class name= "ColorPicker" inherits= "BoxContainer" version= "4.0" >
2017-09-12 20:42:36 +00:00
<brief_description >
Color picker control.
</brief_description>
<description >
2020-02-26 03:47:06 +00:00
Displays a color picker widget. Useful for selecting a color from an RGB/RGBA colorspace.
2017-09-12 20:42:36 +00:00
</description>
<tutorials >
2020-10-01 08:34:47 +00:00
<link title= "Tween Demo" > https://godotengine.org/asset-library/asset/146</link>
2017-09-12 20:42:36 +00:00
</tutorials>
<methods >
<method name= "add_preset" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "color" type= "Color" />
2017-09-12 20:42:36 +00:00
<description >
2019-06-21 23:04:47 +00:00
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.
[b]Note:[/b] the presets list is only for [i]this[/i] color picker.
2017-09-12 20:42:36 +00:00
</description>
</method>
2018-10-03 14:12:38 +00:00
<method name= "erase_preset" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "color" type= "Color" />
2018-10-03 14:12:38 +00:00
<description >
2019-06-21 23:04:47 +00:00
Removes the given color from the list of color presets of this color picker.
2018-10-03 14:12:38 +00:00
</description>
</method>
2018-12-13 14:12:25 +00:00
<method name= "get_presets" qualifiers= "const" >
2021-07-30 13:28:05 +00:00
<return type= "PackedColorArray" />
2018-10-03 14:12:38 +00:00
<description >
2019-05-24 02:15:43 +00:00
Returns the list of colors in the presets of the color picker.
2018-10-03 14:12:38 +00:00
</description>
</method>
2017-09-12 20:42:36 +00:00
</methods>
2018-01-11 22:38:35 +00:00
<members >
2019-09-24 17:45:03 +00:00
<member name= "color" type= "Color" setter= "set_pick_color" getter= "get_pick_color" default= "Color(1, 1, 1, 1)" >
2018-01-11 22:38:35 +00:00
The currently selected color.
</member>
2019-06-29 10:38:01 +00:00
<member name= "deferred_mode" type= "bool" setter= "set_deferred_mode" getter= "is_deferred_mode" default= "false" >
2018-12-20 12:46:54 +00:00
If [code]true[/code], 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).
2018-07-26 09:56:21 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "edit_alpha" type= "bool" setter= "set_edit_alpha" getter= "is_editing_alpha" default= "true" >
2018-12-20 12:46:54 +00:00
If [code]true[/code], shows an alpha channel slider (transparency).
2018-01-11 22:38:35 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "hsv_mode" type= "bool" setter= "set_hsv_mode" getter= "is_hsv_mode" default= "false" >
2019-06-21 23:04:47 +00:00
If [code]true[/code], allows editing the color with Hue/Saturation/Value sliders.
2019-05-03 17:38:45 +00:00
[b]Note:[/b] Cannot be enabled if raw mode is on.
</member>
2021-04-19 10:26:37 +00:00
<member name= "picker_shape" type= "int" setter= "set_picker_shape" getter= "get_picker_shape" enum= "ColorPicker.PickerShapeType" default= "0" >
2021-02-23 10:22:46 +00:00
The shape of the color space view. See [enum PickerShapeType].
</member>
2019-06-29 10:38:01 +00:00
<member name= "presets_enabled" type= "bool" setter= "set_presets_enabled" getter= "are_presets_enabled" default= "true" >
2019-10-06 23:26:15 +00:00
If [code]true[/code], the "add preset" button is enabled.
2019-06-24 08:39:59 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "presets_visible" type= "bool" setter= "set_presets_visible" getter= "are_presets_visible" default= "true" >
2019-10-06 23:26:15 +00:00
If [code]true[/code], saved color presets are visible.
2019-06-24 08:39:59 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "raw_mode" type= "bool" setter= "set_raw_mode" getter= "is_raw_mode" default= "false" >
2018-12-20 12:46:54 +00:00
If [code]true[/code], 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).
2019-06-21 23:04:47 +00:00
[b]Note:[/b] Cannot be enabled if HSV mode is on.
2018-01-11 22:38:35 +00:00
</member>
</members>
2017-09-12 20:42:36 +00:00
<signals >
<signal name= "color_changed" >
2021-07-30 13:28:05 +00:00
<argument index= "0" name= "color" type= "Color" />
2017-09-12 20:42:36 +00:00
<description >
Emitted when the color is changed.
</description>
</signal>
2018-10-03 14:12:38 +00:00
<signal name= "preset_added" >
2021-07-30 13:28:05 +00:00
<argument index= "0" name= "color" type= "Color" />
2018-10-03 14:12:38 +00:00
<description >
Emitted when a preset is added.
</description>
</signal>
<signal name= "preset_removed" >
2021-07-30 13:28:05 +00:00
<argument index= "0" name= "color" type= "Color" />
2018-10-03 14:12:38 +00:00
<description >
Emitted when a preset is removed.
</description>
</signal>
</signals>
2017-09-12 20:42:36 +00:00
<constants >
2021-02-23 10:22:46 +00:00
<constant name= "SHAPE_HSV_RECTANGLE" value= "0" enum= "PickerShapeType" >
HSV Color Model rectangle color space.
</constant>
<constant name= "SHAPE_HSV_WHEEL" value= "1" enum= "PickerShapeType" >
HSV Color Model rectangle color space with a wheel.
</constant>
<constant name= "SHAPE_VHS_CIRCLE" value= "2" enum= "PickerShapeType" >
HSV Color Model circle color space. Use Saturation as a radius.
</constant>
2017-09-12 20:42:36 +00:00
</constants>
<theme_items >
2021-08-04 16:54:41 +00:00
<theme_item name= "add_preset" data_type= "icon" type= "Texture2D" >
2020-03-03 18:21:21 +00:00
The icon for the "Add Preset" button.
2017-09-12 20:42:36 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "bar_arrow" data_type= "icon" type= "Texture2D" >
2021-02-17 05:30:56 +00:00
The texture for the arrow grabber.
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "color_hue" data_type= "icon" type= "Texture2D" >
2020-03-03 18:21:21 +00:00
Custom texture for the hue selection slider on the right.
2017-09-12 20:42:36 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "color_sample" data_type= "icon" type= "Texture2D" >
2017-09-12 20:42:36 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "h_width" data_type= "constant" type= "int" default= "30" >
2020-03-03 18:21:21 +00:00
The width of the hue selection slider.
2017-09-12 20:42:36 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "label_width" data_type= "constant" type= "int" default= "10" >
2017-09-12 20:42:36 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "margin" data_type= "constant" type= "int" default= "4" >
2020-03-03 18:21:21 +00:00
The margin around the [ColorPicker].
2017-09-12 20:42:36 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "overbright_indicator" data_type= "icon" type= "Texture2D" >
2020-03-03 18:21:21 +00:00
The indicator used to signalize that the color value is outside the 0-1 range.
2019-10-01 08:55:49 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "picker_cursor" data_type= "icon" type= "Texture2D" >
2021-04-19 10:26:37 +00:00
</theme_item>
2021-08-18 00:09:48 +00:00
<theme_item name= "sample_bg" data_type= "icon" type= "Texture2D" >
2017-10-11 21:54:43 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "screen_picker" data_type= "icon" type= "Texture2D" >
2020-03-03 18:21:21 +00:00
The icon for the screen color picker button.
2017-09-12 20:42:36 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "sv_height" data_type= "constant" type= "int" default= "256" >
2020-03-03 18:21:21 +00:00
The height of the saturation-value selection box.
2017-09-12 20:42:36 +00:00
</theme_item>
2021-08-04 16:54:41 +00:00
<theme_item name= "sv_width" data_type= "constant" type= "int" default= "256" >
2020-03-03 18:21:21 +00:00
The width of the saturation-value selection box.
2017-09-12 20:42:36 +00:00
</theme_item>
</theme_items>
</class>