opencvputtext中文（opencv 中文显示）

# 简介在计算机视觉领域中，OpenCV 是一个功能强大的开源库，广泛应用于图像处理和计算机视觉任务。其中，`cv2.putText()` 函数是 OpenCV 提供的一个重要工具，用于在图像上添加文本标注。然而，在使用该函数时，如果需要添加中文字符，会遇到编码问题或显示乱码的情况。本文将详细介绍如何正确使用 `cv2.putText()` 来显示中文，并解决相关问题。---## 一、为什么会出现中文乱码？### 1. 编码问题 Python 默认使用的字符编码是 ASCII，而中文字符属于 Unicode 编码范围。当尝试直接在图像上绘制中文时，如果没有正确设置字体支持中文字符，就会出现乱码。### 2. 字体选择 OpenCV 的 `cv2.putText()` 函数依赖于系统默认的字体，而默认字体通常不支持中文字符。因此，必须手动指定支持中文的字体文件。---## 二、解决方案：正确配置中文显示要成功在 OpenCV 图像上显示中文，需要完成以下步骤：### 1. 安装支持中文的字体 首先，需要准备一个支持中文的字体文件（例如 `.ttf` 或 `.otf` 格式的字体）。常见的中文字体有： - 微软雅黑 (`msyh.ttc`) - 宋体 (`simsun.ttc`) - 黑体 (`simhei.ttf`)可以从本地电脑的字体目录（如 Windows 的 `C:\Windows\Fonts`）中找到这些字体文件。### 2. 加载字体并绘制中文以下是使用 OpenCV 和 Python 绘制中文的具体代码示例：```python import cv2 import numpy as np# 创建一个空白图像 img = np.zeros((500, 500, 3), dtype=np.uint8) # 黑色背景# 指定字体路径（请替换为实际路径） font_path = "path/to/your/font/simhei.ttf" # 替换为你的字体文件路径# 加载字体 font = cv2.FONT_HERSHEY_SIMPLEX # 基础字体 font_scale = 1 thickness = 2# 在图像上绘制中文 cv2.putText(img, '你好，OpenCV！', (50, 250), font, font_scale, (0, 255, 0), thickness, cv2.LINE_AA)# 显示图像 cv2.imshow('Image with Chinese Text', img) cv2.waitKey(0) cv2.destroyAllWindows() ```---## 三、详细说明### 1. 关键参数解析 -

`img`

: 表示目标图像。 -

`text`

: 要绘制的文本内容，可以是中文或其他语言。 -

`(x, y)`

: 文本的起始坐标，表示左下角的位置。 -

`font`

: 字体类型，这里使用的是 `cv2.FONT_HERSHEY_SIMPLEX`。 -

`font_scale`

: 字体大小缩放比例。 -

`(b, g, r)`

: 文本颜色，以 BGR 格式表示。 -

`thickness`

: 文本线条粗细。 -

`lineType`

: 线条类型，`cv2.LINE_AA` 表示抗锯齿。### 2. 中文字体加载 由于 OpenCV 本身并不支持直接加载 TTF 文件，可以通过 `Pillow` 库加载字体后传递给 OpenCV 使用。以下是改进版代码：```python from PIL import ImageFont, ImageDraw, Image import cv2 import numpy as np# 创建空白图像 img = np.zeros((500, 500, 3), dtype=np.uint8)# 加载中文字体 font_path = "path/to/your/font/simhei.ttf" font = ImageFont.truetype(font_path, 40)# 将图像转换为 PIL 格式 pil_img = Image.fromarray(cv2.cvtColor(img, cv2.COLOR_BGR2RGB))# 创建绘图对象 draw = ImageDraw.Draw(pil_img)# 在图像上绘制中文 draw.text((50, 250), '你好，OpenCV！', font=font, fill=(0, 255, 0))# 将 PIL 图像转换回 OpenCV 格式 img = cv2.cvtColor(np.array(pil_img), cv2.COLOR_RGB2BGR)# 显示图像 cv2.imshow('Image with Chinese Text', img) cv2.waitKey(0) cv2.destroyAllWindows() ```---## 四、总结通过以上方法，我们可以成功在 OpenCV 图像上绘制中文字符。需要注意的是： 1. 确保字体文件路径正确。 2. 使用支持中文的字体文件（如 SimHei）。 3. 如果直接使用 OpenCV 的 `cv2.putText()`，可能需要结合 Pillow 来加载字体。希望本文能帮助开发者顺利实现中文文本的绘制功能！

