【花雕学编程】Arduino动手做（249）---ESP32+GC9A01之基于内存方式播放X翼战机GIF动画

驴友花雕

已于 2025-04-23 18:24:25 修改

阅读量312

点赞数 7

分类专栏：开源硬件文章标签：嵌入式硬件单片机 c++ Arduino TFT GC9A01播放翼战机动画 ESP32 1.28寸 TFT Arduino动手做（249）

于 2025-04-23 17:01:16 首次发布

本文链接：https://blog.csdn.net/weixin_41659040/article/details/147443063

版权

开源硬件专栏收录该内容

1680 篇文章

订阅专栏

在这里插入图片描述

37款传感器与模块的提法，在网络上广泛流传，其实Arduino能够兼容的传感器模块肯定是不止37种的。鉴于本人手头积累了一些传感器和执行器模块，依照实践出真知（一定要动手做）的理念，以学习和交流为目的，这里准备逐一动手试试多做实验，不管成功与否，都会记录下来——小小的进步或是搞不掂的问题，希望能够抛砖引玉。

【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
实验二百四十九：1.28寸圆形彩色TFT显示屏高清IPS 模块 240*240 SPI接口GC9A01驱动

在这里插入图片描述

实验开发板使用ESP32

在这里插入图片描述

实验模块接线示意图

在这里插入图片描述

【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
实验二百四十九：1.28寸圆形彩色TFT显示屏高清IPS 模块 240*240 SPI接口GC9A01驱动
项目之一百二十四：ESP32+GC9A01之基于内存方式播放翼战机GIF动画

实验开源代码

/*
  【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
  实验二百四十九：1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动
  项目之一百二十四：ESP32+GC9A01之基于内存方式播放翼战机GIF动画
*/

//       GC9A01---------- ESP32
//       RST ------------ NC（复位引脚，此处未连接）
//       CS ------------- D4（片选引脚，连接到ESP32的D4引脚）
//       DC ------------- D2（数据/命令选择引脚，连接到ESP32的D2引脚）
//       SDA ------------ D23 (green)（主数据输出引脚，连接到ESP32的D23引脚，绿色线）
//       SCL ------------ D18 (yellow)（时钟信号引脚，连接到ESP32的D18引脚，黄色线）
//       GND ------------ GND（接地引脚，连接到ESP32的接地端）
//       VCC -------------3V3（电源引脚，连接到ESP32的3.3V电源）

#include <SPI.h>
#include <TFT_eSPI.h>     // 📌 ESP32 专用的 TFT 显示屏库
                          // 🚀 需要通过 Arduino Library Manager 安装
                          // ⚠️ 使用前需要正确配置屏幕驱动
                          
#include <AnimatedGIF.h>  // 📌 GIF 动画库
                          // 🚀 通过 Arduino Library Manager 安装
                          // 🎥 负责解码 GIF 并显示到屏幕
AnimatedGIF gif;          // 🏗 创建 GIF 处理对象

// 📌 预加载的 GIF 图片
#include "images/hyperspace.h"  // 星空动画
#include "images/nostromo.h"    // 未来风格 HUD
#include "images/hud_1.h"       // HUD 显示风格 1
#include "images/hud_2.h"       // HUD 显示风格 2
#include "images/hud_5.h"       // HUD 显示风格 5
#include "images/hud_6.h"       // HUD 显示风格 6
#include "images/hud_7.h"       // HUD 显示风格 7
#include "images/darthvader.h"  // 达斯·维达角色
#include "images/x_wing.h"      // X 翼战机动画
#include "images/colortest.h"   // 颜色测试动画

// 🎥 选择要播放的 GIF 图片
// ⚠️ 只启用一个 GIF，否则 ESP32 可能内存不足
// ⚠️ 如果需要加载多个 GIF，需调整 ESP32 的 Flash 分区
//
// #define GIF_IMAGE colortest
// #define GIF_IMAGE hyperspace
// #define GIF_IMAGE nostromo
// #define GIF_IMAGE darthvader
// #define GIF_IMAGE hud_1
// #define GIF_IMAGE hud_2
// #define GIF_IMAGE hud_5
// #define GIF_IMAGE hud_6
// #define GIF_IMAGE hud_7
#define GIF_IMAGE x_wing  // 🚀 选择 X 翼战机动画

// 📌 创建 TFT 显示对象
TFT_eSPI tft = TFT_eSPI();

void setup() {
  Serial.begin(115200);   // 📡 初始化串口，方便调试
  tft.begin();            // 🖥 启动 TFT 显示屏
  tft.setRotation(2);     // 🔄 设置屏幕旋转角度（0-3）
  tft.fillScreen(TFT_BLACK); // 🎨 清空屏幕，填充黑色
  gif.begin(BIG_ENDIAN_PIXELS); // 🖥 初始化 GIF 处理库（使用大端像素格式）
}

void loop()
{
  // 🚀 尝试打开 GIF 文件
  if (gif.open((uint8_t *)GIF_IMAGE, sizeof(GIF_IMAGE), GIFDraw))  
  {
    Serial.printf("✅ 成功打开 GIF；尺寸 = %d x %d\n", gif.getCanvasWidth(), gif.getCanvasHeight());
    
    tft.startWrite();  // 🖥 开启 TFT 显示屏的写入模式
    
    // 🔄 播放 GIF 每一帧
    while (gif.playFrame(true, NULL))
    {
      yield(); // ⚡ 让 ESP32 处理其他任务，避免卡死
    }
    
    gif.close();   // 🎥 关闭 GIF 文件
    tft.endWrite(); // 🖥 关闭 TFT 写入模式
  }
}

这段代码用于在 ESP32 的 TFT 显示屏上播放 GIF 动画 🎥✨，它结合了 TFT_eSPI 库和 AnimatedGIF 库，能够流畅显示科幻风格 HUD、星战角色、动态特效等动画。

核心逻辑
1️⃣ 加载 GIF 图像 → 代码包含多个预加载的 GIF 文件，你可以选择要播放的动画（如 X 翼战机）
2️⃣ 初始化显示屏 → 通过 TFT_eSPI 库配置屏幕，设置旋转角度，并清空背景色
3️⃣ GIF 播放控制 → 使用 gif.open() 读取动画数据，然后逐帧渲染到屏幕
4️⃣ 流畅显示 GIF → 使用 gif.playFrame(true, NULL) 播放每一帧，并确保 ESP32 运行稳定
5️⃣ 循环播放动画 → GIF 播放完成后自动重启，形成无缝动态效果

最终效果
🎥 ESP32 屏幕上流畅播放 GIF 动画 🚀 可以选择不同的 GIF 文件（HUD 界面、科幻角色、星战战机等） 🔄 动画不断循环，让显示效果更加生动

实验场景图动态图

在这里插入图片描述