latest
介绍(Introduction)
特性(Key features)
软硬件需求(Requirements)
许可(License)
仓库结构(Repository layout)
Release policy
Release cycle
Branches
Changelog
Version support
FAQ
Where can I ask questions?
Is my MCU/hardware supported?
Is my display supported?
Nothing happens, my display driver is not called. What have I missed?
Why is the display driver called only once? Only the upper part of the display is refreshed.
Why do I see only garbage on the screen?
Why do I see nonsense colors on the screen?
How to speed up my UI?
How to reduce flash/ROM usage?
How to reduce the RAM usage
How to work with an operating system?
快速开始(Get started)
快速概览 Quick overview
Get started in a simulator
Add LVGL into your project
Learn the basics
Widgets
Events
Parts
States
Styles
Themes
Examples
Micropython
Simulator on PC
Select an IDE
Set-up Eclipse CDT
Install Eclipse CDT
Install SDL 2
Pre-configured project
Add the pre-configured project to Eclipse CDT
Compile and Run
STM32
NXP
Creating new project with LVGL
Adding HW acceleration for NXP iMX RT platforms using PXP (PiXel Pipeline) engine for existing projects
Features supported:
Basic configuration:
Basic initialization:
Project setup:
Advanced configuration:
Espressif (ESP32)
Get the LVGL demo project for ESP32
Use LVGL in your ESP32 project
Prerequisites
Get LVGL
Use lvgl_esp32_drivers in your project
Support for ESP32-S2
Arduino
Get the LVGL Arduino library
Set up drivers
Configure LVGL
Initialize LVGL and run an example
Debugging and logging
Micropython
What is Micropython?
Highlights of Micropython
Why Micropython + LVGL?
Here are some advantages of using LVGL in Micropython:
Micropython + LVGL could be used for:
So what does it look like?
A simple example
How can I use it?
Online Simulator
PC Simulator
Embedded platform
Where can I find more information?
Tasmota and berry
What is Tasmota?
What is Berry?
Highlights of Berry
Why LVGL + Tasmota + Berry?
Tasmota + Berry + LVGL could be used for:
So what does it look like?
A simple example
How can I use it?
Where can I find more information?
Tasmota Documentation
Berry Documentation
Tasmota LVGL Berry documentation
NuttX RTOS
What is NuttX?
Highlights of NuttX
Why NuttX + LVGL?
Here are some advantages of using LVGL in NuttX
NuttX + LVGL could be used for
How to get started with NuttX and LVGL?
First you need to install the pre-requisites on your system
Now let’s create a workspace to save our files
Clone the NuttX and Apps repositories:
Configure NuttX to use the stm32f429i-disco board and the LVGL Demo
Flashing the firmware in the board using OpenOCD:
Where can I find more information?
RT-Thread RTOS
What is RT-Thread?
How to run LVGL on RT-Thread?
CMake
Espressif (ESP32)
MicroPython
Zephyr
Prerequisites
Make
Ninja
Building LVGL with CMake
Additional CMake options
Building LVGL examples with CMake
Building LVGL drivers and demos with CMake
移植(Porting)
Set up a project
Get the library
Configuration file
Initialization
Display interface
Draw buffer
Buffering modes
One buffer
Two buffers
Full refresh
Direct mode
Display driver
Mandatory fields
Optional fields
Examples
Rotation
Further reading
API
Input device interface
Types of input devices
Touchpad, mouse or any pointer
Keypad or keyboard
Encoder
Button
Other features
Parameters
Feedback
Associating with a display
Buffered reading
Further reading
API
Tick interface
API
Task Handler
Sleep management
Operating system and interrupts
Tasks and threads
Interrupts
Logging
Log level
Printing logs
Logging with printf
Custom log function
Add logs
概览(Overview)
对象(Objects)
属性(Attributes)
基本属性(Basic attributes)
具体属性(Specific attributes)
工作机制(Working mechanisms)
父子结构(Parent-child structure)
同时移动(Moving together)
子对象的可见性(Visibility only on the parent)
创建/删除对象(Create and delete objects)
屏幕(Screens)
创建屏幕(Create screens)
设置活动屏幕(Get the active screen)
加载屏幕(Load screens)
层(Layers)
多显示器处理(Handling multiple display)
部件块(Parts)
状态(States)
截屏(Snapshot)
位置、大小与布局(Positions, sizes, and layouts)
概览(Overview)
单位(Units)
盒子模型(Boxing model)
重要提示(Important notes)
坐标(Position)
简易方式(Simple way)
对齐(Align)
尺寸(Size)
简易方式(Simple way)
使用样式(Using styles)
位置变换(Translation)
变形(Transformation)
最大最小值(Min and Max size)
布局(Layout)
概览
内置布局(Built-in layout)
标志(Flags)
添加新布局(Adding new layouts)
Examples
样式(Styles)
状态(States)
层叠样式(Cascading styles)
继承(Inheritance)
部件块(Parts)
初始化样式和设置/读取属性(Initialize styles and set/get properties)
向部件添加和删除样式(Add and remove styles to a widget)
添加样式(Add styles)
删除样式(Remove styles)
报告样式变更(Report style changes)
获取某个对象的属性值(Get a property’s value on an object)
局部样式(Local styles)
属性(Properties)
典型背景属性(Typical background properties)
变换(Transitions)
Color filter
主题(Themes)
扩展主题(Extending themes)
例子(Examples)
API
样式属性(Style properties)
大小与位置(Size and position)
宽度(width)
最小宽度(min_width)
最大宽度(max_width)
高度(height)
最小高度(min_height)
最大高度(max_height)
x
y
对齐方式(align)
变换宽度(transform_width)
变换高度(transform_height)
变换x坐标(translate_x)
变换y坐标(translate_y)
缩放(transform_zoom)
变换角度(transform_angle)
填充(Padding)
顶部填充(pad_top)
底部填充(pad_bottom)
左部填充(pad_left)
右部填充(pad_right)
行填充(pad_row)
列填充(pad_column)
背景(Background)
背景颜色(bg_color)
bg_opa
渐变色(bg_grad_color)
渐变方向(bg_grad_dir)
背景色起点(bg_main_stop)
背景渐变色起点(bg_grad_stop)
背景图片(bg_img_src)
背景图片透明度(bg_img_opa)
背景图片重新着色(bg_img_recolor)
背景图片重新着色强度(bg_img_recolor_opa)
背景图片平铺(bg_img_tiled)
边框(Border)
边框颜色(border_color)
边框不透明度(border_opa)
边框宽度(border_width)
边界尺寸(border_side)
border_post
轮廓(Outline)
轮廓宽度(outline_width)
outline_color
outline_opa
outline_pad
Shadow
shadow_width
shadow_ofs_x
shadow_ofs_y
shadow_spread
shadow_color
shadow_opa
Image
img_opa
img_recolor
img_recolor_opa
Line
line_width
line_dash_width
line_dash_gap
line_rounded
line_color
line_opa
Arc
arc_width
arc_rounded
arc_color
arc_opa
arc_img_src
Text
text_color
text_opa
text_font
text_letter_space
text_line_space
text_decor
text_align
Miscellaneous
radius
clip_corner
opa
color_filter_dsc
color_filter_opa
anim_time
anim_speed
transition
blend_mode
layout
base_dir
滚动(Scroll)
概览(Overview)
滚动条(Scrollbar)
时间(Events)
Basic example
滚动的特点(Features of scrolling)
可滚动性(Scrollable)
滚动链(Scroll chain)
滚动动量(Scroll momentum)
弹性滚动(Elastic scroll)
捕捉(Snapping)
单次滚动(Scroll one)
Scroll on focus
Scroll manually
Self size
Examples
层(Layers)
创建顺序(Order of creation)
将对象置于上层(Bring to the foreground)
顶层与系统层(Top and sys layers)
事件(Events)
给对象添加事件(Add events to the object)
从对象中删除事件(Remove event(s) from an object)
事件代码(Event codes)
Input device events
绘图事件(Drawing events)
其他事件(Other events)
特殊事件(Special events)
自定义事件(Custom events)
手动发送事件(Sending events)
刷新事件(Refresh event)
Fields of lv_event_t
Event bubbling
Examples
输入设备(Input devices)
Pointers
Cursor
Gestures
Keypad and encoder
Groups
Styling
API
Input device
Groups
显示器(Displays)
Multiple display support
Using only one display
Mirror display
Split image
Screens
Transparent screens
Features of displays
Inactivity
Background
API
色彩(Colors)
Creating colors
RGB
HSV
Palette
Modify and mix colors
Built-in colors
Opacity
Color types
Convert color
API
字体(Fonts)
Unicode编码支持(Unicode support)
内嵌字体(Built-in fonts)
普通字体(Normal fonts)
特殊字体(Special fonts)
特性(Special features)
双向书写支持(Bidirectional support)
阿拉伯语和波斯语支持(Arabic and Persian support)
亚像素渲染(Subpixel rendering)
压缩字体(Compressed fonts)
增加新字体(Add a new font)
添加新符号(Add new symbols)
在运行时加载字体(Load a font at run-time)
添加新的字体引擎(Add a new font engine)
字体退回(Use font fallback)
图像(Images)
储存图像(Store images)
变量(Variables)
文件(Files)
颜色格式(Color formats)
添加与使用图像(Add and use images)
在线转换(Online converter)
手动创建(Manually create an image)
使用图像(Use images)
图像解码器(Image decoder)
自定义图像格式(Custom image formats)
注册图像解码器(Register an image decoder)
手动使用解码器(Manually use an image decoder)
图像缓存(Image caching)
Cache size
Value of images
Memory usage
Clean the cache
API
Image buffer
文件系统(File system)
Ready to use drivers
Adding a driver
Registering a driver
Implementing the callbacks
Other callbacks
Usage example
Use drives for images
API
动画(Animations)
Create an animation
Animation path
Speed vs time
Delete animations
Timeline
Examples
API
定时器(Timers)
Create a timer
Ready and Reset
Set parameters
Repeat count
Measure idle time
Asynchronous calls
API
Drawing
Mechanism of screen refreshing
Masking
Using masks
Hook drawing
Main drawing
Post drawing
Part drawing
Others
New widget
部件(Widgets)
Base object (lv_obj)
Overview
Coordinates
Parents and children
Display and Screens
Events
Styles
Flags
Groups
Extended click area
Events
Keys
Example
API
Core widgets
Arc (lv_arc)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Bar (lv_bar)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Button (lv_btn)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Button matrix (lv_btnmatrix)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Canvas (lv_canvas)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Checkbox (lv_checkbox)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Drop-down list (lv_dropdown)
Overview
Parts and Styles
Usage
Overview
Events
Keys
Example
API
图像部件 Image (lv_img)
概览 Overview
部件块与样式(Parts and Styles)
用法(Usage)
Transformations
Events
Keys
Example
API
Label (lv_label)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Line (lv_line)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Roller (lv_roller)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Slider (lv_slider)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Switch (lv_switch)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Table (lv_table)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Text area (lv_textarea)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Extra widgets
Animation Image (lv_animimg)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Calendar (lv_calendar)
Overview
Parts and Styles
Usage
Events
Keys
Headers
Example
API
Chart (lv_chart)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Color wheel (lv_colorwheel)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Image button (lv_imgbtn)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Keyboard (lv_keyboard)
Overview
Parts and Styles
Usage
Events
Keys
Examples
API
LED (lv_led)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
List (lv_list)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Menu (lv_menu)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Meter (lv_meter)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Message box (lv_msgbox)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Span (lv_span)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Spinbox (lv_spinbox)
Overview
Parts and Styles
Events
Keys
Example
API
Example
Spinner (lv_spinner)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Tabview (lv_tabview)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Tile view (lv_tileview)
Overview
Parts and Styles
Usage
Events
Keys
Example
API
Window (lv_win)
Overview
Parts and Styles
Usage
Get the parts
Events
Keys
Example
API
布局(Layouts)
Flex
Overview
Terms
Simple interface
Flex flow
Flex align
Flex grow
Style interface
Internal padding
Other features
RTL
New track
Example
API
Grid
Overview
Terms
Simple interface
Grid descriptors
Grid items
Grid align
Style interface
Internal padding
Other features
RTL
Example
API
第三方库(3rd party libraries)
File System Interfaces
Usage
BMP decoder
Limitations
Example
API
JPG decoder
Overview
Usage
Converter
Converting JPG to C array
Converting JPG to SJPG
Example
API
PNG decoder
Example
API
GIF decoder
Convert GIF files to C array
Use GIF images from file
Memory requirements
Example
API
FreeType support
Install FreeType
Add FreeType to your project
Usage
Example
Learn more
API
QR code
Get started
Notes
Example
API
Lottie player
Build Rlottie
Usage
Use Rlottie from file
Use Rlottie from raw string data
Getting animations
Controlling animations
Example
API
FFmpeg support
Install FFmpeg
Add FFmpeg to your project
Usage
Example
API
其他(Others)
Snapshot
Usage
Free the Image
Use Existing Buffer
Example
API
Monkey
Usage
Example
API
贡献(Contributing)
Introduction
Pull request
From GitHub
From command line
Commit message format
Developer Certification of Origin (DCO)
Overview
Accepted licenses and copyright notices
Your own work
Use code from online source
Use MIT licensed code
Use GPL licensed code
Ways to contribute
Give LVGL a Star
Tell what you have achieved
Write examples
Improve the docs
Report bugs
Send fixes
Join the conversations in the Forum
Add features
Become a maintainer
Move your project repository under LVGL organization
更新日志(Changelog)
v8.1.0 10 November 2021
Overview
Breaking Changes
Architectural
New Features
Performance
Fixes
Examples
Docs
CI and tests
Others
v8.0.2 (16.07.2021)
v8.0.1 (14.06.2021)
v8.0.0 (01.06.2021)
Directory structure
Widget changes
New scrolling
New layouts
Styles
Events
Driver changes
Other changes
New release policy
Migrating from v7 to v8
v7.11.0 (16.03.2021)
New features
Bugfixes
v7.10.1 (16.02.2021)
Bugfixes
v7.10.0 (02.02.2021)
New features
Bugfixes
v7.9.1 (19.01.2021)
Bugfixes
v7.9.0 (05.01.2021)
New features
Bugfixes
v7.8.1 (15.12.2020)
Bugfixes
v7.8.0 (01.12.2020)
New features
Bugfixes
v7.7.2 (17.11.2020)
Bugfixes
v7.7.1 (03.11.2020)
Bugfixes
v7.7.0 (20.10.2020)
New features
Bugfixes
v7.6.1 (06.10.2020)
Bugfixes
v7.6.0 (22.09.2020)
New features
Bugfixes
v7.5.0 (15.09.2020)
New features
Bugfixes
v7.4.0 (01.09.2020)
New features
Bugfixes
v7.3.1 (18.08.2020)
Bugfixes
v7.3.0 (04.08.2020)
New features
Bugfixes
v7.2.0 (21.07.2020)
New features
Bugfixes
v7.1.0 (07.07.2020)
New features
Bugfixes
v7.0.2 (16.06.2020)
Bugfixes
v7.0.1 (01.06.2020)
Bugfixes
v7.0.0 (18.05.2020)
Documentation
Legal changes
New drawing system
New style system
GPU integration
Renames
Reworked and improved object
New object types
Others
Demos
New release policy
Migrating from v6 to v7
后续目标(Roadmap)
v8.2
Ideas
LVGL_Chinese_Documents
»
概览(Overview)
在 GitHub 上修改
概览(Overview)
¶
对象(Objects)
属性(Attributes)
工作机制(Working mechanisms)
屏幕(Screens)
部件块(Parts)
状态(States)
截屏(Snapshot)
位置、大小与布局(Positions, sizes, and layouts)
概览(Overview)
坐标(Position)
尺寸(Size)
使用样式(Using styles)
位置变换(Translation)
变形(Transformation)
布局(Layout)
Examples
样式(Styles)
状态(States)
层叠样式(Cascading styles)
继承(Inheritance)
部件块(Parts)
初始化样式和设置/读取属性(Initialize styles and set/get properties)
向部件添加和删除样式(Add and remove styles to a widget)
局部样式(Local styles)
属性(Properties)
变换(Transitions)
Color filter
主题(Themes)
例子(Examples)
API
样式属性(Style properties)
大小与位置(Size and position)
填充(Padding)
背景(Background)
边框(Border)
轮廓(Outline)
Shadow
Image
Line
Arc
Text
Miscellaneous
滚动(Scroll)
概览(Overview)
Basic example
滚动的特点(Features of scrolling)
Scroll manually
Self size
Examples
层(Layers)
创建顺序(Order of creation)
将对象置于上层(Bring to the foreground)
顶层与系统层(Top and sys layers)
事件(Events)
给对象添加事件(Add events to the object)
从对象中删除事件(Remove event(s) from an object)
事件代码(Event codes)
手动发送事件(Sending events)
Fields of lv_event_t
Event bubbling
Examples
输入设备(Input devices)
Pointers
Keypad and encoder
API
显示器(Displays)
Multiple display support
Screens
Features of displays
API
色彩(Colors)
Creating colors
Opacity
Color types
API
字体(Fonts)
Unicode编码支持(Unicode support)
内嵌字体(Built-in fonts)
特性(Special features)
增加新字体(Add a new font)
添加新符号(Add new symbols)
在运行时加载字体(Load a font at run-time)
添加新的字体引擎(Add a new font engine)
字体退回(Use font fallback)
图像(Images)
储存图像(Store images)
颜色格式(Color formats)
添加与使用图像(Add and use images)
图像解码器(Image decoder)
图像缓存(Image caching)
API
文件系统(File system)
Ready to use drivers
Adding a driver
Usage example
Use drives for images
API
动画(Animations)
Create an animation
Animation path
Speed vs time
Delete animations
Timeline
Examples
API
定时器(Timers)
Create a timer
Ready and Reset
Set parameters
Repeat count
Measure idle time
Asynchronous calls
API
Drawing
Mechanism of screen refreshing
Masking
Hook drawing
New widget