简介在计算机视觉领域中，OpenCV 是一个功能强大的开源库，广泛应用于图像处理和计算机视觉任务。其中，`cv2.putText()` 函数是 OpenCV 提供的一个重要工具，用于在图像上添加文本标注。然而，在使用该函数时，如果需要添加中文字符，会遇到编码问题或显示乱码的情况。本文将详细介绍如何正确使用 `cv2.putText()` 来显示中文，并解决相关问题。---

一、为什么会出现中文乱码？

1. 编码问题 Python 默认使用的字符编码是 ASCII，而中文字符属于 Unicode 编码范围。当尝试直接在图像上绘制中文时，如果没有正确设置字体支持中文字符，就会出现乱码。

2. 字体选择 OpenCV 的 `cv2.putText()` 函数依赖于系统默认的字体，而默认字体通常不支持中文字符。因此，必须手动指定支持中文的字体文件。---

二、解决方案：正确配置中文显示要成功在 OpenCV 图像上显示中文，需要完成以下步骤：

1. 安装支持中文的字体 首先，需要准备一个支持中文的字体文件（例如 `.ttf` 或 `.otf` 格式的字体）。常见的中文字体有： - 微软雅黑 (`msyh.ttc`) - 宋体 (`simsun.ttc`) - 黑体 (`simhei.ttf`)可以从本地电脑的字体目录（如 Windows 的 `C:\Windows\Fonts`）中找到这些字体文件。

2. 加载字体并绘制中文以下是使用 OpenCV 和 Python 绘制中文的具体代码示例：```python import cv2 import numpy as np

创建一个空白图像 img = np.zeros((500, 500, 3), dtype=np.uint8)

黑色背景

指定字体路径（请替换为实际路径） font_path = "path/to/your/font/simhei.ttf"

替换为你的字体文件路径

加载字体 font = cv2.FONT_HERSHEY_SIMPLEX

基础字体 font_scale = 1 thickness = 2

在图像上绘制中文 cv2.putText(img, '你好，OpenCV！', (50, 250), font, font_scale, (0, 255, 0), thickness, cv2.LINE_AA)

显示图像 cv2.imshow('Image with Chinese Text', img) cv2.waitKey(0) cv2.destroyAllWindows() ```---

三、详细说明

1. 关键参数解析 - **`img`**: 表示目标图像。 - **`text`**: 要绘制的文本内容，可以是中文或其他语言。 - **`(x, y)`**: 文本的起始坐标，表示左下角的位置。 - **`font`**: 字体类型，这里使用的是 `cv2.FONT_HERSHEY_SIMPLEX`。 - **`font_scale`**: 字体大小缩放比例。 - **`(b, g, r)`**: 文本颜色，以 BGR 格式表示。 - **`thickness`**: 文本线条粗细。 - **`lineType`**: 线条类型，`cv2.LINE_AA` 表示抗锯齿。

2. 中文字体加载 由于 OpenCV 本身并不支持直接加载 TTF 文件，可以通过 `Pillow` 库加载字体后传递给 OpenCV 使用。以下是改进版代码：```python from PIL import ImageFont, ImageDraw, Image import cv2 import numpy as np

创建空白图像 img = np.zeros((500, 500, 3), dtype=np.uint8)

加载中文字体 font_path = "path/to/your/font/simhei.ttf" font = ImageFont.truetype(font_path, 40)

将图像转换为 PIL 格式 pil_img = Image.fromarray(cv2.cvtColor(img, cv2.COLOR_BGR2RGB))

创建绘图对象 draw = ImageDraw.Draw(pil_img)

在图像上绘制中文 draw.text((50, 250), '你好，OpenCV！', font=font, fill=(0, 255, 0))

将 PIL 图像转换回 OpenCV 格式 img = cv2.cvtColor(np.array(pil_img), cv2.COLOR_RGB2BGR)

显示图像 cv2.imshow('Image with Chinese Text', img) cv2.waitKey(0) cv2.destroyAllWindows() ```---

四、总结通过以上方法，我们可以成功在 OpenCV 图像上绘制中文字符。需要注意的是： 1. 确保字体文件路径正确。 2. 使用支持中文的字体文件（如 SimHei）。 3. 如果直接使用 OpenCV 的 `cv2.putText()`，可能需要结合 Pillow 来加载字体。希望本文能帮助开发者顺利实现中文文本的绘制功能！