项目简介
本项目是对Adafruit SSD1306库的扩展,可实现使用UTF8字符编码在相关设备上打印日语字体。通过简单修改,能在原库基础上支持日语字符输出,还提供了一些便于开发者使用的扩展功能。
项目的主要特性和功能
- 支持日语字符输出,可使用
print('STR')
/println('STR')
输出描述日语字符(UTF8)的字符串。 - 具备半角全角转换功能,能将半角英数记号和假名转换为全角字符,可通过
void setHalf2Full(bool enable)
设置。 - 支持自定义字体字符集,修改
fontconvert/chara_list.txt
并运行fontconvert/font_converter.py
,可减少ROM容量或添加未收录字符。 - 易于适配其他设备,
UTF8_Adafruit_SSD1306.h
代码简单,少量修改即可适配。
安装使用步骤
集成到项目
- 用Arduino IDE的库管理器添加本库。
- 将
.ino
文件中的#include <Adafruit_SSD1306.h>
替换为#include <UTF8_Adafruit_SSD1306.h>
。
扩展功能使用
若要使用半角全角转换功能,在代码中调用void setHalf2Full(bool enable)
设置,标准状态下该功能禁用。
自定义字体字符集
- 修改
fontconvert/chara_list.txt
文件,添加或删除所需字符。 - 运行
fontconvert/font_converter.py
脚本,将修改后的字符集集成到项目中。
适配其他设备
- 复制
UTF8_Adafruit_SSD1306.h
文件并另存为新文件名。 - 将文件中的
#include <Adafruit_SSD1306.h>
替换为要应用的设备的头文件。 - 将
class UTF8_Adafruit_SSD1306 : public Adafruit_SSD1306, private UTF8_Write {
中的类名UTF8_Adafruit_SSD1306
和Adafruit_SSD1306
替换为要应用的设备的类名。 - 在构造函数中定义与要应用的设备的构造函数相同参数的构造函数,并在调用要应用的设备的构造函数时调用
UTF8_ExtensionCore_Constructor_Initializer
。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】