OpenCV putText在图像上添加汉字

该代码片段展示了如何使用OpenCV库结合Windows API在图像上绘制中文文本,包括字体设置、大小、颜色等属性,并提供了UTF-8到GBK编码转换的辅助方法。示例程序读取图片,添加中文文本并显示结果。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

#pragma once
#ifndef PUTTEXT_H_
#define PUTTEXT_H_


#include <Windows.h>
#include <string>
#include <opencv2/opencv.hpp>


using namespace cv;


class putText
{
private:
	static void GetStringSize(HDC hdc, const char* str, int* w, int* h);


public:
	static void putTextZH(Mat& dst, const char* str, Point org, Scalar color, int fontsize,
		const char* fn = "Arial", bool italic = false, bool underline = false);
	static std::string UtfToGbk(std::string strValue);
};


#endif // !PUTTEXT_H_
#include "putText.h"


void putText::GetStringSize(HDC hdc, const char* str, int* w, int* h)
{
	SIZE size;
	GetTextExtentPoint32A(hdc, str, strlen(str), &size);
	if (w != 0) *w = size.cx;
	if (h != 0) *h = size.cy;
}

void putText::putTextZH(Mat& dst, const char* str, Point org, Scalar color, int fontsize, const char* fn, bool italic, bool underline)
{
	CV_Assert(dst.data != 0 && (dst.channels() == 1 || dst.channels() == 3));


	int x, y, r, b;
	//坐标点大于图像宽和高直接返回
	if (org.x > dst.cols || org.y > dst.rows) return;
	x = org.x < 0 ? -org.x : 0;
	y = org.y < 0 ? -org.y : 0;


	LOGFONTA lf;
	lf.lfHeight = -fontsize; //字体高度
	lf.lfWidth = 0;          //平均宽度
	lf.lfEscapement = 0;   //字符排列角度
	lf.lfOrientation = 0;   //字符本身旋转的角度
	lf.lfWeight = 5;        //设置字体线条的宽度
	lf.lfItalic = italic; //斜体
	lf.lfUnderline = underline; //下划线
	lf.lfStrikeOut = 0;     //是否字符中央加横线
	lf.lfCharSet = DEFAULT_CHARSET;   //字符集
	lf.lfOutPrecision = 0;  //字体的精确度
	lf.lfQuality = PROOF_QUALITY;  //字体质量
	lf.lfPitchAndFamily = 0; //选择字体的间距和字体家族
	strcpy_s(lf.lfFaceName, fn); //字体的名称


	HFONT hf = CreateFontIndirectA(&lf);
	HDC hdc = CreateCompatibleDC(0);
	HFONT holdfont = (HFONT)SelectObject(hdc, hf);


	int strBaseW = 0, strBaseH = 0;
	int singleRow = 0;
	char buf[1 << 12];
	strcpy_s(buf, str);
	char* bufT[1 << 12];   //这个用于分隔字符串后剩余的字符,可能会超出。


	//处理多行
	{
		int nnh = 0;
		int cw, ch;


		const char* ln = strtok_s(buf, "\n", bufT);
		while (ln != 0)
		{
			GetStringSize(hdc, ln, &cw, &ch);
			strBaseW = max(strBaseW, cw);
			strBaseH = max(strBaseH, ch);


			ln = strtok_s(0, "\n", bufT);
			nnh++;
		}
		singleRow = strBaseH;
		strBaseH *= nnh;
	}


	if (org.x + strBaseW < 0 || org.y + strBaseH < 0)
	{
		SelectObject(hdc, holdfont);
		DeleteObject(hf);
		DeleteObject(hdc);
		return;
	}


	r = org.x + strBaseW > dst.cols ? dst.cols - org.x - 1 : strBaseW - 1;
	b = org.y + strBaseH > dst.rows ? dst.rows - org.y - 1 : strBaseH - 1;
	org.x = org.x < 0 ? 0 : org.x;
	org.y = org.y < 0 ? 0 : org.y;


	BITMAPINFO bmp = { 0 };
	BITMAPINFOHEADER& bih = bmp.bmiHeader;
	int strDrawLineStep = strBaseW * 3 % 4 == 0 ? strBaseW * 3 : (strBaseW * 3 + 4 - ((strBaseW * 3) % 4));


	bih.biSize = sizeof(BITMAPINFOHEADER);
	bih.biWidth = strBaseW;
	bih.biHeight = strBaseH;
	bih.biPlanes = 1;
	bih.biBitCount = 24;
	bih.biCompression = BI_RGB;
	bih.biSizeImage = strBaseH * strDrawLineStep;
	bih.biClrUsed = 0;
	bih.biClrImportant = 0;


	void* pDibData = 0;
	HBITMAP hBmp = CreateDIBSection(hdc, &bmp, DIB_RGB_COLORS, &pDibData, 0, 0);


	CV_Assert(pDibData != 0);
	HBITMAP hOldBmp = (HBITMAP)SelectObject(hdc, hBmp);


	//color.val[2], color.val[1], color.val[0]
	SetTextColor(hdc, RGB(255, 255, 255));
	SetBkColor(hdc, 0);
	//SetStretchBltMode(hDC, COLORONCOLOR);


	strcpy_s(buf, str);
	const char* ln = strtok_s(buf, "\n", bufT);
	int outTextY = 0;
	while (ln != 0)
	{
		TextOutA(hdc, 0, outTextY, ln, strlen(ln));
		outTextY += singleRow;
		ln = strtok_s(0, "\n", bufT);
	}
	uchar* dstData = (uchar*)dst.data;
	int dstStep = dst.step / sizeof(dstData[0]);
	unsigned char* pImg = (unsigned char*)dst.data + org.x * dst.channels() + org.y * dstStep;
	unsigned char* pStr = (unsigned char*)pDibData + x * 3;
	for (int tty = y; tty <= b; ++tty)
	{
		unsigned char* subImg = pImg + (tty - y) * dstStep;
		unsigned char* subStr = pStr + (strBaseH - tty - 1) * strDrawLineStep;
		for (int ttx = x; ttx <= r; ++ttx)
		{
			for (int n = 0; n < dst.channels(); ++n) {
				double vtxt = subStr[n] / 255.0;
				int cvv = vtxt * color.val[n] + (1 - vtxt) * subImg[n];
				subImg[n] = cvv > 255 ? 255 : (cvv < 0 ? 0 : cvv);
			}


			subStr += 3;
			subImg += dst.channels();
		}
	}


	SelectObject(hdc, hOldBmp);
	SelectObject(hdc, holdfont);
	DeleteObject(hf);
	DeleteObject(hBmp);
	DeleteDC(hdc);
}

