【Wio Terminal】使用LCD屏幕（2）

一、使用不同的字体

本节提供了如何在Wio Terminal设备上选择和使用包含GNU FreeFonts的字体库的指南。

1、可用的字体

这个字体库中有三种主要的字体可以使用，包括衬线字体（Serif）、无衬线字体（Sans）和等宽字体（Mono）。每种字体都有几种样式（粗体、斜体、倾斜体）和字体大小，从9pt、12pt、18pt到24pt不等。（pt：字体字号大小的单位）

2、在Wio Terminal上使用字体

为了更方便使用这些字体，可以将Seeed_Arduino_LCD文件内的 Free_Fonts.h文件拷贝到项目中。参考路径：

C:\Users\Documents\Arduino\libraries

为了节省大量的打字时间，在sketch中可以通过三种方式引用每种字体：

方法一：使用完整的字体名称

tft.setFreeFont(&FreeSansBoldOblique24pt7b);

在这种方法中，你需要使用字体的完整名称来引用它。这通常包括字体的类型（如Sans Serif）、样式（如Bold、Oblique）和大小（如24pt）。这种方法的优点是清晰明了，但缺点是名称可能很长，容易出错。

方法二：使用FF#编号

tft.setFreeFont(FF32);

在这种方法中，每个字体都被分配了一个唯一的编号（如FF32），你可以在草图中使用这个编号来引用字体。这种方法的优点是简短易记，但缺点是你需要查看Free_Fonts.h文件来找到每个字体的对应编号。

方法三：使用缩写名称

tft.setFreeFont(FSSBO24)

在这种方法中，字体名称被缩写为一系列字母和数字的组合。这些字母代表字体的类型、样式和大小。例如，FSSBO24代表Free Sans Serif Bold Oblique 24pt字体。这种方法的优点是既简短又具有一定的描述性，但缺点是初次使用时可能需要熟悉缩写的含义。

缩写含义解释：
F = Free font（免费字体）
M = Mono（等宽字体）
SS = Sans Serif（无衬线字体，双S用于与衬线字体区分）
S = Serif（衬线字体）
B = Bold（粗体）
O = Oblique（倾斜体，字母O不是数字0）
I = Italic（斜体）
No = point size（字体大小，可以是9、12、18或24）
通过这三种方法，你可以根据自己的喜好和项目需求在Arduino的sketch中灵活地引用和使用字体。

使用不同字体的示例：
使用该实例时，你需要将arduino打开的sketch保存在桌面上或指定文件夹，将下面路径的Free_Fonts.h复制到你刚才保存的sketch的文件夹下。

C:\Users\Documents\Arduino\libraries\Seeed_Arduino_LCD\examples\320x240\All_Free_Fonts_Demo

#include"TFT_eSPI.h"
#include"Free_Fonts.h" // 包含头文件
TFT_eSPI tft;

void setup() {
  tft.begin();
  tft.setRotation(3);
  tft.fillScreen(TFT_BLACK); // 黑色背景
  
  tft.setFreeFont(&FreeSansBoldOblique12pt7b); // 选择 Free, Sans, Bold, Oblique, 12pt的字体
  tft.drawString("Sans Serif 12pt",70,80);// 在(70,80)处开始写下字符串

  tft.setFreeFont(FF10); // 选择 Free, Mono, Oblique, 12pt的字体
  tft.drawString("Mono 12pt",70,110);// 在(70,110)处开始写下字符串

  tft.setFreeFont(FS12); // 选择 Free, Serif, 12pt的字体
  tft.drawString("Serif 12pt",70,140);//在(70,140)处开始写下字符串
  
}
void loop() {}

二、显示抗锯齿字体

本节演示了如何在Wio Terminal上使用抗锯齿字体（例如显示日文字符、希腊字符和其他UCS-2字形）！此外，平滑字体还可以用于在计算机上，并以您喜欢的字体来显示英文字符。

安装相应的库

如使用LCD屏幕（1）中开头所述，这里同样方法添加.zip文件。
下载Seeed_Arduino_FS
下载Seeed_Arduino_SFUD

生成vlw字体文件

下面演示了如何生成可以在Wio Terminal上用于平滑字体的vlw字体文件：
第一步
下载 processing。
第二步
打开软件，点击工具 > 创建字体。

第三步
将会出现一个“创建字体”窗口。您可以在此选择您计算机上可用的字体。您可以更改字体大小，并点击“字符…”进行进一步的设置。此外，您还可以更改vlw文件的文件名。

第四步
点击Characters，将会出现一个“字符选择器”窗口，您可以在其中选择特定语言的Unicode字符块（例如本例中的“基本拉丁语”）。对于亚洲字符（中文、日文、韩文），建议使用“CJK Compatibility ”或“CJK category”的Unicode字符块。点击“确定”以保存字体设置。（日常用中文可使用“CJK Unified Ideographs”）

第五步
点击文件 > 保存。

储存到SD卡中

现在，将vlw字体文件复制到SD卡中，并将SD卡重新插入Wio Terminal。

配置LCD库

默认情况下，LCD库中的平滑字体选项是关闭的，以节省Wio Terminal的资源。因此，需要在Wio Terminal中配置以启用平滑字体。

请导航到Arduino库文件夹（libraries）-> Seeed_Arduino_LCD，并使用编辑器打开User_Setup.h文件。搜索#define SMOOTH_FONT并将该行取消注释，如下所示：

现在你已经在Wio Terminal上启用了平滑字体，可以显示任何你喜欢的字体或字符了！

显示

将SD卡内的字体加载到Wio Terminal：

void loadFont(String fontName);	// fontName是vlw文件名。

在屏幕上显示vlw文件中的所有字符：

void showFont(uint32_t td);		// td是显示所有字符时屏幕之间的延迟时间

卸载字体：

void unloadFont();

要在屏幕上显示字符，您可以使用类似于TFT库中的函数，如 tft.println()。此外，您还可以使用其他函数，如tft.setCursor() 和 tft.setTextColor()，来改变显示字符的位置和颜色。

示例：
可以直接点击此处直接下载代码文件，无需复制下面代码。
这里不建议使用中文，因为中文的.vlw太大， tft.loadFont()加载后会爆内存，博主的单片机甚至出现无法烧录的情况。若您出现在此情况，请拔出SD卡，下拉复位后，再烧录。

#include<SPI.h>
#include "Seeed_FS.h"
#include "SD/Seeed_SD.h"
#include"TFT_eSPI.h"

TFT_eSPI tft;

void setup() {
    tft.begin();
    Serial.begin(115200);
    tft.setRotation(3);
    tft.fillScreen(TFT_BLACK); //Black background

    while(!SD.begin(SDCARD_SS_PIN, SDCARD_SPI)){
        Serial.println("SD card error!\n");
        while(1);
  }
  delay(1000);

  tft.loadFont("Apple-Chancery-24");
  // Show all characters on screen with 2 second (2000ms) delay between screens
  tft.showFont(2000); // Note: This function moves the cursor position!

  tft.setTextColor(TFT_RED,TFT_BLACK);
  tft.setCursor(0,0);

  tft.println("Konnichiwa");
  tft.println("Sayonara");
  tft.println();
  tft.unloadFont();

  tft.loadFont("Latin-Hiragana-24");
  tft.setTextColor(TFT_GREEN,TFT_BLACK);
  tft.println("こんにちは");
  tft.println("さようなら");
  tft.unloadFont();
  
}
void loop(){}