全类型读码

## 全类型读码

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

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

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

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

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

## 参数配置说明
### 条码类型：
* All：根据码的信息自动推断条码的类型。
* OneD:一种支持GS1链接语法的各类一维码。
* QR Code:一种快速响应矩阵码，其特点为三个角上有回字形方块。
* Code 39:一种高可靠性的字母数组条码。
* Code 128:一种极高密度高可靠性功能强大的字符数字条码。
* Code 93:一种高效高密度的字母数组条码。
* Codabar:一种早期高可读性的数字条码。
* Interleaved 2 of 5:一种遵循GS1链接语法的产品外箱条码。
* Industrial 2 of 5:一种早期、简单的纯数字一维码。
* EAN-13：一种全世界最通用最核心的零售商品标识码。
* EAN-8:一种商品标识码，专用于包装面积非常小的零售商品。
* UPC-A:一种北美地区零售商品的标准条码。
* UPC-E:一种UPC-A零压缩短码版本。
* PDF417:一种堆叠式线性二维码，主要应用于证件和物流领域。
* DataMatrix:一种二位矩阵码，其特点为有两个相邻边是实线形成L型边界。
* Aztec:一种矩阵式二维码，其特点为中心有一个牛眼式的定位标识。
* Code 39 Extended:一种Code 39扩展版本的条码。
* Maxicode:一种专用于工业和物流运输的二维码。
* GS1 Databar:一种遵循GS1链接语法的Databar条码。
* PatchCode:一种特殊用途的条码不用于存储数据。
* GS1 Composite:一种将一维码和二维码组合的复合条码。
* Postal Code:一种专用于邮件分拣的条码。
* DotCode:一种专为工业喷印设计的二维码。
* MSI Code:一种早期、连续型的纯数字条码。
### 单ROI读码个数：
单个检测区域内识别条码的最大个数。
### 前缀字符筛选：
筛选条码识别结果中起始字符为指定字符的条码。
### 字符个数判定：
条码识别结果中字符数量的判定。
### 条码位置筛选：
* 忽略此项：不对识别结果做位置筛选。
* 最上边条码：只保留识别结果中位置在最上方的条码。
* 最下边条码：只保留识别结果中位置在最下方的条码。
* 最左边条码：只保留识别结果中位置在最左边的条码。
* 最右边条码：只保留识别结果中位置在最右边的条码。
### 读码级别：
* 极速：使用极速模式的参数进行识别。
* 标准：使用标准模式的参数进行识别。
* 最大：使用最大模式的参数进行识别。

![](/media/202602/全类型读码-高级参数_1770623311.png)
### 超时时间
识别条码的最大检测时间。
### 软件许可证
使用此模块时算法厂家的授权码。
### 一维码中心筛选
* 中心X：筛选条码中心位置的横坐标位于此范围内的识别结果。
* 中心Y：筛选条码中心位置的纵坐标位于此范围内的识别结果。
### 检测失败时输出字符
未识别到条码时输出字符。
### 显示中心信息
显示所有识别条码的中心坐标以便于中心筛选的查看。

![](/media/202602/全类型读码-显示设置_1770623450.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.使用此模块时请将dynamsoft_c_package.dll和Dynamsoft软件的DynamsoftBarcodeReaderx64.dll等库文件放到软件发布包，然后重新打开软件即可使用。
2.此模块只能用于window10或者以上版本的操作系统。
3.DataMatrix包含用于结构或控制目的的不可见字符，可以使用lua脚本OUT1 = IN1:gsub("[\0-\31]", "")移除这些字符。

点击此处跳转到对应的中文说明书文章页:&nbsp;[All Type Code Reading](/doc/484)