基于Processing4给TFT_eSPI库添加自定义中文字库

准备工作

在 TFT_eSPI 库中自定义中文字库，需要用到的软件及网站如下：

• [Processing][官网]，下载软件，绿色软件，无需安装，本文是使用的 4.3 版本
• 汉字字符集编码查询，在线网站，用于查询汉字的 unicode

生成字库

在 TFT_eSPI 库中有个 Tools/Create_Smooth_Font/Create_font 的文件夹，这个是 Processing 的工程文件。

使用 processing 打开 Create_font. pde 文件。只需简单修改就可以，如下所示：

// 制作TFT_eSPI字库使用的电脑字体
int fontNumber = -1; //使用的字体
String fontName = "font";  // 导出字库名称

// Define the font size in points for the TFT_eSPI font file
int  fontSize = 32; // TFT_eSPI中字体像素大小

int displayFontSize = 32; // Processing 显示字体大小

// 输入Unicode编码的起始码值和结束码值
static final int[] unicodeBlocks = {
  0x0021, 0x007E, //Basic Latin, 128, 128, Latin (52 characters), Common (76 characters)
};

// 输入需要额外生成字库的Unicode码值
static final int[] specificUnicodes = {
  0x6E29, 0x5EA6, 0x6E7F, 0x5EA6 //温度湿度
};

打开汉字字符集编码查询网站，输入需要转换的汉字，将 unicode 值放入 specificUnicodes 数组中。

在 Processing 中先运行一次，发现有报错。然后在 FontFiles 文件夹下可以看到生成的 System_Font_List. txt，这个文件展示了电脑上安装的所有字体，找到需要使用的字体，将前面的编号（如：[480] 微软雅黑）赋值给 fontNumber，int fontNumber = 480;

在 Processing 中重新运行，在弹出窗口可以看到生成的字符。

如果运行后，在弹出窗口看到生成的字符有乱码。这是因为 fontNumber 的值对应的字体并不支持汉字，重新修改 fontNumber 的值即可。

使用字库

TFT_eSPI 中需要用到的是. h 文件，将 font32. h 放入 arduino 工程文件夹中，使用中文字库的示例如下：

#include <TFT_eSPI.h>

#include "font32.h"        //字库

TFT_eSPI tft = TFT_eSPI(); 
TFT_eSprite sprite = TFT_eSprite(&tft);

// 使用TFT_eSPI指定字库
tft.loadFont(font32); //指定tft屏幕对象载入font32字库
tft.drawCentreString("温度", 40, 0, 4);
tft.drawCentreString("湿度", 40, 64, 4);
tft.unloadFont(); //释放字库文件,节省资源

// 使用TFT_eSprite指定字库
sprite.loadFont(font32);
sprite.setTextColor(TFT_WHITE);
sprite.drawCentreString("温度", 40, 0, 4);
sprite.drawCentreString("湿度", 40, 64, 4);
sprite.unloadFont();