基于RK3576开发板的字库引擎

1. 字库引擎简介

在某些应用场景中，会有在图像中打上水印的情况，特别是要写上【中文水印】，而opencv又无法做到支持中文。针对这种情况，EASY EAI api封装了一个字库引擎，专门用于给图像写上文字。

例如图中的绿色文字：

2. 快速上手

如果您初次阅读此文档，请阅读：《入门指南/源码管理及编程介绍/源码工程管理》，按需管理自己工程源码（注：此文档必看，并建议采用【远程挂载管理】方式，否则有代码丢失风险！！！）。

2.1 源码工程下载

先在PC虚拟机定位到nfs服务目录，再在目录中创建存放源码仓库的管理目录：

cd ~/nfsroot
mkdir GitHub
cd GitHub

再通过git工具，在管理目录内克隆远程仓库（需要设备能对外网进行访问）

git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-3576.git

注：

* 此处可能会因网络原因造成卡顿，请耐心等待。

* 如果实在要在gitHub网页上下载，也要把整个仓库下载下来，不能单独下载本实例对应的目录。

2.2 开发环境搭建

通过adb shell进入板卡开发环境，如下图所示。

通过以下命令，把nfs目录挂载上nfs服务器。

mount -t nfs -o nolock < nfs server ip >:< nfs path in server > /home/orin-nano/Desktop/nfs/

2.3 例程编译

然后定位到nfs的挂载目录，再在目录中创建存放源码仓库的管理目录：

cd /home/orin-nano/Desktop/nfs/GitHub

进入到对应的例程目录执行编译操作，具体命令如下所示：

cd EASY-EAI-Toolkit-3576/Demos/common-font_engine/
./build.sh

2.4 例程运行及效果

进入Release目录执行下方命令，运行示例程序：

cd ./Release
./test-font_engine

执行效果如下所示。

就可看到在原图基础上，打上了【中文水印】。

API的详细说明，以及API的调用（本例程源码），详细信息见下方说明。

3. 字符串操作API说明

3.1 引用方式

EASY EAI api库位于本仓库的easyeai-api目录中。为方便客户在本地工程中直接调用我们的EASY EAI api库，此处列出工程中需要链接的库以及头文件等，方便用户直接添加。

描述	CMake写法	Makefile写法
api.cmake	${common_root}/font_engine/api.cmake	无
头文件目录	${FONT_ENGINE_INCLUDE_DIRS}	-I ../../easyeai-api/common/font_engine
源文件目录	${FONT_ENGINE_SOURCE_DIRS}	../../easyeai-api/common/font_engine
库文件目录	无	无
库链接参数	${FONT_ENGINE_LIBS}	无

API源代码路径为EASY-EAI-Toolkit-3576/easyeai-api/common/font_engine/。用户可通过源代码了解接口实现，甚至可对源码进行修改。

3.2 创建全局字体对象

函数原型如下所示。

int32_t global_font_create(const char *fontLib, const char *codec);

具体介绍如下所示。

函数名：global_font_create()
头文件	easyeai-api/common/font_engine/font_engine.h
输入参数	fontLib：待载入的字库文件，如"./simhei.ttf"
	codec：需要写入到图像中文字的字符编码格式，如utf-8或者gbk等
返回值	创建成功：0 创建失败：-1
注意事项	如果本进程已经某处创建了全局字符对象，则再次调用的返回值必然是-1

3.3 给全局字体对象按指定格式进行字符解码

函数原型如下所示。

int32_t global_font_set_textCodec(const char *codec);

具体介绍如下所示。

函数名：global_font_set_textCodec()
头文件	easyeai-api/common/font_engine/font_engine.h
输入参数	codec：需要写入到图像中文字的字符编码格式，如utf-8或者gbk等
返回值	设置成功：0 设置失败：-1
注意事项	需要全局字体对象已经被创建。

3.4 设置全局字体对象对象的字号

函数原型如下所示。

int32_t global_font_set_fontSize(uint32_t fontSize);

具体介绍如下所示。

函数名：global_font_set_fontSize()
头文件	easyeai-api/common/font_engine/font_engine.h
输入参数	fontSize：待设定的目标字号
返回值	设置成功：0 设置失败：-1
注意事项	需要全局字体对象已经被创建。

3.5 向图像写入指定字符

函数原型如下所示。

int32_t putText(uint8_t *imgData, uint32_t imgWidth, uint32_t imgHeight, const char *text, uint32_t posX, uint32_t posY, FontColor color);

具体介绍如下所示。

函数名：putText()
头文件	easyeai-api/common/font_engine/font_engine.h
输入参数	imgData：图像数据首地址，数据格式为BGR888 imgWidth：图像分辨率尺寸，宽度。 imgHeight：图像分辨率尺寸，高度。 text：待写入的字符。 posX：待写入字符的左上角相对于图像的x坐标。图像的坐标原点也位于左上角。 posY：待写入字符的左上角相对于图像的y坐标。图像的坐标原点也位于左上角。 color：字体的色值，结构体在下方说明。
返回值	写入成功：0 写入失败：-1
注意事项	需要全局字体对象已经被创建。

FontColor结构体：

typedef struct {
	uint8_t Alpha;	//透明度通道色值
	uint8_t Red;	//红色通道色值
	uint8_t Green;	//绿色通道色值
	uint8_t Bule;	//蓝色通道色值
}FontColor;

3.6 销毁全局字体对象

函数原型如下所示。

int32_t global_font_destory();

具体介绍如下所示。

函数名：global_font_destory()
头文件	easyeai-api/common/font_engine/font_engine.h
输入参数	无
返回值	销毁成功：0 销毁失败：-1
注意事项	需要全局字体对象已经被创建。

4. API测试案例

示例代码路径为EASY-EAI-Toolkit-3576/Demos/common-font_engine/test-font_engine.cpp。

以下为各个API的实际用例。

int main(void)
{
	// 初始化字体透明度和颜色
	FontColor color = {200, 135, 189, 67};    // {A, R, G, B};
	
	// 创建全局字体
	global_font_create("./simhei.ttf", CODE_UTF8);
	
	// 读取底图
	cv::Mat img = cv::imread("./testPic.png");
	
	// 写入文字
	global_font_set_fontSize(80);
	putText(img.data, img.cols, img.rows, "欢迎使用", 210, 940, color);
	global_font_set_fontSize(40);
	putText(img.data, img.cols, img.rows, "欢迎使用", 290, 1020, color);
	
	// 保存写入文字后的底图
	cv::imwrite("./res.jpg", img);
	
	// 销毁全局字体
	global_font_destory();
	
	return 0;
}

审核编辑 黄宇