识别
条码读取(仅QR)
调用与二维码读取共用的检测实现，在图像中定位并解码 QR 码，输出码文本、中心坐标与旋转角并叠加检测框；当前仅支持 QR 码制BarcodeReader · v1.0 · by system
输入参数 3
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 图像 | images | vec_img | [] | 是 | 逐帧参与检测的彩色或灰度图像序列，空帧或空指针原样透传到输出且不产生码条目；整个图像容器缺失时返回 -1 并在运行信息提示输入图像为空 |
| 下采样 | downSample | int | 1 | 否 | 检测前的下采样倍数，默认 1 表示按原图尺寸处理；取值大于 1 且图像尺寸足够大时先按比例缩小再检测以加快速度，检出的中心坐标会还原到原图尺度，取 1 或更小不做缩放 |
| 条码类型 | barcodeType | enum | 0 | 否 | 指定要读取的码制，当前仅提供 QR 一个选项，默认即为 QR；选择其它码制序号时工具直接返回 -1，并在运行信息写明该码制尚未实现，不进行任何检测 |
输出参数 8
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 运行结果 | resultCode | int | — | 否 | 0=完成 QR 码检测解码并输出码数量、文本与几何信息；-1=输入图像容器缺失、选择了未实现的码制或处理过程中发生异常，运行信息写明具体原因 |
| 运行信息 | resultInfo | string | — | 否 | 成功时固定为 Success；失败时给出具体原因，如输入图像为空、所选码制未实现、OpenCV 处理异常或内存不足，便于定位输入连线与码制设置 |
| 图像 | images | vec_img | — | 否 | 逐帧输出的 BGR 可视化图像，帧数与输入一致；检出 QR 码时用绿色线段连出四角定位框，未检出或空帧时为原图拷贝，灰度输入会先转成 BGR 再输出 |
| 码数量 | codeCount | int | — | 否 | 所有帧累计检出的码条目数量，与码文本、中心坐标、角度等序列等长；空帧或未检出码的帧不产生条目，逐帧把结果追加到同一序列后统一输出 |
| 码文本 | codeText | vec_string | — | 否 | 逐条给出的 QR 码解码文本序列，与码数量和各几何量逐项对应；元素顺序按帧序与帧内检出顺序排列，未解码出文本的码不会写入序列 |
| 中心X | codeCenterX | vec_double | — | 否 | 各检出码中心点的横坐标序列，量纲为像素且已还原到原图尺度；由码四个角点横坐标取平均得到，与码文本逐项对应，空帧不产生条目 |
| 中心Y | codeCenterY | vec_double | — | 否 | 各检出码中心点的纵坐标序列，量纲为像素且已还原到原图尺度；由码四个角点纵坐标取平均得到，与码文本逐项对应，空帧不产生条目 |
| 角度 | codeAngle | vec_double | — | 否 | 各检出码的旋转角序列，单位为度，由码上边缘相对水平方向的夹角计算，取值约在 -90 到 90 之间；与码文本逐项对应，空帧不产生条目 |
接入方式
联系与反馈
获取安装包与技术反馈
安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。
- 安装包获取与部署说明
- 界面组态与工具配置
- 功能建议与问题反馈
微信扫码 · 安装包与问题反馈