ColorPicker

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

选色器控制。

描述

显示一个取色器部件。可以从RGB/RGBA彩色空间内选取一个颜色。

注意：这个控件就是取色器本身。如果你需要一个能够弹出一个ColorPicker窗口的按钮，你可以使用一个ColorPickerButton来代替它。

教程

• Tween Demo

属性

方法

主题属性

信号

• color_changed ( Color color )

更改颜色时发出。

• preset_added ( Color color )

添加预设时发出。

• preset_removed ( Color color )

删除预设时发出。

属性说明

• Color color

当前选择的颜色。

• bool deferred_mode

如果true，只有在用户松开鼠标按钮后才会应用颜色，否则即使在鼠标移动事件中也会立即应用(会造成性能问题)。

• bool edit_alpha

如果true，显示alpha通道滑块（透明度）。

• bool hsv_mode

如果true，则允许使用“色相/饱和度/值”滑块编辑颜色。

注意：如果启用了原始模式，则无法启用。

• bool presets_enabled

如果true，则启用 “添加预置 “按钮。

• bool presets_visible

如果true，则保存的颜色预设可见。

• bool raw_mode

如果true，则允许颜色R，G，B分量值超过1.0，该值可用于需要它的某些特殊操作（例如着色而不会使HDR变暗或渲染精灵）。

注意：如果启用了HSV模式，则无法启用。

方法说明

• void add_preset ( Color color )

将给定的颜色添加到颜色预设列表中。用户将能够选择颜色选择器中颜色预设。

注意：预设列表仅适用于这个颜色选择器。

• void erase_preset ( Color color )

从这个颜色选择器的颜色预设列表中删除给定的颜色。

• PoolColorArray get_presets ( ) const

返回颜色选择器预设中的颜色列表。

Theme Property Descriptions

• int h_width

色相选择滑块的宽度。

• int label_width

• int margin

ColorPicker周围的边距。

• int sv_height

饱和值选择框的高度。

• int sv_width

饱和度选择框的宽度。

• Texture add_preset

添加预设 “按钮的图标。

• Texture color_hue

右侧的色相选择滑块的自定义纹理。

• Texture color_sample

• Texture overbright_indicator

该指示器用于指示颜色值在0-1范围之外。

• Texture preset_bg

• Texture screen_picker

屏幕颜色选择器按钮的图标。