LVGL-label控件

毕瀚
2023-12-01

label的对齐方式

lv_obj_set_width(label, LV_HOR_RES_MAX);//
lv_obj_align(label, parent, LV_ALIGN_IN_TOP_MID, 0, 95 + (j*157));//文本控件的对齐方式
lv_label_set_long_mode(label, LV_LABEL_LONG_BREAK);
lv_label_set_align(label, LV_LABEL_ALIGN_CENTER);//文本内容的对齐方式。

注意:创建 label 并且设置文本和长模式后, 控件的大小已经扩展到文本大小,
因此需要先设置长模式, 然后设置控件尺寸。

label渲染

1、lv_label_design()

2、先label的背景矩形,再label的文字。每种对象都有渲染描述(lv_draw_xx_dsc_t),渲染描述先初始化再从对象的风格链表里面去取。

        lv_draw_rect_dsc_init(&draw_rect_dsc);
        lv_obj_init_draw_rect_dsc(label, LV_LABEL_PART_MAIN, &draw_rect_dsc);                lv_draw_rect(&bg_coords, clip_area, &draw_rect_dsc);

        lv_draw_label_dsc_init(&label_draw_dsc);
        lv_obj_init_draw_label_dsc(label, LV_LABEL_PART_MAIN, &label_draw_dsc);                 lv_draw_label(&txt_coords, &txt_clip, &label_draw_dsc, ext->text, hint);

3、 通过两层循环完成整个字符的显示。 一次lv_draw_letter()只显示一个字符。lv_draw_line()是下划线,删除线的渲染。

        lv_draw_letter(&pos, mask, font, letter, color,opa,dsc->blend_mode);

        lv_draw_line(&p1, &p2, mask, &line_dsc);

4、

enum {
    LV_FONT_SUBPX_NONE,
    LV_FONT_SUBPX_HOR,
    LV_FONT_SUBPX_VER,
    LV_FONT_SUBPX_BOTH,
};

typedef uint8_t lv_font_subpx_t;

    if(font_p->subpx) {
        draw_letter_subpx(pos_x, pos_y, &g, clip_area, map_p, color, opa, blend_mode);
    }
    else {
        draw_letter_normal(pos_x, pos_y, &g, clip_area, map_p, color, opa, blend_mode);
    }

label滚动

label = lv_label_create(parent, NULL);
lv_label_set_long_mode(label,LV_LABEL_LONG_SROLL_CIRC);
lv_label_set_anim_speed(label, 5);

label编码

用户可以在lv_conf.h中配置文本的编码方式,如果用户没有配置则使用lv_conf_internal.h中的内部默认的配置。

/*lv_conf.h中配置。Select a character encoding for strings. Your IDE or editor should have the same character encoding.* - LV_TXT_ENC_UTF8 * - LV_TXT_ENC_ASCII*/
#define LV_TXT_ENC LV_TXT_ENC_UTF8

/*lv_conf_internal.h中配置。*/

#ifndef LV_TXT_ENC
#  ifdef CONFIG_LV_TXT_ENC
#    define LV_TXT_ENC CONFIG_LV_TXT_ENC
#  else
#    define  LV_TXT_ENC LV_TXT_ENC_UTF8
#  endif
#endif

Unicode字符集可以简写为UCS(Unicode Character Set)。早期的Unicode标准有UCS-2、UCS-4的说法。UCS-2用两个字节编码,UCS-4用4个字节编码。UCS-4根据最高位为0的最高字节分成2^7=128个group。每个group再根据次高字节分为256个平面(plane)。每个平面根据第3个字节分为256行(row),每行有256个码位(cell)。group 0的平面0被称作BMP(Basic Multilingual Plane)。将UCS-4的BMP去掉前面的两个零字节就得到了UCS-2。

每个平面有2^16=65536个码位。Unicode计划使用了17个平面,一共有17*65536=1114112个码位。在Unicode 5.0.0版本中,已定义的码位只有238605个,分布在平面0、平面1、平面2、平面14、平面15、平面16。其中平面15和平面16上只是定义了两个各占65534个码位的专用区(Private Use Area),分别是0xF0000-0xFFFFD和0x100000-0x10FFFD。所谓专用区,就是保留给大家放自定义字符的区域,可以简写为PUA。

3400-4DBF/4E00-9FFF/20000-3FFFF:CJK统一表意符号(CJK Unified Ideographs)

汉字unicode编码表:一般使用2w基本汉字就够了

字符集    字数    Unicode 编码
基本汉字    20902字    4E00-9FA5
基本汉字补充    38字    9FA6-9FCB
扩展A    6582字    3400-4DB5
扩展B    42711字    20000-2A6D6
扩展C    4149字    2A700-2B734
扩展D    222字    2B740-2B81D
康熙部首    214字    2F00-2FD5
部首扩展    115字    2E80-2EF3
兼容汉字    477字    F900-FAD9
兼容扩展    542字    2F800-2FA1D
PUA(GBK)部件    81字    E815-E86F
部件扩展    452字    E400-E5E8
PUA增补    207字    E600-E6CF
汉字笔画    36字    31C0-31E3
汉字结构    12字    2FF0-2FFB
汉语注音    22字    3105-3120
注音扩展    22字    31A0-31BA
〇    1字    3007

E000-F8FF:自行使用区域(Private Use Zone)

平面0上定义了27973个汉字。平面2的43253个字符都是汉字。常用汉字都是在平面0上。

CJK:中日韩越统一表意文字(CJKV Unified Ideographs),目的是要把分别来自中文、日文、韩文中,本质相同、形状一样或稍异的表意文字(主要为汉字,但也有仿汉字如日本国字、韩国独有汉字)于ISO 10646及Unicode标准内赋予相同编码。越南文后来亦加入此计划,所以亦有“CJKV”的称呼。

平面0也有一个专用区(用户自定义使用):0xE000-0xF8FF,有6400个码位(lv自定义符号也是使用的这部分编码)。平面0的0xD800-0xDFFF,共2048个码位,是一个被称作代理区(Surrogate)的特殊区域。代理区的目的用两个UTF-16字符表示BMP以外的字符。

label换行

1、LV_ATTRIBUTE_FAST_MEM void lv_draw_label(const lv_area_t * coords, const lv_area_t * mask,
                                         const lv_draw_label_dsc_t * dsc,
                                         const char * txt,
                                       lv_draw_label_hint_t * hint)

line_end,line_start一行字符开始,结束在txt指针的下标,当UTF8格式时,大部分的中文是3个字节。

2、uint32_t _lv_txt_get_next_line(const char * txt, const lv_font_t * font, lv_coord_t letter_space, lv_coord_t max_width, lv_txt_flag_t flag)

3、static uint32_t lv_txt_get_next_word(const char * txt, const lv_font_t * font,
                                     lv_coord_t letter_space, lv_coord_t max_width,
                                     lv_txt_flag_t flag, uint32_t * word_w_ptr, lv_txt_cmd_state_t * cmd_state, bool force)

_lv_txt_get_next_line(&txt[line_start], font, dsc->letter_space, w, dsc->flag);

获取连续一串字显示的字符,遇到换行或结束时跳出循环。在此过程中记录在max_width下的相对&txt[index]的下标值。

4、uint32_t (*_lv_txt_encoded_next)(const char *txt, uint32_t *i)

获取*txt中的第*i个内容的字符,如果是UTF8的中文还要转码。并返回下一个字符的下标到*i中。

5、static inline bool is_break_char(uint32_t letter)

 类似资料: