l531798151的博客

lvgl字体无法设置字号，只能每种字号都做一个字体文件，界面中用到了多个字号的文字，又不希望每个字号都加载一个字体文件。可以通过外接矢量字库芯片来实现。矢量字体可以缩放后不损失清晰度，并且字库数据存储在外部芯片里，通过spi与模块连接，不占用内部存储空间。

LVGL API 字体--bpp- 每像素位数（抗锯齿）--size- 输出字体大小（像素）-o--output- 输出路径（文件或目录，取决于格式）--format- 输出格式- 转储字形图像和字体信息，用于调试- 以二进制形式转储字体（如规范中所述- 以LittlevGL格式转储字体- 始终使用更快速的 kering 存储格式，但要付出一定的代价。如果出现尺寸差异，则会显示出来--lcd- 生成具有 3 倍水平分辨率的位图，用于子像素平滑--lcd-v。

LVGL字库有3种方式可以使用，刚接触的客户可能不太了解怎样选用，以下对这3种方式做一下简单说明。

表格（Table）

截屏（Screenshots）分 享导出pdf截屏功能，core版本号要>=3211。

图片（Gif）GIF图片显示，core版本号要>=3211。

二维码（Qrcode）

屏幕横屏竖屏切换(Rotation)

窗口 (Window)分 享导出pdf。

开关 (Switch)

加载器(Spinner)

微调框 (Spinbox)微调框用于数值调整，有时候我们希望获取一个用户输入的数值，但是又不希望弹出键盘，可以使用微调框。

滑动条 (Slider)滑动条看起来和进度条是有些是有些像，但不同的是滑动条可以进行数值选择。

页面 (Page)当控件内容过多，无法在屏幕内完整显示时，可让其在页面内显示。

滑动条 (Slider)滑动条看起来和进度条是有些是有些像，但不同的是滑动条可以进行数值选择。

页面 (Page)当控件内容过多，无法在屏幕内完整显示时，可让其在页面内显示。

图片 (Image)图片IMG是用于显示图像的基本对象类型，图像来源可以是文件，或者定义的符号。

标签 (Label)标签是 LVGL 用来显示文字的控件。

键盘 (Keyboard)LVGL 可以添加触摸键盘，但是很明显，使用触摸键盘的话必须要使用触摸的输入方式，否则无法驱动键盘。

下拉框 (Dropdown)分 享导出pdf在显示选项过多时，可以通过下拉框收起多余选项。只为用户展示列表中的一项。

axis lvgl.CHART_AXIS_PRIMARY_Y 或 lvgl.CHART_AXIS_SECONDARY_Y。axis lvgl.CHART_AXIS_PRIMARY_Y 或 lvgl.CHART_AXIS_SECONDARY_Y。返回 lvgl.CHART_AXIS_PRIMARY_Y 或 lvgl.CHART_AXIS_SECONDARY_Y。调用 lvgl.chart_set_x_start_point(chart, ser, id)可以通过点 id 单独设置某个点的数值。

容器是 lvgl 相当重要的一个控件了，可以设置布局，容器的大小也会自动进行调整，利用容器可以创建出自适应成都很高的界面布局。lvgl.FIT_PARENT – 父容器的大小减去 pad_top/bottom/left/right 后的空间。调用 lvgl.cont_set_fit4(cont, left, right, top, bottom)调用 lvgl.cont_get_fit_bottom(cont)调用 lvgl.cont_get_fit_right(cont)

addBtn(50 , “BTN_STATE_CHECKED_RELEASED”) – 切换按钮 释放。addBtn(100 , “BTN_STATE_CHECKED_PRESSED”) – 切换按钮 按下。addBtn(150 , “BTN_STATE_CHECKED_DISABLED”) – 切换按钮 禁用。lvgl.BTN_STATE_CHECKED_PRESSED – 切换按钮 按下。lvgl.BTN_STATE_CHECKED_DISABLED – 切换按钮 禁用。

日历控件当然是用在显示日期的地方，一个日历控件就能当成是一个应用了。日期是通过 lvgl.calendar_date_t() 函数创建的，这是个用户自定义数据，注意不要用 talbe 创建日期，两者还是有区别的。lvgl.calendar_set_today_date(calendar, today) – 设置当前日期。lvgl.calendar_set_showed_date(calendar, show) – 设置显示日期。日历控件有三个常用日期，今天的日期，高亮日期，当前显示的日期。

