LVGL中文手册.pdf

LVGL（Light and Versatile Graphics Library）是一个开源的嵌入式图形库，提供创建嵌入式GUI所需的各种控件和功能。它被广泛应用于小型嵌入式系统，如微控制器或低级处理器上，用于为设备提供丰富的用户交互界面。 ### LVGL对象概念 LVGL将用户界面元素统称为对象，又称为小部件。这些对象包括常见的界面元素，如按钮、标签、图像、列表、图表和文本等。对象是构成LVGL用户界面的基本构建块，通过它们可以设计出功能丰富的界面。 #### 对象属性 LVGL中所有对象共享一些基本属性，这些属性包括尺寸、父对象、拖动启用、单击启用和位置等。通过API函数，如`lv_obj_set_size`和`lv_obj_set_pos`可以设置这些基本属性。 除此之外，不同类型的对象还具有特定的属性。例如，滑块（slider）具有当前值、自定义样式、最小值和最大值等属性。这些属性的设置和获取使用特定于对象类型的API函数完成，比如`lv_slider_set_range`用于设置滑块的最小和最大值。 #### 工作机制 ##### 父子结构 在LVGL中，父对象可以看作是其子对象的容器。每个对象只有一个父对象，除了屏幕之外。父对象类型不受限制，但有典型的情况，如按钮作为父对象和标签作为子对象。通过改变父对象的位置属性，所有子对象会相应地移动，它们的位置是相对于父对象的。 ##### 创建与删除 LVGL支持动态创建和删除对象。这表示只有当前创建的对象会消耗RAM，而不需要的时候可以将其删除。通过`lv_<type>_create`函数可以创建对象，需要指定父对象指针和一个可选的复制对象指针。如果创建屏幕对象，则父对象指针为NULL。所有对象都是通过C语言中的`lv_obj_t`指针引用的，通过该指针可以设置或获取对象的属性。 删除对象时，`lv_obj_del`函数会立即删除指定的对象及其所有子对象。如果出于某些原因不能立即删除对象，则可以使用`lv_obj_del_async`。 #### 版本更新 本文档翻译对应的LVGL原版是7.4.0版本。随着版本的更新，LVGL不断引入新特性，修复已知问题，并改善性能。 ### 翻译与分享 文档是由一位名叫CaiXuefeng的爱好者翻译的，他花费了两个月的业余时间进行翻译工作。他希望这份文档能够帮助其他同样对嵌入式系统和LVGL感兴趣的用户。文档不包含附录部分，并且译者明确指出，翻译过程中没有进行详细的检查，因此可能存在一些错误或不足。 ### 使用规范 译者指出，他不希望别人得到文档后将其变卖，而是希望用户能够共同学习和分享知识。尽管文档存在不完善之处，但他期待读者能理解他的初衷，并且在遇到问题时不进行责骂，而是共同推动社区的进步。 ### 结语 LVGL是一个功能强大、高效的图形库，适用于多种嵌入式设备。通过灵活的对象创建、管理以及属性设置机制，LVGL让开发者能够在有限的硬件资源上构建出复杂的用户界面。由于其开源和易用性，LVGL在嵌入式开发者中间非常受欢迎。通过翻译和分享LVGL的文档，可以进一步促进这个开源项目的普及和技术交流。