Colors（颜色）

显示原文

The color module handles all color-related functions like changing color depth, creating colors from hex code, converting between color depths, mixing colors, etc.

The type lv_color_t is used to store a color in RGB888 format. This type and format is used in almost all APIs regardless to LV_COLOR_DEPTH.

颜色模块处理所有与颜色相关的功能，如更改颜色深度、从十六进制代码创建颜色、在不同颜色深度之间转换、混合颜色等。

类型 lv_color_t 用于存储 RGB888 格式的颜色。这个类型和格式在几乎所有的 API 中都被使用，与 LV_COLOR_DEPTH 无关。

Creating colors（创造色彩）

RGB（三原色）

显示原文

Create colors from Red, Green and Blue channel values:

/* All channels are 0-255 */
lv_color_t c = lv_color_make(red, green, blue);


/* Same but can be used for const initialization as well */
lv_color_t c = LV_COLOR_MAKE(red, green, blue);

/* From hex code 0x000000..0xFFFFFF interpreted as RED + GREEN + BLUE */
lv_color_t c = lv_color_hex(0x123456);

/* From 3 digits. Same as lv_color_hex(0x112233) */
lv_color_t c = lv_color_hex3(0x123);

从红色、绿色和蓝色通道值创建颜色

/*All channels are 0-255*/
lv_color_t c = lv_color_make(red, green, blue);


/*Same but can be used for const initialization too */
lv_color_t c = LV_COLOR_MAKE(red, green, blue);

/*From hex code 0x000000..0xFFFFFF interpreted as RED + GREEN + BLUE*/
lv_color_t c = lv_color_hex(0x123456);

/*From 3 digits. Same as lv_color_hex(0x112233)*/
lv_color_t c = lv_color_hex3(0x123);

HSV（色调饱和值-Hue Saturation Value）

显示原文

Create colors from Hue, Saturation and Value values:

//h = 0..359, s = 0..100, v = 0..100
lv_color_t c = lv_color_hsv_to_rgb(h, s, v);

//All channels are 0-255
lv_color_hsv_t c_hsv = lv_color_rgb_to_hsv(r, g, b);


//From lv_color_t variable
lv_color_hsv_t c_hsv = lv_color_to_hsv(color);

根据色相、饱和度和值创建颜色

//h = 0..359, s = 0..100, v = 0..100
lv_color_t c = lv_color_hsv_to_rgb(h, s, v);

//All channels are 0-255
lv_color_hsv_t c_hsv = lv_color_rgb_to_hsv(r, g, b);


//From lv_color_t variable
lv_color_hsv_t c_hsv = lv_color_to_hsv(color);

Palette（调色板）

显示原文

LVGL includes Material Design's palette of colors. In this system all named colors have a nominal main color as well as four darker and five lighter variants.

The names of the colors are as follows:

LV_PALETTE_RED
LV_PALETTE_PINK
LV_PALETTE_PURPLE
LV_PALETTE_DEEP_PURPLE
LV_PALETTE_INDIGO
LV_PALETTE_BLUE
LV_PALETTE_LIGHT_BLUE
LV_PALETTE_CYAN
LV_PALETTE_TEAL
LV_PALETTE_GREEN
LV_PALETTE_LIGHT_GREEN
LV_PALETTE_LIME
LV_PALETTE_YELLOW
LV_PALETTE_AMBER
LV_PALETTE_ORANGE
LV_PALETTE_DEEP_ORANGE
LV_PALETTE_BROWN
LV_PALETTE_BLUE_GREY
LV_PALETTE_GREY

To get the main color use lv_color_t c = lv_palette_main(LV_PALETTE_...).

For the lighter variants of a palette color use lv_color_t c = lv_palette_lighten(LV_PALETTE_..., v). v can be 1..5. For the darker variants of a palette color use lv_color_t c = lv_palette_darken(LV_PALETTE_..., v). v can be 1..4.

LVGL 包含了 Material Design 的调色板。在这个系统中，所有命名的颜色都有一个主要颜色以及四种较暗和五种较亮的变体。