std::string putText::UtfToGbk(std::string strValue)
{
	int len = MultiByteToWideChar(CP_UTF8, 0, strValue.c_str(), -1, NULL, 0);
	wchar_t* wstr = new wchar_t[len + 1];
	memset(wstr, 0, len + 1);
	MultiByteToWideChar(CP_UTF8, 0, strValue.c_str(), -1, wstr, len);
	len = WideCharToMultiByte(CP_ACP, 0, wstr, -1, NULL, 0, NULL, NULL);
	char* str = new char[len + 1];
	memset(str, 0, len + 1);
	WideCharToMultiByte(CP_ACP, 0, wstr, -1, str, len, NULL, NULL);
	if (wstr) delete[] wstr;
	return std::string(str);
}
#include<iostream>
#include"putText.h"
#include<opencv2/opencv.hpp>
#include<Windows.h>

using namespace std;
using namespace cv;



int main(int argc, char* argv[])
{
	string imgName;
	if (argc > 1)
	{
		imgName = argv[1];
	}
	else
	{
		cout << "please input img path: ";
		cin >> imgName;
		cout << endl;
	}
	string n = "图像处理";
	string nn = putText::UtfToGbk(n);
	Mat img;
	img = imread(imgName);
	putText::putTextZH(img, nn.c_str(), Point(img.cols / 2, img.rows / 2), Scalar(255, 10, 200), 100, "微软雅黑");

	cv::namedWindow("img", WINDOW_NORMAL);
	cv::imshow("img", img);
	cv::waitKey();

	return 0;
}