按钮控件继承自容器，可以使用设置容器特有的一些属性，比如 fit 这部分可以参考容器的使用，这部分就不在这里展开了，这里可以看看效果，lvgl.FIT_TIGHT 就是扩展到最大，我们现在可以创建一个按钮，让它横向填充满屏幕。简单看，一个按钮就三种状态，正常，按下，禁用。addBtn(100 , “BTN_STATE_CHECKED_PRESSED”) – 切换按钮 按下。addBtn(150 , “BTN_STATE_CHECKED_DISABLED”) – 切换按钮 禁用。

进度条设置的值可以是实时的，当然也可以是有延时的，可以通过 lvgl.ANIM_OFF lvgl.ANIM_ON 这两个值来决定是否显示设置值的一个中间效果。调用 lvgl.bar_set_start_value(bar, start_value, anim)调用 lvgl.bar_set_anim_time(bar, anim_time)调用 lvgl.bar_set_value(bar, value, anim)调用 lvgl.bar_get_anim_time(bar)

控件是有一些默认角度设置的，未设置到的角度都是采用的默认数值，所以尽管 示例代码 只是设置了一个终止角度，但还是绘制出了控件。曲线控件，也可以称为弧。曲线控件可以设置前景和背景的起始和终止角度，角度的取值范围是 0-360度，需要注意的是，0度是在三点钟方向，180度是在9点钟方向。可以为曲线控件设置数值范围，然后通过设置值的方式设置控件的一个显示弧度，起始也就是对前景设置的函数做了一个封装，这样使用起来更加方便。调用 lvgl.arc_set_bg_start_angle(arc, start)

在 LVGL 中，控件的字体是可以改变的，通过 lvgl.style_set_text_font(my_style, lvgl.STATE_DEFAULT, my_font) 设置样式的 text_font 属性，也可以使用 lvgl.obj_set_style_local_text_font 去设置单个控件的字体。– 没有控件去使用这个字体时，可以回收字体资源。

样式可以级联，这意味着可以将多个样式分配给一个对象，并且每种样式可以具有不同的属性。与 CSS（伪类描述不同的状态，例如 :hover）不同，在 LVGL 中，将属性分配给给定的状态。可以向对象添加更多样式，然后让后来添加的样式修改或扩展其他样式的属性。例如，创建常规的灰色按钮样式，并为仅设置新的背景色的红色按钮创建新的样式。在这种情况下，释放按钮时它将是红色的，因为在最后添加的样式（红色样式）中找到了完美的匹配。按下按钮时，浅灰色是更好的搭配，因为它完美地描述了当前状态，因此按钮将是浅灰色的。

lvgl.anim_speed_to_time(speed, start, end) 函数以毫秒为单位计算从给定速度的起始值到结束值所需的时间。例如，在 lvgl.obj_set_x 单位为像素的情况下，因此 20 表示20 px/sec 的速度。路径主要是根据动画的当前状态计算要设置的下一个值的功能。例如 lvgl.obj_set_x(obj，value) 或 lvgl.obj_set_width(obj，value)要创建动画，必须初始化 lvgl.anim_t，并使用 lvgl.anim_set_…

