LVGL-轻便而多功能的图形库

LVGL提供了使用易于使用的图形元素，精美的视觉效果和低内存占用量来创建嵌入式GUI所需的一切。

Website · Online demo · Docs · Forum

特征

强大的构建块：按钮，图表，列表，滑块，图像等。 先进的图形：动画，抗锯齿，不透明度，平滑滚动 使用各种输入设备：触摸屏，鼠标，键盘，编码器，按钮等。 使用多种显示方式：例如单色和彩色显示 独立于任何微控制器或显示器使用的硬件 可扩展以使用很少的内存（64 kB闪存，10 kB RAM） 支持UTF-8的多语言支持，双向和阿拉伯脚本支持 通过类似CSS的样式完全可自定义的图形元素 支持操作系统，外部存储器和GPU，但不是必需的 即使只有一个帧缓冲区也可以平滑渲染 用C语言编写，以实现最大的兼容性（与C ++兼容） Micropython Binding在Micropython中公开了LVGL API 无需嵌入式硬件即可在PC上开发的模拟器 快速开发的示例和教程 文档和API参考

Requirements

Basically, every modern controller (which is able to drive a display) is suitable to run LVGL. The minimal requirements are:

Note that the memory usage might vary depending on the architecture, compiler and build options.

Just to mention some platforms:

• STM32F1, STM32F3, STM32F4, STM32F7, STM32L4, STM32L5, STM32H7
• Microchip dsPIC33, PIC24, PIC32MX, PIC32MZ
• NXP: Kinetis, LPC, iMX, iMX RT
• Linux frame buffer (/dev/fb)
• Raspberry Pi
• Espressif ESP32
• Infineon Aurix
• Nordic NRF52 Bluetooth modules
• Quectel modems

Get started

This list shows the recommended way of learning the library:

1. Check the Online demos to see LVGL in action (3 minutes)
2. Read the Introduction page of the documentation (5 minutes)
3. Get familiar with the basics on the Quick overview page (15 minutes)
4. Set up a Simulator (10 minutes)
5. Try out some Examples
6. Port LVGL to a board. See the Porting guide or check the ready to use Projects
7. Read the Overview page to get a better understanding of the library (2-3 hours)
8. Check the documentation of the Widgets to see their features and usage
9. If you have questions go to the Forum
10. Read the Contributing guide to see how you can help to improve LVGL (15 minutes)

Examples

For more examples see the lv_examples repository.

Button with label

lv_obj_t * btn = lv_btn_create(lv_scr_act(), NULL);     /*Add a button to the current screen*/
lv_obj_set_pos(btn, 10, 10);                            /*Set its position*/
lv_obj_set_size(btn, 100, 50);                          /*Set its size*/
lv_obj_set_event_cb(btn, btn_event_cb);                 /*Assign a callback to the button*/

lv_obj_t * label = lv_label_create(btn, NULL);          /*Add a label to the button*/
lv_label_set_text(label, "Button");                     /*Set the labels text*/

...

void btn_event_cb(lv_obj_t * btn, lv_event_t event)
{
    if(event == LV_EVENT_CLICKED) {
        printf("Clicked\n");
    }
}

LVGL from Micropython

Learn more about Micropython.

# Create a Button and a Label
scr = lv.obj()
btn = lv.btn(scr)
btn.align(lv.scr_act(), lv.ALIGN.CENTER, 0, 0)
label = lv.label(btn)
label.set_text("Button")

# Load the screen
lv.scr_load(scr)

Contributing

LVGL is an open project and contribution is very welcome. There are many ways to contribute from simply speaking about your project, through writing examples, improving the documentation, fixing bugs to hosing your own project under in LVGL.

For a detailed description of contribution opportunities visit the Contributing section of the documentation.