Introduction(介绍)
Requirements(要求)
License(许可证)
Release policy(发布政策)
Branches(分支)
Change log(变更日志)
FAQ(常见问题)
Where can I ask questions?(我在哪里提问?)
Is my display supported?(我的显示器受支持吗?)
My display driver is not called. What have I missed?(我的显示驱动程序没有被调用。我错过了什么?)
Why do I see nonsense colors on the screen?(为什么我在屏幕上看到无意义的颜色?)
How do I reduce flash/ROM usage?(如何减少 Flash/ROM 使用量?)
How do I use LVGL with an operating system?(如何在操作系统中使用 LVGL?)
LVGL Basics(LVGL 基础)
Overview of LVGL's Data Flow(LVGL 数据流概述)
Application's Job(应用程序的任务)
Major Concepts(主要概念)
Display vs Screen(显示(Display)与屏幕(Screen))
Default Display(默认显示设备)
Screen Widgets(屏幕部件)
Widgets(小部件)
Creating Widgets(创建小部件)
Modifying Widgets(修改小部件)
Deleting Widgets(删除小部件)
Events(事件)
Parts(部件)
States(状态)
Styles(样式)
Themes(主题)
MicroPython
Going Deeper(深入了解)
Basic Examples(基本示例)
A very simple
hello world
label
A button with a label and react on click event
Create styles from scratch for buttons
Create a slider and write its value on a label
Add LVGL to Your Project(添加LVGL到你的工程)
Getting LVGL(获取 LVGL)
Demos and Examples(演示与示例)
Building LVGL(构建 LVGL)
Make and CMake
Managed builds
Configuration(配置)
lv_conf.h(LV 配置头文件)
Creating lv_conf.h(创建 LV 配置头文件)
Configuration Settings(配置设置)
Kconfig
Connecting LVGL to Your Hardware(将 LVGL 连接到您的硬件)
Initializing LVGL(初始化LVGL)
Tick Interface(滴答(Tick)接口)
Display Interface(显示接口)
Input-Device Interface
API
Timer Handler(定时器处理程序)
Threading Considerations(线程相关注意事项)
Definitions(定义)
LVGL and Threads(LVGL 与线程)
Tasks(任务)
Method 1: Use a Gateway Thread(方法 1:使用网关线程)
Method 2: Use a MUTEX(方法 2:使用互斥锁)
Sleep Management(睡眠管理)
Other Platforms and Tools(其他平台和工具)
Base Widget(控件基础)
Widget Basics
What is a Widget?
Base Widget
Attributes
Basic attributes
Widget-specific attributes
Parents and children
Working Mechanisms
Parent-child structure
Moving together
Visibility only on the parent
Create and delete Widgets
Screens
What are Screens?
Creating Screens
Active Screen
Loading Screens
Layers
Transparent Screens
Parts
States
Flags
Base-Widget Events
Events from Input Devices
Special Events
Drawing Events
Other Events
Keys
Snapshot
Example
Base objects with custom styles
Make an object draggable
Transform object using a 3x3 matrix
API
Positions, sizes, and layouts(位置、大小和布局)
Overview(概述)
Units(单位)
Boxing Model(盒子模型)
Important Notes(重要笔记)
Positioning Widgets
Direct
Alignment(对齐)
Size(大小)
Sizing the simple way(最简单的方法)
Extending the click area
Using styles(使用样式)
Translation(位置转换)
Transformation(大小转换)
Min and Max size(最小和最大尺寸)
Layout(布局)
Layout Overview(布局概述)
Built-in layouts(内置布局)
Flags(标志)
Adding new layouts(添加新布局)
Examples
API
Layers(图层)
Order of Creation(图层顺序)
Changing Order(改变顺序)
Screen-like layers(屏幕状的层次)
Top and sys layers(顶层和系统层)
Bottom layers(底层)
Draw Layers(绘制图层)
Simple Layer(简单层)
Transformed Layer(转换图层)
Clip corner(夹角)
API
Styles
Style Details(风格样式)
States(状态)
Cascading styles(层叠样式)
Inheritance(继承)
Parts(部分)
Initialize styles and set/get properties(初始化样式和设置/获取属性)
Add and remove styles to a widget(向控件添加和删除样式)
Local Styles(本地样式)
Style Properties Overview
Transitions(过渡特效)
Opacity, Blend modes and Transformations(不透明度,混合模式和变换)
Color Filter(色彩过滤)
Themes(主题)
Examples
Style properties(样式属性)
Size and position(大小和位置)
Padding
Margin
Background
Border
Outline
Shadow
Image
Line
Arc
Text
Miscellaneous
Flex
Grid
Events(事件)
Adding Events to a Widget(添加事件到对象)
Removing Event(s) from Widgets(从对象中删除事件)
Event Codes(事件代码)
Input device events(输入设备事件)
Drawing Events(绘图事件)
Special Events(特殊事件)
Other Events(其他事件)
Display Events(展示时间)
Custom Events(自定义事件)
Sending events(发送事件)
Refresh event(刷新事件)
Sending Events Manually
Fields of lv_event_t(lv_event_t 的字段)
Event Bubbling(事件冒泡)
Examples
Button click event
Click streaks
Handle multiple events
Event bubbling
Draw event
API
Layouts(布局)
Flex(弹性布局)
Overview(概述)
Terms(约定)
Simple Interface(简单接口)
Style Interface(样式接口)
Other Features(其它功能)
Examples
Grid(网格布局)
Overview(概述)
Terms(约定)
Simple Interface(简单的接口)
Style interface(样式接口)
Other features(其它功能)
Example
API
Scrolling(滚动)
Overview(概述)
Scrollbar(滚动条)
Scrolling Events(事件)
Basic example(基本示例)
Features of scrolling(滚动的特点)
Scrollable(滚动效果)
Scroll chaining(滚动条)
Scroll momentum(滚动惯性效果)
Elastic scroll(弹性卷轴效果)
Snapping(捕捉)
Scroll one(只滚动一个)
Scroll on focus(滚动焦点)
Scrolling Programmatically
Self Size(自身尺寸)
Examples
Nested scrolling
Snapping
Floating button
Styling the scrollbars
Right to left scrolling
Translate on scroll
API
Widgets(控件)
Animation Image (动画图像) (lv_animimg)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Image sources(图片来源)
Using the inner animation
Events(事件)
Keys(按键)
Example
Simple Animation Image
API
Arc(圆弧 ) (lv_arc)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Value and range(值和范围)
Rotation(旋转)
Mode(模式)
Change rate(变化率)
Knob offset(旋钮偏移)
Setting indicator programmatically(以编程方式设置指示器)
Interactive area(交互区域)
Place another Widget on the knob(将另一个部件放置在旋钮上)
Events(事件)
Keys(按键)
Example
Simple Arc
Loader with Arc
API
Bar (进度条)(lv_bar)
Overview(概述)
Parts and Styles(零件和样式)
Usage(用法)
Orientation and size(方向与尺寸)
Value and range(值和范围)
Modes(模式)
Events(事件)
Keys(按键)
Example
Simple Bar
Styling a bar
Temperature meter
Stripe pattern and range value
Bar with LTR and RTL base direction
Custom drawer to show the current value
Bar with opposite direction
API
Button(按钮) (lv_button)
Overview(概述)
Parts and Styles(零件和样式)
Usage(用法)
Events(事件)
Keys(按键)
Example
Simple Buttons
Styling buttons
Gummy button
API
Button matrix(矩阵按钮) (lv_buttonmatrix)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Button map(按钮映射)
Button widths(按钮宽度)
Button behavior(按钮行为)
One check(一次检查)
Events(事件)
Keys(按键)
Example
Simple Button matrix
Custom buttons
Pagination
API
Calendar(日历) (lv_calendar)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Current date(当前日期)
Month shown(显示月份)
Highlighted days(突出显示的日期)
Names of days(日期名称)
Custom year list(自定义年份列表)
Chinese calendar(中国历法)
Headers(头部)
Arrow buttons(箭头按钮)
Drop-down(下拉列表)
Events(事件)
Keys(按键)
Example
Calendar with header
Chinese calendar
API
Canvas(画布)(lv_canvas)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Buffer(缓冲区)
Indexed colors(颜色索引)
Drawing(画画)
Events(事件)
Keys(按键)
Example
Drawing on the Canvas and rotate
Transparent Canvas with chroma keying
Draw a rectangle to the canvas
Draw a label to the canvas
Draw an arc to the canvas
Draw an image to the canvas
Draw a line to the canvas
Draw a vector graphic to the canvas
API
Chart(图表) (lv_chart)
Overview(概述)
Chart Basics(图表基础)
Chart layers(图表图层)
Parts and Styles(部分和样式)
Details(细节)
Chart type(图表类型)
Data series(Series数据)
Modifying data(修改数据)
Update modes(更新模式)
Number of points(点数)
Vertical range(垂直范围)
Division lines(分割线)
Override default start point for series(覆盖series的默认起点)
Tick marks and labels(刻度线和标签)
Zoom(缩放)
Cursor(光标)
Events(事件)
Keys(按键)
Example
Line Chart
Axis ticks and labels with scrolling
Show the value of the pressed points
Recolor bars based on their value
Faded area line chart with custom division lines
Show cursor on the clicked point
Scatter chart
Circular line chart with gap
API
Checkbox(复选框) (lv_checkbox)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Text(文本)
Check, uncheck, disable(选中,取消选中,禁用)
Events(事件)
Keys(按键)
Example
Simple Checkboxes
Checkboxes as radio buttons
API
Drop-down list(下拉列表)(lv_dropdown)
Overview(概述)
Parts and Styles(部分和样式)
Button(按钮)
List(列表)
Usage(用法)
Options(选项)
List items(列表选项)
Get selected option(获取选择的选项)
Direction(方向)
Symbol(符号)
Show selected(显示选中)
Programmatically open/close(编程打开或关闭)
Events(事件)
Keys(按键)
Example
Simple Drop down list
Drop down in four directions
Menu
API
Image (图象)(lv_image)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Image source(图片来源)
Label as an image(标签作为图象)
Transparency(透明度)
Palette and Alpha index(调色板和 Alpha 索引)
Recolor(重新着色)
Offset(偏移量)
Transformations(转换)
Inner align(内部对齐)
Events(事件)
Keys(按键)
Example
Image from variable and symbol
Image recoloring
Rotate and zoom
Image offset and styling
API
Image button (图像按钮)(lv_imagebutton)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Image sources(图片来源)
Setting State Programmatically(以编程方式设置状态)
Events(事件)
Keys(按键)
Example
Simple Image button
API
Keyboard(键盘) (lv_keyboard)
Overview(概述)
Parts and Styles(部分与样式)
Usage(用法)
Modes(模式)
Assign Text area(指定文本框)
Key Popovers(按键弹出提示)
New Keymap(自定义键盘布局)
Events(事件)
Keys(按键)
Example
Keyboard with text area
Keyboard with custom map
API
Label (标签)(lv_label)
Overview(概述)
Parts and Styles(零件和样式)
Usage(用法)
Set text(设置文本)
Newline(新行)
Long modes(长模式)
Text selection(文本选择)
Text alignment(文本对齐方式)
Very long texts(非常长的文本)
Custom scrolling animations(自定义滚动动画)
Symbols(符号)
Events(事件)
Keys(按键)
Example
Line wrap, recoloring and scrolling
Text shadow
Show LTR, RTL and Chinese texts
Draw label with gradient color
Customize circular scrolling animation
API
LED(指示灯) (lv_led)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Color(颜色)
Brightness(亮度)
Toggle(切换)
Events(事件)
Keys(按键)
Example
LED with custom style
API
Line (线条)(lv_line)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Set points(设置点)
Auto-size(自动调整大小)
Invert y(反转 y轴)
Events(事件)
Keys(按键)
Example
Simple Line
API
List(列表) (lv_list)
Overview
Parts and Styles(部分和样式)
Usage(用法)
Buttons(按钮)
Texts(文本)
Events(事件)
Keys(按键)
Example
Simple List
Sorting a List using up and down buttons
API
Lottie动画 (lv_lottie)
Overview(概览)
Parts and Styles(部分和样式)
Usage(用法)
Dependencies(依赖)
Set a buffer(设置缓冲区)
Set a source(设置源)
Get the animation(获取动画)
Events(事件)
Keys(按键)
Example(示例)
Load a Lottie animation from an array
Load a Lottie animation from file
API
Menu (菜单)(lv_menu)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Create a menu(创建菜单)
Header mode(标头模式)
Root back button mode(根页面后退按钮模式)
Create a menu page(创建菜单页面)
Set a menu page in the main area(在主区域设置菜单页面)
Set a menu page in the sidebar(在侧边栏中设置菜单页面)
Linking between menu pages(菜单页之间的链接)
Create a menu container, section, separator(创建菜单容器、部分、分隔符)
Events(事件)
Keys(按键)
Example
Simple Menu
Simple Menu with root btn
Simple Menu with custom header
Simple Menu with floating btn to add new menu page
Complex Menu
API
Message box(消息框) (lv_msgbox)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Create a message box(创建消息框)
Adding buttons
Get the parts(获取各个组成部分)
Close the message box(关闭消息框)
Events(事件)
Keys(按键)
Example
Simple Message box
Scrolling and styled Message box
API
Roller (滚轮)(lv_roller)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Set options(设置选项)
Get selected option(获取选中的选项)
Visible rows(可见行)
Events(事件)
Keys(按键)
Example
Simple Roller
Styling the roller
add fade mask to roller
API
Scale (标尺)(lv_scale)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Mode
Setting ranges(设置范围)
Tick drawing order(刻度绘制顺序)
Configure ticks(配置刻度)
Sections(剖面)
Creating Sections(创建区段)
Styling Sections(设置区段样式)
Useful Style Properties for Sections(对于区段(Section)有用的样式属性)
Events(事件)
Keys
Example
A simple horizontal scale
An vertical scale with section and custom styling
A simple round scale
A round scale with section and custom styling
A round scale with multiple needles, resembling a clock
API
Slider (滑动条)(lv_slider)
Overview(概述)
Parts and Styles(零件和样式)
Usage(用法)
Value, range and orientation(值、范围和方向)
Modes(模式)
Knob-only mode(仅旋钮模式)
Events(事件)
Keys(按键)
Example
Simple Slider
Slider with custom style
Slider with extended drawer
Slider with opposite direction
API
Span(富文本) (lv_span)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Set text and style(设置文本和样式)
Retrieving a span child(检索 span 子项)
Child Count(子项计数)
Text align(文本对齐)
Modes(模式)
Overflow(溢出)
First line indent(首行缩进)
Lines(行)
Events(事件)
Keys(按键)
Example
Span with custom styles
API
Spinbox (微调框)(lv_spinbox)
Overview(概述)
Parts and Styles(部分和样式)
Value, range and step(值、范围和步长)
Format(格式)
Rollover(翻转)
Events(事件)
Keys(按键)
Example
Simple Spinbox
API
Spinner(环形加载器) (lv_spinner)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Create a spinner(创建环形加载器)
Events(事件)
Keys(按键)
Example
Simple spinner
API
Switch (开关)(lv_switch)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Change state(改变状态)
Change orientation
Events(事件)
Keys(按键)
Example
Simple Switch
Switch Orientation
API
Table(表格) (lv_table)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Set cell value(设置单元格的值)
Rows and Columns(行和列)
Width and Height(宽度和高度)
Merge cells(合并单元格)
Scrolling(滚动)
Events(事件)
Keys(按键)
Example
Simple table
Lightweighted list from table
MicroPython
API
Tabview(选项卡) (lv_tabview)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Create a Tab view(创建选项卡)
Add tabs(添加选项卡标签)
Rename tabs(重命名选项卡标签)
Change tab(切换选项卡标签)
Set tab bar position(设置选项卡栏位置)
Set tab bar size(设置选项卡栏大小)
Get the parts(获取部分)
Events(事件)
Keys(按键)
Example
Simple Tabview
Tabs on the left, styling and no scrolling
API
Text area(文本框) (lv_textarea)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Add text(添加文本)
Placeholder(占位符)
Delete character(删除字符)
Move the cursor(移动光标)
Hide the cursor(隐藏光标)
One line mode(单行模式)
Password mode(密码模式)
Accepted characters(字符白名单)
Max text length(设置文本长度)
Very long texts(超长文本)
Select text(选择文本)
Events(事件)
Keys(按键)
Example
Simple Text area
Text area with password field
Text auto-formatting
API
Tile view(平铺视图) (lv_tileview)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Add a tile(添加瓷砖)
Change tile(切换瓷砖显示)
Events(事件)
Keys(按键)
Example
Tileview with content
API
Window (窗口)(lv_win)
Overview(概述)
Parts and Styles(部分和样式)
Usage(用法)
Create a Window(创建一个窗口)
Title and buttons(标头和按钮)
Get the parts(获取部分)
Events(事件)
Keys(按键)
Example
Simple window
API
New Widget
Main Components(主要组件)
Display (lv_display)
What is a Display?
什么是显示器?
How Many Displays Can LVGL Use?
LVGL 可以使用多少个显示器?
Display Features
Attributes
属性
Screen Layers
屏幕层
Display Events
显示器事件
Display Setup
Creating a Display
创建显示器
Draw Buffer(s)
绘图缓冲区
Flush Callback
Flush Callback
Advanced Options
Resolution
分辨率
Flush-Wait Callback
刷新等待回调
Rotation
旋转
Color Format
颜色格式
Swapping Endian-ness
交换字节序
Monochrome Displays
单色显示器
Constraints on Redrawn Area
重绘区域的约束
Tiled Rendering
分块渲染
Decoupling the Display Refresh Timer
解耦显示刷新定时器
Force Refreshing
强制刷新
Mirroring a Display
显示镜像
Split Image
拆分图像
User Data
用户数据
Inactivity Measurement
不活动时间测量
API
Input devices(输入设备)
Pointers(光标)
Cursor(光标)
Gestures (手势)
Keypad and encoder(键盘和编码器)
Groups(组)
Styling(风格样式)
API
Colors(颜色)
Creating colors(创造色彩)
RGB(三原色)
HSV(色调饱和值-Hue Saturation Value)
Palette(调色板)
Modify and mix colors(修改和混合颜色)
Built-in colors(内置颜色)
Opacity(不透明度)
API
Fonts(字体)
Unicode support(支持Unicode编码)
Typesetting
Built-in fonts(内置字体)
Normal fonts(普通字体)
Special fonts(特殊字体)
Special features(特殊功能)
Bidirectional support(双向支持)
Arabic and Persian support(阿拉伯语和波斯语支持)
Compressed fonts(压缩字体)
Kerning(字距调整)
Add a new font(添加新的字体)
Add new symbols(添加新符号)
Load a Font at Run-Time(在运行时加载字体)
Loading a Font from a Memory Buffer at Run-Time(从内存缓冲区在运行时加载字体)
Use a BDF font(使用BDF字体)
Convert BDF to TTF(将BDF转换为TTF)
Example for a 12px font(12像素字体示例)
Adding a New Font Engine(添加新的字体引擎)
Using Font Fallback(使用字体回退)
API
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 post-processing(图像后处理)
Image caching(图片缓存)
Cache size(缓存大小)
Value of images(图片的价值)
Memory usage(内存使用情况)
Clean the cache(清理缓存)
Custom cache algorithm(自定义缓存算法)
API
Timers(定时器)
Create a timer(创建定时器)
Ready and Reset(准备与重置)
Set parameters(参数设置)
Repeat count(设置重复次数)
Enable and Disable(启用和禁用)
Pause and Resume(暂停和恢复)
Measure idle time(测量空闲时间)
Timer handler resume callback(定时器处理程序恢复回调)
Asynchronous calls(异步调用)
API
File system(文件系统)
Ready to use drivers(准备使用驱动程序)
Adding a driver(添加驱动程序)
Registering a driver(注册驱动)
Implementing the callbacks(实现回调)
Other callbacks(其他回调)
Usage example(使用示例)
Use drives for images(使用图像驱动程序)
Optional file buffering/caching(可选的文件缓冲/缓存)
lv_fs_read
(behavior when the cache is enabled)
lv_fs_write
(behavior when the cache is enabled)
lv_fs_seek
(behavior when the cache is enabled)
lv_fs_tell
(behavior when the cache is enabled)
lv_fs_read
(启用缓存时的行为)
lv_fs_write
(启用缓存时的行为)
lv_fs_seek
(启用缓存时的行为)
API
Drawing Pipeline
Overview
Draw task
Draw unit
Draw task evaluation
Dispatching
Layers
Hierarchy of modules
概述
绘制任务
绘制单元
绘制任务评估
任务分配
图层
模块层次结构
References
参考资料
API
Others Components(其他组件)
File Explorer(文件资源管理器)
Usage(用法)
Quick access(快速访问)
Sort(排序)
Events(事件)
Example
Simple File Explorer
Control File Explorer
Custom sort
API
Font Manager
Usage
Initialize Font Manager
Create Font from Font Manager
Delete Font
Delete Font Manager
Example
Font manager example
API
Fragment(片段)
Usage(用法)
Create Fragment Class(创建片段类)
Use(使用)
lv_fragment_manager
Fragment Based Navigation(片段式导航)
Example
Basic fragment usage
Stack navigation example
API
Grid navigation(网格导航)
Usage(用法)
Focusable objects(可以聚焦的对象)
Example
Basic grid navigation
Grid navigation on a list
Nested grid navigations
Simple navigation on a list widget
Grid navigation for only one axis
API
Pinyin IME(拼音输入法)
Usage(用法)
Custom dictionary(自定义词典)
Dictionary format(字典格式)
Apply new dictionary(应用新的字典)
Modes(模式)
Example
Pinyin IME 26 key input
Pinyin IME 9 key input
API
Image font(图片字体)
Usage(用法)
Example
Use emojis in a text.
API
Monkey测试(压力测试)
Usage(用法)
Example
Touchpad monkey example
Encoder monkey example
Button monkey example
API
Widget ID(对象ID)
Usage(用法)
Use custom ID generator(使用自定义的ID生成器)
Dump Widget Tree(转储对象树)
Find child by ID(通过ID查找子对象)
Widget Property(小部件属性)
Usage(用法)
Property ID(属性ID)
Property Value(属性值)
A Step Further(更进一步)
Observer(观察者)
Overview(概述)
Subject(主题)
Subject initialization(主题初始化)
Set subject value(设定主题值)
Get subject's value(获取主题的值)
Get subject's previous value(获取主题的以前的值)
Observer(观察者)
Subscribe to a subject(订阅一个主题)
Unsubscribe from a subject(取消订阅一个主题)
Subject groups(主题组)
Widget binding(小部件绑定)
Base object(基本对象)
Label(标签)
Arc(弧)
Slider(滑动器)
Roller(滚筒)
Drop-down(下拉菜单)
Example
Bind a slider's value to a label
Handling login and its states
Set time with 12/24 mode and AM/PM
Custom tab view with state management
Firmware update process
Modular style update on theme change
API
Snapshot(快照)
Usage(用法)
Free the Image(释放图像)
Use Existing Buffer(使用现有的缓冲区)
Example
Simple snapshot example
API
Examples(示例)
Get started(入门)
A very simple
hello world
label
A button with a label and react on click event
Create styles from scratch for buttons
Create a slider and write its value on a label
Styles(样式)
Size styles
Background styles
Border styles
Outline styles
Shadow styles
Image styles
Arc styles
Text styles
Line styles
Transition
Using multiple styles
Local styles
Add styles to parts and states
Extending the current theme
Opacity and Transformations
Metallic knob with conic gradient
Radial gradient as background
Gradients for button background
Animations(动画)
Start animation on an event
Playback animation
Cubic Bezier animation
Animation timeline
Events(事件)
Button click event
Click streaks
Handle multiple events
Event bubbling
Draw event
Layouts(布局)
Flex
A simple row and a column layout with flexbox
Arrange items in rows with wrap and even spacing
Demonstrate flex grow
Demonstrate flex grow.
Demonstrate column and row gap style properties
RTL base direction changes order of the items
Grid
A simple grid
Demonstrate cell placement and span
Demonstrate grid's -free unit-
Demonstrate track placement
Demonstrate column and row gap
Demonstrate RTL direction on grid
Scrolling(滚动)
Nested scrolling
Snapping
Floating button
Styling the scrollbars
Right to left scrolling
Translate on scroll
Widgets(控件)
Base object(基础对象)
Base objects with custom styles
Make an object draggable
Transform object using a 3x3 matrix
Arc(圆弧)
Simple Arc
Loader with Arc
Bar(进度条)
Simple Bar
Styling a bar
Temperature meter
Stripe pattern and range value
Bar with LTR and RTL base direction
Custom drawer to show the current value
Bar with opposite direction
Button(按钮)
Button matrix(矩阵按钮)
Calendar(日历)
Calendar with header
Chinese calendar
Canvas(画布)
Drawing on the Canvas and rotate
Transparent Canvas with chroma keying
Draw a rectangle to the canvas
Draw a label to the canvas
Draw an arc to the canvas
Draw an image to the canvas
Draw a line to the canvas
Draw a vector graphic to the canvas
Chart(图表)
Line Chart
Axis ticks and labels with scrolling
Show the value of the pressed points
Recolor bars based on their value
Faded area line chart with custom division lines
Show cursor on the clicked point
Scatter chart
Circular line chart with gap
Checkbox(复选框)
Simple Checkboxes
Checkboxes as radio buttons
Colorwheel(色轮)
Dropdown(下拉列表)
Simple Drop down list
Drop down in four directions
Menu
Image(图像)
Image button(图像按钮)
Simple Image button
Keyboard(键盘)
Keyboard with text area
Keyboard with custom map
Label(标签)
Line wrap, recoloring and scrolling
Text shadow
Show LTR, RTL and Chinese texts
Draw label with gradient color
Customize circular scrolling animation
LED(指示灯)
LED with custom style
Line(线条)
Simple Line
List(列表)
Simple List
Sorting a List using up and down buttons
Menu(菜单)
Simple Menu
Simple Menu with root btn
Simple Menu with custom header
Simple Menu with floating btn to add new menu page
Complex Menu
Meter(仪表)
Message box(消息框)
Simple Message box
Scrolling and styled Message box
Roller(滚轮)
Simple Roller
Styling the roller
add fade mask to roller
Scale(标尺)
A simple horizontal scale
An vertical scale with section and custom styling
A simple round scale
A round scale with section and custom styling
A round scale with section and custom styling
A round scale with multiple needles, resembling a clock
A round scale with multiple needles, resembling a clock
A round scale with multiple needles, resembling a clock
A round scale with multiple needles, resembling a clock
Slider(滑动条)
Simple Slider
Slider with custom style
Slider with extended drawer
Slider with opposite direction
Span(富文本)
Span with custom styles
Spinbox(微调框)
Simple Spinbox
Spinner(环形加载器)
Simple spinner
Switch(开关)
Simple Switch
Switch Orientation
Table(表格)
Simple table
Lightweighted list from table
Tabview(选项卡)
Simple Tabview
Tabs on the left, styling and no scrolling
Textarea(文本框)
Simple Text area
Text area with password field
Text auto-formatting
Tileview(平铺视图)
Tileview with content
Window(窗口)
Simple window
Debugging(调试)
GDB Plug-In
Debugging LVGL with GDB
Dump obj tree
Show obj's style
Connect to Debugger
Logging(日志)
Log level(日志等级)
Printing logs(打印日志)
Logging with printf(使用 printf 记录)
Custom log function(自定义日志功能)
Add logs(添加日志)
API
Profiler(性能分析器)
Introduction(介绍)
Usage(用法)
Configure profiler(配置性能分析器)
Run the test scenario(运行测试场景)
Process the logs(处理日志)
Performance analysis(性能分析)
Add Measurement Point(添加测量点)
Custom profiler implementation(自定义分析器实现)
FAQ(常见问题解答)
Perfetto log parsing fails(完美的日志解析失败)
Function execution time displayed as 0s in Perfetto(功能执行时间显示为0秒在Perfetto中)
Significant stuttering occurs during profiling(在进行分析过程中出现了明显的卡顿。)
Trace logs are not being output(未输出追踪日志)
VG-Lite Simulator(VG-Lite模拟器)
How it works(工作原理)
Configuration(配置)
Integration and Drivers(集成与驱动)
Bindings(绑定)
Output API as JSON data(输出API作为JSON数据)
Cpp(C++(是一种计算机编程语言))
JavaScript
Table of Contents(目录)
Features(功能)
Demo(演示)
Building(构建)
Components(控件)
Font(字体)
Animation(动画)
Style(风格)
JSAPI
Thanks(感谢)
MicroPython
What is MicroPython?
什么是MicroPython?
Why MicroPython + LVGL?(为什么选择MicroPython + LVGL?)
So what does it look like?(所以它看起来是什么样子?)
How can I use it?(如何使用它?)
Where can I find more information?
The MicroPython Binding is auto generated!(MicroPython绑定是自动生成的!)
PikaScript(皮卡脚本)
What is PikaScript ?(什么是皮卡脚本?)
Why PikaScript + LVGL ?(为什么选择 PikaScript + LVGL?)
So how does it look like?(那看起来怎么样呢?)
How does it work?(它是如何工作的?)
How can I use it?(如何使用它?)
Build systems(构建系统)
make
CMake
Overview(概览)
Chip vendors(芯片供应商)
Arm
Compile LVGL for Arm(为 Arm 编译 LVGL)
IDE Support(IDE 支持)
Arm2D and the Helium instruction set(Arm2D 和 Helium 指令集)
Neon Acceleration(Neon 加速)
Espressif (ESP32 Chip Series)(乐鑫科技(ESP32芯片系列))
LVGL Demo Projects for ESP32(ESP32的LVGL演示项目)
Using LVGL in your ESP-IDF project(在您的 ESP-IDF 项目中使用 LVGL)
Support for Display and Touch Drivers(支持显示和触摸驱动)
NXP
Creating new project with LVGL(使用LVGL创建新项目)
HW acceleration for NXP iMX RT platforms(NXP iMX RT 平台的硬件加速)
Renesas(瑞萨)
Dave2D(Dave2D)
GLCDC
Supported boards(认证板)
Get started with the Renesas ecosystem(开始使用瑞萨电子生态系统)
Modify the project(修改项目)
Support(支持)
STM32
Including LVGL in a Project(在项目中包含LVGL)
Bare Metal Example(裸机示例)
FreeRTOS Example(FreeRTOS示例)
DMA2D Support(DMA2D 支持)
Drivers(驱动)
Display
Linux Framebuffer Driver(Linux framebuffer驱动程序)
Generic MIPI DCS compatible LCD Controller driver(通用MIPI DCS兼容的液晶控制器驱动程序)
ILI9341 LCD Controller driver(ILI9341液晶控制器驱动程序)
Step-by-step Guide: How to use the LVGL v9 LCD drivers with STM32 devices(分步指南:如何将LVGL v9 LCD驱动程序与STM32设备一起使用)
Renesas GLCDC
STM32 LTDC Driver
ST7735 LCD Controller driver(ST7735液晶显示控制器驱动程序)
ST7789 LCD Controller driver(ST7789液晶控制器驱动程序)
ST7796 LCD Controller driver(ST7796液晶控制器驱动程序)
Libinput Driver(Libinput驱动)
Overview(概览)
Prerequisites(先决条件)
Configuring the driver(配置驱动程序)
Usage(用法)
OpenGL ES Display/Inputs driver(OpenGL ES 显示/输入驱动程序)
Overview(概述)
Prerequisites(先决条件)
Configure OpenGL driver(配置OpenGL驱动程序)
Basic usage(基本用法)
Advanced usage(高级用法)
OpenGL Texture Caching Renderer(OpenGL 纹理缓存渲染器)
Touchpad(触摸板)
Linux Evdev Driver(Linux Evdev 驱动)
FT6X36
Wayland Display/Inputs driver(Wayland 显示/输入驱动程序)
Overview(概览)
Dependencies(依赖关系)
Configuring the wayland driver(配置 Wayland 驱动程序)
Example(示例)
Usage(用法)
Building the wayland driver(构建 Wayland 驱动程序)
Current state and objectives(现状和目标)
Bug reports(错误报告)
Windows Display/Inputs driver(Windows显示/输入驱动程序)
Overview(概览)
Prerequisites(先决条件)
Configure Windows driver(配置Windows驱动程序)
Usage(用法)
X11 Display/Inputs driver(X11显示/输入驱动程序)
Overview(概览)
Prerequisites(先决条件)
Configure X11 driver(配置X11驱动程序)
Usage(用法)
Renderers and GPUs
Software Renderer
API
Arm-2D GPU (Arm-2D 图形处理器)
How to Use (如何使用)
Design Considerations(设计建议)
Examples(示例工程)
API
NemaGFX Acceleration
Get Started with the Riverdi STM32U5 5-inch Display
Usage and Configuration
TSC Images
DMA2D
API
NXP PXP GPU
API
NXP VGLite GPU
API
SDL Renderer
API
STM32 DMA2D GPU
API
VG-Lite General GPU(VG-Lite通用GPU)
Configuration(配置)
VG-Lite Simulator(VG-Lite模拟器)
Frameworks(框架)
Arduino
Get the LVGL Arduino library (获取LVGL Arduino库)
Set up drivers(安装驱动程序)
Configure LVGL(配置LVGL)
Initialize and run LVGL(初始化并运行LVGL)
Use the examples and demos(使用示例和演示)
Debugging and logging(调试和日志记录)
Platformio
Tasmota and berry(Tasmota 和 berry)
What is Tasmota?(Tasmota是什么?)
What is Berry?(Berry是什么?)
Why LVGL + Tasmota + Berry?(为什么选择 LVGL + Tasmota + Berry?)
So what does it look like?(那么它看起来像什么样子呢?)
How can I use it?(我们怎么样使用它?)
Where can I find more information?(我可以在哪里找到更多信息?)
IDEs
MDK
Simulator on PC(PC端模拟器)
Select an IDE(选择一个IDE)
Built-in drivers(内置驱动)
(RT)OS
FreeRTOS
MQX RTOS
NuttX RTOS
What is NuttX?(NuttX是什么?)
Why NuttX + LVGL?(为什么选择NuttX + LVGL?)
How to get started with NuttX and LVGL?(如何开始使用NuttX和LVGL?)
Where can I find more information?(在哪里可以找到更多信息?)
PX5 RTOS
QNX
What is QNX?(QNX是什么?)
How to run LVGL on QNX?(如何在 QNX 上运行 LVGL?)
RT-Thread RTOS
What is RT-Thread?(RT-Thread是什么?)
How to run LVGL on RT-Thread?(如何在RT-Thread上运行LVGL)
Yocto
Yocto Project Core Components(Yocto 项目核心组件)
LVGL in Yocto
Yocto Project Terms
Yocto Project Core Components(Yocto 项目核心组件)
LVGL in Yocto
Yocto Project Terms
Zephyr
What is Zephyr?(Zephyr是什么?)
How to run LVGL on Zephyr?(如何在Zephyr上运行LVGL?)
Leveraging Zephyr Features(利用Zephyr特性)
Where can I find more information?(在哪里可以找到更多信息? )
3rd party libraries(第三方库)
Arduino ESP littlefs
Usage
API
Arduino SD
Usage(用法)
API
Barcode(条形码)
Usage(用法)
Notes(笔记)
Example
Create a Barcode
API
BMP decoder(BMP解码器)
Limitations(限制)
Example
Open a BMP image from file
API
FFmpeg support(FFmpeg 支持)
Install FFmpeg(安装 FFmpeg)
Add FFmpeg to your project(将 FFmpeg 添加到您的项目)
Usage(用法)
Events
Example
Decode image
Decode video
API
FreeType support(FreeType 支持)
Add FreeType to your project(将 FreeType 添加到你的项目)
For UNIX(对于 UNIX)
For Embedded Devices(对于嵌入式设备)
Usage(用法)
Example
Open a front with FreeType
Use a bitmap font to draw Emojis using FreeType
Learn more(了解更多信息)
API
File System Interfaces(文件系统接口)
Usage(用法)
Working with common prefixes
Working with common prefixes(处理通用前缀)
Caching(缓存)
API
GIF decoder(GIF解码器)
Convert GIF files to C array(将 GIF 文件转换为 C 数组)
Use GIF images from file(使用GIF文件)
Memory requirements(内存要求)
Example
Open a GIF image from file and variable
API
littlefs
Usage(用法)
Example(示例)
API
libjpeg-turbo decoder(libjpeg-turbo 解码器)
Install(安装)
Add libjpeg-turbo to your project(将 libjpeg-turbo 添加到您的项目中)
Usage(用法)
Example
L