项目简介
本项目借助Adafruit GFX库和GNU Unifont字体构建全球显示系统,可在各类显示设备上无缝展示全球所有语言文本。通过将标准的5x7字体替换为8x16像素的GNU Unifont字体,能显示基本多语言平面(BMP)中的全部Unicode字符。
项目的主要特性和功能
- 支持全球语言,能显示基本多语言平面(BMP)从U+0000到U+FFFF代码点的所有Unicode字符。
- 适配多种显示设备,如OLED、TFT、e - ink等。
- 支持UTF - 8编码,有严格的UTF - 8解码器,可将UTF - 8编码字符串转为适合显示的代码点。
- 字体存储灵活,可将Unifont字体存于Flash芯片或程序内存,用户能按需选择。
- 易于集成,可作为Adafruit GFX库的替代品,在不使用图形字体时无缝替换现有项目中的Adafruit GFX库。
安装使用步骤
假设用户已下载本项目的源码文件:
1. 安装依赖库:确保已安装Adafruit GFX库和SPI TFT显示库。
2. 配置硬件:依据所使用的显示设备型号和连接方式,配置对应的硬件接口和参数。
3. 加载Unifont字体:
- 若使用带Flash芯片的开发板(如Feather M0/M4 Express),把unifontconvert/unifont.bin
文件复制到开发板文件系统,在代码中调用display.loadUnifontFile()
加载字体文件。
- 若使用其他开发板,用unifontconvert/converter.py
工具选择所需字符块,生成glcdfont.c
文件替换库中的同名文件。
4. 编写代码:运用Adafruit GFX库的函数编写代码以实现图形和文本显示。例如,用display.writeCodepoint(c)
显示单个Unicode字符,或用display.printUTF8(s)
显示UTF - 8编码的字符串。
5. 编译和烧录:将编写好的代码编译并烧录到开发板,连接显示设备后查看显示效果。
注意事项
- 硬件需与Adafruit GFX库兼容。
- 自定义字体时,生成的字体文件要与Adafruit GFX库格式兼容。
- 使用UTF - 8解码器时,注意处理可能出现的错误,保证代码健壮性。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】