二维码快速识别

## 二维码快速识别

识别图像中指定区域的二维码信息。

## 模块原理
此模块是实现对二维码的定位和译码过程。

### 算法工作流
1.在图像中根据所选类型二维码的生成规则定位二维码的准确区域。
2.根据码的特性解码并纠错。
3.将解码出的字符串输出。

## 使用场景
二维码识别模块用于定位和识别指定区域内的二维码，容忍目标二维码以任意角度旋转以及具有一定量角度倾斜。

### 前序模块
此模块的前序模块一般为相机采图或者图像预处理模块。

## 参数配置说明
### 二维码类型：
* QR：一种快速响应矩阵码，其特点为三个角上有回字形方块。
* Aztec:一种矩阵式二维码，其特点为中心有一个牛眼式的定位标识。
* ECC200:一种二位矩阵码，其特点为有两个相邻边是实线形成L型边界。
* PDF417:一种堆叠式线性二维码，主要应用于证件和物流领域。
* GS1 QR:一种支持GS1链接语法的QR码，主要应用于零售商品包装。
* GS1 Aztec:一种支持GS1链接语法的Aztec码，主要应用于医疗标签、物流和运算领域。
* GS1 DataMatrix：一种支持GS1链接语法的DataMatrix码，主要应用于工业追溯。
### 单ROI读码个数：
单个检测区域内识别二维码的最大个数。
### 前缀字符筛选：
筛选二维码识别结果中起始字符为指定字符的二维码。
### 字符个数判定：
二维码识别结果中字符数量的判定。
### 二维码位置筛选：
* 忽略此项：不对识别结果做位置筛选。
* 最上边条码：只保留识别结果中位置在最上方的二维码。
* 最下边条码：只保留识别结果中位置在最下方的二维码。
* 最左边条码：只保留识别结果中位置在最左边的二维码。
* 最右边条码：只保留识别结果中位置在最右边的二维码。
### 二维码颜色：
* 任意：识别二维码的颜色为黑色或者白色。
* 黑色：识别二维码的颜色只能是黑色。
* 白色：识别二维码的颜色只能是白色。

![](/media/202602/二维码高级参数_1770278777.png)
### 最大读码次数
识别不到二维码结果时对图像进行预处理并重新识别的最大次数。
### 学习&训练
识别不到二维码时可以点击按钮进行识别参数的学习。
### 超时时间
识别二维码时最大的检测时间。
### 读码级别
* 标准：使用标准模式的参数进行识别。
* 增强：使用增强模式的参数进行识别。
* 最大：使用最大模式的参数进行识别。
* 特级：使用图像增强和最大模式的参数进行识别。
### 二维码中心筛选
* 中心X：筛选二维码中心位置的横坐标位于此范围内的识别结果。
* 中心Y：筛选二维码中心位置的纵坐标位于此范围内的识别结果。
### 检测失败时输出字符
未识别到二维码时输出字符。
### 显示中心信息
显示所有识别二维码的中心坐标以便于中心筛选的查看。

![](/media/202602/二维码显示设置_1770280361.png)
### 显示设置
设置ROI，二维码区域和二维码信息显示相关参数

![](/media/202602/位置调整_1770106939.png)
### 位置调整
手动调整ROI相关参数。

### ROI类型
* 斜矩形：既可以移动和改变大小也可以旋转角度的矩形，其角度范围为0至360度的任意值。
### ROI模式
* 单个ROI：只有一个二维码识别检测区域。
* 阵列ROI：支持多个二维码识别区域。
### ROI来源
* 手动ROI：此模式下本模块可以直接设置ROI相关参数。
* 引用ROI：此模式下本模块不能修改ROI相关参数，只能从上方模块引入。
### 位置修正
* 不启用：不对设置的ROI进行位置调整。
* 姿态修正：根据输入的此值对设置的ROI进行位置调整。

## 输出说明
### 运行结果
条码识别是否成功。
### 二维码个数
识别的二维码数量。
### 字符个数
识别的二维码结果中字符数量。
### 字符输出
识别的二维码结果。
### 二维码区域数组
识别的二维码所在图像区域。
### ROI个数
ROI的数量。
### ROI状态数组
每个ROI是否识别到二维码。

## 注意事项
1.使用此模块时请将获取MVTec授权的halcon.dll和halconc.dll放到软件发布包，然后重新打开软件即可使用。
2.此模块只能用于window10或者以上版本的操作系统。
3.ECC200包含用于结构或控制目的的不可见字符，可以使用lua脚本OUT1 = IN1:gsub("[\0-\31]", "")移除这些字符。

点击此处跳转到对应的中文说明书文章页:&nbsp;[2D Barcode Quick Recognition](/doc/473)