【LVGL-字库应用】

  • 开发
  • 37

LVGL-中文字库应用

■ LVGL-内部字库

LVGL 提供了一套内置的字库，这些字库在移植的时候已经被添加到工程当中， 我们打开Middlewares/lvgl/src/font 分组， 即可找到这些字库文件。

■ LVGL 内部字库的使用流程：

步骤一. 打开 lv_conf.h 文件， 将所需要使用的内部字库使能
在这里插入图片描述
步骤二. 调用字库
使能了内部字库之后，用户就可以直接在字体设置函数中调用相应的字库了，
字号越大，文字越大，但其占用的内存也越多。

void lv_mainstart(void)
{
	lv_obj_t* label = lv_label_create(lv_scr_act());
	lv_obj_set_style_text_font(label,&lv_font_montserrat_16,LV_STATE_DEFAULT); //设置了 16 号字体
	lv_label_set_text(label,"Hello Word!!!!");
}

■ LVGL-自定义字库

■ 方法一：C 语言数组（内部读取）-在线转换工具

LVGL 官方的在线字体转换工具（网址： https://lvgl.io/tools/fontconverter） ， 将字库文件（例如 TTF） 转换成 C 语言数组字体文件， 然后将其添加到工程中， 声明字体后即可调用。
在这里插入图片描述

使用在线转换工具生成字体需要七步：
① 在“Name”选项中填入字体名称。 注意： 该名称在声明字体的时候需要用到，请不要
使用中文名称；
② 在“Size”选项中填入字体的尺寸，这里是以像素为单位的；
③ 在“Bpp”选项中选择像素深度， 注意： 该值越大，则抗锯齿效果越好，但是对内存的
占用也会越高，一般的工程选择 4bbp 即可；
④ 选择字体文件，例如 ttf、 otf 格式的文件；
⑤ 在“Range”选项中填入文字编码范围， 以确定字体的转换范围。基本汉字的编码范围
是 0x4E00-0x9FA5， 数字、拉丁字母、标点符号的编码范围是 0x20-0x7E，这两个范围内已经
涵盖了两万多个字符， 可以满足绝大部分的使用场景。 关于文字的编码，大家感兴趣的话可以
在网上了解一下。 注意： 转换的范围越大，字库所占用的内存就越高， 在该选项中，建议大家
只填 0x20-0x7E。
⑥ 在“Symbols”选项中直接填入需要转换的文字。我们一般会将需要转换的汉字填入该
选项；
⑦ 点击“Convert”，即可生成字体文件（后缀为.c） 。

代码调用字体

LV_FONT_DECLARE(my_Font14) /* 声明字体 */
void lv_mainstart(void)
{
	lv_obj_t *font_label = lv_label_create(lv_scr_act());
	lv_obj_set_style_text_font(font_label, &my_Font14, LV_STATE_DEFAULT);
	lv_label_set_text(font_label, "你好");
	lv_obj_center(font_label);
}

■ 方法二：C 语言数组（内部读取）-利用离线字体转换软件（V0.5 版本）

利用离线字体转换软件（V0.5 版本） ， 将中文字库转化为 C 语言数组文件。
【阿里】 ， 其开发的离线转换软件可以帮助用户轻松地生成 LVGL字库， 大家可以在他的博客网址（http://dz.lfly.xyz/forum.php） 中下载字体转换软件.

使用方法：

  1. 打开 LvglFontTool V0.5 软件,点击“选择字体”
    在这里插入图片描述
  2. 在弹窗中选择所需字体
    在这里插入图片描述
  3. 加入常用汉字
    在这里插入图片描述
  4. 选择 LVGL 版本、 字体类型，设置字体名称，

在这里插入图片描述

  1. 点击“开始转换” 将会得到一个.c 文件。
  2. 参照方法一添加到工程中。

■ 方法三：C 语言数组（内部读取）-离线字体转换软件（V0.4 版本） ，

利用离线字体转换软件（V0.4 版本） ， 将中文字库转化为 C 语言数组文件。 与方法二不同的是，我们此处使用的是自选的 TTF 字体文件（V0.4 版本软件支持该功能） ， 具体的使用
方法如下

  1. 打开 LvglFontTool V0.4 软件点击“选择字体”
    在这里插入图片描述
  2. 在弹窗中选择所需的 TTF 字体， 设置字体大小，
    在这里插入图片描述
  3. 添加常用的汉字
    4.
  4. 选择 LVGL 版本、字体类型，设置字体名称，
    在这里插入图片描述
  5. 点击“开始转换”， 等待转换完成后， 点击“保存” 即可得到一个.c 文件。
  6. 添加到工程中去。

