LittleVGL (LVGL)干货入门教程四之制作和使用中文汉字字库

前言:

阅读前，请确保你至少拥有以下条件：

1. 已实现显示API（教程一已实现， 链接：LittleVGL (LVGL)入门教程一之移植到stm32芯片）
2. 已实现输入设备API（教程二已实现，链接：LittleVGL (LVGL)干货入门教程二之LVGL的输入设备（indev）API对接。）
3. 已实现文件系统API（教程三已实现，链接：LittleVGL (LVGL)干货入门教程三之LVGL的文件系统（fs）API对接）

这篇文章会讲

• LVGL字库的制作
• LVGL的字库的各种使用方式（本文重点）

目录：

• LittleVGL (LVGL)干货入门教程四之制作和使用中文汉字字库
• • • 前言:
  • 一、LVGL字库的种类介绍。
  • 二、字库如何制作？
  • 三、如何使用字库？
  • • （一）添加外部或内部字库。
    • • • （1）内部字库
        • （2）外部字库
    • （二）声明制作好的字库。
    • （三）对接字库API。
    • （四）使用字库
    • （五）KEIL MDK中文编译报错
  • 五、启动LVGL
• 本篇完
• 其他：
• 下一篇

字库的原理就不赘述了，百度一大把，主要就是不同编码字库的每个字，都按照不同的方式排列，根据编码可以进行搜索和定位，最后提取字库并用点阵方式显示就行，PC上多用矢量字体（使用顶点和曲线），一般最简单的方法就是使用点阵字体（也是很常用的形式）。

一、LVGL字库的种类介绍。

• 内部大数组（字体体量小时常用，如纯英文字体）
• 外部bin文件（字体体量大时常用，如中文字体）

二、字库如何制作？

事实上，字库的制作有专用的工具，例如LVGL的官网提供在线字库转换工具（没网络就不行了，甚至经常抽风，本人就没有成功过，就不讲了，有兴趣可以自己试试）。
有兴趣的话也可以去LVGL官网了解字体相关的接口。
也有第三方大神制作的离线字库转换工具，并且非常简单实用。

可以去这个作者的网站下载：
LVGL字体转换工具：LvglFontTool
LVGL字体乱码：Lvgl之显示汉字出现乱码

三、如何使用字库？

（一）添加外部或内部字库。

（1）内部字库

直接把生成的C文件添加进项目编译即可，C文件里面包含了字库的查找函数和位图等，和一些LVGL的字库接口，当然不需要你亲自使用，只是为LVGL提供操作接口。

（2）外部字库

当你使用上述的LvglFontTool进行外部字体转换后，会得到两个文件，假如我的字体名为“font”，那么生成的这两个文件名为“font.c”和“font.bin”，C文件提供了字库的查找函数（不需要你使用，只是为LVGL提供操作接口）和使用字库的API（需要自行对接API），bin文件即字库文件。

（二）声明制作好的字库。

当你使用上述工具制作好字库后，会得到字库名，你可以通过三种方法调用这个字库：

第一种：

extern lv_font_t font_name;		

第二种：

LV_FONT_DECLARE(font_name);		

第三种(改lv_conf.h)：
在 lv_conf.h 里找到宏定义 “LV_FONT_CUSTOM_DECLARE”：

#define LV_FONT_CUSTOM_DECLARE LV_FONT_DECLARE( ariblk_12 ) \ LV_FONT_DECLARE( ariblk_14 ) \ LV_FONT_DECLARE( ariblk_16 ) \ LV_FONT_DECLARE( ariblk_36_num ) \ LV_FONT_DECLARE(MSYH_BD_12_CN)

上面的操作仅仅是声明而已。

（三）对接字库API。

使用就基本没什么不同了，下文会统一说怎么使用，但区别在于，外部字库的C文件需要对接一个API，实现提取存储设备字库文件指定偏移内容的功能（例如把字库文件放在SD卡或者SPI Flash里，把里面的内容提取给LVGL使用）。


生成外部字库的C文件后，找到函数 “__user_font_getdata” 和数组 “__g_font_buf” 。

 


static uint8_t __g_font_buf[323];	//如bin文件存在SPI FLASH可使用此buff


