Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

ColorPicker

Inherits: BoxContainer < Container < Control < CanvasItem < Node < Object

Control de selección de color.

Descripción

Displays a color picker widget. Useful for selecting a color from an RGB/RGBA colorspace.

Note: This control is the color picker widget itself. You can use a ColorPickerButton instead if you need a button that brings up a ColorPicker in a pop-up.

Tutoriales

Propiedades

Color

color

Color( 1, 1, 1, 1 )

bool

deferred_mode

false

bool

edit_alpha

true

bool

hsv_mode

false

bool

presets_enabled

true

bool

presets_visible

true

bool

raw_mode

false

Métodos

void

add_preset ( Color color )

void

erase_preset ( Color color )

PoolColorArray

get_presets ( ) const

Propiedades del Theme

int

h_width

30

int

label_width

10

int

margin

4

int

sv_height

256

int

sv_width

256

Texture

add_preset

Texture

color_hue

Texture

color_sample

Texture

overbright_indicator

Texture

preset_bg

Texture

screen_picker

Señales

  • color_changed ( Color color )

Emitido cuando se cambia el color.


  • preset_added ( Color color )

Emitido cuando se añade un preajuste.


  • preset_removed ( Color color )

Se emite cuando se elimina una preajuste.

Descripciones de Propiedades

Default

Color( 1, 1, 1, 1 )

Setter

set_pick_color(value)

Getter

get_pick_color()

El color actualmente seleccionado.


  • bool deferred_mode

Default

false

Setter

set_deferred_mode(value)

Getter

is_deferred_mode()

Si 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).


Default

true

Setter

set_edit_alpha(value)

Getter

is_editing_alpha()

Si true, muestra un deslizador de canal alfa (transparencia).


Default

false

Setter

set_hsv_mode(value)

Getter

is_hsv_mode()

Si true, permite editar el color con los deslizadores de Tono/Saturación/Valor.

Nota: No puede ser activado si el modo raw está activado.


  • bool presets_enabled

Default

true

Setter

set_presets_enabled(value)

Getter

are_presets_enabled()

Si true, el botón "añadir preajuste" está activado.


  • bool presets_visible

Default

true

Setter

set_presets_visible(value)

Getter

are_presets_visible()

Si true, los preajustes de color guardados son visibles.


Default

false

Setter

set_raw_mode(value)

Getter

is_raw_mode()

Si true, permite que los valores de los componentes de color R, G, B vayan más allá de 1.0, lo que puede ser usado para ciertas operaciones especiales que lo requieran (como teñir sin oscurecer o renderizar sprites en HDR).

Nota: No se puede activar si el modo HSV está activado.

Descripciones de Métodos

  • void add_preset ( 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.


  • void erase_preset ( Color color )

Elimina el color dado de la lista de colores predefinidos de este selector de colores.


Devuelve la lista de colores en los preajustes del selector de colores.

Theme Property Descriptions

Default

30

El ancho del deslizador de selección de tonos.


  • int label_width

Default

10


Default

4

El margen alrededor del ColorPicker.


  • int sv_height

Default

256

La altura del cuadro de selección del valor de la saturación.


Default

256

El ancho de la caja de selección del valor de saturación.


El icono del botón "Añadir Preajuste".


Textura personalizada para el deslizador de selección de tonos de la derecha.



El indicador utilizado para señalar que el valor del color está fuera del rango de 0-1.



El icono del botón del selector de color de la pantalla.