LuatOS之LVGL字体篇

最新推荐文章于 2024-06-10 09:41:05 发布
最新推荐文章于 2024-06-10 09:41:05 发布
阅读量5.2k 收藏 22
点赞数 3
分类专栏： LuatOS-Soc 文章标签： 物联网 单片机
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_29536545/article/details/119916577
版权

前言

之前展示过Luatos在win32上运行LVGL的效果，今天带来LVGL的字体篇

介绍

LVGL字体支持很全，支持 UTF-8 编码的 Unicode 字符，分内部字体和外部字体，字体制作工具也很多：LVGL官方的字体制作工具，第三方的LvglFontTool和MCU_Font等。本文会介绍不同字体制作方法时分别使用不同工具使大家对其都有了解。

内部字体

LVGL的内部字体分为 LVGL自带字体和自己制作的自定义内部字体。

内部自支持字体

LVGL的内部就已经支持多种字体大小，可通过 LV_FONT_… 定义在 lv_conf.h 中启用即可

/* Montserrat fonts with bpp = 4
 * https://fonts.google.com/specimen/Montserrat  */
#define LV_FONT_MONTSERRAT_8     0
#define LV_FONT_MONTSERRAT_10    0
#define LV_FONT_MONTSERRAT_12    0
#define LV_FONT_MONTSERRAT_14    1
#define LV_FONT_MONTSERRAT_16    0
#define LV_FONT_MONTSERRAT_18    0
#define LV_FONT_MONTSERRAT_20    0
#define LV_FONT_MONTSERRAT_22    0
#define LV_FONT_MONTSERRAT_24    0
#define LV_FONT_MONTSERRAT_26    0
#define LV_FONT_MONTSERRAT_28    0
#define LV_FONT_MONTSERRAT_30    0
#define LV_FONT_MONTSERRAT_32    0
#define LV_FONT_MONTSERRAT_34    0
#define LV_FONT_MONTSERRAT_36    0
#define LV_FONT_MONTSERRAT_38    0
#define LV_FONT_MONTSERRAT_40    0
#define LV_FONT_MONTSERRAT_42    0
#define LV_FONT_MONTSERRAT_44    0
#define LV_FONT_MONTSERRAT_46    0
#define LV_FONT_MONTSERRAT_48    0

/* Demonstrate special features */
#define LV_FONT_MONTSERRAT_12_SUBPX      0
#define LV_FONT_MONTSERRAT_28_COMPRESSED 0  /*bpp = 3*/
#define LV_FONT_DEJAVU_16_PERSIAN_HEBREW 0  /*Hebrew, Arabic, PErisan letters and all their forms*/
#define LV_FONT_SIMSUN_16_CJK            0  /*1000 most common CJK radicals*/

/*Pixel perfect monospace font
 * http://pelulamu.net/unscii/ */
#define LV_FONT_UNSCII_8     0
#define LV_FONT_UNSCII_16     0

同时支持多国语言：希伯来语、阿拉伯语、波斯语字母及其所有形式，并且支持中文，但是实际上中文的支持是使用1000多个最常见的部首组成的，实际测试会发现很多汉字都没有~

内部自定义字体

当你要使用一些好看的字体，或者中文等LVGL没有集成的字体怎么办呢？当然可以自己制作字库，首先介绍的是使用LvglFontTool制作内部字体，打开LvglFontTool

image.png

抗锯齿选择默认，我们的lvgl是7.11版本，所以此处版本选择用于6.0版本以上，英文和数字根据自己需要勾选，类型选择内部字体，剩下都勾选上即可，字体名自己设置，包含里加上lvgl.h头文件，之后我们点击选择字体

image.png

字体我们选择我们的ttf字体，选择字体大小，点击确定
之后写入需要的汉字或者根据自己需要点击加入常用汉字、全部汉字、图标

image.png
之后点击保存，开始转换
image.png
稍作等待
image.png
之后将生成的.c文件放在LuatOS\components\lvgl\font目录下，在luat_lvgl_fonts.h中声明你的字库

#ifndef LUAT_LIB_FONTS_H
#define LUAT_LIB_FONTS_H

#include "luat_base.h"

#ifdef __cplusplus
extern "C" {
#endif
#include "../src/lv_font/lv_font.h"

LV_FONT_DECLARE(lv_font_opposans_m_8)
LV_FONT_DECLARE(lv_font_opposans_m_10)
LV_FONT_DECLARE(lv_font_opposans_m_12)
LV_FONT_DECLARE(lv_font_opposans_m_14)
LV_FONT_DECLARE(lv_font_opposans_m_16)
LV_FONT_DECLARE(lv_font_opposans_m_18)
LV_FONT_DECLARE(lv_font_opposans_m_20)
LV_FONT_DECLARE(lv_font_opposans_m_22)
LV_FONT_DECLARE(lv_font_simsun_48)

#ifdef __cplusplus
}
#endif
#endif