lvgl.event_send_refresh(obj) 只是 lvgl.event_send(obj, lvgl.EVENT_REFRESH, nil) 的包装。lvgl.event_send_refresh_recursive(obj) 将 lvgl.EVENT_REFRESH 事件发送给对象及其所有子对象。若要手动发送事件到对象，请使用 lvgl.event_send(obj, lvgl.EVENT_…lvgl.EVENT_VALUE_CHANGED – 对象值已更改（例如，对于滑动条）

要设置或清除某个状态(但不更改其他状态)，调用 lvgl.obj_add/clear_state(obj, part, lvgl.STATE_…父对象的类型没有限制，但是有特殊的父对象（例如，按钮）和特殊的子对象（例如，标签）。如果更改了父对象的位置，则子对象将与父对象一起移动，并且子对象的位置都保持相对于父对象位置不变。obj1 = lvgl.obj_create(par, nil) – 基于前面创建的对象(par)创建一个子对象(obj1)，之前的对像成为父对象。

要设置或清除某个状态(但不更改其他状态)，调用 lvgl.obj_add/clear_state(obj, part, lvgl.STATE_…父对象的类型没有限制，但是有特殊的父对象（例如，按钮）和特殊的子对象（例如，标签）。如果更改了父对象的位置，则子对象将与父对象一起移动，并且子对象的位置都保持相对于父对象位置不变。obj1 = lvgl.obj_create(par, nil) – 基于前面创建的对象(par)创建一个子对象(obj1)，之前的对像成为父对象。

代码烧录 或 环境搭建 可以参考合宙 DOC 社区的文章，同时您也可以加入我们的QQ讨论群或者微信技术支持群进行交流探讨，碰到任何问题，欢迎咨询。若要运行在屏幕尺寸更小的环境，您需要手动更改控件大小，同时调整控件的显示位置。底层固件需要支持 LVGL，通常选用的固件是 LuatOS-Air_VXXXX_RDA8910_BT_FLOAT.pac。其中 lcd.lua 是屏幕驱动，tp.lua 是触摸驱动，main.lua 里就是我们的主代码，当然，您也可以通过 更新说明 选择支持 LVGL 的其他底层版本。

imagebutton 图片按钮 图片按钮控件。imagebutton 图片按钮 图片按钮控件。animation 动画 对象的动态显示效果。animation 动画 对象的动态显示效果。style 样式 用于设置对象统一外观。style 样式 用于设置对象统一外观。checkbox 复选框 复选框控件。checkbox 复选框 复选框控件。container 容器 容器控件。spinbox 微调框 微调框控件。container 容器 容器控件。spinbox 微调框 微调框控件。

LVGL 官方使用 C 语言，LuatOS-SoC 使用 7.11 版本的 LVGL 源码为基础制作了 lua 版本的 LVGL，使您在使用 LuatOS-SoC 为您带来快速开发体验的同时，也能快速，高效的开发出漂亮的图形界面。LVGL 是一个开源的图形库，它提供了创建嵌入式 GUI 所需的一切，具有易于使用的图形元素、漂亮的视觉效果和低内存占用的特点。支持各种 输入设备 ：触摸屏、鼠标、键盘、编码器、按钮等。强大的 控件 ：按钮、图表、列表、滑动条、图像等。100+ 简单 示例。

timeout number 可选参数，默认为10000 等待扫描热点返回的超时时间，单位毫秒，默认为10秒。timeout number 可选参数，默认为10000 等待扫描热点返回的超时时间，单位毫秒，默认为10秒。result：true或者false，true表示扫描成功，false表示扫描失败或者超时失败。result：true或者false，true表示扫描成功，false表示扫描失败或者超时失败。cnt：number类型，表示扫描到的热点个数。cnt：number类型，表示扫描到的热点个数。

arg param AT命令参数，例如AT+CMGS=12命令执行后，接下来会发送此参数；arg param AT命令参数，例如AT+CMGS=12命令执行后，接下来会发送此参数；onrsp param AT命令应答的处理函数，只是当前发送的AT命令应答有效，处理之后就失效了。onrsp param AT命令应答的处理函数，只是当前发送的AT命令应答有效，处理之后就失效了。prefix param urc前缀，最前面的连续字符串，包含+、大写字符、数字的组合。

event string 事件，可选值"open",“message”,“close”,“error”,“pong”event string 事件，可选值"open",“message”,“close”,“error”,“pong”string,状态值(“CONNECTING”,“OPEN”,“CLOSING”,“CLOSED”)string,状态值(“CONNECTING”,“OPEN”,“CLOSING”,“CLOSED”)

local str = string.rawurlEncode(“中国2018”) , str == “%e4%b8%ad%e5%9b%bd2018”local str = string.urlEncode(“中国2018”) , str == “%e4%b8%ad%e5%9b%bd2018”“w"或者"w+b”：空文件写入模式，如果文件不存在，则新建文件，然后从起始位置开始写入；“a"或者"a+b”：追加写入模式，如果文件不存在，则新建文件，然后从起始位置开始写入；false表示写入失败。