AI一维码/二维码识别

您正在查看最新版本(V2.2.2)的文档。如果您想查阅其他版本的文档,可以点击页面右上角“切换版本”按钮进行切换。

■ 如果您不确定当前使用的产品是哪个版本,请随时联系梅卡曼德技术支持。

功能描述

该步骤可在指定图像区域内识别一维码/二维码,获取码内容、码制、码中心位姿、码轮廓及判定结果等信息。步骤支持的码制包括 Code 128、Code 39、Code 93、EAN、UPC、DM Code、QR Code。

使用该步骤需要“Lite AI”功能授权,请联系梅卡曼德销售获取。

使用场景

该步骤适用于需要读取一维码或二维码信息的视觉检测与机器人引导场景,例如 3C、汽车零部件、医疗、物流仓储等行业中的上下料、分拣和追溯等应用。

输入与输出

输入

输入端口 数据类型 说明

图像

Image

含有一维码/二维码的图像。

物体位姿

Pose2D[]

匹配到的物体在图像中的位置与姿态。

输出

输出端口 数据类型 说明

码内容

String[]

输出识别到的一维码/二维码内容。多个码被识别时,该内容按排序方式输出。

码制

String[]

输出识别到的一维码/二维码的码制,例如 Code 128、QR Code、DM Code 等。多个码被识别时,该内容按排序方式输出。

码中心位姿

Pose2D[]

输出识别到的一维码/二维码中心点在图像中的二维位姿。多个码被识别时,该内容按排序方式输出。

码轮廓

Shape2D/Contour[]

输出识别到的一维码/二维码区域的四个顶点在图像中的坐标,四个顶点连接后表示码的轮廓。多个码被识别时,该内容按排序方式输出。

单个码判定结果

Bool[]

输出每个一维码/二维码的判定结果。若对应码成功读取,则输出 true,否则输出 false。多个码被识别时,该内容按排序方式输出。

全部码判定结果

Bool

输出所有一维码/二维码的整体判定结果。未启用数量判定时,所有单个码均成功读取即输出 true。启用数量判定时,当所有单个码均成功读取,且实际识别数量等于期望数量,才输出 true,否则输出 false。若启用了超时判定,且步骤运行时间超过设定时间仍未完成识别,则输出 false。

检测后的图像

Image

带有检测结果的图像。

参数说明

一维码设置

参数 解释

码制

参数解释:选择需要识别的一维码码制。选择后,步骤将仅识别所选码制的一维码,有助于减少误识别并提升识别效率。

值列表:全选、Code 128、Code 39、Code 93、EAN、UPC

码极性

参数解释:设置待识别码图的明暗极性。根据码和背景的颜色关系选择极性,可减少误识别并提高识别稳定性。

值列表:

  • 白底黑码:识别浅色背景上的深色码。

  • 黑底白码:识别深色背景上的浅色码。

启用形变校正

参数解释:启用后,步骤会在识别过程中校正码的形变,以提高一维码/二维码识别成功率。该校正仅用于识别,不会修改原图。启用后会增加步骤处理耗时。

二维码设置

参数 解释

码制

参数解释:选择需要识别的二维码码制。选择后,步骤将仅识别所选码制的二维码,有助于减少误识别并提升识别效率。

值列表:全选、DM Code、QR Code

码极性

参数解释:设置待识别码图的明暗极性。根据码和背景的颜色关系选择极性,可减少误识别并提高识别稳定性。

值列表:

  • 自动:同时识别浅色背景上的深色码和深色背景上的浅色码。

  • 白底黑码:识别浅色背景上的深色码。

  • 黑底白码:识别深色背景上的浅色码。

启用形变校正

参数解释:启用后,步骤会在识别过程中校正码的形变,以提高一维码/二维码识别成功率。该校正仅用于识别,不会修改原图。启用后会增加步骤处理耗时。

DM Code码尺寸

参数解释:设置待识别的 DM Code 码的尺寸。指定尺寸后,步骤仅按该尺寸进行识别,可提高识别速度并减少误识别。若不确定实际码尺寸,可选择“自动”,步骤将自动判断 DM Code 码尺寸。

值列表:自动、10*10、12*12、14*14、16*16、18*18、20*20、22*22、24*24、26*26、32*32、36*36

QR Code码尺寸

参数解释:设置待识别的 QR Code 码的尺寸。指定尺寸后,步骤仅按该尺寸进行识别,可提高识别速度并减少误识别。若不确定实际码尺寸,可选择“自动”,步骤将自动判断 QR Code 码尺寸。

值列表:自动、21*21、25*25、29*29、33*33, 37*37、41*41

通用设置

参数 解释

排序方式

参数解释:设置多个一维码/二维码识别结果的排序方式。步骤以码中心点坐标为基准对识别结果进行排序。输出端口中的码内容、码制、码中心位姿、码轮廓和单个码判定结果将按照该排序方式输出。

值列表:

  • 先X后Y:先按 X 坐标排序,再按 Y 坐标排序。适用于码主要沿水平方向排列的场景。

  • 先Y后X:先按 Y 坐标排序,再按 X 坐标排序。适用于码主要沿垂直方向排列的场景。

  • 自动网格排序:自动按网格结构排序。根据码中心点的 Y 坐标邻近关系,将多个码自动划分为多行;同一行内按 X 坐标排序,行与行之间按 Y 坐标排序。适用于多个码呈规则行列分布的场景。

校验方式

参数解释:设置一维码/二维码识别结果的校验方式,用于判断识别结果是否符合对应标准或规则。校验结果将通过“单个码判定结果”和“全部码判定结果”端口输出。

启用数量判定

参数解释:启用后,步骤会判断实际识别到的一维码/二维码数量是否等于期望数量,并将该结果作为“全部码判定结果”的判定条件之一。

期望数量

参数解释:设置期望识别到的一维码/二维码数量。

调节说明:勾选启用数量判定后,需设置该参数。

启用超时判定

参数解释:启用后,可设置识别超时时间。若步骤运行时间超过设定时间仍未完成识别,“全部码判定结果”端口输出 false。如果当前时间内识别到了码,则其他端口输出识别到的信息。如果当前时间未识别到码,则其他端口无输出。

超时时间

参数解释:设置单次识别的最长时间,单位为毫秒(ms)。

调节说明:勾选启用超时判定后,需设置该参数。

步骤实际运行时间可能略长于该值,属于正常现象。

可视化设置

参数 解释

字体缩放比例

参数解释:设置可视化图片上的文本字体缩放比例。

可视化检测结果

参数解释:启用后,步骤将输出带有识别结果可视化信息的图像,便于查看一维码/二维码识别结果。

该页面是否有帮助?

可以通过以下方式反馈意见:

我们重视您的隐私

我们使用 cookie 为您在我们的网站上提供最佳体验。继续使用该网站即表示您同意使用 cookie。如果您拒绝,将使用一个单独的 cookie 来确保您在访问本网站时不会被跟踪或记住。