ColorPicker¶
Inherits: BoxContainer < Container < Control < CanvasItem < Node < Object
选色器控制。
描述¶
显示一个取色器部件。可以从RGB/RGBA彩色空间内选取一个颜色。
注意:这个控件就是取色器本身。如果你需要一个能够弹出一个ColorPicker
窗口的按钮,你可以使用一个ColorPickerButton来代替它。
教程¶
属性¶
|
||
|
||
|
||
|
||
|
||
|
||
|
方法¶
void |
add_preset ( Color color ) |
void |
erase_preset ( Color color ) |
get_presets ( ) const |
主题属性¶
|
||
|
||
|
||
|
||
|
||
信号¶
color_changed ( Color color )
更改颜色时发出。
preset_added ( Color color )
添加预设时发出。
preset_removed ( Color color )
删除预设时发出。
属性说明¶
Color color
Default |
|
Setter |
set_pick_color(value) |
Getter |
get_pick_color() |
当前选择的颜色。
bool deferred_mode
Default |
|
Setter |
set_deferred_mode(value) |
Getter |
is_deferred_mode() |
如果true
,只有在用户松开鼠标按钮后才会应用颜色,否则即使在鼠标移动事件中也会立即应用(会造成性能问题)。
bool edit_alpha
Default |
|
Setter |
set_edit_alpha(value) |
Getter |
is_editing_alpha() |
如果true
,显示alpha通道滑块(透明度)。
bool hsv_mode
Default |
|
Setter |
set_hsv_mode(value) |
Getter |
is_hsv_mode() |
如果true
,则允许使用“色相/饱和度/值”滑块编辑颜色。
注意:如果启用了原始模式,则无法启用。
bool presets_enabled
Default |
|
Setter |
set_presets_enabled(value) |
Getter |
are_presets_enabled() |
如果true
,则启用 "添加预置 "按钮。
bool presets_visible
Default |
|
Setter |
set_presets_visible(value) |
Getter |
are_presets_visible() |
如果true
,则保存的颜色预设可见。
bool raw_mode
Default |
|
Setter |
set_raw_mode(value) |
Getter |
is_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
Default |
|
色相选择滑块的宽度。
int label_width
Default |
|
int margin
Default |
|
ColorPicker
周围的边距。
int sv_height
Default |
|
饱和值选择框的高度。
int sv_width
Default |
|
饱和度选择框的宽度。
Texture add_preset
添加预设 "按钮的图标。
Texture color_hue
右侧的色相选择滑块的自定义纹理。
Texture color_sample
Texture overbright_indicator
该指示器用于指示颜色值在0-1范围之外。
Texture preset_bg
Texture screen_picker
屏幕颜色选择器按钮的图标。