# TTGO-汉字显示

**Repository Path**: l_y_r/ttgo-chinese-character-display

## Basic Information

- **Project Name**: TTGO-汉字显示
- **Description**: 在 esp32 TTGO板子上使用micropython显示汉字
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 2
- **Created**: 2021-12-12
- **Last Updated**: 2024-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TTGO-汉字显示

#### 介绍
在 esp32 TTGO板子上使用micropython显示汉字。  
关于硬件的资料可以前往该链接`https://github.com/Xinyuan-LilyGO/TTGO-T-Display`


#### 目录结构说明
- firmware: 支持汉字显示的micropython固件
- make_font_tool: 
    - cnfont_from_bin.py：py字库转换工具
    - font_bin：4种大小的unicode编码汉字库bin文件
- main.py: 使用字库汉字显示demo  

四种大小的py字库文件样例
- unicn_16x16.py
- unicn_16x16.py
- unicn_16x16.py
- unicn_16x16.py

#### 快速体验

1.  烧录好固件
2.  上传main.py以及四种字库.py文件到板端
3.  重启运行即可看到屏幕显示

#### 生成py字库教程
1.  先选好自已要制作的字体大小以及字型，比如要制作16*16宋体的字库，那么先用字库生成工具生成unicode全汉字的字库bin文件，比如我使用的一个字库工具下载链接`http://www.gaotongfont.cn/font-id-187.html`。当然我已经生成好了4种大小的子库bin文件放在了`make_font_tool/font_bin`目录下。

2.  使用`cnfont_from_bin.py`转换工具把我们需要转换的汉字生成py字库文件。  
命令行使用例子：
`cnfont_from_bin.py unicn_16x16.bin unicn_16x16.py -w 16  -s "你好啊"`  
其中第一个参数就是输入的bin字库文件，第二个参数是输出的py字库文件，-w传入字宽，-s传入要生成字库的汉字文本（重复的汉字只会在字库里生成一次点阵）  
如下图：  
![在这里插入图片描述](https://img-blog.csdnimg.cn/3fafad02ff2b4203aa948e21a27afc2e.png)
3.  生成的unicn_16x16.py文件就是需要的字库了，当然为了压缩该文件体积也可以使用mpy-cross工具把他编译成字节码bin文件。


#### st7789屏幕显示mod的API接口说明
st7789驱动模组来自于该仓库：`https://github.com/russhughes/st7789_mpy.git`  
详细的使用说明也在该仓库的readme文档里了， 我在此模组基础上增加了一个显示汉字的接口：  

`text_ch(font, s, x, y[, fg, bg])`  
使用指定的位图字体将文本写入显示器，坐标为文本的左上角。 文本的前景色和背景色可以通过可选参数 fg 和 bg 设置，否则前景色默认为白色，背景色默认为黑色。用法与`text()`接口一致，只是字符串只能为中文。


运行demo演示结果如图：  
![在这里插入图片描述](https://img-blog.csdnimg.cn/c84e5f80d250409aa3ddf7d4aa5efbe9.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA6Iie5YiA5Lmm55Sf,size_20,color_FFFFFF,t_70,g_se,x_16)

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)