m0_62599305的博客

LVGL v9.0.0 是一个重大版本更新，引入了许多新的功能和优化，同时对部分 API 进行了重大变更。虽然许多变更是内部重构，但也有一些直接影响开发者的改动。本版本还提升了性能，并提供了更多对运行时环境的支持。在迁移项目时，请特别注意可能的非兼容性，因为某些变更可能不会直接导致编译错误，但会影响功能的正确性。关键注意事项缓冲区设置变更在 v8 中，使用设置缓冲区大小（以像素为单位）。在 v9 中，需使用函数，并将缓冲区大小改为以字节为单位设置。示例：lv_color_t类型v9 中，

在v9.2版本中，新增了许多功能，其中鼠标悬停处理（Mouse Hovering）是一个非常重要的更新。这个功能通过新增的 LV_STATE_HOVERED状态，显著提升了用户界面对鼠标事件的响应能力和灵活性。是一个用于表示控件被鼠标悬停时的状态标志。其具体数值为 0x0010。通过这个状态，开发者可以轻松定义控件在鼠标悬停时的行为和视觉效果，例如改变颜色、显示阴影等。的引入，使得鼠标悬停处理更加直观和高效。通过这一特性，开发者可以轻松构建更具交互性和吸引力的用户界面。

是 LVGL 提供的一种用于解析、栅格化和播放 Lottie 动画的组件。Lottie 动画是一种基于矢量的动画格式，可以视为现代化的 SVG 和 GIF 的结合体。通过 Lottie 动画，开发者可以轻松实现高效且流畅的动画效果，适用于嵌入式系统的用户界面设计。什么是 Lottie 动画？Lottie 动画是一种基于 JSON 描述的矢量动画格式，通常由设计工具（如 Adobe After Effects）制作，并可以通过等平台下载。Lottie Widget 基于 lv_canvas。

在用户界面设计中，按钮矩阵是一种常见的控件，用于以紧凑和高效的方式排列多个按钮。LittlevGL 的提供了一种轻量化的实现方式，避免为每个按钮单独创建对象，从而节省内存和计算资源。本文将详细介绍的功能、用法和事件处理。按钮矩阵概述使用虚拟绘制的方式显示按钮，每个按钮仅占用约 8 字节内存，而普通按钮对象需 100-150 字节。按钮矩阵支持使用行列布局，适合键盘导航和编码器操作。是一个强大而灵活的控件，适合需要排列多个按钮的场景。通过简单的配置即可实现多行、多列布局，以及丰富的交互功能。

在图形用户界面中，列表是最常用的布局之一，用于展示一组条目或者选项。LittlevGL 提供的lv_list控件是一个非常灵活且功能强大的控件，能够方便地展示按钮、文本等元素。通过该控件，您可以快速实现如菜单、选项卡、设置列表等常见的界面组件。lv_list控件是一个非常方便和实用的控件，适用于创建各种类型的垂直列表。无论是在菜单界面、设置界面还是信息展示中，lv_list都能提供灵活的布局和丰富的交互功能。通过添加按钮和文本，您可以轻松地实现各种复杂的界面元素，增强用户体验。

是一个容器对象，用于创建网格布局的可导航界面，每个元素被称为“tile”（瓦片）。用户可以通过滑动手势在不同的瓦片之间切换，类似于智能手表的界面。通过精确控制滑动方向，您可以定制每个瓦片的滑动行为，允许在指定方向上滑动，或者完全禁用滑动。是一个灵活的容器控件，特别适合用于显示网格布局的界面，尤其在智能手表等设备中得到广泛应用。通过控制滑动方向和启用动画，开发者可以轻松创建类似翻页的效果。它允许用户在多个瓦片之间导航，并能够为每个瓦片添加不同的内容，提供了丰富的交互功能。

颜色是图形界面设计中不可或缺的一部分，它不仅用于界面美化，还能传递信息、增强交互体验。在 LVGL 中，颜色模块（Color Module）提供了丰富的功能，包括颜色创建、调色、转换、混合等操作。本文将全面介绍 LVGL 颜色模块的功能、使用方法及其相关 API。在 LVGL 中，颜色模块用于处理所有与颜色相关的操作，如改变颜色深度、从 HEX 代码创建颜色、在不同颜色格式之间转换，以及混合或修改颜色等。

