2 Star 8 Fork 6

RT-Thread-Mirror / Chinese_font_library

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

Chinese font library

1.简介

Chinese font library用于解决嵌入式开发中需要在LCD上显示中文的问题,该软件包基于FAL软件包的功能实现,通过访问存储在外部spi flash的字库文件,实现汉字的显示。同时提供 utf-8 -> unicode -> gbk 的转换函数接口,以应用于网络数据场景。更多应用场景(例:GSM中文短信等)有待实现。

1.1目录结构

名称 说明
src 源码
inc 头文件
examples 示例

1.2许可证

1.3依赖

  • RT-Thread SUFD组件
  • RT-Thread FAL软件包
  • 存储在外部spi flash的字库文件

2.获取方式

3.使用方式

3.1 标准API

在指定位置显示字符串

void show_str(uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint8_t *str, uint8_t size);
参数 描述
x 字符串起始x坐标
y 字符串起始y坐标
width 字符串所占宽度
height 字符串所占高度
*str 字符串指针
size 字体大小
返回 描述
void

3.2 网络应用场景API(编码转换)

utf-8转unicode

int utf82unicode(char* pInput, char* pOutput)
参数 描述
*pInput utf8字符指针
*pOutput unicode字符指针
返回 描述
int unicode字符大小

unicode转gbk

void unicode2gbk(uint8_t *pInput, uint8_t *pOutput);
参数 描述
*pInput unicode字符指针
*pOutput gbk字符指针
返回 描述
void

4.注意事项

Chinese_font_library基于fal软件包实现,使用之前需要做一些准备工作:

  • 因为要使用fal读外部Flash,所以要对Flash进行移植工作,参考:Flash 设备及分区移植示例
  • 在fal_cfg.h的分区表中为外部Flash划出"font"分区,例:
{FAL_PART_MAGIC_WROD,       "font",    "nor_flash",            (512 + 1024 + 512) * 1024,  7 * 1024 * 1024, 0}
  • 将字库文件烧写进"font"分区。
  • 需要根据你的字库文件结构及位置修改cn_port.c(需要对应你的font分区),我这里使用的是正点原子的字库。
    _font_info ftinfo =
    {
        .ugbkaddr = 0x0000000+sizeof(ftinfo),
        .ugbksize = 174344,
        .f12addr=0x0002A908+sizeof(ftinfo),
        .gbk12size=574560,
        .f16addr = 0x000B6D68+sizeof(ftinfo),
        .gbk16size = 766080,
        .f24addr = 0x00171DE8+sizeof(ftinfo),
        .gbk24size = 1723680,
        .f32addr = 0x00316B08+sizeof(ftinfo),
        .gbk32size = 3064320
    };
  • 使用前需调用fal_init()初始化fal库。

5.联系方式

空文件

简介

用于解决嵌入式开发中需要在LCD上显示中文的问题,该软件包基于FAL软件包的功能实现,通过访问存储在外部spi flash的字库文件,实现汉字的显示。同时提供 utf-8 -> unicode -> gbk 的转换函数接口 展开 收起
C
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
C
1
https://gitee.com/RT-Thread-Mirror/Chinese_font_library.git
git@gitee.com:RT-Thread-Mirror/Chinese_font_library.git
RT-Thread-Mirror
Chinese_font_library
Chinese_font_library
master

搜索帮助