■ 方法三：文件系统读取字库（外部读取）- 【阿里】的离线字体转换软件（V0.5 版本）

  1. 打开 LvglFontTool V0.5 软件点击“选择字体”，
    在这里插入图片描述
  2. 选择所需字体
    在这里插入图片描述
  3. 加入常用汉字

在这里插入图片描述

  1. 选择版本、类型（XBF，外部 bin 文件），设置字体名称
    在这里插入图片描述

  2. 点击“开始转换”在弹窗中选择文件路径并点击“保存”。等待转换完成， 将会得到两个文件，它们的后缀分别为.c 和.bin。
    我们把.c 文件添加到工程中，而.bin 文件则放到 SD 卡里面（建议路径： 根目录→SYSTEM→LVFONT） 。

  3. 打 开 工 程 ， 找 到 上 一 步 添 加 的 字 体 文 件 （ 例 如 示 例 中 的 Font12.c ） ， 修 改__user_font_getdata 函数， 如下源码所示：

static uint8_t *__user_font_getdata(int offset, int size){
	/* 如字模保存在 SPI FLASH, SPIFLASH_Read(__g_font_buf,offset,size);
	如字模已加载到 SDRAM,直接返回偏移地址即可如:return (uint8_t*)(sdram_fontddr+offset); */
	norflash_ex_read(__g_font_buf,ftinfo.lvgl_12addr +offset,size);
	return __g_font_buf;
}

注意： 上述源码是以 Mini Pro H750 开发板为例的， 其他的开发板用户请根据实际的开发板例程来修改

  1. 添加汉字显示相关的 TEXT 文件
    在这里插入图片描述
  2. 修改 fonts.h 文件
/* 字体信息保存首地址
* 占 41 个字节,第 1 个字节用于标记字库是否存在.后续每 8 个字节一组,分别保存起始地址和文件大小
*/
extern uint32_t FONTINFOADDR;
/* 字库信息结构体定义
* 用来保存字库基本信息，地址，大小等
*/
typedef __PACKED_STRUCT
{
	uint8_t fontok; /* 字库存在标志， 0XAA，字库正常；其他，字库不存在 */
	uint32_t ugbkaddr; /* unigbk 的地址 */
	uint32_t ugbksize; /* unigbk 的大小 */
	uint32_t f12addr; /* gbk12 地址 */
	uint32_t gbk12size; /* gbk12 的大小 */
	uint32_t f16addr; /* gbk16 地址 */
	uint32_t gbk16size; /* gbk16 的大小 */
	uint32_t f24addr; /* gbk24 地址 */
	uint32_t gbk24size; /* gbk24 的大小 */
	uint32_t f32addr; /* gbk32 地址 */
	uint32_t gbk32size; /* gbk32 的大小 */
	uint32_t lvgl_12addr; /* LVGL12 地址 */
	uint32_t lvgl_12size; /* LVGL12 的大小 */
	uint32_t lvgl_24addr; /* LVGL24 地址 */
	uint32_t lvgl_24size; /* LVGL24 的大小 */
	uint32_t lvgl_36addr; /* LVGL36 地址 */
	uint32_t lvgl_36size; /* LVGL36 的大小 */
} _font_info;
  1. 修改 fonts.c 文件中的 FONT_GBK_PATH 和 FONT_UPDATE_REMIND_TBL 数组， 如下源码所示：