这些颜色的名称如下：

LV_PALETTE_RED
LV_PALETTE_PINK
LV_PALETTE_PURPLE
LV_PALETTE_DEEP_PURPLE
LV_PALETTE_INDIGO
LV_PALETTE_BLUE
LV_PALETTE_LIGHT_BLUE
LV_PALETTE_CYAN
LV_PALETTE_TEAL
LV_PALETTE_GREEN
LV_PALETTE_LIGHT_GREEN
LV_PALETTE_LIME
LV_PALETTE_YELLOW
LV_PALETTE_AMBER
LV_PALETTE_ORANGE
LV_PALETTE_DEEP_ORANGE
LV_PALETTE_BROWN
LV_PALETTE_BLUE_GREY
LV_PALETTE_GREY

要获取主要颜色，可以使用 lv_color_t c = lv_palette_main(LV_PALETTE_...)。

对于调色板颜色的较亮变体，可以使用 lv_color_t c = lv_palette_lighten(LV_PALETTE_..., v)。 v 可以是 1..5。对于调色板颜色的较暗变体，可以使用 lv_color_t c = lv_palette_darken(LV_PALETTE_..., v)。 v 可以是 1..4。

Modify and mix colors（修改和混合颜色）

显示原文

The following functions can modify a color:

// Lighten a color. 0: no change, 255: white
lv_color_t c = lv_color_lighten(c, lvl);

// Darken a color. 0: no change, 255: black
lv_color_t c = lv_color_darken(lv_color_t c, lv_opa_t lvl);

// Lighten or darken a color. 0: black, 128: no change 255: white
lv_color_t c = lv_color_change_lightness(lv_color_t c, lv_opa_t lvl);


// Mix two colors with a given ratio 0: full c2, 255: full c1, 128: half c1 and half c2
lv_color_t c = lv_color_mix(c1, c2, ratio);

以下函数可以修改颜色：

// Lighten a color. 0: no change, 255: white
lv_color_t c = lv_color_lighten(c, lvl);

// Darken a color. 0: no change, 255: black
lv_color_t c = lv_color_darken(lv_color_t c, lv_opa_t lvl);

// Lighten or darken a color. 0: black, 128: no change 255: white
lv_color_t c = lv_color_change_lightness(lv_color_t c, lv_opa_t lvl);


// Mix two colors with a given ratio 0: full c2, 255: full c1, 128: half c1 and half c2
lv_color_t c = lv_color_mix(c1, c2, ratio);

Built-in colors（内置颜色）

显示原文

lv_color_white() and lv_color_black() return 0xFFFFFF and 0x000000 respectively.

lv_color_white() 和 lv_color_black() 分别返回 0xFFFFFF 和 0x000000。

Opacity（不透明度）

显示原文

To describe opacity the lv_opa_t type is created from uint8_t. Some special purpose defines are also introduced:

LV_OPA_TRANSP Value: 0, means no opacity making the color completely transparent
LV_OPA_10 Value: 25, means the color covers only a little
LV_OPA_20 ... OPA_80 follow logically
LV_OPA_90 Value: 229, means the color near completely covers
LV_OPA_COVER Value: 255, means the color completely covers (full opacity)

You can also use the LV_OPA_* defines in lv_color_mix() as a mixing ratio.

为了描述不透明度，创建了 lv_opa_t 类型，它是基于 uint8_t 类型的。同时，还引入了一些特殊用途的定义：

LV_OPA_TRANSP 值：0，表示没有不透明度，使颜色完全透明
LV_OPA_10 值：25，表示颜色只覆盖一点点
LV_OPA_20 ... OPA_80 按逻辑顺序递增
LV_OPA_90 值：229，表示颜色几乎完全覆盖
LV_OPA_COVER 值：255，表示颜色完全覆盖（完全不透明）

你也可以在 lv_color_mix() 中使用 LV_OPA_* 定义作为混合比例。

API