是一个可编辑的文本输入控件，通常用于在用户界面中输入和编辑多行或单行文本。该控件支持文本插入、删除、光标控制、文本选择、密码输入等功能。它的文本内容可以通过键盘、API 或事件进行修改，还可以设置最大文本长度、占位符文本和密码模式等。是一个强大且灵活的文本输入控件，适用于多种用户输入场景，支持文本插入、删除、光标控制、密码输入等功能。通过 LittlevGL 提供的丰富 API，开发者可以自定义文本区域的外观和行为，实现复杂的文本输入需求。

图表是数据可视化的重要工具，lv_chart是 LittlevGL 提供的一个灵活的控件，用于展示数据点和趋势。它支持多种图表类型（折线图、柱状图、散点图等）以及丰富的交互功能，如滚动、缩放和光标跟踪。本文将详细介绍lv_chart的功能、用法及示例代码。图表概述lv_chart图表类型：折线图、柱状图、散点图。双 y 轴：支持左侧和右侧独立的 y 轴。分隔线：横向和纵向分隔线。缩放与滚动：可通过容器实现缩放与滚动。光标：动态显示特定点的坐标。

是 LittlevGL 提供的一个虚拟键盘控件，适用于在图形界面中输入文本。与按钮矩阵类似，虚拟键盘预定义了多个键位布局，支持多种模式和自定义键位映射，能够满足各种文本输入需求。通过与文本区域 (Text Area) 的结合，键盘能够自动将输入的字符传送到指定区域。控件是 LittlevGL 提供的强大虚拟键盘解决方案，适用于任何需要文本输入的界面。通过预定义的键盘模式、自定义键位映射和文本区域自动填充功能，可以大大提升用户输入体验。无论是在嵌入式系统的用户界面中，还是在其他需要虚拟键盘的应用中，

Observer 模块是 LVGL 提供的标准观察者模式实现，用于处理事件驱动的逻辑。它将数据（称为Subject）和响应这些数据的行为（称为Observer）解耦，使程序结构更清晰、可扩展性更高。Subject是一个持有值的对象，当值发生变化时，会通知相关的观察者。Observer是监听 Subject 值变化并在变化时执行特定逻辑的回调函数。通过这种模式，多个模块或对象可以对同一个数据变化作出响应，而无需直接耦合。

