f7f6115f76
- Document a few more properties and methods - Add more information to many classes - Fix lots of typos and gramar mistakes - Use [code] tags for parameters consistently - Use [b] and [i] tags consistently - Put "Warning:" and "Note:" on their own line to be more visible, and make them always bold - Tweak formatting in code examples to be more readable - Use double quotes consistently - Add more links to third-party technologies
110 lines
3.9 KiB
XML
110 lines
3.9 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="ColorPicker" inherits="BoxContainer" category="Core" version="3.2">
|
|
<brief_description>
|
|
Color picker control.
|
|
</brief_description>
|
|
<description>
|
|
[Control] node displaying a color picker widget. It's useful for selecting a color from an RGB/RGBA colorspace.
|
|
</description>
|
|
<tutorials>
|
|
</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="PoolColorArray">
|
|
</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">
|
|
The currently selected color.
|
|
</member>
|
|
<member name="deferred_mode" type="bool" setter="set_deferred_mode" getter="is_deferred_mode">
|
|
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">
|
|
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">
|
|
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">
|
|
</member>
|
|
<member name="presets_visible" type="bool" setter="set_presets_visible" getter="are_presets_visible">
|
|
</member>
|
|
<member name="raw_mode" type="bool" setter="set_raw_mode" getter="is_raw_mode">
|
|
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="Texture">
|
|
</theme_item>
|
|
<theme_item name="color_hue" type="Texture">
|
|
</theme_item>
|
|
<theme_item name="color_sample" type="Texture">
|
|
</theme_item>
|
|
<theme_item name="h_width" type="int">
|
|
</theme_item>
|
|
<theme_item name="label_width" type="int">
|
|
</theme_item>
|
|
<theme_item name="margin" type="int">
|
|
</theme_item>
|
|
<theme_item name="preset_bg" type="Texture">
|
|
</theme_item>
|
|
<theme_item name="screen_picker" type="Texture">
|
|
</theme_item>
|
|
<theme_item name="sv_height" type="int">
|
|
</theme_item>
|
|
<theme_item name="sv_width" type="int">
|
|
</theme_item>
|
|
</theme_items>
|
|
</class>
|