/* 字库存放在磁盘中的路径 */
char *const FONT_GBK_PATH[8] =
{
	"/SYSTEM/FONT/UNIGBK.BIN", /* UNIGBK.BIN 的存放位置 */
	"/SYSTEM/FONT/GBK12.FON", /* GBK12 的存放位置 */
	"/SYSTEM/FONT/GBK16.FON", /* GBK16 的存放位置 */
	"/SYSTEM/FONT/GBK24.FON", /* GBK24 的存放位置 */
	"/SYSTEM/FONT/GBK32.FON", /* GBK32 的存放位置 */
	"/SYSTEM/LVFONT/Font12.BIN", /* Font12 的存放位置 */
	"/SYSTEM/LVFONT/Font24.BIN", /* Font24 的存放位置 */
	"/SYSTEM/LVFONT/Font36.BIN", /* Font36 的存放位置 */
};
/* 更新时的提示信息 */
char *const FONT_UPDATE_REMIND_TBL[8] =
{
	"Updating UNIGBK.BIN", /* 提示正在更新 UNIGBK.bin */
	"Updating GBK12.FON ", /* 提示正在更新 GBK12 */
	"Updating GBK16.FON ", /* 提示正在更新 GBK16 */
	"Updating GBK24.FON ", /* 提示正在更新 GBK24 */
	"Updating GBK32.FON ", /* 提示正在更新 GBK32 */
	"Updating Font12.BIN", /* 提示正在更新 Font12 */
	"Updating Font24.BIN", /* 提示正在更新 Font24 */
	"Updating Font36.BIN", /* 提示正在更新 Font36 */
};
  1. 修改 fonts.c 文件中的 fonts_update_fontx 函数
/**
* @brief 更新某一个字库
* @param x, y : 提示信息的显示地址
* @param size : 提示信息字体大小
* @param fpath : 字体路径
* @param fx : 更新的内容
* @arg 0, ungbk;
* @Arg 1, gbk12;
* @arg 2, gbk16;
* @arg 3, gbk24;
* @arg 4, gbk32;
* @param color : 字体颜色
* @retval 0, 成功; 其他, 错误代码;
*/
static uint8_t fonts_update_fontx( uint16_t x,
			uint16_t y,
			uint8_t size,
			uint8_t *fpath,
			uint8_t fx,
			uint16_t color)
{
	uint32_t flashaddr = 0;
	FIL *fftemp;
	uint8_t *tempbuf;
	uint8_t res;
	uint16_t bread;
	uint32_t offx = 0;
	uint8_t rval = 0;
	fftemp = (FIL *)mymalloc(SRAMIN, sizeof(FIL)); /* 分配内存 */
	if (fftemp == NULL)rval = 1;
	tempbuf = mymalloc(SRAMIN, 4096); /* 分配 4096 个字节空间 */
	if (tempbuf == NULL)rval = 1;
	res = f_open(fftemp, (const TCHAR *)fpath, FA_READ);
if (res)rval = 2; /* 打开文件失败 */
if (rval == 0)
{
switch (fx)
{
case 0: /* 更新 UNIGBK.BIN */
/* 信息头之后，紧跟 UNIGBK 转换码表 */
ftinfo.ugbkaddr = FONTINFOADDR + sizeof(ftinfo);
ftinfo.ugbksize = fftemp->obj.objsize; /* UNIGBK 大小 */
flashaddr = ftinfo.ugbkaddr;
break;
case 1: /* 更新 GBK12.BIN */
/* UNIGBK 之后，紧跟 GBK12 字库 */
ftinfo.f12addr = ftinfo.ugbkaddr + ftinfo.ugbksize;
ftinfo.gbk12size = fftemp->obj.objsize; /* GBK12 字库大小 */
flashaddr = ftinfo.f12addr; /* GBK12 的起始地址 */
break;
case 2: /* 更新 GBK16.BIN */
/* GBK12 之后，紧跟 GBK16 字库 */
ftinfo.f16addr = ftinfo.f12addr + ftinfo.gbk12size;
ftinfo.gbk16size = fftemp->obj.objsize; /* GBK16 字库大小 */
flashaddr = ftinfo.f16addr; /* GBK16 的起始地址 */
break;
case 3: /* 更新 GBK24.BIN */
/* GBK16 之后，紧跟 GBK24 字库 */
ftinfo.f24addr = ftinfo.f16addr + ftinfo.gbk16size;
ftinfo.gbk24size = fftemp->obj.objsize; /* GBK24 字库大小 */
flashaddr = ftinfo.f24addr; /* GBK24 的起始地址 */
break;
case 4: /* 更新 GBK32.BIN */
/* GBK24 之后，紧跟 GBK32 字库 */
ftinfo.f32addr = ftinfo.f24addr + ftinfo.gbk24size;
ftinfo.gbk32size = fftemp->obj.objsize; /* GBK32 字库大小 */
flashaddr = ftinfo.f32addr; /* GBK32 的起始地址 */
break;
case 5:/* 更新 LVGL12.BIN */ (1)
ftinfo.lvgl_12addr=ftinfo.f32addr+ftinfo.gbk32size;
ftinfo.lvgl_12size=fftemp->obj.objsize;
flashaddr=ftinfo.lvgl_12addr;
break;
case 6:/* 更新 LVGL24.BIN */ (2)
ftinfo.lvgl_24addr=ftinfo.lvgl_12addr+ftinfo.lvgl_12size;
ftinfo.lvgl_24size=fftemp->obj.objsize;
flashaddr=ftinfo.lvgl_24addr;
break;
case 7:/* 更新 LVGL36.BIN */ (3)
ftinfo.lvgl_36addr=ftinfo.lvgl_24addr+ftinfo.lvgl_24size;
ftinfo.lvgl_36size=fftemp->obj.objsize;
flashaddr=ftinfo.lvgl_36addr;
break;
}
while (res == FR_OK) /* 死循环执行 */
{
res = f_read(fftemp, tempbuf, 4096, (UINT *)&bread); /* 读取数据 */
if (res != FR_OK)break; /* 执行错误 */
/* 从 0 开始写入 bread 个数据 */
norflash_ex_write(tempbuf, offx + flashaddr, bread);
offx += bread;
/* 进度显示 */
fonts_progress_show(x, y, size, fftemp->obj.objsize, offx, color);
if (bread != 4096)break; /* 读完了. */
}
f_close(fftemp);
}
myfree(SRAMIN, fftemp); /* 释放内存 */
myfree(SRAMIN, tempbuf); /* 释放内存 */
return res;
}
  1. 修改 fonts.c 文件中的 fonts_update_font 函数，