static uint8_t *__user_font_getdata(int offset, int size) { 
	

	
	return (uint8_t*)((uint32_t)(SDRAM_FONT_BASE_ADDR + offset)); 

	
	
	sf_of_read(__g_font_buf, offset, size);
	return __g_font_buf;

	
	
	FRESULT fres = FR_NOT_READY;
	FIL file = { 0};
	fres = f_open(&file, font_path, FA_OPEN_EXISTING | FA_READ);
	if (fres != FR_OK)
		goto __out;		// goto常用于错误处理
	fres = f_lseek(&file, offset);		// 寻址
	if (fres != FR_OK)
		goto __out;		
	fres = f_read(&file, __g_font_buf, NULL, NULL);
	if (fres == FR_OK)	// 成功则直接返回
		goto __out;		
	else
		memset(__g_font_buf, 0, sizeof(__g_font_buf));  // 清空数组
		
__out:
	if (file)
		f_close(&file);
    return __g_font_buf;
}

如果你完成了上述的API对接，那么接下来把C文件加入工程编译，并且把bin字库文件烧写到spi flash或者使用文件系统放入文件即可。

（四）使用字库

接下来算是重头戏了，就是如何使用字库，使用方面的话，无论是内部还是外部的字库，操作都是一样的，下面给出例程，例程创建了一个label，并用2种不同方式使用font，并居中显示中文文字：

#include <lvgl.h>
#include "main.h"

#define LVGL_TICK 10


static void lvgl_font_test(uint8_t method)
{ 
	static lv_style_t label_style ={  0 };	// style 必须要为static
    lv_obj_t* label1 = NULL;

    label1 = lv_label_create(lv_scr_act(), NULL);
    lv_label_set_recolor(label1, true);
    lv_label_set_text(label1, (LV_SYMBOL_HOME "你好 #ff0000 Trisuborn"));
    lv_obj_align(label1, NULL, LV_ALIGN_CENTER, 0, 0);

    LV_FONT_DECLARE(font_name);	// 声明过了就不用
    if ( method ) { 
        lv_style_set_text_font(&label_style, LV_STATE_DEFAULT, &font_name);
        lv_obj_add_style(label1, LV_LABEL_PART_MAIN, &label_style);
    } else { 
        lv_obj_set_style_local_text_font(
            label1,
            LV_LABEL_PART_MAIN,
            LV_STATE_DEFAULT,
            &font_name
        );
    }
}


static void lvgl_font_test2(void)
{ 
	lv_font_t * my_font;
	my_font = lv_font_load(X/path/to/my_font.bin);

	
	lv_obj_t* label2 = lv_label_create(lv_scr_act(), NULL);
    lv_label_set_text(label2, (LV_SYMBOL_HOME "你好 世界"));
    lv_obj_align(label2, NULL, LV_ALIGN_IN_BOTTOM_MID, 0, 0);

	
	lv_font_free(my_font);
}


static void lvgl_init( void ) 
{ 
    lv_init();
    lv_port_disp_init();        // 显示器初始化
    lv_port_indev_init();       // 输入设备初始化
    lv_port_fs_init();          // 文件系统设备初始化
}


int main(void)
{ 
	lvgl_init();
	
	lvgl_font_test(1);
	// lvgl_font_test(0);
	
	// lvgl_font_test2();
	
	while(1) { 
		lv_tick_inc(LVGL_TICK);
		lv_task_handler();
		delay_ms(LVGL_TICK);
	}
}

（五）KEIL MDK中文编译报错

编译时，打开Option for target，打开C/C++选项卡，在 “Misc Controls”一栏填入 “–locale=english” 。

五、启动LVGL

参考我的第一篇文章即可：
LittleVGL (LVGL)干货入门教程一之移植到stm32芯片

本篇完

其他：

LittleVGL (LVGL)干货入门教程一之移植到stm32芯片

LittleVGL (LVGL)干货入门教程二之LVGL的输入设备（indev）API对接。

LittleVGL (LVGL)干货入门教程三之LVGL的文件系统（fs）API对接

个人Github页：https://github.com/Trisuborn

下一篇

待续。。。