之后在luat_lib_lvgl_font.c中对lua暴露你的字库就可以了

/*
获取内置字体
@api lvgl.font_get(name)
@string 字体名称+字号, 例如 opposans_m_10 simsun_48
@return userdata 字体指针
@usage

local font = lvgl.font_get("simsun_48")
*/
int luat_lv_font_get(lua_State *L) {
    lv_font_t* font = NULL;
    const char* fontname = luaL_checkstring(L, 1);
    if (!strcmp("", fontname)) {
    }
#ifdef LV_FONT_MONTSERRAT_14
    else if (!strcmp("montserrat_14", fontname)) { font = &lv_font_montserrat_14;}
#endif
#ifdef LV_FONT_OPPOSANS_M_8
    else if (!strcmp("opposans_m_8", fontname)) { font = &lv_font_opposans_m_8;}
#endif
#ifdef LV_FONT_OPPOSANS_M_10
    else if (!strcmp("opposans_m_10", fontname)) { font = &lv_font_opposans_m_10;}
#endif
#ifdef LV_FONT_OPPOSANS_M_12
    else if (!strcmp("opposans_m_12", fontname)) { font = &lv_font_opposans_m_12;}
#endif
#ifdef LV_FONT_OPPOSANS_M_14
    else if (!strcmp("opposans_m_14", fontname)) { font = &lv_font_opposans_m_14;}
#endif
#ifdef LV_FONT_OPPOSANS_M_16
    else if (!strcmp("opposans_m_16", fontname)) { font = &lv_font_opposans_m_16;}
#endif
#ifdef LV_FONT_OPPOSANS_M_18
    else if (!strcmp("opposans_m_18", fontname)) { font = &lv_font_opposans_m_18;}
#endif
#ifdef LV_FONT_OPPOSANS_M_20
    else if (!strcmp("opposans_m_20", fontname)) { font = &lv_font_opposans_m_20;}
#endif
#ifdef LV_FONT_OPPOSANS_M_22
    else if (!strcmp("opposans_m_22", fontname)) { font = &lv_font_opposans_m_22;}
#endif
#ifdef USE_LVGL_SIMSUN_48
    else if (!strcmp("simsun_48", fontname)) { font = &lv_font_simsun_48;}
#endif

    if (font) {
        lua_pushlightuserdata(L, font);
        return 1;
    }
    return 0;
}

注意：编译时别忘了在luat_conf_bsp.h中启用lvgl和字库呦~

外部字体

LVGL同时支持外部字体，你可以将.bin格式字体放在flash中或sd中，在程序运行中加载字体，这种方式无需修改固件

这里我们用离线版LVGL官方工具生成外部字体

首先安装nodejs这里不做介绍，下载安装即可

打开cmd运行

npm i lv_font_conv -g

即可安装好lv_font_conv

我们cmd运行lv_font_conv测试

image.png

证明lv_font_conv 已正常运行

下面我们了解一下lv_font_conv命令：

常用命令：

  • --bpp - 每像素位数（抗锯齿）
  • --size - 输出字体大小（像素）
  • -o, --output- 输出路径（文件或目录，取决于格式）
  • --format - 输出格式
    • --format dump - 转储字形图像和字体信息，用于调试
    • --format bin- 以二进制形式转储字体（如规范中所述）
    • --format lvgl- 以LittlevGL格式转储字体
  • --force-fast-kern-format- 始终使用更快速的 kering 存储格式，但要付出一定的代价。如果出现尺寸差异，则会显示出来
  • --lcd - 生成具有 3 倍水平分辨率的位图，用于子像素平滑
  • --lcd-v - 生成具有 3 倍垂直分辨率的位图，用于子像素平滑
  • --use-color-info- 尝试使用字体中的字形颜色信息来创建灰度图标。由于灰色色调是通过透明度模拟的，因此仅在对比背景上效果会很好
  • --lv-include- 仅与--format lvgl，为 设置备用路径lvgl.h

字体命令：

  • --font- 字体文件的路径（ttf/woff/woff2/otf）。可多次用于合并
  • -r, --range- 单个字形或范围 + 可选映射，属于先前声明的--font. 可以多次使用。例子：
    • -r 0x1F450 - 单值、十进制或十六进制格式
    • -r 0x1F450-0x1F470 - 范围
    • -r '0x1F450=>0xF005' - 带有映射的单个字形
    • -r '0x1F450-0x1F470=>0xF005' - 带映射的范围
    • -r 0x1F450 -r 0x1F451-0x1F470 - 2个范围
    • -r 0x1F450,0x1F451-0x1F470- 同上，但定义为 single -r
  • --symbols- 要复制的字符列表（而不是 中的数字格式-r）
    • --symbols 0123456789., - 提取字符以显示数字
  • --autohint-off - 不要强制自动提示（默认情况下“灯”是打开的）
  • --autohint-strong - 使用更强大的自动提示（会破坏字距调整）

