1. 字庫(kù)引擎簡(jiǎn)介

在某些應(yīng)用場(chǎng)景中，會(huì)有在圖像中打上水印的情況，特別是要寫(xiě)上【中文水印】，而opencv又無(wú)法做到支持中文。針對(duì)這種情況，EASY EAI api封裝了一個(gè)字庫(kù)引擎，專(zhuān)門(mén)用于給圖像寫(xiě)上文字。

例如圖中的綠色文字：

2. 快速上手

如果您初次閱讀此文檔，請(qǐng)閱讀：《入門(mén)指南/源碼管理及編程介紹/源碼工程管理》，按需管理自己工程源碼（注：此文檔必看，并建議采用【遠(yuǎn)程掛載管理】方式，否則有代碼丟失風(fēng)險(xiǎn)?。。。?。

2.1 源碼工程下載

先在PC虛擬機(jī)定位到nfs服務(wù)目錄，再在目錄中創(chuàng)建存放源碼倉(cāng)庫(kù)的管理目錄：

cd ~/nfsroot
mkdir GitHub
cd GitHub

再通過(guò)git工具，在管理目錄內(nèi)克隆遠(yuǎn)程倉(cāng)庫(kù)（需要設(shè)備能對(duì)外網(wǎng)進(jìn)行訪問(wèn)）

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

注：

* 此處可能會(huì)因網(wǎng)絡(luò)原因造成卡頓，請(qǐng)耐心等待。

* 如果實(shí)在要在gitHub網(wǎng)頁(yè)上下載，也要把整個(gè)倉(cāng)庫(kù)下載下來(lái)，不能單獨(dú)下載本實(shí)例對(duì)應(yīng)的目錄。

2.2 開(kāi)發(fā)環(huán)境搭建

通過(guò)adb shell進(jìn)入板卡開(kāi)發(fā)環(huán)境，如下圖所示。

通過(guò)以下命令，把nfs目錄掛載上nfs服務(wù)器。

mount -t nfs -o nolock : /home/orin-nano/Desktop/nfs/

2.3 例程編譯

然后定位到nfs的掛載目錄，再在目錄中創(chuàng)建存放源碼倉(cāng)庫(kù)的管理目錄：

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

進(jìn)入到對(duì)應(yīng)的例程目錄執(zhí)行編譯操作，具體命令如下所示：

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

2.4 例程運(yùn)行及效果

進(jìn)入Release目錄執(zhí)行下方命令，運(yùn)行示例程序：

cd ./Release
./test-font_engine

執(zhí)行效果如下所示。

就可看到在原圖基礎(chǔ)上，打上了【中文水印】。

API的詳細(xì)說(shuō)明，以及API的調(diào)用（本例程源碼），詳細(xì)信息見(jiàn)下方說(shuō)明。

3. 字符串操作API說(shuō)明

3.1 引用方式

EASY EAI api庫(kù)位于本倉(cāng)庫(kù)的easyeai-api目錄中。為方便客戶在本地工程中直接調(diào)用我們的EASY EAI api庫(kù)，此處列出工程中需要鏈接的庫(kù)以及頭文件等，方便用戶直接添加。

API源代碼路徑為EASY-EAI-Toolkit-3576/easyeai-api/common/font_engine/。用戶可通過(guò)源代碼了解接口實(shí)現(xiàn)，甚至可對(duì)源碼進(jìn)行修改。

3.2 創(chuàng)建全局字體對(duì)象

函數(shù)原型如下所示。

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

具體介紹如下所示。

3.3 給全局字體對(duì)象按指定格式進(jìn)行字符解碼

函數(shù)原型如下所示。

int32_t global_font_set_textCodec(const char *codec);

具體介紹如下所示。

3.4 設(shè)置全局字體對(duì)象對(duì)象的字號(hào)

函數(shù)原型如下所示。

int32_t global_font_set_fontSize(uint32_t fontSize);

具體介紹如下所示。

3.5 向圖像寫(xiě)入指定字符

函數(shù)原型如下所示。

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

具體介紹如下所示。

FontColor結(jié)構(gòu)體：

typedef struct {
	uint8_t Alpha;	//透明度通道色值
	uint8_t Red;	//紅色通道色值
	uint8_t Green;	//綠色通道色值
	uint8_t Bule;	//藍(lán)色通道色值
}FontColor;

3.6 銷(xiāo)毀全局字體對(duì)象

函數(shù)原型如下所示。

int32_t global_font_destory();

具體介紹如下所示。

4. API測(cè)試案例

示例代碼路徑為EASY-EAI-Toolkit-3576/Demos/common-font_engine/test-font_engine.cpp。

以下為各個(gè)API的實(shí)際用例。

int main(void)
{
	// 初始化字體透明度和顏色
	FontColor color = {200, 135, 189, 67};    // {A, R, G, B};
	
	// 創(chuàng)建全局字體
	global_font_create("./simhei.ttf", CODE_UTF8);
	
	// 讀取底圖
	cv::Mat img = cv::imread("./testPic.png");
	
	// 寫(xiě)入文字
	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);
	
	// 保存寫(xiě)入文字后的底圖
	cv::imwrite("./res.jpg", img);
	
	// 銷(xiāo)毀全局字體
	global_font_destory();
	
	return 0;
}

審核編輯 黃宇