/**
* @brief 更新字体文件
* @note 所有字库一起更新(UNIGBK,GBK12,GBK16,GBK24,GBK32)
* @param x, y : 提示信息的显示地址
* @param size : 提示信息字体大小
* @param src : 字库来源磁盘
* @arg "0:", SD 卡;
* @Arg "1:", FLASH 盘
* @arg "2:", U 盘
* @param color : 字体颜色
* @retval 0, 成功; 其他, 错误代码;
*/
uint8_t fonts_update_font( uint16_t x,
	uint16_t y,
	uint8_t size,
	uint8_t *src,
	uint16_t color)
	{
	uint8_t *pname;
	uint32_t *buf;
	uint8_t res = 0;
	uint16_t i, j;
	FIL *fftemp;
	uint8_t rval = 0;
	res = 0XFF;
	ftinfo.fontok = 0XFF;
	pname = mymalloc(SRAMIN, 100); /* 申请 100 字节内存 */
	buf = mymalloc(SRAMIN, 4096); /* 申请 4K 字节内存 */
	fftemp = (FIL *)mymalloc(SRAMIN, sizeof(FIL)); /* 分配内存 */
	if (buf == NULL || pname == NULL || fftemp == NULL)
	{
		myfree(SRAMIN, fftemp);
		myfree(SRAMIN, pname);
		myfree(SRAMIN, buf);
		return 5; /* 内存申请失败 */
	}
	/* 先查找文件 UNIGBK,GBK12,GBK16,GBK24,GBK32,
	LVGL12.BIN,LVGL24.BIN,LVGL36BIN 是否正常 */
	for (i = 0; i < 8; i++) (1)
	{
		strcpy((char *)pname, (char *)src); /* copy src 内容到 pname */
		strcat((char *)pname, (char *)FONT_GBK_PATH[i]); /* 追加具体文件路径 */
		res = f_open(fftemp, (const TCHAR *)pname, FA_READ);/* 尝试打开 */
		if (res)
		{
			rval |= 1 << 7; /* 标记打开文件失败 */
			break; /* 出错了,直接退出 */
		}
	}
	myfree(SRAMIN, fftemp); /* 释放内存 */
	if (rval == 0) /* 字库文件都存在. */
	{
		/* 提示正在擦除扇区 */
		lcd_show_string(x, y, 240, 320, size, "Erasing sectors... ", color);
		for (i = 0; i < FONTSECSIZE; i++) /* 先擦除字库区域,提高写入速度 */
		{
			/* 进度显示 */
			fonts_progress_show(x + 20 * size / 2, y, size, FONTSECSIZE,
			i, color);
			/* 读出整个扇区的内容 */
			norflash_ex_read((uint8_t *)buf, ((FONTINFOADDR /
			4096)+i) * 4096, 4096);
			for (j = 0; j < 1024; j++) /* 校验数据 */
			{
				if (buf[j] != 0XFFFFFFFF)break; /* 需要擦除 */
			}
			if (j != 1024)
			{
			/* 需要擦除的扇区 */
			norflash_ex_erase_sector((FONTINFOADDR / 4096) + i);
			}
		}
		/* 依次更新 UNIGBK,GBK12,GBK16,GBK24,GBK32,
		LVGL12.BIN,LVGL24.BIN,LVGL36BIN */
		for (i = 0; i < 8; i++)
		{
			lcd_show_string(x, y, 240, 320, size,
			FONT_UPDATE_REMIND_TBL[i], color);
			strcpy((char *)pname, (char *)src);
			strcat((char *)pname, (char *)FONT_GBK_PATH[i]);
			res = fonts_update_fontx(x + 20 * size / 2, y, size,
			pname, i, color);
			if (res)
			{
				myfree(SRAMIN, buf);
				myfree(SRAMIN, pname);
				return 1 + i;
			}
		}
		/* 全部更新好了 */
		ftinfo.fontok = 0XAA;
		/* 保存字库信息 */
		norflash_ex_write((uint8_t *)&ftinfo, FONTINFOADDR, sizeof(ftinfo));
	}
	myfree(SRAMIN, pname); /* 释放内存 */
	myfree(SRAMIN, buf);
	return rval; /* 无错误. */
}
  1. 打开 lv_conf.h 文件，找到 LV_FONT_CUSTOM_DECLARE 配置项， 声明该字体， 如下源码所示：
