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 模块自行封装。

相关推荐
海绵波波10713 小时前
opencv、torch、torchvision、tensorflow的区别
人工智能·opencv·tensorflow
顾随18 小时前
(三)OpenCV——图像形态学
图像处理·人工智能·python·opencv·计算机视觉
jndingxin1 天前
OpenCV直线段检测算法类cv::line_descriptor::LSDDetector
人工智能·opencv·算法
Mikowoo0072 天前
03_opencv_imwrite()函数
opencv·计算机视觉
ddfa12342 天前
opencv 值类型 引用类型
人工智能·opencv·计算机视觉
金山几座2 天前
揭开图像的秘密:OpenCV直方图入门详解
opencv·计算机视觉
批量小王子2 天前
2025-07-15通过边缘线检测图像里的主体有没有出血
人工智能·opencv·计算机视觉
Java与Android技术栈3 天前
macOS 为 Compose Desktop 构建跨平台图像库:OpenCV + libraw + libheif 实践
人工智能·opencv·macos·计算机视觉
阿_旭3 天前
【CV综合实战】基于深度学习的工业压力表智能检测与读数系统【3】使用OpenCV读取分割后的压力表读数
人工智能·深度学习·opencv·压力表读数读取
AI technophile3 天前
OpenCV计算机视觉实战(15)——霍夫变换详解
人工智能·opencv·计算机视觉