1. OSD簡介

在某些應用場景中（比如IPCamera），會有在圖像中打上水印的需求，特別是要寫上【中文水印】，而opencv又無法做到支持中文。針對這種情況，EASY EAI api封裝了一個字庫引擎，專門用于給圖像寫上文字。

例如圖中的綠色文字：

2. 快速上手

2.1 開發環境準備

如果您初次閱讀此文檔，請閱讀《入門指南/開發環境準備/Easy-Eai編譯環境準備與更新》，并按照其相關的操作，進行編譯環境的部署。

在PC端Ubuntu系統中執行run腳本，進入EASY-EAI編譯環境，具體如下所示。

cd ~/develop_environment ./run.sh 2204

2.2 源碼下載以及例程編譯

在EASY-EAI編譯環境下創建存放源碼倉庫的管理目錄：

cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit

通過git工具，在管理目錄內克隆遠程倉庫

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

注：

* 此處可能會因網絡原因造成卡頓，請耐心等待。

* 如果實在要在gitHub網頁上下載，也要把整個倉庫下載下來，不能單獨下載本實例對應的目錄。

進入到對應的例程目錄執行編譯操作，具體命令如下所示：

cd EASY-EAI-Toolkit-1126B/Demos/common-font_engine/ ./build.sh cpres

注：

* 由于依賴庫部署在板卡上，因此交叉編譯過程中必須保持/mnt掛載。

2.3 例程運行

通過串口調試或ssh調試，進入板卡后臺，定位到例程部署的位置，如下所示：

cd /userdata/Demo/common-font_engine

運行例程命令如下所示：

./test-font_engine

2.4 運行效果

執行效果如下所示。

測試程序運行后會生成一張名為“result.jpg”的圖片，如下所示。

回到【編譯窗口】，直接用eog命令把圖片打開：

eog /mnt/userdata/Demo/common-font_engine/result.jpg & eog /mnt/userdata/Demo/common-font_engine/testPic.png &

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

若EASY-EAI編譯環境提示找不到eog命令，可以采用下方操作安裝一下eog命令：

sudo apt-get update sudo apt-get install eog

也可以嘗試把圖片，從板卡上拷到電腦上來：

cp /mnt/userdata/Demo/common-font_engine/result.jpg ./Release

API的詳細說明，以及API的調用（本例程源碼），詳細信息見下方說明。

3. 字符串操作API說明

3.1 引用方式

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

API源代碼路徑為EASY-EAI-Toolkit-1126B/easyeai-api/common/font_engine/。用戶可通過源代碼了解接口實現，甚至可對源碼進行修改。

3.2 創建全局字體對象

函數原型如下所示。

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

具體介紹如下所示。

3.3 給全局字體對象按指定格式進行字符解碼

函數原型如下所示。

int32_t global_font_set_textCodec(const char *codec);

具體介紹如下所示。

3.4 設置全局字體對象對象的字號

函數原型如下所示。

int32_t global_font_set_fontSize(uint32_t fontSize);

具體介紹如下所示。

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);

具體介紹如下所示。

FontColor結構體：

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

3.6 銷毀全局字體對象

函數原型如下所示。

int32_t global_font_destory();

具體介紹如下所示。

4. API測試案例

示例代碼路徑為EASY-EAI-Toolkit-1126B/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; }