mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
930 lines
42 KiB
ReStructuredText
930 lines
42 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. _class_ColorPicker:
|
|
|
|
ColorPicker
|
|
===========
|
|
|
|
**Hereda:** :ref:`VBoxContainer<class_VBoxContainer>` **<** :ref:`BoxContainer<class_BoxContainer>` **<** :ref:`Container<class_Container>` **<** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
|
|
|
Un widget que proporciona una interfaz para seleccionar o modificar un color.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Descripción
|
|
----------------------
|
|
|
|
Un widget que proporciona una interfaz para seleccionar o modificar un color. Opcionalmente, puede proporcionar funcionalidades como un muestreador de color (cuentagotas), modos de color y preajustes.
|
|
|
|
\ **Nota:** Este control es el widget selector de color en sí mismo. Puedes usar un :ref:`ColorPickerButton<class_ColorPickerButton>` en su lugar si necesitas un botón que muestre un **ColorPicker** en un popup.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Tutoriales
|
|
--------------------
|
|
|
|
- `Demo de Interpolación de Tweens <https://godotengine.org/asset-library/asset/2733>`__
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Propiedades
|
|
----------------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`can_add_swatches<class_ColorPicker_property_can_add_swatches>` | ``true`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`Color<class_Color>` | :ref:`color<class_ColorPicker_property_color>` | ``Color(1, 1, 1, 1)`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`ColorModeType<enum_ColorPicker_ColorModeType>` | :ref:`color_mode<class_ColorPicker_property_color_mode>` | ``0`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`color_modes_visible<class_ColorPicker_property_color_modes_visible>` | ``true`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`deferred_mode<class_ColorPicker_property_deferred_mode>` | ``false`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`edit_alpha<class_ColorPicker_property_edit_alpha>` | ``true`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`edit_intensity<class_ColorPicker_property_edit_intensity>` | ``true`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`hex_visible<class_ColorPicker_property_hex_visible>` | ``true`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` | :ref:`picker_shape<class_ColorPicker_property_picker_shape>` | ``0`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`presets_visible<class_ColorPicker_property_presets_visible>` | ``true`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`sampler_visible<class_ColorPicker_property_sampler_visible>` | ``true`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`sliders_visible<class_ColorPicker_property_sliders_visible>` | ``true`` |
|
|
+----------------------------------------------------------+----------------------------------------------------------------------------+-----------------------+
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Métodos
|
|
--------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`add_preset<class_ColorPicker_method_add_preset>`\ (\ color\: :ref:`Color<class_Color>`\ ) |
|
|
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`add_recent_preset<class_ColorPicker_method_add_recent_preset>`\ (\ color\: :ref:`Color<class_Color>`\ ) |
|
|
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`erase_preset<class_ColorPicker_method_erase_preset>`\ (\ color\: :ref:`Color<class_Color>`\ ) |
|
|
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`erase_recent_preset<class_ColorPicker_method_erase_recent_preset>`\ (\ color\: :ref:`Color<class_Color>`\ ) |
|
|
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`PackedColorArray<class_PackedColorArray>` | :ref:`get_presets<class_ColorPicker_method_get_presets>`\ (\ ) |const| |
|
|
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`PackedColorArray<class_PackedColorArray>` | :ref:`get_recent_presets<class_ColorPicker_method_get_recent_presets>`\ (\ ) |const| |
|
|
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Propiedades del Tema
|
|
----------------------------------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Color<class_Color>` | :ref:`focused_not_editing_cursor_color<class_ColorPicker_theme_color_focused_not_editing_cursor_color>` | ``Color(1, 1, 1, 0.275)`` |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`int<class_int>` | :ref:`center_slider_grabbers<class_ColorPicker_theme_constant_center_slider_grabbers>` | ``1`` |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`int<class_int>` | :ref:`h_width<class_ColorPicker_theme_constant_h_width>` | ``30`` |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`int<class_int>` | :ref:`label_width<class_ColorPicker_theme_constant_label_width>` | ``10`` |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`int<class_int>` | :ref:`margin<class_ColorPicker_theme_constant_margin>` | ``4`` |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`int<class_int>` | :ref:`sv_height<class_ColorPicker_theme_constant_sv_height>` | ``256`` |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`int<class_int>` | :ref:`sv_width<class_ColorPicker_theme_constant_sv_width>` | ``256`` |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`add_preset<class_ColorPicker_theme_icon_add_preset>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`bar_arrow<class_ColorPicker_theme_icon_bar_arrow>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`color_hue<class_ColorPicker_theme_icon_color_hue>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`color_script<class_ColorPicker_theme_icon_color_script>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`expanded_arrow<class_ColorPicker_theme_icon_expanded_arrow>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`folded_arrow<class_ColorPicker_theme_icon_folded_arrow>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`menu_option<class_ColorPicker_theme_icon_menu_option>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`overbright_indicator<class_ColorPicker_theme_icon_overbright_indicator>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`picker_cursor<class_ColorPicker_theme_icon_picker_cursor>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`picker_cursor_bg<class_ColorPicker_theme_icon_picker_cursor_bg>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`sample_bg<class_ColorPicker_theme_icon_sample_bg>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`sample_revert<class_ColorPicker_theme_icon_sample_revert>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`screen_picker<class_ColorPicker_theme_icon_screen_picker>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`shape_circle<class_ColorPicker_theme_icon_shape_circle>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`shape_rect<class_ColorPicker_theme_icon_shape_rect>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`Texture2D<class_Texture2D>` | :ref:`shape_rect_wheel<class_ColorPicker_theme_icon_shape_rect_wheel>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`StyleBox<class_StyleBox>` | :ref:`picker_focus_circle<class_ColorPicker_theme_style_picker_focus_circle>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`StyleBox<class_StyleBox>` | :ref:`picker_focus_rectangle<class_ColorPicker_theme_style_picker_focus_rectangle>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
| :ref:`StyleBox<class_StyleBox>` | :ref:`sample_focus<class_ColorPicker_theme_style_sample_focus>` | |
|
|
+-----------------------------------+---------------------------------------------------------------------------------------------------------+---------------------------+
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Señales
|
|
--------------
|
|
|
|
.. _class_ColorPicker_signal_color_changed:
|
|
|
|
.. rst-class:: classref-signal
|
|
|
|
**color_changed**\ (\ color\: :ref:`Color<class_Color>`\ ) :ref:`🔗<class_ColorPicker_signal_color_changed>`
|
|
|
|
Emitida cuando se cambia el color.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_signal_preset_added:
|
|
|
|
.. rst-class:: classref-signal
|
|
|
|
**preset_added**\ (\ color\: :ref:`Color<class_Color>`\ ) :ref:`🔗<class_ColorPicker_signal_preset_added>`
|
|
|
|
Emitida cuando se añade un preajuste.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_signal_preset_removed:
|
|
|
|
.. rst-class:: classref-signal
|
|
|
|
**preset_removed**\ (\ color\: :ref:`Color<class_Color>`\ ) :ref:`🔗<class_ColorPicker_signal_preset_removed>`
|
|
|
|
Emitida cuando se elimina un preajuste.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Enumeraciones
|
|
--------------------------
|
|
|
|
.. _enum_ColorPicker_ColorModeType:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **ColorModeType**: :ref:`🔗<enum_ColorPicker_ColorModeType>`
|
|
|
|
.. _class_ColorPicker_constant_MODE_RGB:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`ColorModeType<enum_ColorPicker_ColorModeType>` **MODE_RGB** = ``0``
|
|
|
|
Permite editar el color con deslizadores de Rojo/Verde/Azul en el espacio de color sRGB.
|
|
|
|
.. _class_ColorPicker_constant_MODE_HSV:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`ColorModeType<enum_ColorPicker_ColorModeType>` **MODE_HSV** = ``1``
|
|
|
|
Permite editar el color con los deslizadores de Tono/Saturación/Valor.
|
|
|
|
.. _class_ColorPicker_constant_MODE_RAW:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`ColorModeType<enum_ColorPicker_ColorModeType>` **MODE_RAW** = ``2``
|
|
|
|
**Obsoleto:** This is replaced by :ref:`MODE_LINEAR<class_ColorPicker_constant_MODE_LINEAR>`.
|
|
|
|
|
|
|
|
.. _class_ColorPicker_constant_MODE_LINEAR:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`ColorModeType<enum_ColorPicker_ColorModeType>` **MODE_LINEAR** = ``2``
|
|
|
|
Permite editar el color con los deslizadores de Rojo/Verde/Azul en el espacio de color lineal.
|
|
|
|
.. _class_ColorPicker_constant_MODE_OKHSL:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`ColorModeType<enum_ColorPicker_ColorModeType>` **MODE_OKHSL** = ``3``
|
|
|
|
Permite editar el color con los deslizadores de Tono/Saturación/Luminosidad.
|
|
|
|
OKHSL es un nuevo espacio de color similar a HSL pero que se ajusta mejor a la percepción aprovechando el espacio de color Oklab, que está diseñado para ser simple de usar, al tiempo que hace un buen trabajo prediciendo la luminosidad, el croma y el tono percibidos.
|
|
|
|
\ `Espacios de color Okhsv y Okhsl <https://bottosson.github.io/posts/colorpicker/>`__
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _enum_ColorPicker_PickerShapeType:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **PickerShapeType**: :ref:`🔗<enum_ColorPicker_PickerShapeType>`
|
|
|
|
.. _class_ColorPicker_constant_SHAPE_HSV_RECTANGLE:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` **SHAPE_HSV_RECTANGLE** = ``0``
|
|
|
|
Espacio de color rectangular del modelo de color HSV.
|
|
|
|
.. _class_ColorPicker_constant_SHAPE_HSV_WHEEL:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` **SHAPE_HSV_WHEEL** = ``1``
|
|
|
|
Espacio de color rectangular del modelo de color HSV con una rueda.
|
|
|
|
.. _class_ColorPicker_constant_SHAPE_VHS_CIRCLE:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` **SHAPE_VHS_CIRCLE** = ``2``
|
|
|
|
Espacio de color circular del modelo de color HSV. Utiliza la Saturación como radio.
|
|
|
|
.. _class_ColorPicker_constant_SHAPE_OKHSL_CIRCLE:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` **SHAPE_OKHSL_CIRCLE** = ``3``
|
|
|
|
Espacio de color circular del modelo de color HSL OK.
|
|
|
|
.. _class_ColorPicker_constant_SHAPE_NONE:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` **SHAPE_NONE** = ``4``
|
|
|
|
La forma del espacio de color y el botón de selección de forma están ocultos. No se puede seleccionar desde el popup de formas.
|
|
|
|
.. _class_ColorPicker_constant_SHAPE_OK_HS_RECTANGLE:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` **SHAPE_OK_HS_RECTANGLE** = ``5``
|
|
|
|
Rectángulo del modelo de color OKHSL con luminosidad constante.
|
|
|
|
.. _class_ColorPicker_constant_SHAPE_OK_HL_RECTANGLE:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` **SHAPE_OK_HL_RECTANGLE** = ``6``
|
|
|
|
Rectángulo del modelo de color OKHSL con saturación constante.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de Propiedades
|
|
--------------------------------------------------------
|
|
|
|
.. _class_ColorPicker_property_can_add_swatches:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **can_add_swatches** = ``true`` :ref:`🔗<class_ColorPicker_property_can_add_swatches>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_can_add_swatches**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **are_swatches_enabled**\ (\ )
|
|
|
|
Si es ``true``, es posible añadir preajustes bajo Muestras. Si ``false``, el botón para añadir preajustes está desactivado.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_color:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`Color<class_Color>` **color** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_ColorPicker_property_color>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_pick_color**\ (\ value\: :ref:`Color<class_Color>`\ )
|
|
- :ref:`Color<class_Color>` **get_pick_color**\ (\ )
|
|
|
|
El color actualmente seleccionado.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_color_mode:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`ColorModeType<enum_ColorPicker_ColorModeType>` **color_mode** = ``0`` :ref:`🔗<class_ColorPicker_property_color_mode>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_color_mode**\ (\ value\: :ref:`ColorModeType<enum_ColorPicker_ColorModeType>`\ )
|
|
- :ref:`ColorModeType<enum_ColorPicker_ColorModeType>` **get_color_mode**\ (\ )
|
|
|
|
El modo del color seleccionado actualmente.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_color_modes_visible:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **color_modes_visible** = ``true`` :ref:`🔗<class_ColorPicker_property_color_modes_visible>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_modes_visible**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **are_modes_visible**\ (\ )
|
|
|
|
Si es ``true``, los botones del modo de color son visibles.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_deferred_mode:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **deferred_mode** = ``false`` :ref:`🔗<class_ColorPicker_property_deferred_mode>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_deferred_mode**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **is_deferred_mode**\ (\ )
|
|
|
|
Si es ``true``, el color se aplicará sólo después de que el usuario suelte el botón del ratón, de lo contrario se aplicará inmediatamente incluso en el evento de movimiento del ratón (lo que puede causar problemas de rendimiento).
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_edit_alpha:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **edit_alpha** = ``true`` :ref:`🔗<class_ColorPicker_property_edit_alpha>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_edit_alpha**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **is_editing_alpha**\ (\ )
|
|
|
|
Si es ``true``, muestra un deslizador de canal alfa (opacidad).
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_edit_intensity:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **edit_intensity** = ``true`` :ref:`🔗<class_ColorPicker_property_edit_intensity>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_edit_intensity**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **is_editing_intensity**\ (\ )
|
|
|
|
If ``true``, shows an intensity slider. The intensity is applied as follows: convert the color to linear encoding, multiply it by ``2 ** intensity``, and then convert it back to nonlinear sRGB encoding.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_hex_visible:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **hex_visible** = ``true`` :ref:`🔗<class_ColorPicker_property_hex_visible>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_hex_visible**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **is_hex_visible**\ (\ )
|
|
|
|
Si es ``true``, el campo de entrada del código de color hexadecimal es visible.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_picker_shape:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` **picker_shape** = ``0`` :ref:`🔗<class_ColorPicker_property_picker_shape>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_picker_shape**\ (\ value\: :ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>`\ )
|
|
- :ref:`PickerShapeType<enum_ColorPicker_PickerShapeType>` **get_picker_shape**\ (\ )
|
|
|
|
La forma de la vista del espacio de color.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_presets_visible:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **presets_visible** = ``true`` :ref:`🔗<class_ColorPicker_property_presets_visible>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_presets_visible**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **are_presets_visible**\ (\ )
|
|
|
|
Si es ``true``, los preajustes de Muestras y Colores Recientes son visibles.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_sampler_visible:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **sampler_visible** = ``true`` :ref:`🔗<class_ColorPicker_property_sampler_visible>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_sampler_visible**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **is_sampler_visible**\ (\ )
|
|
|
|
Si es ``true``, el selector de color y la vista previa del color son visibles.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_property_sliders_visible:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **sliders_visible** = ``true`` :ref:`🔗<class_ColorPicker_property_sliders_visible>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_sliders_visible**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **are_sliders_visible**\ (\ )
|
|
|
|
Si es ``true``, los deslizadores de color estarán visibles.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de Métodos
|
|
------------------------------------------------
|
|
|
|
.. _class_ColorPicker_method_add_preset:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **add_preset**\ (\ color\: :ref:`Color<class_Color>`\ ) :ref:`🔗<class_ColorPicker_method_add_preset>`
|
|
|
|
Añade el color dado a una lista de preajustes de color. Los preajustes se muestran en el selector de color y el usuario podrá seleccionarlos.
|
|
|
|
\ **Nota:** La lista de preajustes es solo para *este* selector de color.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_method_add_recent_preset:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **add_recent_preset**\ (\ color\: :ref:`Color<class_Color>`\ ) :ref:`🔗<class_ColorPicker_method_add_recent_preset>`
|
|
|
|
Añade el color dado a una lista de preajustes de color recientes para que pueda ser seleccionado más adelante. Los preajustes recientes son los colores que se han seleccionado recientemente, un nuevo preajuste se crea y se añade automáticamente a los preajustes recientes cuando seleccionas un nuevo color.
|
|
|
|
\ **Nota:** La lista de preajustes recientes es solo para *este* selector de color.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_method_erase_preset:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **erase_preset**\ (\ color\: :ref:`Color<class_Color>`\ ) :ref:`🔗<class_ColorPicker_method_erase_preset>`
|
|
|
|
Elimina el color dado de la lista de colores predefinidos de este selector de colores.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_method_erase_recent_preset:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **erase_recent_preset**\ (\ color\: :ref:`Color<class_Color>`\ ) :ref:`🔗<class_ColorPicker_method_erase_recent_preset>`
|
|
|
|
Elimina el color dado de la lista de preajustes de color recientes de este selector de color.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_method_get_presets:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`PackedColorArray<class_PackedColorArray>` **get_presets**\ (\ ) |const| :ref:`🔗<class_ColorPicker_method_get_presets>`
|
|
|
|
Devuelve la lista de colores en los preajustes del selector de colores.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_method_get_recent_presets:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`PackedColorArray<class_PackedColorArray>` **get_recent_presets**\ (\ ) |const| :ref:`🔗<class_ColorPicker_method_get_recent_presets>`
|
|
|
|
Devuelve la lista de colores en los preajustes recientes del selector de color.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de las propiedades del tema
|
|
----------------------------------------------------------------------------------
|
|
|
|
.. _class_ColorPicker_theme_color_focused_not_editing_cursor_color:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Color<class_Color>` **focused_not_editing_cursor_color** = ``Color(1, 1, 1, 0.275)`` :ref:`🔗<class_ColorPicker_theme_color_focused_not_editing_cursor_color>`
|
|
|
|
Color del rectángulo o círculo dibujado cuando una parte de la forma del selector está enfocada pero no se puede editar mediante el teclado o el mando. Se muestra *sobre* la forma del selector, por lo que se debe utilizar un color parcialmente transparente para garantizar que la forma del selector siga siendo visible.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_constant_center_slider_grabbers:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`int<class_int>` **center_slider_grabbers** = ``1`` :ref:`🔗<class_ColorPicker_theme_constant_center_slider_grabbers>`
|
|
|
|
Anula la propiedad de tema :ref:`Slider.center_grabber<class_Slider_theme_constant_center_grabber>` de los deslizadores.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_constant_h_width:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`int<class_int>` **h_width** = ``30`` :ref:`🔗<class_ColorPicker_theme_constant_h_width>`
|
|
|
|
El ancho del deslizador de selección de tonos.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_constant_label_width:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`int<class_int>` **label_width** = ``10`` :ref:`🔗<class_ColorPicker_theme_constant_label_width>`
|
|
|
|
El ancho mínimo de las etiquetas de color junto a los deslizadores.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_constant_margin:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`int<class_int>` **margin** = ``4`` :ref:`🔗<class_ColorPicker_theme_constant_margin>`
|
|
|
|
El margen alrededor del **ColorPicker**.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_constant_sv_height:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`int<class_int>` **sv_height** = ``256`` :ref:`🔗<class_ColorPicker_theme_constant_sv_height>`
|
|
|
|
La altura del cuadro de selección del valor de la saturación.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_constant_sv_width:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`int<class_int>` **sv_width** = ``256`` :ref:`🔗<class_ColorPicker_theme_constant_sv_width>`
|
|
|
|
El ancho de la caja de selección del valor de saturación.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_add_preset:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **add_preset** :ref:`🔗<class_ColorPicker_theme_icon_add_preset>`
|
|
|
|
El icono del botón "Añadir Preajuste".
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_bar_arrow:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **bar_arrow** :ref:`🔗<class_ColorPicker_theme_icon_bar_arrow>`
|
|
|
|
La textura para el agarrador de flecha.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_color_hue:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **color_hue** :ref:`🔗<class_ColorPicker_theme_icon_color_hue>`
|
|
|
|
Textura personalizada para el deslizador de selección de tonos de la derecha.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_color_script:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **color_script** :ref:`🔗<class_ColorPicker_theme_icon_color_script>`
|
|
|
|
El icono para el botón que cambia el texto del color a hexadecimal.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_expanded_arrow:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **expanded_arrow** :ref:`🔗<class_ColorPicker_theme_icon_expanded_arrow>`
|
|
|
|
El icono para el menú desplegable de preajustes de color cuando está expandido.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_folded_arrow:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **folded_arrow** :ref:`🔗<class_ColorPicker_theme_icon_folded_arrow>`
|
|
|
|
El icono para el menú desplegable de preajustes de color cuando está plegado.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_menu_option:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **menu_option** :ref:`🔗<class_ColorPicker_theme_icon_menu_option>`
|
|
|
|
El icono para el menú de opciones de preajustes de color.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_overbright_indicator:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **overbright_indicator** :ref:`🔗<class_ColorPicker_theme_icon_overbright_indicator>`
|
|
|
|
El indicador utilizado para señalar que el valor del color está fuera del rango de 0-1.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_picker_cursor:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **picker_cursor** :ref:`🔗<class_ColorPicker_theme_icon_picker_cursor>`
|
|
|
|
La imagen que se muestra sobre la caja/círculo de color (dependiendo de :ref:`picker_shape<class_ColorPicker_property_picker_shape>`), marcando el color actualmente seleccionado.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_picker_cursor_bg:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **picker_cursor_bg** :ref:`🔗<class_ColorPicker_theme_icon_picker_cursor_bg>`
|
|
|
|
La imagen de relleno que se muestra detrás del cursor del selector.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_sample_bg:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **sample_bg** :ref:`🔗<class_ColorPicker_theme_icon_sample_bg>`
|
|
|
|
Panel de fondo para la caja de vista previa del color (visible cuando el color es translúcido).
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_sample_revert:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **sample_revert** :ref:`🔗<class_ColorPicker_theme_icon_sample_revert>`
|
|
|
|
El icono para el botón de revertir (visible en el medio del color "antiguo" cuando difiere del color seleccionado actualmente). Este icono se modula con un color oscuro si el color "antiguo" es lo suficientemente brillante, por lo que el icono debe ser brillante para garantizar la visibilidad en ambos escenarios.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_screen_picker:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **screen_picker** :ref:`🔗<class_ColorPicker_theme_icon_screen_picker>`
|
|
|
|
El icono del botón del selector de color de la pantalla.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_shape_circle:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **shape_circle** :ref:`🔗<class_ColorPicker_theme_icon_shape_circle>`
|
|
|
|
El icono para formas de selector circulares.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_shape_rect:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **shape_rect** :ref:`🔗<class_ColorPicker_theme_icon_shape_rect>`
|
|
|
|
El icono para formas de selector rectangulares.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_icon_shape_rect_wheel:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`Texture2D<class_Texture2D>` **shape_rect_wheel** :ref:`🔗<class_ColorPicker_theme_icon_shape_rect_wheel>`
|
|
|
|
El icono para formas de selector de rueda rectangular.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_style_picker_focus_circle:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`StyleBox<class_StyleBox>` **picker_focus_circle** :ref:`🔗<class_ColorPicker_theme_style_picker_focus_circle>`
|
|
|
|
El :ref:`StyleBox<class_StyleBox>` usado cuando la parte con forma de círculo del selector está enfocada. Se muestra *sobre* la forma del selector, por lo que se debe usar un :ref:`StyleBox<class_StyleBox>` parcialmente transparente para asegurar que la forma del selector permanezca visible. Un :ref:`StyleBox<class_StyleBox>` que representa un contorno o un subrayado funciona bien para este propósito. Para deshabilitar el efecto visual de enfoque, asigna un recurso :ref:`StyleBoxEmpty<class_StyleBoxEmpty>`. Nota que deshabilitar el efecto visual de enfoque dañará la usabilidad de la navegación con teclado/mando, por lo que esto no se recomienda por razones de accesibilidad.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_style_picker_focus_rectangle:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`StyleBox<class_StyleBox>` **picker_focus_rectangle** :ref:`🔗<class_ColorPicker_theme_style_picker_focus_rectangle>`
|
|
|
|
El :ref:`StyleBox<class_StyleBox>` usado cuando la parte con forma de rectángulo del selector está enfocada. Se muestra *sobre* la forma del selector, por lo que se debe usar un :ref:`StyleBox<class_StyleBox>` parcialmente transparente para asegurar que la forma del selector permanezca visible. Un :ref:`StyleBox<class_StyleBox>` que representa un contorno o un subrayado funciona bien para este propósito. Para deshabilitar el efecto visual de enfoque, asigna un recurso :ref:`StyleBoxEmpty<class_StyleBoxEmpty>`. Nota que deshabilitar el efecto visual de enfoque dañará la usabilidad de la navegación con teclado/mando, por lo que esto no se recomienda por razones de accesibilidad.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_ColorPicker_theme_style_sample_focus:
|
|
|
|
.. rst-class:: classref-themeproperty
|
|
|
|
:ref:`StyleBox<class_StyleBox>` **sample_focus** :ref:`🔗<class_ColorPicker_theme_style_sample_focus>`
|
|
|
|
El :ref:`StyleBox<class_StyleBox>` usado para la parte de muestra del color anterior cuando está enfocada. Se muestra *sobre* la muestra, por lo que se debe usar un :ref:`StyleBox<class_StyleBox>` parcialmente transparente para asegurar que la forma del selector permanezca visible. Un :ref:`StyleBox<class_StyleBox>` que representa un contorno o un subrayado funciona bien para este propósito. Para deshabilitar el efecto visual de enfoque, asigna un recurso :ref:`StyleBoxEmpty<class_StyleBoxEmpty>`. Nota que deshabilitar el efecto visual de enfoque dañará la usabilidad de la navegación con teclado/mando, por lo que esto no se recomienda por razones de accesibilidad.
|
|
|
|
.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)`
|
|
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
|
.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)`
|
|
.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)`
|
|
.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)`
|
|
.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)`
|
|
.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)`
|
|
.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)`
|
|
.. |void| replace:: :abbr:`void (Sin valor de retorno.)`
|