summaryrefslogtreecommitdiff
path: root/doc/classes/ColorPicker.xml
blob: 2fc4313e47d0841a4a347ec13c8aebb5b79a45bb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
<?xml version="1.0" encoding="UTF-8" ?>
<class name="ColorPicker" inherits="BoxContainer" version="4.0">
	<brief_description>
		Color picker control.
	</brief_description>
	<description>
		Displays a color picker widget. Useful for selecting a color from an RGB/RGBA colorspace.
	</description>
	<tutorials>
		<link title="Tween Demo">https://godotengine.org/asset-library/asset/146</link>
	</tutorials>
	<methods>
		<method name="add_preset">
			<return type="void">
			</return>
			<argument index="0" name="color" type="Color">
			</argument>
			<description>
				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.
			</description>
		</method>
		<method name="erase_preset">
			<return type="void">
			</return>
			<argument index="0" name="color" type="Color">
			</argument>
			<description>
				Removes the given color from the list of color presets of this color picker.
			</description>
		</method>
		<method name="get_presets" qualifiers="const">
			<return type="PackedColorArray">
			</return>
			<description>
				Returns the list of colors in the presets of the color picker.
			</description>
		</method>
	</methods>
	<members>
		<member name="color" type="Color" setter="set_pick_color" getter="get_pick_color" default="Color( 1, 1, 1, 1 )">
			The currently selected color.
		</member>
		<member name="deferred_mode" type="bool" setter="set_deferred_mode" getter="is_deferred_mode" default="false">
			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).
		</member>
		<member name="edit_alpha" type="bool" setter="set_edit_alpha" getter="is_editing_alpha" default="true">
			If [code]true[/code], shows an alpha channel slider (transparency).
		</member>
		<member name="hsv_mode" type="bool" setter="set_hsv_mode" getter="is_hsv_mode" default="false">
			If [code]true[/code], allows editing the color with Hue/Saturation/Value sliders.
			[b]Note:[/b] Cannot be enabled if raw mode is on.
		</member>
		<member name="presets_enabled" type="bool" setter="set_presets_enabled" getter="are_presets_enabled" default="true">
			If [code]true[/code], the "add preset" button is enabled.
		</member>
		<member name="presets_visible" type="bool" setter="set_presets_visible" getter="are_presets_visible" default="true">
			If [code]true[/code], saved color presets are visible.
		</member>
		<member name="raw_mode" type="bool" setter="set_raw_mode" getter="is_raw_mode" default="false">
			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).
			[b]Note:[/b] Cannot be enabled if HSV mode is on.
		</member>
	</members>
	<signals>
		<signal name="color_changed">
			<argument index="0" name="color" type="Color">
			</argument>
			<description>
				Emitted when the color is changed.
			</description>
		</signal>
		<signal name="preset_added">
			<argument index="0" name="color" type="Color">
			</argument>
			<description>
				Emitted when a preset is added.
			</description>
		</signal>
		<signal name="preset_removed">
			<argument index="0" name="color" type="Color">
			</argument>
			<description>
				Emitted when a preset is removed.
			</description>
		</signal>
	</signals>
	<constants>
	</constants>
	<theme_items>
		<theme_item name="add_preset" type="Texture2D">
			The icon for the "Add Preset" button.
		</theme_item>
		<theme_item name="bar_arrow" type="Texture2D">
			The texture for the arrow grabber.
		</theme_item>
		<theme_item name="color_hue" type="Texture2D">
			Custom texture for the hue selection slider on the right.
		</theme_item>
		<theme_item name="color_sample" type="Texture2D">
		</theme_item>
		<theme_item name="h_width" type="int" default="30">
			The width of the hue selection slider.
		</theme_item>
		<theme_item name="label_width" type="int" default="10">
		</theme_item>
		<theme_item name="margin" type="int" default="4">
			The margin around the [ColorPicker].
		</theme_item>
		<theme_item name="overbright_indicator" type="Texture2D">
			The indicator used to signalize that the color value is outside the 0-1 range.
		</theme_item>
		<theme_item name="preset_bg" type="Texture2D">
		</theme_item>
		<theme_item name="screen_picker" type="Texture2D">
			The icon for the screen color picker button.
		</theme_item>
		<theme_item name="sv_height" type="int" default="256">
			The height of the saturation-value selection box.
		</theme_item>
		<theme_item name="sv_width" type="int" default="256">
			The width of the saturation-value selection box.
		</theme_item>
	</theme_items>
</class>