文字绘制——putText详解

本文介绍OpenCV中cv::putText()函数用于在图像上绘制文字的方法,及如何利用cv::getTextSize()预先获取文本框尺寸,实现文本的精准定位。通过示例代码展示了如何设置文字样式、颜色、位置等参数。

opencv中除了提供绘制各种图形的函数外,还提供了一个特殊的绘制函数——在图像上绘制文字。这个函数即是cv::putText()。

具体形式如下:

	void cv::putText(
		cv::Mat& img, // 待绘制的图像
		const string& text, // 待绘制的文字
		cv::Point origin, // 文本框的左下角
		int fontFace, // 字体 (如cv::FONT_HERSHEY_PLAIN)
		double fontScale, // 尺寸因子,值越大文字越大
		cv::Scalar color, // 线条的颜色(RGB)
		int thickness = 1, // 线条宽度
		int lineType = 8, // 线型(4邻域或8邻域,默认8邻域)
		bool bottomLeftOrigin = false // true='origin at lower left'
	);


opencv支持的文字字体有以下几种:


另外,我们在实际绘制文字之前,还可以使用cv::getTextSize()接口先获取待绘制文本框的大小,以方便放置文本框。具体调用形式如下:

	cv::Size cv::getTextSize(
		const string& text,
		cv::Point origin,
		int fontFace,
		double fontScale,
		int thickness,
		int* baseLine
	);


下面就通过一个示例,来看看cv::getTextSize()与cv::putText()相结合的妙用:

#include <iostream>
    #include "opencv2/opencv.hpp"
    using namespace std;
    using namespace cv;
    int main( )
    {
	//创建空白图用于绘制文字
     Mat image = Mat::zeros(Size(640, 480), CV_8UC3);
	//设置蓝色背景
	image.setTo(Scalar(100, 0, 0));
 
	//设置绘制文本的相关参数
	string text = "JILIN UNIVERSITY";
	int font_face = FONT_HERSHEY_COMPLEX; 
	double font_scale = 2;
	int thickness = 2;
	int baseline;
	//获取文本框的长宽
	Size text_size = getTextSize(text, font_face, font_scale, thickness, &baseline);
 
	//将文本框居中绘制
	Point origin; 
	origin.x = image.cols / 2 - text_size.width / 2;
	origin.y = image.rows / 2 + text_size.height / 2;
	putText(image, text, origin, font_face, font_scale, Scalar(0, 255, 255), thickness, 8, 0);
 
	//显示绘制解果
    imshow("image", image);
	waitKey(0);
	return 0;
	}

效果图:在这里插入图片描述

### 关于 OpenCV `putText` 函数绘制文字时显示问号的解决方案 在使用 OpenCV 的 `putText` 函数时,如果尝试直接绘制文字符,则可能会遇到图像上仅显示问号的情况。这是由于默认字体不支持 Unicode 字符集中的汉字编码所致[^1]。 一种常见的解决方法是引入第三方库 FreeType 来加载并渲染 TrueType 字体文件(如 `.ttf` 文件),从而支持中文字符的正常显示[^4]。以下是具体实现方式: #### 方法一:基于 FreeType 库的支持 FreeType 是一个开源的字体引擎库,能够解析和渲染各种类型的字体文件。通过该库可以动态加载指定的中文字体(例如“微软雅黑”)。以下是一个简单的 C++ 实现示例: ```cpp #include <opencv2/opencv.hpp> #include <ft2build.h> #include FT_FREETYPE_H void drawChineseText(cv::Mat& image, const std::string& text, cv::Point position, int fontSize, cv::Scalar color, const std::string& fontPath) { FT_Library ft; if (FT_Init_FreeType(&ft)) { throw "Could not init FreeType Library"; } FT_Face face; if (FT_New_Face(ft, fontPath.c_str(), 0, &face)) { throw "Could not open font"; } FT_Set_Pixel_Sizes(face, 0, fontSize); for (size_t i = 0; i < text.length(); ++i) { unsigned char c = text[i]; if (FT_Load_Char(face, c, FT_LOAD_RENDER)) { continue; } cv::rectangle(image, cv::Rect(position.x + face->glyph->bitmap_left, position.y - face->glyph->bitmap_top, face->glyph->bitmap.width, face->glyph->bitmap.rows), cv::Scalar(255, 255, 255), CV_FILLED); for(int j = 0; j < face->glyph->bitmap.rows; ++j){ for(int k = 0; k < face->glyph->bitmap.width; ++k){ if(face->glyph->bitmap.buffer[j * face->glyph->bitmap.width + k]){ image.at<cv::Vec3b>(position.y - face->glyph->bitmap_top + j, position.x + face->glyph->bitmap_left + k)[0] = static_cast<uchar>(color[0]); image.at<cv::Vec3b>(position.y - face->glyph->bitmap_top + j, position.x + face->glyph->bitmap_left + k)[1] = static_cast<uchar>(color[1]); image.at<cv::Vec3b>(position.y - face->glyph->bitmap_top + j, position.x + face->glyph->bitmap_left + k)[2] = static_cast<uchar>(color[2]); } } } position.x += face->glyph->advance.x >> 6; } FT_Done_Face(face); FT_Done_FreeType(ft); } int main(){ cv::Mat img = cv::imread("test.jpg"); drawChineseText(img, "你好世界", cv::Point(50, 50), 24, cv::Scalar(255, 0, 0), "/usr/share/fonts/truetype/windows/MSYH.TTF"); cv::imshow("Image with Chinese Text", img); cv::waitKey(0); } ``` 上述代码片段展示了如何借助 FreeType 加载自定义字体,并将其应用于 OpenCV 图像处理过程中。 #### 方法二:封装专用函数 另一种更简便的方式是直接调用已封装好的工具类或头文件,比如 `putTextZH()` 函数。此函数内部实现了对特定字体的支持逻辑,开发者只需提供目标字符串及相关参数即可完成操作[^3]。 ```cpp // 假设已经包含了 putTextCN.h 头文件 cv::Mat img = cv::imread("test.jpg"); wchar_t* msg = L"我是一个粉刷匠,\n粉刷本领强."; putTextZH(img, msg, cv::Point(50, 50), cv::Scalar(255, 0, 0), 10, "微软雅黑", false, false); cv::imshow("Result", img); cv::waitKey(0); ``` 这种方法无需手动管理复杂细节,适合快速开发场景下的应用需求。 --- #### 总结 无论是采用 FreeType 进行底层定制化实现还是依赖现有封装接口解决问题,在实际项目中都需要确保所使用的字体资源路径有效以及环境配置正确无误。此外还需注意跨平台兼容性问题可能带来的额外挑战。
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

zqx951102

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值