LovyanGFX 开源项目使用教程

1. 项目的目录结构及介绍

LovyanGFX 项目的目录结构如下：

LovyanGFX/
├── CMakeLists.txt
├── README.md
├── component.mk
├── examples/
│   ├── examples_for_PC/
│   └── ...
├── library.json
├── library.properties
├── license.txt
├── src/
│   ├── lgfx_user/
│   └── ...
└── ...

目录结构介绍

• CMakeLists.txt: 用于构建项目的 CMake 配置文件。
• README.md: 项目的基本介绍和使用说明。
• component.mk: 用于 ESP-IDF 项目的组件配置文件。
• examples/: 包含项目的示例代码，分为 examples_for_PC 和其他平台相关的示例。
• library.json 和 library.properties: 用于 Arduino IDE 的库配置文件。
• license.txt: 项目的开源许可证文件。
• src/: 项目的源代码目录，包含核心库文件和用户自定义配置文件。

2. 项目的启动文件介绍

LovyanGFX 项目的启动文件主要位于 src/ 目录下，其中 LovyanGFX.hpp 是核心库文件，包含了项目的核心功能和 API。

核心文件介绍

• LovyanGFX.hpp: 这是 LovyanGFX 库的主头文件，包含了所有图形操作的接口和实现。
• LGFX_AUTODETECT.hpp: 用于自动检测和配置显示设备的头文件。

启动流程

1. 包含头文件: 在主程序中包含 LovyanGFX.hpp 和 LGFX_AUTODETECT.hpp。
2. 初始化显示设备: 调用 lcd.init() 初始化显示设备。
3. 设置显示参数: 设置显示方向、亮度、颜色深度等参数。
4. 绘制图形: 使用 LovyanGFX 提供的 API 进行图形绘制。

3. 项目的配置文件介绍

LovyanGFX 项目的配置文件主要位于 src/lgfx_user/ 目录下，用户可以根据自己的需求进行自定义配置。

配置文件介绍

• LGFX_ESP32_sample.hpp: 这是一个示例配置文件，展示了如何为 ESP32 平台配置 LovyanGFX。
• LGFX_TFT_eSPI.hpp: 如果用户之前使用的是 TFT_eSPI 库，可以通过这个文件进行兼容配置。

配置流程

1. 选择配置文件: 根据使用的平台和需求选择合适的配置文件。
2. 自定义配置: 在配置文件中修改显示设备的参数，如 SPI 速度、I2C 地址等。
3. 包含配置文件: 在主程序中包含自定义的配置文件。

通过以上步骤，用户可以轻松地使用 LovyanGFX 库进行图形显示和操作。