【花雕学编程】Arduino动手做（249）---ESP32 1.28寸 TFT GC9A01屏幕之文本正反旋转与随机中心文字

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

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

实验开发板使用ESP32

实验模块接线示意图

【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
实验二百四十九：1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动
项目实验之十七：实现文本正反旋转与随机中心文字

实验开源代码

/*
  【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
  实验二百四十九：1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动
  项目实验之十七：实现文本正反旋转与随机中心文字
*/

//       GC9A010 -------- 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"                   // 引入SPI库
#include "Adafruit_GFX.h"          // 引入Adafruit GFX库
#include "Adafruit_GC9A01A.h"      // 引入GC9A01A显示屏驱动库

#define TFT_DC 2                   // 定义TFT显示屏的DC引脚
#define TFT_CS 4                   // 定义TFT显示屏的CS引脚

Adafruit_GC9A01A tft(TFT_CS, TFT_DC); // 创建GC9A01A对象

#define DELAY_TIME 100             // 每次旋转延迟（毫秒）
#define SCREEN_CENTER_X 120        // 屏幕中心X坐标（240x240屏幕）
#define SCREEN_CENTER_Y 120        // 屏幕中心Y坐标（240x240屏幕）
#define RADIUS 80                  // 旋转半径
#define NUM_TURNS 1                // 每个方向的旋转圈数
#define OFFSET_LEFT 25             // 向左偏移量

void setup() {
    Serial.begin(9600);            // 初始化串口通信
    Serial.println("Rotating Letters and Centered Random 'OK'!");

    tft.begin();                   // 初始化显示屏
    tft.setRotation(2);            // 设置初始旋转方向
    tft.fillScreen(GC9A01A_BLACK); // 清屏
    randomSeed(analogRead(0));     // 初始化随机数种子
}

void rotateText(int direction) {
    // 根据旋转方向正转或反转
    for (int angle = 0; angle < NUM_TURNS * 360; angle += 10) {
        // 清屏
        tft.fillScreen(GC9A01A_BLACK);

        // 随机生成颜色
        uint16_t randomColor = random(0x0000, 0xFFFF); // RGB565随机颜色

        // 计算字母位置（向左偏移 OFFSET_LEFT）
        float radian = angle * direction * 3.14159 / 180; // 正转：方向为1，反转：方向为-1
        int x = SCREEN_CENTER_X + RADIUS * cos(radian) - OFFSET_LEFT; // “Hello”左偏移
        int y = SCREEN_CENTER_Y + RADIUS * sin(radian);

        // 设置旋转文字属性
        tft.setTextColor(randomColor);                 // 设置随机颜色
        tft.setTextSize(2);                            // 设置字体大小
        tft.setCursor(x, y);                           // 设置文本位置
        tft.print("Hello");                            // 显示字母

        // 显示中心文字“OK”
        int randomSize = random(1, 5);                 // 随机生成字体大小
        tft.setTextColor(GC9A01A_WHITE);               // 中心文字颜色为白色
        tft.setTextSize(randomSize);                   // 设置中心文字大小
        tft.setCursor(SCREEN_CENTER_X - (6 * randomSize), SCREEN_CENTER_Y - (8 * randomSize));
        tft.print("OK");                               // 屏幕正中心显示“OK”

        delay(DELAY_TIME);                             // 延迟控制动画速度
    }
}

void loop() {
    rotateText(1);  // 正转一圈
    rotateText(-1); // 反转一圈
}

代码说明

1、中心文字“OK”保持屏幕中央：

中心文字计算仅依赖屏幕中心坐标SCREEN_CENTER_X和SCREEN_CENTER_Y：

tft.setCursor(SCREEN_CENTER_X - (6 * randomSize), SCREEN_CENTER_Y - (8 * randomSize));

2、“Hello”文字左偏移：

在旋转逻辑中对“Hello”文字的 X 坐标进行左移偏移：

int x = SCREEN_CENTER_X + RADIUS * cos(radian) - OFFSET_LEFT;

3、旋转逻辑保持不变：

“Hello”文字继续完成正转一圈、反转一圈的旋转，动画效果自然流畅。

4、随机字体大小：

中心文字“OK”的字体大小仍然随机，范围为1至4号。

5、效果描述

“Hello”文字沿圆形轨迹旋转一圈，并整体向左偏移25像素，颜色动态变化。

中心文字“OK”始终位于屏幕正中心，字体大小随机，颜色固定为白色。

动画顺畅，视觉效果更加生动。

实验场景图 动态图