Logo
9.0
  • 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?（LVGL是否支持我的 MCU/硬件？）
      • Is my display supported?（支持我的显示器吗？）
      • LVGL doesn't start, randomly crashes or nothing is drawn on the display. What can be the problem?（LVGL未启动、随机崩溃或显示器上未绘制任何内容。问题出在哪里？）
      • 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?（如何减少闪存/ROM的使用？）
      • How to reduce the RAM usage?（如何减少内存使用）
      • How to work with an operating system?（如何使用操作系统？）
  • 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
    • Animations（动画）
      • Start animation on an event
      • Playback animation
      • Animation timeline
    • Events（事件）
      • Button click event
      • 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
      • 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
      • 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
      • 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
      • Roller（滚轮）
        • Simple Roller
        • Styling the roller
        • add fade mask to roller
      • Scale（标尺）
      • 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
      • 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
  • Get started（开始）
    • Quick overview（快速概览）
      • Get started in a simulator（从模拟器开始）
      • Add LVGL into your project（将 LVGL 添加到您的项目中）
      • Learn the basics（学习基础知识）
        • Widgets（部件）
        • Events（事件）
        • Parts（部分）
        • States（状态）
        • Styles（样式）
        • Themes（主题）
      • 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
      • Micropython
  • Integration and Drivers（集成与驱动）
    • Build systems（构建系统）
      • make
      • cmake
        • Overview（概览）
    • Chip vendors（芯片供应商）
      • Espressif (ESP32 chip series)（乐鑫科技（ESP32芯片系列））
        • LVGL demo project for ESP32（ESP32的LVGL演示项目）
        • Using LVGL in your ESP-IDF project（在您的 ESP-IDF 项目中使用 LVGL）
        • Using lvgl_esp32_drivers in ESP-IDF project（在ESP-IDF项目中使用lvgl_esp32_drivers）
      • NXP
        • Creating new project with LVGL（使用LVGL创建新项目）
        • HW acceleration for NXP iMX RT platforms（NXP iMX RT 平台的硬件加速）
      • Renesas（瑞萨）
        • Dave2D（Dave2D）
        • Certified boards（认证板）
        • Get started with the Renesas ecosystem（开始使用瑞萨电子生态系统）
        • Getting started with LVGL（LVGL 入门）
        • Modify the project（修改项目）
        • Support（支持）
      • STM32
        • Including LVGL in a Project（在项目中包含LVGL）
        • Bare Metal Example（裸机示例）
        • FreeRTOS Example（FreeRTOS示例）
    • 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设备一起使用）
        • ST7735 LCD Controller driver（ST7735液晶显示控制器驱动程序）
        • ST7789 LCD Controller driver（ST7789液晶控制器驱动程序）
        • ST7796 LCD Controller driver（ST7796液晶控制器驱动程序）
      • Touchpad（触摸板）
        • FT6X36
      • Libinput Driver（Libinput驱动）
        • Overview（概览）
        • Prerequisites（先决条件）
        • Configuring the driver（配置驱动程序）
        • Usage（用法）
      • X11 Display/Inputs driver（X11显示/输入驱动程序）
        • Overview（概览）
        • Prerequisites（先决条件）
        • Configure X11 driver（配置X11驱动程序）
        • Usage（用法）
      • Windows Display/Inputs driver（Windows显示/输入驱动程序）
        • Overview（概览）
        • Prerequisites（先决条件）
        • Configure Windows driver（配置Windows驱动程序）
        • Usage（用法）
    • 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
      • Simulator on PC（PC端模拟器）
        • Select an IDE（选择一个IDE）
        • Set-up Eclipse CDT（设置 Eclipse CDT）
        • Using SDL manually（手动使用 SDL）
      • MDK
    • (RT)OS
      • 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?（在哪里可以找到更多信息？）
      • RT-Thread RTOS
        • What is RT-Thread?（RT-Thread是什么？）
        • How to run LVGL on RT-Thread?（如何在RT-Thread上运行LVGL）
      • FreeRTOS
      • Zephyr
        • What is Zephyr?（Zephyr是什么？）
        • How to run LVGL on Zephyr?（如何在Zephyr上运行LVGL？）
        • Leveraging Zephyr Features（利用Zephyr特性）
        • Where can I find more information?（在哪里可以找到更多信息？ ）
      • PX5 RTOS
    • Bindings（绑定）
      • 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绑定是自动生成的！）
      • Cpp（C++（是一种计算机编程语言））
      • PikaScript（皮卡脚本）
        • What is PikaScript ?（什么是皮卡脚本？）
        • Why PikaScript + LVGL ?（为什么选择 PikaScript + LVGL？）
        • So how does it look like?（那看起来怎么样呢？）
        • How does it work?（它是如何工作的？）
        • How can I use it?（如何使用它？）
      • JavaScript
        • Table of Contents（目录）
        • Features（功能）
        • Demo（演示）
        • Building（构建）
        • Components（部件）
        • Font（字体）
        • Animation（动画）
        • Style（风格）
        • JSAPI
        • Thanks（感谢）
  • Porting（移植）
    • Set up a project（设置项目）
      • Get the library（获取LVGL图形库）
      • Add lvgl to your project（将 lvgl 添加到您的项目）
        • Automatically add files（自动添加文件）
        • Make and CMake
        • Other platforms and tools（其它平台和工具）
        • Demos and Examples（演示和示例）
      • Configuration file（修改配置文件）
      • Initialization（初始化）
    • Display interface（显示接口）
      • Basic setup（基本设置）
        • flush_cb
        • Draw buffers（绘制缓冲区）
      • Advanced options（高级选项）
        • Resolution（分辨率）
        • Flush wait callback（刷新等待回调）
        • Rotation（旋转）
        • Color format（颜色格式）
        • Swap endianness（交换字节序）
        • User data（用户数据）
        • Decoupling the display refresh timer
        • Force refreshing（强制刷新）
      • Events（事件）
      • 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（缓冲读取）
        • Switching the input device to event-driven mode（将输入设备切换到事件驱动模式）
      • Further reading（深入学习）
      • API
    • Tick interface（心跳接口）
      • API
    • Timer Handler
      • API
    • Sleep management（睡眠管理）
    • Operating system and interrupts（操作系统和中断）
      • Tasks and threads（任务和线程）
      • Interrupts（中断）
    • Logging（日志）
      • Log level（日志等级）
      • Printing logs（打印日志）
        • Logging with printf（使用 printf 记录）
        • Custom log function（自定义日志功能）
      • Add logs（添加日志）
      • API
    • Custom GPU
      • Overview
        • Draw task
        • Draw unit
        • Draw task evaluation
        • Dispatching
        • Layers
        • Hierarchy of modules
      • References
      • API
  • 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 displays（处理多个显示器）
      • Parts（部分）
      • States（状态）
      • Snapshot（快照）
      • API
    • Positions, sizes, and layouts（位置、大小和布局）
      • Overview（概述）
        • Units（单位）
        • Boxing model（盒子模型）
        • Important notes（重要笔记）
      • Position（位置）
        • Simple way（最简单的方法）
        • Align（对齐）
      • Size（大小）
        • Sizing the Simple way（最简单的方法）
      • Using styles（使用样式）
      • Translation（位置转换）
      • Transformation（大小转换）
        • Min and Max size（最小和最大尺寸）
      • Layout（布局）
        • Layout Overview（布局概述）
        • Built-in layout（内置布局）
        • Flags（标志）
        • Adding new layouts（添加新布局）
      • Examples
      • API
    • Styles（风格样式）
      • States（状态）
      • Cascading styles（层叠样式）
      • Inheritance（继承）
      • Parts（部分）
      • Initialize styles and set/get properties（初始化样式和设置/获取属性）
      • Add and remove styles to a widget（向部件添加和删除样式）
        • Add styles（添加样式）
        • Replace styles（替换样式）
        • Remove styles（删除样式）
        • Report style changes（通知样式更改）
        • Get a property's value on an object（获取对象的属性值）
      • Local styles（本地样式）
      • Properties（属性）
        • Typical background properties（典型的背景属性）
      • Transitions（过渡特效）
      • Opacity, Blend modes and Transformations（不透明度，混合模式和变换）
      • Color filter（色彩过滤）
      • Themes（主题）
        • Extending themes（扩展主题）
      • Examples
        • 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
      • API
    • Style properties（样式属性）
      • Size and position（大小和位置）
        • width（宽度）
        • min_width（最小宽度）
        • max_width（最大宽度）
        • height（高度）
        • min_height（最低高度）
        • max_height（最大高度）
        • length（长度）
        • x
        • y
        • align（排列）
        • transform_width（改变宽度）
        • transform_height（改变高度）
        • translate_x（改变x）
        • translate_y（改变y）
        • transform_scale_x（改变x比例）
        • transform_scale_y（改变y比例）
        • transform_rotation（改变旋转）
        • transform_pivot_x（改变x中心点）
        • transform_pivot_y（改变y中心点）
        • transform_skew_x
        • transform_skew_y
      • Padding
        • pad_top
        • pad_bottom
        • pad_left
        • pad_right
        • pad_row
        • pad_column
      • Margin
        • margin_top
        • margin_bottom
        • margin_left
        • margin_right
      • Background
        • bg_color
        • bg_opa
        • bg_grad_color
        • bg_grad_dir
        • bg_main_stop
        • bg_grad_stop
        • bg_main_opa
        • bg_grad_opa
        • bg_grad
        • bg_image_src
        • bg_image_opa
        • bg_image_recolor
        • bg_image_recolor_opa
        • bg_image_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_offset_x
        • shadow_offset_y
        • shadow_spread
        • shadow_color
        • shadow_opa
      • Image
        • image_opa
        • image_recolor
        • image_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_image_src
      • Text
        • text_color
        • text_opa
        • text_font
        • text_letter_space
        • text_line_space
        • text_decor
        • text_align
      • Miscellaneous
        • radius
        • clip_corner
        • opa
        • opa_layered
        • color_filter_dsc
        • color_filter_opa
        • anim
        • anim_duration
        • transition
        • blend_mode
        • layout
        • base_dir
        • bitmap_mask_src
        • rotary_sensitivity
      • Flex
        • flex_flow
        • flex_main_place
        • flex_cross_place
        • flex_track_place
        • flex_grow
      • Grid
        • grid_column_dsc_array
        • grid_column_align
        • grid_row_dsc_array
        • grid_row_align
        • grid_cell_column_pos
        • grid_cell_x_align
        • grid_cell_column_span
        • grid_cell_row_pos
        • grid_cell_y_align
        • grid_cell_row_span
    • 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
        • Nested scrolling
        • Snapping
        • Floating button
        • Styling the scrollbars
        • Right to left scrolling
        • Translate on scroll
      • API
    • Layers（图层）
      • Order of creation（图层顺序）
        • Change order（改变顺序）
      • Screen-like layers（屏幕状的层次）
        • Top and sys layers（顶层和系统层）
        • Bottom layers（底层）
      • Draw layers（绘制图层）
        • Simple layer（简单层）
        • Transformed layer（转换图层）
        • Clip corner（夹角）
      • API
    • Events（事件）
      • Add events to a widget（添加事件到对象）
      • Remove event(s) from widgets(从对象中删除事件)
      • Event codes（事件代码）
        • Input device events（输入设备事件）
        • Drawing events（绘图事件）
        • Special events（特殊事件）
        • Other events（其他事件）
        • Display events（展示时间）
        • Custom events（自定义事件）
      • Sending events（发送事件）
        • Refresh event（刷新事件）
      • Fields of lv_event_t（lv_event_t 的字段）
      • Event bubbling（事件冒泡）
      • Examples
        • Button click event
        • Handle multiple events
        • Event bubbling
        • Draw event
      • API
    • Input devices（输入设备）
      • Pointers（光标）
        • Cursor（光标）
        • Gestures (手势)
      • Keypad and encoder（键盘和编码器）
        • Groups（组）
        • Styling（风格样式）
      • API
    • 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（色调饱和值-Hue Saturation Value）
        • Palette（调色板）
        • Modify and mix colors（修改和混合颜色）
        • Built-in colors（内置颜色）
      • Opacity（不透明度）
      • API
    • Fonts（字体）
      • Unicode support（支持Unicode编码）
      • Built-in fonts（内置字体）
        • Normal fonts（普通字体）
        • Special fonts（特殊字体）
      • Special features（特殊功能）
        • Bidirectional support（双向支持）
        • Arabic and Persian support(阿拉伯语和波斯语支持)
        • Subpixel rendering（亚像素渲染）
        • Compressed fonts（压缩字体）
        • Kerning（字距调整）
      • Add a new font（添加新的字体）
      • Add new symbols（添加新符号）
      • Load a font at run-time（在运行时加载字体）
      • Load a font from a memory buffer at run-time（从内存缓冲区在运行时加载字体）
      • Add a new font engine（添加新的字体引擎）
      • Use 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
    • 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
        • Start animation on an event
        • Playback animation
        • Animation timeline
      • 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
    • Drawing（绘画）
      • Mechanism of screen refreshing（屏幕刷新机制）
      • Masking（蒙版）
        • Using masks（使用遮罩）
      • Hook drawing（挂钩绘图）
        • Main drawing（主图）
        • Post drawing（后绘图）
        • Part drawing（零件绘图）
        • Others（其他）
      • 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（未输出追踪日志）
    • Renderers and GPUs
      • Software renderer
        • API
      • SDL renderer
        • API
      • Arm-2D GPU （Arm-2D 图形处理器）
        • How to Use （如何使用）
        • Design Considerations（设计建议）
        • Examples（示例工程）
        • API
      • NXP PXP GPU
        • API
      • DMA2D GPU
        • API
      • NXP VGLite GPU
        • API
    • 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
        • Base objects with custom styles
        • Make an object draggable
      • API
    • Arc（圆弧 ） (lv_arc)
      • Overview（概述）
      • Parts and Styles（零件和样式）
      • Usage（用法）
        • Value and range（值和范围）
        • Rotation（旋转）
        • Mode（模式）
        • Change rate（变化率）
        • Knob offset（旋钮控件）
        • Setting the indicator manually（手动设置指示灯）
        • Advanced hit test（高级触摸测试）
        • Place another object to the knob（将另一个对象放在旋钮上）
      • Events（事件）
      • Keys（按键）
      • Example
        • Simple Arc
        • Loader with Arc
      • API
    • Animation Image （动画图像） (lv_animimg)
      • Overview（概述）
      • Parts and Styles（零件和样式）
      • Usage（用法）
        • Image sources（图片来源）
      • Events（事件）
      • Keys（按键）
      • Example
        • Simple Animation Image
      • API
    • Bar （进度条）(lv_bar)
      • Overview（概述）
      • Parts and Styles（零件和样式）
      • Usage（用法）
        • 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's text（按钮的文字）
        • Control buttons（控制按钮）
        • One check（一次检查）
      • Events（事件）
      • Keys（按键）
      • Example
        • Simple Button matrix
        • Custom buttons
        • Pagination
      • API
    • Calendar（日历） (lv_calendar)
      • Overview（概述）
      • Parts and Styles（零件和样式）
      • Usage（用法）
        • Current date（当前日期）
        • Shown date（显示日期）
        • Highlighted days（重要日子）
        • Name of the days（日期名称）
        • Custom year list（自定义年份列表）
        • Chinese calendar（中国日历）
      • Events（事件）
      • Keys（按键）
      • Headers（头部）
        • Arrow buttons（箭头按钮）
        • Drop-down（下拉列表）
      • Example
        • Calendar with header
      • API
    • Chart（图表） (lv_chart)
      • Overview（概述）
      • Parts and Styles（零件和样式）
      • Usage（用法）
        • Chart type（图表类型）
        • Data series（数据系列）
        • Modify the data（修改数据）
        • Update modes（更新模式）
        • Number of points（点数）
        • Vertical range（垂直范围）
        • Division lines（分割线）
        • Override default start point for 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
      • 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
    • 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（选项）
        • Set options（设置选项）
        • Get selected option（获取选择的选项）
        • Direction（方向）
        • Symbol（符号）
        • Show selected（显示选中）
        • Manually 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（图片来源）
        • States（状态）
      • 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
    • Menu （菜单）(lv_menu)
      • Overview（概述）
      • Parts and Styles（零件和样式）
      • Usage（用法）
        • Create a menu（创建菜单）
        • Header mode（标头模式）
        • Root back button mode（Root后退按钮模式）
        • 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（创建消息框）
        • Get the parts（获取零件）
        • Close the message box（关闭消息框）
      • Events（事件）
      • Keys（按键）
      • Example
        • Simple 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（用法）
        • Set ranges（设置范围）
        • Configure ticks（配置刻度线）
        • Sections（部分）
      • Events（事件）
      • Keys
      • Example
      • API
    • Slider （滑动条）(lv_slider)
      • Overview（概述）
      • Parts and Styles（零件和样式）
      • Usage（用法）
        • Value and range（值和范围）
        • 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（改变状态）
      • Events（事件）
      • Keys（按键）
      • Example
        • Simple Switch
      • API
    • Table（表） (lv_table)
      • Overview（概述）
      • Parts and Styles（零件和样式）
      • Usage（用法）
        • Set cell value（设置单元格的值）
        • Rows and Columns（行和列）
        • Width and Height（宽度和高度）
        • Merge cells（合并单元格）
        • Scroll（滚动）
      • 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
  • Layouts（布局）
    • Flex（弹性布局）
      • Overview（概述）
      • Terms（约定）
      • Simple interface（简单接口）
        • Flex flow
        • Flex align
        • Flex grow
      • Style interface（样式接口）
        • Internal padding（内部填充）
      • Other features（其它功能）
        • RTL
        • New track（新轨道）
      • Example
        • 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
      • API
    • Grid（网格布局）
      • Overview（概述）
      • Terms（约定）
      • Simple interface（简单的接口）
        • Grid descriptors（网格描述符）
        • Grid items（网格项）
        • Grid align（网格对齐）
        • Sub grid（子网格）
      • Style interface（样式接口）
        • Internal padding（内部填充）
      • Other features（其它功能）
        • RTL
      • Example
        • 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
      • API
  • 3rd party libraries（第三方库）
    • File System Interfaces（文件系统接口）
      • Usage（用法）
      • API
    • BMP decoder（BMP解码器）
      • Limitations（限制）
      • Example
      • Open a BMP image from file
      • API
    • Tiny JPEG Decompressor (TJpgDec)（微型 JPEG 解压缩器 (TJpgDec) ）
      • Overview（概述）
      • Usage（用法）
      • Converter（转换器）
        • Converting JPEG to C array（将JPEG转换为C数组）
      • Example
      • Load a JPG image
      • API
    • libjpeg-turbo decoder（libjpeg-turbo 解码器）
      • Install（安装）
      • Add libjpeg-turbo to your project（将 libjpeg-turbo 添加到您的项目中）
      • Usage（用法）
      • Example
      • Load a JPG image
      • API
    • LodePNG decoder
      • Compress PNG files（压缩PNG文件）
      • Example
      • Open a PNG image from file and variable
      • API
    • libpng decoder（libpng解码器）
      • Install（安装）
      • Add libpng to your project（将libpng加入你的项目）
      • Usage（用法）
      • Example
      • Open a PNG image from file
      • 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
    • FreeType support（FreeType 支持）
      • Add FreeType to your project（将 FreeType 添加到你的项目）
        • For UNIX（对于 UNIX）
        • For Embedded Devices（对于嵌入式设备）
      • Usage（用法）
      • Example
      • Open a front with FreeType
      • Learn more（了解更多信息）
      • API
    • Tiny TTF font engine（微小的TTF字体引擎）
      • Usage（用法）
      • Example
      • Open a font with Tiny TTF from data array
      • Load a font with Tiny_TTF from file
      • Change font size with Tiny_TTF
      • API
    • QR code（二维码）
      • Usage（用法）
      • Notes（笔记）
      • Example
      • Create a QR Code
      • API
    • Barcode（条形码）
      • Usage（用法）
      • Notes（笔记）
      • Example
      • Create a Barcode
      • API
    • Lottie player
      • Build Rlottie（构建Rlottie）
        • ESP-IDF example at bottom （ESP-IDF 示例位于底部）
      • Usage（用法）
        • Use Rlottie from file（从文件使用 Rlottie）
        • Use Rlottie from raw string data（从原始字符串数据使用 Rlottie）
      • Getting animations（获取动画）
      • Controlling animations（控制动画）
      • ESP-IDF Example（ESP-IDF 示例）
        • Background（背景）
        • IDF Setup（IDF设置）
        • Rlottie patch file（Rlottie 补丁文件）
        • CMakeLists for IDF（适用于 IDF 的 CMakeLists）
        • Additional Rlottie considerations in ESP-IDF（ESP-IDF 中的其它 Rlottie 注意事项）
        • Additional changes to make use of SPIRAM（使用 SPIRAM 的其他更改）
      • Example
      • Load a Lottie animation from raw data
      • Load a Lottie animation from a file
      • API
    • FFmpeg support（FFmpeg 支持）
      • Install FFmpeg（安装 FFmpeg）
      • Add FFmpeg to your project（将 FFmpeg 添加到您的项目）
      • Usage（用法）
      • Example
      • Decode image
      • Decode video
      • API
    • RLE Compress（RLE 压缩）
      • Benefits（好处）
      • Theory（理论）
      • Usage（用法）
      • Generate RLE compressed binary images（生成RLE压缩二进制镜像）
    • littlefs
      • Usage（用法）
      • Example（示例）
      • API
  • Others（其他）
    • Snapshot（快照）
      • Usage（用法）
        • Free the Image（释放图像）
        • Use Existing Buffer（使用现有的缓冲区）
      • Example
      • Simple snapshot example
      • API
    • Monkey
      • Usage（用法）
      • Example
      • Touchpad monkey example
      • Encoder monkey example
      • Button monkey 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
      • API
    • File Explorer（文件资源管理器）
      • Usage（用法）
        • Quick access（快速访问）
        • Sort（排序）
      • Events（事件）
      • Example(示例)
      • Simple File Explorer
      • Control File Explorer
      • Custom sort
      • API
    • Fragment（片段）
      • Usage（用法）
        • Create Fragment Class（创建片段类）
        • Use（使用） lv_fragment_manager
        • Fragment Based Navigation（片段式导航）
      • Example
      • Basic fragment usage
      • Stack navigation example
      • API
    • 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