其他调试选项：

  • --no-compress - 禁用内置 RLE 压缩
  • --no-prefilter - 禁用位图线过滤器（XOR），用于提高压缩率
  • --no-kerning - 删除字距调整信息以减小大小（不推荐）
  • --full-info - 不要缩短“font_info.json”（包括像素数据）

我们输入以下命令即可生成我们想要的.bin外部字库了

lv_font_conv --no-compress --format bin --font H:\OPPOSans-M.ttf -o H:\myfontd\opposans_m_8.bin --bpp 4 --size 8 -r 0x30-0x39 -r 0x41-0x5A -r 0x61-0x7A -r 0x4E00-0x9FFF

不想自己做？好的，我已经做好一些放在LuatOS\docs\markdown\exts\lvgl\fonts目录下了呦~

image.png

字体使用

字体使用非常简单，使用lvgl.obj_set_style_local_text_font设置字体即可，外部字体文件需要使用lvgl.font_load函数加载，下面看一下范例：

注意：使用后记得释放字体

内部字体：

	local screen_label = lvgl.label_create(nil, nil)
	lvgl.label_set_text(screen_label, "中文测试abcdABCD1234")
	local style_screen_label_main = lvgl.style_create()
	lvgl.style_set_text_font(style_screen_label_main, lvgl.STATE_DEFAULT, lvgl.font_get("opposans_m_12"))
	lvgl.obj_add_style(screen_label, lvgl.LABEL_PART_MAIN, style_screen_label4_main)
    lvgl.scr_load(screen_label)

效果：

image.png

外部字体：

	local screen_label = lvgl.label_create(nil, nil)
	lvgl.label_set_text(screen_label, "这是一个中文字体测试程序abcdABCD1234")
    local font = lvgl.font_load("/OPPOSans.bin")
    lvgl.obj_set_style_local_text_font(screen_label, lvgl.LABEL_PART_MAIN, lvgl.STATE_DEFAULT, font)
    lvgl.scr_load(screen_label)

效果：

image.png

字体

本文使用的字体是OPPO的OPPO Sans字体，（含中文及西文，6 款字重）允许个人或企业免费使用，含商业用途，版权归 OPPO 广东移动通信有限公司所有。

您应遵守以下条款，违者必究：

  1. 不对字体进行改编或二次开发；

  2. 不对外售卖字体；

  3. 不向他方提供其他下载渠道；

  4. 不用于违法用途。

相关连接

luatos仓库

bsp-win32

lvgl官网

lvgl仓库