#define LV_FONT_CUSTOM_DECLARE LV_FONT_DECLARE(Font12)
  1. 编写示例代码：
void lv_mainstart(void)
{
	lv_obj_t* label = lv_label_create(lv_scr_act());
	lv_obj_set_style_text_font(label,& Font12,LV_STATE_DEFAULT);
	lv_label_set_text(label,"Hello ALIENTEK!!!!");
}

在这里插入图片描述

■ LVGL-中文字库应用

在这里插入图片描述

■ 可从window中选择字库文件

在这里插入图片描述

■ LVGL在线字体转换网页-在线字体转换配置

lvgl在线字体转换网页
在这里插入图片描述
在这里插入图片描述

■ 将生成的字体文件添加到工程中来。

在这里插入图片描述

■ 测试代码

在这里插入图片描述

在这里插入图片描述
在这里插入图片描述

■ 综合示例：

在这里插入图片描述
在这里插入图片描述

阅读全部

相关推荐

  2. <span style='color:red;'>LVGL</span>：

    LVGL：

    2024-03-29 21:50:03      28 阅读

  9. 轻松应用字典树

    2024-03-29 21:50:03       69 阅读

最近更新

  3. docker php8.1+nginx base 镜像 dockerfile 配置

    2024-03-29 21:50:03       98 阅读

  4. Could not load dynamic library ‘cudart64_100.dll‘

    2024-03-29 21:50:03       106 阅读

  9. 在Django里面运行非项目文件

    2024-03-29 21:50:03       87 阅读

  19. Python语言-面向对象

    2024-03-29 21:50:03       96 阅读

  20. 如何分清楚常见的 Git 分支管理策略Git Flow、GitHub Flow 和 GitLab Flow

    2024-03-29 21:50:03       91 阅读

热门阅读

  1. 服务器硬件基础知识

    2024-03-29 21:50:03       42 阅读

  3. blog-engine-10-middleman 静态站点生成器，利用了现代 Web 开发中的所有快捷方式和工具

    2024-03-29 21:50:03       42 阅读

  5. 牛客的一道题（C）序列中删除指定数字

    2024-03-29 21:50:03       44 阅读

  15. 【独立开发前线】Vol.24 独立开发者应该怎样看技术能力

    2024-03-29 21:50:03       43 阅读

  17. 数据关联_3.7

    2024-03-29 21:50:03       39 阅读

  18. 基于Python的高考志愿辅助填报系统

    2024-03-29 21:50:03       41 阅读
  19. Spring

    Spring

    2024-03-29 21:50:03      45 阅读

  22. vue父组件值变化，子组件不刷新的问题（三种方案）

    2024-03-29 21:50:03       40 阅读

  23. dockerfile编写

    2024-03-29 21:50:03       36 阅读

  24. 008_function_convention_in_Matlab中的函数约定

    2024-03-29 21:50:03       33 阅读

  26. linux三剑客之grep

    2024-03-29 21:50:03       48 阅读