<think>嗯,用户想在OpenCV中使用putText函数显示中文字符。我之前记得OpenCV的默认putText函数不支持中文,直接使用的话会显示乱码或者方块。那用户可能需要用到其他方法。 首先,用户提供的引用里有提到一些方法,比如使用cv2.freetype,但可能没有这个库。或者安装opencv-contrib-python,里面可能包含更多的模块。不过用户提到尝试过这些方法但没成功,所以可能需要另一种解决方案。 然后,引用里有一个PutText.h的头文件,里面定义了GetStringSize和putTextZH函数,使用Windows的HDC来绘制文字。这应该是一种通过Windows API来渲染中文的方法,可能适用于C++环境。不过用户可能需要Python的示例代码,所以需要考虑如何转换到Python。 在Python中,可能需要使用PIL库来生成中文文本的图像,然后将该图像OpenCV的帧上。因为PIL支持中文字体,可以正确渲染,然后转换成OpenCV的格式。这样就能绕过putText不支持中文的问题了。 不过用户需要示例代码,所以得写出具体的步骤:导入PIL和OpenCV,创建图像,使用PIL的DrawText写入中文,然后转换成OpenCV的Mat格式。可能还需要处理颜色空间的转换,比如RGB到BGR。 另外,要注意字体文件的路径是否正确,用户需要指定一个中文字体文件,比如simsun.ttc或者微软雅黑。如果没有安装这些字体,可能需要用户自己下载或者指定系统内的字体路径。 总结下来,步骤应该是:使用PIL.Image绘制文本,转换图像为NumPy数组,颜色空间转换,然后合并到OpenCV图像中。这样就能实现中文显示了。同时,提醒用户安装必要的库,比如Pillow和opencv-python。 可能还需要提到其他方法,比如使用opencv-contrib-python中的freetype模块,但需要安装正确的版本。如果用户的环境允许,可以尝试这种方法,但可能存在兼容性问题,所以PIL方法可能更可靠。 最后,检查代码是否正确,确保中文字符不会被编码问题影响,比如在Python文件中使用正确的编码声明,或者在字符串前u前缀(Python2可能需要,但Python3默认unicode)。 所以,最终的解决方案应该是基于PIL和OpenCV的结合,生成中文文本,然后合并到目标图像中。</think>在OpenCV中实现中文字符显示需要通过第三方库辅助,以下是两种常用方法及示例代码: --- ### 方法一:使用PIL库与OpenCV结合(推荐) **原理**:利用PIL库的字体渲染能力生成中文文字图像,再转换为OpenCV的Mat格式 ```python import cv2 import numpy as np from PIL import Image, ImageDraw, ImageFont # 创建空白画布 img_opencv = np.zeros((200, 400, 3), dtype=np.uint8) img_pil = Image.fromarray(img_opencv) # 配置中文字体(需系统内有对应字体文件) font_path = "C:/Windows/Fonts/simsun.ttc" # 宋体字体路径 font_size = 24 font = ImageFont.truetype(font_path, font_size) # 在PIL图像上绘制中文 draw = ImageDraw.Draw(img_pil) text = "你好,OpenCV!" position = (50, 80) # 文字起始坐标 color = (255, 0, 0) # BGR颜色:红色 draw.text(position, text, font=font, fill=color) # 转换回OpenCV格式 img_opencv = cv2.cvtColor(np.array(img_pil), cv2.COLOR_RGB2BGR) cv2.imshow("Chinese Text", img_opencv) cv2.waitKey(0) ``` --- ### 方法二:使用OpenCV的freetype模块(需安装扩展包) **环境要求**:需安装`opencv-contrib-python`包 ```python import cv2 import numpy as np # 创建freetype实例 ft = cv2.freetype.createFreeType2() ft.loadFontData(fontFileName='msyh.ttf', # 微软雅黑字体路径 id=0) # 创建空白图像 img = np.zeros((200, 400, 3), dtype=np.uint8) # 绘制中文文本 text = "OpenCV中文显示" position = (50, 100) font_size = 24 color = (0, 0, 255) # BGR颜色:红色 ft.putText(img=img, text=text, org=position, fontHeight=font_size, color=color, thickness=-1, line_type=cv2.LINE_AA, bottomLeftOrigin=True) cv2.imshow("FT Chinese", img) cv2.waitKey(0) ``` --- ### 关键点说明 1. **字体路径**:必须指定系统中存在的TrueType字体文件路径,如`simsun.ttc`(宋体)、`msyh.ttf`(微软雅黑)[^2] 2. **颜色通道**:PIL使用RGB格式,OpenCV使用BGR格式,需通过`cv2.cvtColor`转换 3. **扩展包依赖**:方法二需要安装`opencv-contrib-python`包,且版本需>=3.4.0 ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值