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

相关推荐
星期天要睡觉18 小时前
计算机视觉(opencv)——MediaPipe 实现手部关键点检测与可视化
人工智能·opencv·计算机视觉
却道天凉_好个秋19 小时前
OpenCV(八):NumPy
人工智能·opencv·numpy
fsnine19 小时前
基于OpenCV的通过人脸对年龄、性别、表情与疲劳进行检测
人工智能·opencv·计算机视觉
星期天要睡觉1 天前
计算机视觉(opencv)——仿射变换(Affine Transformation)
人工智能·opencv·计算机视觉
abcd_zjq2 天前
【2025最新】【win10】vs2026+qt6.9+opencv(cmake编译opencv_contrib拓展模
人工智能·qt·opencv·计算机视觉·visual studio
abcd_zjq2 天前
VS2026+QT6.9+opencv图像增强(多帧平均降噪)(CLAHE对比度增强)(边缘增强)(图像超分辨率)
c++·图像处理·qt·opencv·visual studio
Blossom.1182 天前
用一颗MCU跑通7B大模型:RISC-V+SRAM极致量化实战
人工智能·python·单片机·嵌入式硬件·opencv·机器学习·risc-v
mit6.8242 天前
[GazeTracking] 摄像头交互与显示 | OpenCV
人工智能·opencv·交互
星期天要睡觉2 天前
计算机视觉(opencv)——基于 OpenCV DNN 的实时人脸检测 + 年龄与性别识别
opencv·计算机视觉·dnn
AndrewHZ2 天前
【图像处理基石】暗光增强算法入门:从原理到实战(Python+OpenCV)
图像处理·python·opencv·算法·计算机视觉·cv·暗光增强