LVGL 颜色选择器|极客笔记

颜色选择器(lv_cpicker)顾名思义，拾色器允许选择颜色。可以依次选择颜色的色相，饱和度和值。

小部件有两种形式：圆形（圆盘）和矩形。

在这两种形式中，长按对象，颜色选择器将更改为颜色的下一个参数（色相，饱和度或值）。此外，双击将重置当前参数。

零件和样式

拾色器的主要部分称为 LV_CPICKER_PART_BG 。以圆形形式，它使用scale_width设置圆的宽度，并使用pad_inner在圆和内部预览圆之间填充。在矩形模式下，半径可以用于在矩形上应用半径。

该对象具有称为的虚拟部分 LV_CPICKER_PART_KNOB ，它是在当前值上绘制的矩形（或圆形）。它使用所有矩形（如样式属性和填充）使其大于圆形或矩形背景的宽度。

用法

类型

可以使用 lv_cpicker_set_type(cpicker, LV_CPICKER_TYPE_RECT/DISC) 更改颜色选择器的类型

设定颜色

可以使用 lv_cpicker_set_hue/saturation/value(cpicker, x) 手动设置colro，或者使用 lv_cpicker_set_hsv(cpicker, hsv) 或 lv_cpicker_set_color(cpicker, rgb) 一次全部设置

色彩模式

可以使用 lv_cpicker_set_color_mode(cpicker, LV_CPICKER_COLOR_MODE_HUE/SATURATION/VALUE) 手动选择当前颜色。

使用 lv_cpicker_set_color_mode_fixed(cpicker, true) 固定颜色（不要长按更改）

旋钮颜色

lv_cpicker_set_knob_colored(cpicker, true) 使旋钮自动将所选颜色显示为背景色。

事件

仅通用事件是按对象类型发送的。

了解有关事件的更多信息。

按键

LV_KEY_UP, LV_KEY_RIGHT 将当前参数的值增加1
LV_KEY_DOWN, LV_KEY_LEFT 将当前参数减1
LV_KEY_ENTER 长按将显示下一个模式。通过双击将重置当前参数。

进一步了解按键。

范例

光盘颜色选择器

LVGL颜色选择器

光盘颜色选择器

上述效果的示例代码：

#include "../../../lv_examples.h"
#if LV_USE_CPICKER

void lv_ex_cpicker_1(void)
{
    lv_obj_t * cpicker;

    cpicker = lv_cpicker_create(lv_scr_act(), NULL);
    lv_obj_set_size(cpicker, 200, 200);
    lv_obj_align(cpicker, NULL, LV_ALIGN_CENTER, 0, 0);
}

#endif

相关API

函数

lv_obj_t * lv_cpicker_create(lv_obj_t * par，constlv_obj_t *copy)
功能：创建一个颜色选择器对象
返回：
指向创建的颜色选择器的指针
形参：
par：指向对象的指针，它将是新colorpicker的父对象
copy：指向颜色选择器对象的指针，如果不为NULL，则将从其复制新对象


void lv_cpicker_set_type(lv_obj_t * cpicker，lv_cpicker_type_t type)
功能：为选色器设置新类型
形参：
cpicker：指向颜色选择器对象的指针
type：新型的颜色选择器(来自“ lv_cpicker_type_t”枚举)


bool lv_cpicker_set_hue(lv_obj_t * cpicker，uint16_t hue)
功能：设置颜色选择器的当前色相。
返回：
如果更改，则为true，否则为false
形参：
cpicker：指向colorpicker对象的指针
hue：当前选择的色相[0..360]


bool lv_cpicker_set_saturation(lv_obj_t * cpicker，uint8_t saturation)
功能：设置颜色选择器的当前饱和度。
返回：
如果更改，则为true，否则为false
形参：
cpicker：指向colorpicker对象的指针
saturation：当前选择的饱和度[0..100]


bool lv_cpicker_set_value(lv_obj_t * cpicker，uint8_t val )
功能：设置颜色选择器的当前值。
返回：
如果更改，则为true，否则为false
形参：
cpicker：指向colorpicker对象的指针
val：当前选择的值[0..100]


bool lv_cpicker_set_hsv(lv_obj_t * cpicker，lv_color_hsv_t hsv )
功能：设置颜色选择器的当前hsv。
返回：
如果更改，则为true，否则为false
形参：
cpicker：指向colorpicker对象的指针
hsv：当前选择的hsv


bool lv_cpicker_set_color(lv_obj_t * cpicker，lv_color_t color)
功能：设置颜色选择器的当前颜色。
返回：
如果更改，则为true，否则为false
形参：
cpicker：指向colorpicker对象的指针
color：当前选择的颜色


void lv_cpicker_set_color_mode(lv_obj_t * cpicker，lv_cpicker_color_mode_t mode)
功能：设置当前的色彩模式。
形参：
cpicker：指向colorpicker对象的指针
mode：色彩模式(色相/饱和度/色度)


void lv_cpicker_set_color_mode_fixed(lv_obj_t * cpicker，bool fixed)
功能：长时间按中心更改颜色模式时设置
形参：
cpicker：指向colorpicker对象的指针
fixed：长按时无法更改色彩模式


void lv_cpicker_set_knob_colored(lv_obj_t * cpicker，bool en )
功能：使旋钮上色为当前颜色
形参：
cpicker：指向colorpicker对象的指针
en：true：为旋钮着色；false：不给旋钮上色


lv_cpicker_color_mode_t lv_cpicker_get_color_mode(lv_obj_t * cpicker )
功能：获取当前的颜色模式。
返回：
色彩模式(色相/饱和度/色度)
形参：
cpicker：指向colorpicker对象的指针


bool lv_cpicker_get_color_mode_fixed(lv_obj_t * cpicker )
功能：长按中心时获取颜色模式是否更改
返回：
长按无法更改模式
形参：
cpicker：指向colorpicker对象的指针


uint16_t lv_cpicker_get_hue(lv_obj_t * cpicker )
功能：获取颜色选择器的当前色相。
返回：
当前选择的色相
形参：
cpicker：指向colorpicker对象的指针


uint8_t lv_cpicker_get_saturation(lv_obj_t * cpicker )
功能：获取选色器的当前饱和度。
返回：
当前选择的饱和度
形参：
cpicker：指向colorpicker对象的指针


uint8_t lv_cpicker_get_value(lv_obj_t * cpicker )
功能：获取颜色选择器的当前色相。
返回：
当前选择值
形参：
cpicker：指向colorpicker对象的指针


lv_color_hsv_t lv_cpicker_get_hsv(lv_obj_t * cpicker )
功能：获取选色器的当前选定的hsv。
返回：
当前选择的hsv
形参：
cpicker：指向colorpicker对象的指针


lv_color_t lv_cpicker_get_color(lv_obj_t * cpicker )
功能：获取颜色选择器的当前选定颜色。
返回：
当前选择的颜色
形参：
cpicker：指向colorpicker对象的指针


bool lv_cpicker_get_knob_colored(lv_obj_t * cpicker )
功能：旋钮是否着色为当前颜色
返回：
true：为旋钮着色；false：不给旋钮上色
形参：
cpicker：指向颜色选择器对象的指针