Dozingfiretruck
关注
  • 3
    点赞
  • 踩
  • 22
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
专栏目录
lvgl v9.1版本通过LvglFontTool V0.5工具生成内部字体使用
weixin_43972123的博客
05-07 1049
lvglFontTool v0.5版本生成内部字体 适配 lvgl v9.1版本
LvglFontTool
08-30
LvglFontTool
推荐开源项目：lv_font_conv - 嵌入式系统高效字体转换器
最新发布
gitblog_00023的博客
06-10 301
推荐开源项目：lv_font_conv - 嵌入式系统高效字体转换器 项目地址:https://gitcode.com/lvgl/lv_font_conv 在嵌入式开发领域，我们常常需要处理有限的内存资源和CPU性能。为了优化这一问题，lv_font_conv 应运而生，这是一个强大的工具，能够将 TTF/WOFF/OTF 字体转换为紧凑的位图格式，非常适合小型嵌入式系统使用。 项目介绍 lv_f...
【LVGL 学习】加入内部字体
一名嵌入式界的小学生
10-25 1732
使用到的软件 LvglFontTool.exe 字符转换工具 软件界面 按照软件界面配置 1. 打开lvgl源码中，lv_conf.h 文件，测试例程使用V7.7.0版本 在420行加入以下代码 #define LV_FONT_CUSTOM_DECLARE LV_FONT_DECLARE(myFont) // LV_FONT_DECLARE(myFont) “myFont” 是对应软件界面中，请输入的字体名字一栏中的名称 在481行加入以下代码 #define LV_THEME_DEFAULT
lv_font_conv:将TTFWOFF字体转换为紧凑的位图格式
05-01
lv_font_conv-字体转换器转换为紧凑位图格式 将TTF / WOFF / OTF字体转换为，适用于小型嵌入式系统。 主要特点是： 允许双色调和抗锯齿字形（每个像素1-4位）。 保留字距调整信息。 压缩。 用户只能选择所需的字形（子集）。 可以合并多个字体源。 简单的CLI界面，易于集成到外部构建系统中。 安装脚本 需要 v10 +。 全局安装最新版本，以“ lv_font_conv”执行 # install release from npm registry npm i lv_font_conv -g # install from github's repo, master branch npm i lvgl/lv_font_conv -g 通过运行，无需安装 # run from npm registry npx lv_font_conv -h # run f
ESP32开发学习 LVGL Littlevgl 加载外部SD卡字库显示
cnicfhnui的博客
08-05 5485
效果 本文开发环境： Visual Studio Code V1.58.2 LVGL版本 V7.10.0 芯片平台：ESP32 IDF库版本：4.3.0 IDF TOOLS编译工具链版本：2.9 本文软件基于LVGL官方提供的ESP32工程lv_port_esp32修改而来 LVGL ESP32官方地址：https://github.com/lvgl/lv_port_esp32 开发板平台基于HelloBug ESP32开发板 开发板购买链接：https://hellobug.t.
LuatOS-其他
06-12
合宙LuatOS是运行在嵌入式硬件的实时操作系统,只需要少量内存和flash空间就能运行，用户编写lua代码就可完成各种功能。特点：1、基于Lua 5.3.x2、低内存需求, 最低32kb, 96kb flash空间3、硬件抽象层兼容M3/arm/risc...
合宙luatos air32f103例程合集
05-23
《合宙Luatos Air32F103例程合集》是一份专注于STM32微控制器开发的资源集合，特别适用于使用合宙Luatos操作系统和Air32F103芯片的开发者。Luatos是一款轻量级、开源的操作系统，专为物联网设备设计，而Air32F103则...
luatos-wiki:luatos文档
03-19
**luatos-wiki: luatos文档** luatos 是一个基于 Lua 脚本语言的实时操作系统（RTOS），它将 Lua 的轻量级、易读易写的特点与RTOS的强大功能相结合，为嵌入式开发提供了便利的环境。Luatos 的目标是简化嵌入式设备...
lvgl v9.1版本使用lvglFontTool V0.4生成的外部bin字库
05-07
lvglFontTool V0.4生成的外部bin字库适配lvgl v9.1版本
LvglFontTool.zip
11-09
LvglFontTool.zip
LvglFontTool_V0.3.rar
04-22
lvgl的字体生成器，生成中文字符，好用。可以通过这个工具生成中文字符，然后引入到自己的工程中。lvgl的中文字符需要占据一定的空间，使用中文字符需要用户自定义，如果有嵌入式UI开发需要，可以联系我呀。
LuatOS 代码编写工具 v0003
12-15
为您提供LuatOS 代码编写工具下载，合宙LuatOS是运行在嵌入式硬件的实时操作系统,只需要少量内存和flash空间就能运行，用户编写lua代码就可完成各种功能。特点：1、基于Lua 5.3.x2、低内存需求, 最低32kb, 96kb ...
ubuntu18 安装lv_font_conv方法
fei的博客
08-03 172
下载源码，进入源码使用nmp安装。
LVGL font 字库管理(lv_font.c)
Bigan(安)的博客
08-19 1702
LVGL框架中对于字库提供了三个接口（在`lvgl/src/font/lv_font.c`中）用于获取字的图片、字的信息及查询字的宽度。在这三个接口之下，提供了两种字库解决方案：内置字库和外挂字库(freetype)。
luatos 定时器
07-28
Luatos 是一款基于 Lua 编程语言的实时操作系统，它主要用于嵌入式系统开发。在 Luatos 中，可以使用定时器来实现定时任务。 Luatos 提供了一个名为 "sys.timer" 的模块，通过该模块可以创建和管理定时器。下面是一个简单的示例代码，演示了如何使用 Luatos 的定时器功能： ```lua -- 导入 sys.timer 模块 local timer = require "sys.timer" -- 定义一个定时器回调函数 local function timer_callback() print("定时器触发") end -- 创建一个定时器，每隔 1 秒触发一次回调函数 timer.start(timer_callback, 1000) -- 运行 Luatos 主循环 sys.run() ``` 在上述示例中，首先导入了 "sys.timer" 模块，然后定义了一个名为 "timer_callback" 的定时器回调函数。接着通过调用 "timer.start" 函数创建了一个定时器，设置定时器的触发周期为 1000 毫秒（即每隔 1 秒触发一次回调函数）。最后，通过调用 "sys.run" 函数启动 Luatos 的主循环，使程序进入运行状态。 当定时器触发时，定时器回调函数会被执行。在上述示例中，每当定时器触发时，会打印出 "定时器触发" 的信息。 需要注意的是，在 Luatos 中，定时器的触发是基于非精确的软件定时器实现的，因此无法保证定时器的绝对准确性。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值