Pinyin IME 是一个专为中文拼音输入设计的输入法插件，主要用于LVGL 键盘控件，支持26键输入模式和9键输入模式，以及数字键模式。它可以看作是为 LVGL 键盘提供中文拼音输入能力的扩展插件。Pinyin IME 在大多数能运行的环境中都可以运行。字体文件大小：需要支持包含中文字符的字体文件。字典大小：拼音输入所需的汉字词库。自定义字典非常简单。禁用内置字典0编写字典自定义字典的格式如下：lv_100ask_pinyin_dict_t your_pinyin_dict[] = {

在嵌入式图形界面设计中，LED 控件常用于表示状态、通知或指示灯。LittlevGL 提供了一个灵活的 LED 控件lv_led，能够通过调整亮度和颜色来满足多种需求。这些控件不仅能有效显示不同的视觉状态，还能为用户界面增添动态效果。LittlevGL 的lv_led控件提供了一种简单而有效的方式来实现动态的 LED 显示效果。通过设置颜色、亮度和开关状态，您可以灵活地控制 LED 的显示效果，适应不同的视觉反馈需求。无论是在指示状态、通知用户，还是作为界面的一部分，lv_led。

在嵌入式图形开发中，定时任务是一个非常常见的需求，通常用于实现周期性操作或延迟功能。LVGL 提供了内置的定时器（Timer）系统，允许开发者注册回调函数，并在指定的时间间隔内调用这些函数。本文将详细介绍 LVGL 定时器系统的功能、使用方法以及相关的 API。LVGL 的定时器系统允许用户注册函数并在指定的时间间隔内周期性调用。所有定时器的回调函数由函数统一调度，因此需要在程序中定期调用（通常在主循环中）。

在图形用户界面中，消息框（Message Box）是一种常见的弹出式对话框，用于显示重要信息或与用户进行交互。LittlevGL 提供了lv_msgbox控件，它可以轻松实现此功能，包括标题、文本、关闭按钮以及操作按钮，支持模态（阻止屏幕其他部分点击）和非模态模式。通过消息框，开发者可以在不破坏当前界面的情况下提供关键信息或收集用户的反馈。lv_msgbox是一个功能强大且易于使用的控件，适合在界面中创建弹出式对话框。

在图形用户界面 (GUI) 开发中，圆弧是一种常用的控件，可以直观地显示数值范围内的当前状态，比如进度条、调节旋钮等。在 LittlevGL（lvgl）中，lv_arc提供了强大的功能，不仅支持丰富的样式和事件，还允许用户通过触摸或程序调整其值。本文将详细介绍lv_arc的用法，帮助您快速上手。基本构造与样式lv_arc背景弧线 (LV_PART_MAIN)：主弧线，用于显示完整范围。指示器弧线 (LV_PART_INDICATOR)：显示当前值的弧线。旋钮 (LV_PART_KNOB)

在图形用户界面 (GUI) 中，进度条 (Bar)是一种非常常见的控件，用于直观地展示任务的完成程度、数值范围的进度等信息。在 LittlevGL 中，lv_bar提供了一个灵活易用的进度条控件，支持水平和垂直方向的展示，并能够通过动画增强用户体验。本文将全面介绍lv_bar的功能与用法。基本构造与样式lv_bar背景 (LV_PART_MAIN)：用于显示进度条的范围背景。指示器 (LV_PART_INDICATOR)：显示当前值的可视化进度。

lv_indev.h是 LVGL 的输入设备管理模块的核心，它提供了对输入设备的抽象和管理功能，使用户可以轻松地在 LVGL GUI 中集成各种输入设备（如触摸屏、键盘、鼠标、按钮、旋钮编码器等）。本文将全面解读该模块的功能、实现方式以及实际应用，帮助开发者更好地掌握和使用 LVGL 的输入设备功能。lv_indev.h。

滚轮控件（Roller）是 LittlevGL 中用于从多个选项中选择一个的组件。它通过滚动选项列表提供简单直观的交互方式。lv_roller的功能类似于常见的滚轮选择器，支持循环滚动、样式定制以及键盘输入。其可视化的选项选择功能使其在需要快速选择和直观显示的场景中非常实用。lv_roller是 LittlevGL 中一个直观且功能强大的控件，特别适用于需要从多个选项中选择一个的场景。通过支持多种模式（如无限滚动）以及样式自定义，开发者可以轻松实现美观、高效的滚轮选择器。

是 LittlevGL 提供的一个下拉列表控件，允许用户从多个选项中选择一个。它在默认状态下显示一个选中的值或预定义文本。当用户激活下拉列表时，显示一个可滚动的选项列表，用户选择后列表自动关闭。是 LittlevGL 提供的一个功能丰富、使用便捷的下拉列表控件，广泛适用于需要从多个选项中选择的场景。通过本文介绍，您可以掌握其基本用法并轻松实现自定义样式与交互逻辑。

标尺控件（lv_scale）是 LittlevGL 提供的一种线性标尺显示组件，用于展示范围、分段和刻度。它支持灵活的样式定制，能够满足多种数据可视化需求，例如显示刻度范围、分段区间等。本文将详细介绍lv_scale的功能特点、应用场景及实现方式，帮助开发者轻松掌握这一控件。lv_scale是一个功能强大且灵活的标尺控件，适用于各种场景中的范围和分段显示需求。通过精细的样式调整和灵活的分段机制，开发者可以轻松构建美观且实用的用户界面。在嵌入式设备的显示设计中，lv_scale。

要使 LVGL 可以接收来自 GPIO 按钮的输入，我们需要创建一个输入设备回调函数，它会在按钮的状态改变时被调用。假设按钮按下时，GPIO 的状态会改变。// 检查按钮的 GPIO 状态，假设按钮连接到 PA0// 按钮按下：设置为按下状态} else {// 按钮释放：设置为释放状态// 设置按钮的坐标（例如按钮在屏幕上的位置）// 假设按钮在屏幕上的 x 坐标为 100// 假设按钮在屏幕上的 y 坐标为 100配置按钮的 GPIO 输入引脚。

在图形界面设计中，直线绘制是非常常见且重要的功能之一，尤其是在需要进行图形表示、数据可视化和图形界面设计时。LittlevGL 提供的lv_line控件使得在显示屏上绘制直线变得非常简单和灵活。通过设置一组点，lv_line可以自动计算出并连接这些点，绘制出所需的直线图形。lv_line控件是 LittlevGL 提供的一个强大而灵活的工具，用于绘制直线图形。无论是在数据可视化、UI 设计还是路径绘制中，lv_line都能提供准确和高效的直线绘制功能。

在 LVGL 中，lv_animimg是一种类似于普通图像对象（lv_img）的控件，不同之处在于它支持显示一系列图像，以实现图像动画效果。使用lv_animimg，可以设置多个图像源、动画时长以及重复次数等参数，从而展示多帧图像的动态效果。lv_animimg是一个动画图像控件，可以显示一个图像数组，形成图像动画。这个控件能够循环播放图像，创建类似 GIF 动画的效果。你可以自定义动画的播放时长、是否重复等属性。lv_animimg。

是一个容器对象，用于创建网格布局的可导航界面，每个元素被称为“tile”（瓦片）。用户可以通过滑动手势在不同的瓦片之间切换，类似于智能手表的界面。通过精确控制滑动方向，您可以定制每个瓦片的滑动行为，允许在指定方向上滑动，或者完全禁用滑动。是一个灵活的容器控件，特别适合用于显示网格布局的界面，尤其在智能手表等设备中得到广泛应用。通过控制滑动方向和启用动画，开发者可以轻松创建类似翻页的效果。它允许用户在多个瓦片之间导航，并能够为每个瓦片添加不同的内容，提供了丰富的交互功能。

在图形用户界面中，菜单是一种常见的界面元素，通常用于组织和显示多个选项。LittlevGL 提供了lv_menu控件，可以轻松创建多级菜单。该控件不仅支持基本的菜单结构，还包括用于导航的侧边栏和页面转换的功能，是实现复杂界面结构的理想选择。lv_menu控件是一个功能强大的多层级菜单组件，适用于需要展示复杂层次结构的应用。它不仅支持多级页面之间的跳转，还可以灵活地定制头部、侧边栏以及返回按钮等元素。通过该控件，开发者可以轻松构建清晰且易于导航的用户界面，适合用于各种场景，如设置菜单、导航菜单等。

富文本控件（lv_span）是 LittlevGL 提供的一种丰富的文本显示工具，可以在同一个对象中渲染具有不同字体、颜色、大小等样式的文本。与传统的标签控件（lv_label）不同，lv_span通过创建富文本组（spangroup）来管理多个文本片段（span），为开发者提供了更强的灵活性和自定义能力。lv_span是一个功能强大且灵活的富文本控件，可以满足复杂文本显示和样式需求。通过合理配置spangroup和span，开发者可以轻松实现多样化的文本展示效果。

与 Android 的 DIP（设备独立像素）相同，避免与 LVGL 中的。

滑块控件（lv_slider）是 LittlevGL 提供的一种简单易用的值选择工具。它的外观类似于带有滑动按钮的进度条，支持水平或垂直显示方式，并允许用户通过拖动滑块或点击控件设置值。滑块控件可以应用于各种场景，例如音量控制、亮度调节和范围选择器等。本文将详细介绍lv_slider的功能、使用方法和配置技巧。lv_slider是一个功能强大的交互式控件，提供了丰富的配置选项和事件支持，适用于多种场景中的值选择和范围控制需求。通过灵活的样式设置和模式切换，开发者可以轻松实现符合设计需求的滑块组件。

lv_label是 LittlevGL 中最基础的控件之一，用于显示文本。无论是简单的文字内容，还是需要动态更新的文本，lv_label都能提供灵活和高效的解决方案。该控件支持多种文本样式、文本溢出处理方式以及文本选择功能，适用于各种图形界面应用。lv_label是 LittlevGL 提供的一个非常灵活的文本显示控件。无论是静态文本、动态文本、长文本处理，还是文本选择功能，lv_label都能够满足各种需求。通过精细的样式配置和文本处理选项，您可以在嵌入式应用程序中轻松实现丰富的文本显示效果。

lv_spinner是 LittlevGL 提供的一种加载动画控件，呈现为一个环形弧线旋转动画。它在许多场景中可用作加载提示或操作等待的视觉反馈。控件灵活易用，支持自定义动画时长和弧线角度。lv_spinner是一个简单易用的加载动画控件，适合用作等待提示。通过少量代码和配置，开发者可以快速实现灵活的加载动画效果，为应用提供更好的用户体验。通过调整弧线参数和样式，lv_spinner可以适应不同的场景需求，是 LittlevGL 中一个非常实用的控件。

lv_spinbox是 LittlevGL 提供的一种数字选择控件。它展示一个数值，可以通过按键或 API 方法进行增减操作。lv_spinbox的底层是一个经过改造的文本区域控件，支持丰富的功能，如设置数值范围、步进值、自定义格式等，非常适合需要数字输入的场景。lv_spinbox是一个功能强大的数字选择控件，支持多种操作方式和丰富的配置选项。无论是在表单输入、计数器设置，还是其他需要动态调整数值的场景中，lv_spinbox都能提供良好的用户体验。

lv_win是一个类似容器的控件，通常用于创建具有标题栏、控制按钮和内容区域的窗口。通过lv_win，开发者可以构建包含标题、按钮、以及内容区的窗口界面。它可以用来显示信息、提供用户交互或呈现应用的功能界面。lv_win是一个功能强大的窗口控件，适合用于创建带有标题栏和控制按钮的窗口界面。它提供了灵活的方式来添加标题、按钮和内容区域，并允许通过自定义事件和样式来满足不同的设计需求。无论是在嵌入式设备的应用界面还是智能手表等设备上，lv_win都能帮助开发者轻松构建用户友好的窗口界面。

在图形界面开发中，层次（Layer）的概念至关重要，它决定了界面元素的显示顺序以及叠加关系。在LVGL（Light and Versatile Graphics Library）中，层次管理贯穿于整个界面开发过程，不仅可以控制普通对象的显示顺序，还提供了几个特殊的层次，用于实现全局的界面元素和效果。本文将深入探讨 LVGL 的层次概念，介绍其用途、各类层的特点，以及相应的函数和使用方法。层次管理是 LVGL 中不可或缺的一部分，合理调整对象的层次顺序和充分利用特殊层，可以显著提高界面的动态效果和交互体验。

是一个容器对象，用于创建网格布局的可导航界面，每个元素被称为“tile”（瓦片）。用户可以通过滑动手势在不同的瓦片之间切换，类似于智能手表的界面。通过精确控制滑动方向，您可以定制每个瓦片的滑动行为，允许在指定方向上滑动，或者完全禁用滑动。是一个灵活的容器控件，特别适合用于显示网格布局的界面，尤其在智能手表等设备中得到广泛应用。通过控制滑动方向和启用动画，开发者可以轻松创建类似翻页的效果。它允许用户在多个瓦片之间导航，并能够为每个瓦片添加不同的内容，提供了丰富的交互功能。

lv_image是 LittlevGL 中用于显示图像的基础控件。它支持从闪存中读取的像素数组、外部文件或符号（如）作为图像源。通过图像解码器接口，您还可以支持自定义图像格式。lv_image控件是 LittlevGL 中用于显示图像的强大工具，支持多种图像源、灵活的样式定制以及各种图像变换功能。无论是在应用中显示简单图标，还是创建复杂的动态图像效果，lv_image都提供了足够的灵活性和可扩展性。通过本指南，您可以掌握如何有效地使用图像控件来提升用户界面的表现力。

是 LittlevGL 提供的一种简单控件，用于实现带有可选项的复选框。每个 Checkbox 包含一个小方框（Tick Box）和一个标签，当用户点击 Checkbox 时，方框的状态（勾选或未勾选）会切换。本文将详细介绍 Checkbox 的功能、样式和使用方法。代表 Checkbox 的主背景区域，控制 Checkbox 的整体样式。文本样式：包括字体大小、颜色等。pad_column属性调整复选框和标签之间的间距。代表复选框的样式，默认是一个正方形，大小等于主背景区域字体高度。

lv_tabview是 LittlevGL 提供的一种便捷控件，用于将内容分组组织到多个选项卡中。主容器：承载所有选项卡内容。选项卡按钮栏：用于切换不同选项卡。选项卡容器：每个选项卡对应的内容区域。选项卡按钮栏可以位于顶部、底部、左侧或右侧，用户可通过点击选项卡按钮或滑动切换选项卡。lv_tabview是一种功能强大的控件，用于实现多选项卡内容布局，支持灵活的样式设置和交互操作。通过丰富的功能和便捷的 API，开发者可以快速构建具有多选项卡布局的用户界面，从而提升用户体验和界面组织性。

在图形用户界面设计中，按钮是最基础、最常用的控件之一。LittlevGL 的lv_button是基于 Base 对象的控件，尽管它没有新增功能，但它提供了一些默认的优化设置以便于快速使用。本文将详细介绍lv_button的特点、用法和事件处理。基本构造与样式lv_button默认不可滚动。默认会被加入默认的组 (Group)。默认的高度和宽度设置为。LittlevGL 的按钮控件lv_button是一个功能丰富且易用的控件，适用于各种场景的交互设计。

在用户界面设计中，日历控件是一个常见且功能丰富的元素。LittlevGL 的提供了一种轻量级的实现方式，可显示月份、当前日期、高亮特定日期，并支持自定义年份列表和用户交互。本文将详细介绍的功能、用法以及事件处理。日历控件概述以 7x7 的矩阵显示任意月份的日期。显示星期名称。高亮当前日期。高亮用户自定义的日期。此外，是一个可编辑对象，支持通过键盘或编码器导航和选择日期。为了更灵活地显示，默认情况下日历不会直接展示当前年份或月份，但可以通过可选的“标题”附加到日历上。