一维码快速识别

## 一维码快速识别

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

## 模块原理
通常一个完整的条码是有两侧静区、起始符、数据符和终止符组成的，此模块是实现对一维码的定位和译码过程。

### 算法工作流
1.在图像中找到一维码的所在区域。
2.如果一维码在图像中倾斜，需要将其旋转到水平方向以便于解码。
3.在定位到的水平方向上，通常选择一行（或多行取平均）的像素数据进行分析。
4.从左到右扫描该行像素，记录从白到黑和从黑到白的跳变点位置（即边缘位置）。
5.计算相邻边缘之间的距离，即为条或空的宽度（以像素为单位）。
6.由于图像可能存在缩放（条码距离摄像头远近不同），测得的宽度值需要归一化到标准单位模块宽度。
7.根据码制的编码规则，从序列开始匹配起始符，从序列末尾匹配终止符。如果匹配成功，则确定数据区的范围。
8.根据码制的编码规则，每个字符由固定数量的条空单元组成。将条空序列按固定单元数分组。
9.将每组条空单元与码制的字符集进行匹配，得到对应的数字或字符。
10.利用校验码（如果有）验证解码的正确性。如果校验失败，可能尝试其他行或重新解码。
11. 将解码出的字符串输出，并可能附带校验结果。

## 使用场景
条码识别模块用于定位和识别指定区域内的条码，容忍目标条码以任意角度旋转以及具有一定量角度倾斜，该模块常应用于物流读码、商品贴标和零件喷码等场景。

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

## 参数配置说明
### 条码类型：
* 自动：根据码的信息自动推断条码的类型。
* Codabar:一种早期高可读性的数字条码。
* Code 39:一种高可靠性的字母数组条码。
* Code 93:一种高效高密度的字母数组条码。
* Code 128:一种极高密度高可靠性功能强大的字符数字条码。
* EAN-8:一种商品标识码，专用于包装面积非常小的零售商品。
* EAN-13：一种全世界最通用最核心的零售商品标识码。
* UPC-A:一种北美地区零售商品的标准条码。
* UPC-E:一种UPC-A零压缩短码版本。
### 单ROI读码个数：
单个检测区域内识别条码的最大个数。
### 前缀字符筛选：
筛选条码识别结果中起始字符为指定字符的条码。
### 字符个数判定：
条码识别结果中字符数量的判定。
### 条码位置筛选：
* 忽略此项：不对识别结果做位置筛选。
* 最上边条码：只保留识别结果中位置在最上方的条码。
* 最下边条码：只保留识别结果中位置在最下方的条码。
* 最左边条码：只保留识别结果中位置在最左边的条码。
* 最右边条码：只保留识别结果中位置在最右边的条码。
### 条码校验码：
* 无：对识别结果不进行校验。
* 开启校验：对识别结果进行校验。
* 校验并输出：对识别结果进行校验并输出校验码。

![](/media/202602/读码高级参数_1770100543.png)
### 最大读码次数
识别不到条码结果时对图像进行预处理并重新识别的最大次数。
### 最小扫描线数
扫描条码时同一个条码最小的扫描线数量，此参数用于剔除图像中可能识别到的虚假条码。
### 线条最小尺寸
条码中最窄的条和空隙的最小宽度，以像素为单位。
### 线条最大尺寸
条码中最窄的条和空隙的最大宽度，以像素为单位。
### 一维码中心筛选
* 中心X：筛选条码中心位置的横坐标位于此范围内的识别结果。
* 中心Y：筛选条码中心位置的纵坐标位于此范围内的识别结果。
### 检测失败时输出字符
未识别到条码时输出字符。
### 显示中心信息
显示所有识别条码的中心坐标以便于中心筛选的查看。

![](/media/202602/条码识别显示设置_1770101971.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或者以上版本的操作系统。

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