OpenCV putText增加中文支持

OpenCV 默认并不支持中文字符显示,需要增加 freetype 支持,也需正确设置中文字体才能正常显示中文。

OpenCV 2.x 版本没有该模块,而 OpenCV 3.x 及以上版本才正式引入了 freetype 模块 ,可检查并更新到较新且包含该模块的版本。

OpenCV 默认 modules 中是不包含 freetype 的,其 freetype modules 在 opencv_contrib 库中,以 OpenCV 4.10.0 为例,需下载与 OpenCV 源码对应的 opencv_contrib 版本,并解压到 OpenCV 源码根目录;也可以在编译时指定 opencv_contrib 路径 -DOPENCV_EXTRA_MODULES_PATH=<opencv_contrib>/modules

下面以 OpenCV 4.10.0 为例

一、编译

  1. 下载 OpenCV 4.10.0 源码
    OpenCV 官网https://github.com/opencv下载 4.10.0 源码
    https://github.com/opencv/opencv_contrib 下载 Tag 为 4.10.0 的 opencv_contrib
  2. 分别解压 opencv-4.10.0 和 opencv_contrib-4.10.0
bash 复制代码
unzip opencv-4.10.0.zip
tar xvf opencv_contrib-4.10.0.tar.gz
  1. 将 opencv_contrib-4.10.0 的 modules 拷贝到 opencv-4.10.0 中
    因为只需要使用freetype模块,此处只将 opencv_contrib-4.10.0中的freetype modules 拷贝到 opencv-4.10.0 modules 中
bash 复制代码
cp -a opencv_contrib-4.10.0/modules/freetype/ opencv-4.10.0/modules/
  1. 编译
bash 复制代码
cd opencv_contrib-4.10.0
mkdir build
cd build
cmake ..
make -j16
make install

编译成功后,头文件中应该包含

二、使用

需要包含头文件,opencv2/freetype.hpp

freetype 需加载外部的中文字体文件,如常见的宋体字体 SIMSUN.TTC 、黑体字体 simhei.ttf 等

示例如下:

cpp 复制代码
#include <iostream>
#include <opencv2/opencv.hpp>
#include <opencv2/freetype.hpp>

using namespace std;
using namespace cv;

int main(void)
{
    // 创建一个宽400、高100、颜色为蓝色(BGR 格式:255, 0, 0)的空白图片
    Mat image(100, 400, CV_8UC3, Scalar(255, 0, 0));
    // 检查图片是否创建成功
    if (image.empty()) {
        cout << "图片创建失败。" << endl;
        return -1;
    }
    // 创建 FreeType2 对象
    Ptr<freetype::FreeType2> ft2 = freetype::createFreeType2();
    // 加载字体文件
    ft2->loadFontData("./simsun.ttc", 0);
    int font_size = 25;
    // 在图像上绘制中文文本
    Point textOrg(0, 25);
    Scalar font_color(0, 0, 255);
    ft2->putText(image, "Hello OPenCV,你好,OPenCV。", textOrg, font_size, font_color, FILLED, LINE_AA, true);
    ft2->putText(image, "Hello OPenCV,你好,OPenCV。", Point(0, 50), font_size, font_color, FILLED, LINE_AA, true);
    ft2->putText(image, "Hello OPenCV,你好,OPenCV。", Point(0, 75), font_size, font_color, FILLED, LINE_AA, true);
    ft2->putText(image, "Hello OPenCV,你好,OPenCV。", Point(0, 100), font_size, font_color, FILLED, LINE_AA, true);
    // 创建窗口并显示图片
    namedWindow("Blue Blank Image", WINDOW_AUTOSIZE);
    imshow("Blue Blank Image", image);
    // 等待按键按下
    waitKey(0);
    // 销毁窗口
    destroyWindow("Blue Blank Image");
    return 0;
}

编译

bash 复制代码
g++ main.cpp -I /usr/local/include/opencv4/ -L /usr/local/lib  -lopencv_core -lopencv_highgui  -lopencv_freetype

运行

bash 复制代码
export LD_LIBRARY_PATH=/usr/local/lib
./a.out

在 OpenCV 的 putText 函数中,文字显示的 y 坐标对应的是文本左下角的位置。上述代码中,字体大小为25,4行文字刚好占满高度100。

三、总结

OpenCV putText 函数想要显示中文,不管什么版本的 OpenCV,都需要依赖 freetype。只不过 OpenCV 3.x 及以上版本,opencv_contrib 增加了 freetype 模块。OpenCV 2.x 若需要显示中文,可参考opencv_contrib freetype 模块自行封装。

相关推荐
葡萄爱2 小时前
OpenCV图像分割
人工智能·opencv·计算机视觉
编码小哥4 小时前
通过opencv加载、保存视频
人工智能·opencv
发呆小天才O.oᯅ4 小时前
YOLOv8目标检测——详细记录使用OpenCV的DNN模块进行推理部署C++实现
c++·图像处理·人工智能·opencv·yolo·目标检测·dnn
西猫雷婶4 小时前
python学opencv|读取图像(十六)修改HSV图像HSV值
开发语言·python·opencv
pchmi5 小时前
C# OpenCV机器视觉:模板匹配
opencv·c#·机器视觉
Byron Loong6 小时前
Python+OpenCV系列:【打卡系统-需求分析】需求大剖析,考勤革命开启!
python·opencv·需求分析
编码小哥7 小时前
深入解析Mat对象:计算机视觉中的核心数据结构
opencv·计算机视觉
Byron Loong8 小时前
Python+OpenCV系列:【打卡系统-工具模块设计】工具模块深度揭秘,考勤智能化的核心秘籍!
python·opencv·webpack
Learning改变世界1 天前
ubuntu24.04使用opencv4
opencv