Files
godot-docs/classes/class_colorpicker.rst
2020-01-21 09:28:25 +01:00

182 lines
6.5 KiB
ReStructuredText

:github_url: hide
.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the ColorPicker.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.
.. _class_ColorPicker:
ColorPicker
===========
**Inherits:** :ref:`BoxContainer<class_BoxContainer>` **<** :ref:`Container<class_Container>` **<** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
**Category:** Core
Brief Description
-----------------
Color picker control.
Properties
----------
+---------------------------+----------------------------------------------------------------+
| :ref:`Color<class_Color>` | :ref:`color<class_ColorPicker_property_color>` |
+---------------------------+----------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`deferred_mode<class_ColorPicker_property_deferred_mode>` |
+---------------------------+----------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`edit_alpha<class_ColorPicker_property_edit_alpha>` |
+---------------------------+----------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`raw_mode<class_ColorPicker_property_raw_mode>` |
+---------------------------+----------------------------------------------------------------+
Methods
-------
+---------------------------------------------+--------------------------------------------------------------------------------------------------------+
| void | :ref:`add_preset<class_ColorPicker_method_add_preset>` **(** :ref:`Color<class_Color>` color **)** |
+---------------------------------------------+--------------------------------------------------------------------------------------------------------+
| void | :ref:`erase_preset<class_ColorPicker_method_erase_preset>` **(** :ref:`Color<class_Color>` color **)** |
+---------------------------------------------+--------------------------------------------------------------------------------------------------------+
| :ref:`PoolColorArray<class_PoolColorArray>` | :ref:`get_presets<class_ColorPicker_method_get_presets>` **(** **)** const |
+---------------------------------------------+--------------------------------------------------------------------------------------------------------+
Theme Properties
----------------
+-------------------------------+---------------+
| :ref:`Texture<class_Texture>` | add_preset |
+-------------------------------+---------------+
| :ref:`Texture<class_Texture>` | color_hue |
+-------------------------------+---------------+
| :ref:`Texture<class_Texture>` | color_sample |
+-------------------------------+---------------+
| :ref:`int<class_int>` | h_width |
+-------------------------------+---------------+
| :ref:`int<class_int>` | label_width |
+-------------------------------+---------------+
| :ref:`int<class_int>` | margin |
+-------------------------------+---------------+
| :ref:`Texture<class_Texture>` | preset_bg |
+-------------------------------+---------------+
| :ref:`Texture<class_Texture>` | screen_picker |
+-------------------------------+---------------+
| :ref:`int<class_int>` | sv_height |
+-------------------------------+---------------+
| :ref:`int<class_int>` | sv_width |
+-------------------------------+---------------+
Signals
-------
.. _class_ColorPicker_signal_color_changed:
- **color_changed** **(** :ref:`Color<class_Color>` color **)**
Emitted when the color is changed.
----
.. _class_ColorPicker_signal_preset_added:
- **preset_added** **(** :ref:`Color<class_Color>` color **)**
Emitted when a preset is added.
----
.. _class_ColorPicker_signal_preset_removed:
- **preset_removed** **(** :ref:`Color<class_Color>` color **)**
Emitted when a preset is removed.
Description
-----------
:ref:`Control<class_Control>` node displaying a color picker widget. It's useful for selecting a color from an RGB/RGBA colorspace.
Property Descriptions
---------------------
.. _class_ColorPicker_property_color:
- :ref:`Color<class_Color>` **color**
+----------+-----------------------+
| *Setter* | set_pick_color(value) |
+----------+-----------------------+
| *Getter* | get_pick_color() |
+----------+-----------------------+
The currently selected color.
----
.. _class_ColorPicker_property_deferred_mode:
- :ref:`bool<class_bool>` **deferred_mode**
+----------+--------------------------+
| *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).
----
.. _class_ColorPicker_property_edit_alpha:
- :ref:`bool<class_bool>` **edit_alpha**
+----------+-----------------------+
| *Setter* | set_edit_alpha(value) |
+----------+-----------------------+
| *Getter* | is_editing_alpha() |
+----------+-----------------------+
If ``true``, shows an alpha channel slider (transparency).
----
.. _class_ColorPicker_property_raw_mode:
- :ref:`bool<class_bool>` **raw_mode**
+----------+---------------------+
| *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).
Method Descriptions
-------------------
.. _class_ColorPicker_method_add_preset:
- void **add_preset** **(** :ref:`Color<class_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.
----
.. _class_ColorPicker_method_erase_preset:
- void **erase_preset** **(** :ref:`Color<class_Color>` color **)**
Remove the given color from the list of color presets of this color picker.
----
.. _class_ColorPicker_method_get_presets:
- :ref:`PoolColorArray<class_PoolColorArray>` **get_presets** **(** **)** const
Returns the list of colors in the presets of the color picker.