如何将numpy数组或OpenCV读取的图像传入zxing进行条码检测？

核心说明 #

zxing-python的BarCodeReader.decode()方法默认支持文件路径，但不直接接收numpy数组，需要先将numpy数组（包括OpenCV读取的图像）转换为PIL Image对象（或符合要求的字节流），再传入方法。

1. 传入numpy数组进行条码检测 #

如果你的图像已经是numpy数组格式，按以下步骤处理：

• 若数组是OpenCV读取的BGR格式，先转换为RGB（zxing依赖的底层处理基于RGB色彩空间）
• 将numpy数组转为PIL Image对象
• 传入decode()方法

示例代码：

import zxing
import numpy as np
from PIL import Image

# 假设你已有一个numpy数组形式的图像（比如从其他处理流程得到）
img_np = ...  # 你的numpy数组，uint8类型，形状为(H, W, 3)或(H, W)灰度图

# 处理色彩空间：如果是OpenCV读的BGR，转RGB
if len(img_np.shape) == 3 and img_np.shape[2] == 3:
    img_np = cv2.cvtColor(img_np, cv2.COLOR_BGR2RGB)

# 转为PIL Image
img_pil = Image.fromarray(img_np)

# 调用zxing检测
reader = zxing.BarCodeReader()
qrcode = reader.decode(img_pil)

2. OpenCV读取图像直接传入zxing检测 #

结合OpenCV读取图像的流程，完整代码如下：

import zxing
import cv2
from PIL import Image

reader = zxing.BarCodeReader()
# OpenCV读取图像得到numpy数组
img_cv = cv2.imread(img_path)
# BGR转RGB
img_rgb = cv2.cvtColor(img_cv, cv2.COLOR_BGR2RGB)
# 转为PIL Image
img_pil = Image.fromarray(img_rgb)
# 执行检测
qrcode = reader.decode(img_pil)

# 输出结果（如果检测到的话）
if qrcode:
    print(f"条码内容: {qrcode.parsed}")
    print(f"条码格式: {qrcode.format}")
else:
    print("未检测到条码")

额外说明 #

• 如果是灰度图像（单通道numpy数组），无需转换色彩空间，直接转PIL Image即可
• 也可以将图像转为字节流传入，比如用img_pil.tobytes()，但转PIL Image是最直观且不易出错的方式

内容的提问来源于stack exchange，提问作者SunWenkui