跳到主要内容

二维码

用于定位和读取 QR Code、Data Matrix 等二维编码。

Aztec 二维条码解码​

AZTECDECODE · 可执行

合同接受 AZTEC 类型结果;当前 BarcodeDetector 不支持 Aztec,执行时抛 VISION_OCR_DETECTOR_UNAVAILABLE,不把空结果当作 0 码成功。

签名​

void ConfigureVision()
{
var aztecNode = AZTECDECODE(
downsamplingThreshold: 512,
gradientThreshold: 64,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64,
maximumTotalPayloadUtf8Bytes: 1048576
);
}

输入​

inputImage
  • 输入
  • 必填
  • 约束 仅接受 1 或 3 通道。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

maximumSymbolsint
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 1–64。
允许接受的 Aztec 结果数上限。
maximumPayloadCharactersint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单条解码文本的 Unicode 字符数上限。
maximumPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单条解码文本的 UTF-8 字节数上限。
maximumTotalPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 1048576
  • 约束 范围 1–1048576。
本节点全部接受结果的累计 UTF-8 字节数上限。
downsamplingThresholddouble
  • 输入
  • 可选
  • 默认 512
  • 约束 范围 64–32768。
二维条码检测的降采样阈值。
gradientThresholddouble
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 0.000001–1024。
二维条码检测的梯度阈值。

输出​

outputImage
在接受的 Aztec 四边形上绘制绿色轮廓的 8-bit BGR 图像。
textObservations文本结果列表
Kind=OCR:Aztec 的文本观察;每项包含文本和四个角点。
measurements量测值集合
节点前缀键:symbolCount、payloadUtf8Bytes、rejectedOtherTypeCount、rejectedChecksumCount;Aztec 不做额外校验位检查,最后一项保持 0。

行为​

  • 解码后只接受类型 AZTEC;其他类型和空类型计入 rejectedOtherTypeCount。
  • 接受结果按最小 Y、最小 X、文本序稳定排序,并校验四角点有限、位于图像内且构成非退化凸四边形。
  • 当前检测器对该码制直接 fail-closed,不返回空结果冒充 0 码成功。
  • payload 或结果数量越过显式上限时 fail-closed。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_OCR_DETECTOR_UNAVAILABLE:BarcodeDetector 不支持该码制,禁止把空结果当作 0 码成功。
  • VISION_OCR_INPUT_TYPE_UNSUPPORTED:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_OCR_DEGENERATE_GEOMETRY:解码文本、类型与四边形数量不一致,或四边形无效。
  • VISION_OCR_PAYLOAD_LIMIT_EXCEED:单条或累计 payload 超过显式字符/字节上限。
  • VISION_OCR_RESULT_LIMIT_EXCEED:接受的 Aztec 数量超过 maximumSymbols。

示例​

声明 OCR 族节点。当前检测器对该码制 fail-closed,不会返回空结果冒充成功。

void ConfigureVision()
{
var aztecNode = AZTECDECODE(
downsamplingThreshold: 512,
gradientThreshold: 64,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64,
maximumTotalPayloadUtf8Bytes: 1048576
);
}

Data Matrix 二维条码解码​

DATAMATRIXDECODE · 可执行

合同接受 DATA_MATRIX 类型结果;当前 BarcodeDetector 不支持 Data Matrix,执行时抛 VISION_OCR_DETECTOR_UNAVAILABLE,不把空结果当作 0 码成功。

签名​

void ConfigureVision()
{
var dataMatrixNode = DATAMATRIXDECODE(
downsamplingThreshold: 512,
gradientThreshold: 64,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64,
maximumTotalPayloadUtf8Bytes: 1048576
);
}

输入​

inputImage
  • 输入
  • 必填
  • 约束 仅接受 1 或 3 通道。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

maximumSymbolsint
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 1–64。
允许接受的 Data Matrix 结果数上限。
maximumPayloadCharactersint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单条解码文本的 Unicode 字符数上限。
maximumPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单条解码文本的 UTF-8 字节数上限。
maximumTotalPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 1048576
  • 约束 范围 1–1048576。
本节点全部接受结果的累计 UTF-8 字节数上限。
downsamplingThresholddouble
  • 输入
  • 可选
  • 默认 512
  • 约束 范围 64–32768。
二维条码检测的降采样阈值。
gradientThresholddouble
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 0.000001–1024。
二维条码检测的梯度阈值。

输出​

outputImage
在接受的 Data Matrix 四边形上绘制绿色轮廓的 8-bit BGR 图像。
textObservations文本结果列表
Kind=OCR:DataMatrix 的文本观察;每项包含文本和四个角点。
measurements量测值集合
节点前缀键:symbolCount、payloadUtf8Bytes、rejectedOtherTypeCount、rejectedChecksumCount;Data Matrix 不做额外校验位检查,最后一项保持 0。

行为​

  • 解码后只接受类型 DATA_MATRIX;其他类型和空类型计入 rejectedOtherTypeCount。
  • 接受结果按最小 Y、最小 X、文本序稳定排序,并校验四角点有限、位于图像内且构成非退化凸四边形。
  • 当前检测器对该码制直接 fail-closed,不返回空结果冒充 0 码成功。
  • payload 或结果数量越过显式上限时 fail-closed。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_OCR_DETECTOR_UNAVAILABLE:BarcodeDetector 不支持该码制,禁止把空结果当作 0 码成功。
  • VISION_OCR_INPUT_TYPE_UNSUPPORTED:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_OCR_DEGENERATE_GEOMETRY:解码文本、类型与四边形数量不一致,或四边形无效。
  • VISION_OCR_PAYLOAD_LIMIT_EXCEED:单条或累计 payload 超过显式字符/字节上限。
  • VISION_OCR_RESULT_LIMIT_EXCEED:接受的 Data Matrix 数量超过 maximumSymbols。

示例​

声明 OCR 族节点。当前检测器对该码制 fail-closed,不会返回空结果冒充成功。

void ConfigureVision()
{
var dataMatrixNode = DATAMATRIXDECODE(
downsamplingThreshold: 512,
gradientThreshold: 64,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64,
maximumTotalPayloadUtf8Bytes: 1048576
);
}

MaxiCode 二维条码解码​

MAXICODEDECODE · 可执行

合同接受 MAXI_CODE 类型结果;当前 BarcodeDetector 不支持 MaxiCode,执行时抛 VISION_OCR_DETECTOR_UNAVAILABLE,不把空结果当作 0 码成功。

签名​

void ConfigureVision()
{
var maxiCodeNode = MAXICODEDECODE(
downsamplingThreshold: 512,
gradientThreshold: 64,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64,
maximumTotalPayloadUtf8Bytes: 1048576
);
}

输入​

inputImage
  • 输入
  • 必填
  • 约束 仅接受 1 或 3 通道。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

maximumSymbolsint
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 1–64。
允许接受的 MaxiCode 结果数上限。
maximumPayloadCharactersint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单条解码文本的 Unicode 字符数上限。
maximumPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单条解码文本的 UTF-8 字节数上限。
maximumTotalPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 1048576
  • 约束 范围 1–1048576。
本节点全部接受结果的累计 UTF-8 字节数上限。
downsamplingThresholddouble
  • 输入
  • 可选
  • 默认 512
  • 约束 范围 64–32768。
二维条码检测的降采样阈值。
gradientThresholddouble
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 0.000001–1024。
二维条码检测的梯度阈值。

输出​

outputImage
在接受的 MaxiCode 四边形上绘制绿色轮廓的 8-bit BGR 图像。
textObservations文本结果列表
Kind=OCR:MaxiCode 的文本观察;每项包含文本和四个角点。
measurements量测值集合
节点前缀键:symbolCount、payloadUtf8Bytes、rejectedOtherTypeCount、rejectedChecksumCount;MaxiCode 不做额外校验位检查,最后一项保持 0。

行为​

  • 解码后只接受类型 MAXI_CODE;其他类型和空类型计入 rejectedOtherTypeCount。
  • 接受结果按最小 Y、最小 X、文本序稳定排序,并校验四角点有限、位于图像内且构成非退化凸四边形。
  • 当前检测器对该码制直接 fail-closed,不返回空结果冒充 0 码成功。
  • payload 或结果数量越过显式上限时 fail-closed。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_OCR_DETECTOR_UNAVAILABLE:BarcodeDetector 不支持该码制,禁止把空结果当作 0 码成功。
  • VISION_OCR_INPUT_TYPE_UNSUPPORTED:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_OCR_DEGENERATE_GEOMETRY:解码文本、类型与四边形数量不一致,或四边形无效。
  • VISION_OCR_PAYLOAD_LIMIT_EXCEED:单条或累计 payload 超过显式字符/字节上限。
  • VISION_OCR_RESULT_LIMIT_EXCEED:接受的 MaxiCode 数量超过 maximumSymbols。

示例​

声明 OCR 族节点。当前检测器对该码制 fail-closed,不会返回空结果冒充成功。

void ConfigureVision()
{
var maxiCodeNode = MAXICODEDECODE(
downsamplingThreshold: 512,
gradientThreshold: 64,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64,
maximumTotalPayloadUtf8Bytes: 1048576
);
}

PDF417 二维条码解码​

PDF417DECODE · 可执行

合同接受 PDF_417 类型结果;当前 BarcodeDetector 不支持 PDF417,执行时抛 VISION_OCR_DETECTOR_UNAVAILABLE,不把空结果当作 0 码成功。

签名​

void ConfigureVision()
{
var pdf417Node = PDF417DECODE(
downsamplingThreshold: 512,
gradientThreshold: 64,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64,
maximumTotalPayloadUtf8Bytes: 1048576
);
}

输入​

inputImage
  • 输入
  • 必填
  • 约束 仅接受 1 或 3 通道。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

maximumSymbolsint
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 1–64。
允许接受的 PDF417 结果数上限。
maximumPayloadCharactersint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单条解码文本的 Unicode 字符数上限。
maximumPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单条解码文本的 UTF-8 字节数上限。
maximumTotalPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 1048576
  • 约束 范围 1–1048576。
本节点全部接受结果的累计 UTF-8 字节数上限。
downsamplingThresholddouble
  • 输入
  • 可选
  • 默认 512
  • 约束 范围 64–32768。
二维条码检测的降采样阈值。
gradientThresholddouble
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 0.000001–1024。
二维条码检测的梯度阈值。

输出​

outputImage
在接受的 PDF417 四边形上绘制绿色轮廓的 8-bit BGR 图像。
textObservations文本结果列表
Kind=OCR:Pdf417 的文本观察;每项包含文本和四个角点。
measurements量测值集合
节点前缀键:symbolCount、payloadUtf8Bytes、rejectedOtherTypeCount、rejectedChecksumCount;PDF417 不做额外校验位检查,最后一项保持 0。

行为​

  • 解码后只接受类型 PDF_417;其他类型和空类型计入 rejectedOtherTypeCount。
  • 接受结果按最小 Y、最小 X、文本序稳定排序,并校验四角点有限、位于图像内且构成非退化凸四边形。
  • 当前检测器对该码制直接 fail-closed,不返回空结果冒充 0 码成功。
  • payload 或结果数量越过显式上限时 fail-closed。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_OCR_DETECTOR_UNAVAILABLE:BarcodeDetector 不支持该码制,禁止把空结果当作 0 码成功。
  • VISION_OCR_INPUT_TYPE_UNSUPPORTED:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_OCR_DEGENERATE_GEOMETRY:解码文本、类型与四边形数量不一致,或四边形无效。
  • VISION_OCR_PAYLOAD_LIMIT_EXCEED:单条或累计 payload 超过显式字符/字节上限。
  • VISION_OCR_RESULT_LIMIT_EXCEED:接受的 PDF417 数量超过 maximumSymbols。

示例​

声明 OCR 族节点。当前检测器对该码制 fail-closed,不会返回空结果冒充成功。

void ConfigureVision()
{
var pdf417Node = PDF417DECODE(
downsamplingThreshold: 512,
gradientThreshold: 64,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64,
maximumTotalPayloadUtf8Bytes: 1048576
);
}

QR 码解码​

QrCode · 可执行

检测并解码一个或多个 QR 码,返回带状态轮廓的 BGR 图像、规范化文本观察、四角几何和计数测量。识别族/OCR 族分派器已接通。

签名​

void ConfigureVision()
{
var qrNode = QrCode(
epsX: 0.2,
epsY: 0.1,
maximumPayloadCharacters: 4096,
maximumPayloadUtf8Bytes: 4096,
maximumSymbols: 8
);
}

输入​

inputImage
  • 输入
  • 必填
  • 约束 仅接受 1 或 3 通道。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

maximumSymbolsint
  • 输入
  • 可选
  • 默认 8
  • 约束 范围 1–64。
允许检测的最大 QR 码数量。
maximumPayloadCharactersint
  • 输入
  • 可选
  • 默认 4096
  • 约束 范围 1–65536。
单个已解码文本允许的最大 Unicode 字符数。
maximumPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 4096
  • 约束 范围 1–65536。
单个已解码文本允许的最大 UTF-8 字节数。
epsXdouble
  • 输入
  • 可选
  • 默认 0.2
  • 约束 范围 0.01–1。
QR 检测的横向停止标记 epsilon。
epsYdouble
  • 输入
  • 可选
  • 默认 0.1
  • 约束 范围 0.01–1。
QR 检测的纵向停止标记 epsilon。

输出​

outputImage
在检测四边形上绘制轮廓的 8-bit BGR 图像;绿色表示已解码,红色表示仅检测到。
textObservations文本结果列表
Kind=QRCode 的非空解码文本观察;每项包含字符数、UTF-8 字节数和四个角点。
measurements量测值集合
节点前缀键:detectedCount、decodedCount。

行为​

  • 先检测多个 QR 候选,再逐一解码;检测到但未解码的候选只绘制红色轮廓,不生成文本观察。
  • 解码结果按最小 Y、最小 X、文本序稳定排序。
  • 未检测到 QR 码时返回 BGR 图像、空文本观察以及 detectedCount=0、decodedCount=0。
  • 检测数量、单个文本字符数或 UTF-8 字节数超过显式上限时 fail-closed。
  • 执行前或执行期间收到取消请求时终止并返回取消错误。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • ARGUMENT_EXCEPTION:输入不是 8-bit 灰度/BGR 图像。
  • INVALID_DATA_EXCEPTION:返回的 QR 几何点数量不是四点多边形的整数倍。
  • VISION_PIPELINE_RESOURCE_LIMIT:检测数量、单个文本字符数或单个文本 UTF-8 字节数超过对应显式上限。
  • OPERATION_CANCELED_EXCEPTION:执行前或检测/解码期间取消。

示例​

以运行时默认容差和 payload 预算创建可执行 QR 解码节点。

void ConfigureVision()
{
var qrNode = QrCode(
epsX: 0.2,
epsY: 0.1,
maximumPayloadCharacters: 4096,
maximumPayloadUtf8Bytes: 4096,
maximumSymbols: 8
);
}

QR 码检测与解码​

QRCODEDETECT · 可执行

检测并解码一个或多个 QR 码,以 OCR 文本观察格式返回解码文本和四角几何。识别族/OCR 族分派器已接通。

签名​

void ConfigureVision()
{
var qrOcrNode = QRCODEDETECT(
epsX: 0.2,
epsY: 0.1,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64
);
}

输入​

inputImage
  • 输入
  • 必填
  • 约束 仅接受 1 或 3 通道。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

maximumSymbolsint
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 1–64。
允许检测的最大 QR 码数量。
maximumPayloadCharactersint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单个已解码文本允许的最大 Unicode 字符数。
maximumPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–65536。
单个已解码文本允许的最大 UTF-8 字节数。
epsXdouble
  • 输入
  • 可选
  • 默认 0.2
  • 约束 范围 0.01–1。
QR 检测的横向停止标记 epsilon。
epsYdouble
  • 输入
  • 可选
  • 默认 0.1
  • 约束 范围 0.01–1。
QR 检测的纵向停止标记 epsilon。

输出​

outputImage
在检测四边形上绘制轮廓的 8-bit BGR 图像;绿色表示已解码,红色表示仅检测到。
textObservations文本结果列表
Kind=OCR:QrCode 的非空解码文本观察;每项包含文本和四个角点。
measurements量测值集合
节点前缀键:detectedCount、decodedCount、payloadUtf8Bytes。

行为​

  • 先检测多个 QR 候选,再逐一解码;检测到但未解码的候选只绘制红色轮廓,不生成文本观察。
  • 解码结果按最小 Y、最小 X、文本序稳定排序。
  • 未检测到 QR 码时返回 BGR 图像、空文本观察和三个零测量,不伪造结果。
  • 检测数量或单个 payload 超过显式上限时 fail-closed。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_OCR_INPUT_TYPE_UNSUPPORTED:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_OCR_DEGENERATE_GEOMETRY:返回的 QR 几何点数量不是四点多边形的整数倍。
  • VISION_OCR_PAYLOAD_LIMIT_EXCEED:单个 QR payload 超过字符数或 UTF-8 字节数上限。
  • VISION_OCR_RESULT_LIMIT_EXCEED:检测到的 QR 数量超过 maximumSymbols。

示例​

在当前 Windows 版视觉流程中创建可执行的视觉节点。

void ConfigureVision()
{
var qrOcrNode = QRCODEDETECT(
epsX: 0.2,
epsY: 0.1,
maximumPayloadCharacters: 65536,
maximumPayloadUtf8Bytes: 65536,
maximumSymbols: 64
);
}

QR 码定位​

QrLocalization · 可执行

定位一个或多个 QR 码四边形而不解码文本。识别族/OCR 族分派器已接通。

签名​

void ConfigureVision()
{
var qrLocationNode = QrLocalization(
maximumSymbols: 64
);
}

输入​

inputImage
  • 输入
  • 必填
  • 约束 仅接受 1 或 3 通道。
经入站图连接提供的非空 8-bit 灰度或 BGR 图像。

参数​

maximumSymbolsint
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 1–512。
允许定位的最大 QR 四边形数量。

输出​

outputImage
在定位到的 QR 四边形上绘制绿色轮廓的 8-bit BGR 图像。
measurements量测值集合
节点前缀键:symbolCount、firstCenterX、firstCenterY;无定位时中心为 -1。

行为​

  • 输入先转为灰度,再定位多个 QR 候选四边形;不解码文本,也不生成文本观察。
  • 每四个返回点视为一个 QR 四边形,并在原输入的 BGR 投影上绘制绿色轮廓。
  • 无定位时 symbolCount=0,firstCenterX=-1,firstCenterY=-1。
  • 定位数量超过 maximumSymbols 时以资源上限错误 fail-closed。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:maximumSymbols 不是整数。
  • VISION_PIPELINE_PARAMETER_RANGE:maximumSymbols 不在 1–512。
  • ARGUMENT_EXCEPTION:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_PIPELINE_RESOURCE_LIMIT:定位四边形数量超过 maximumSymbols。

示例​

在当前 Windows 版视觉流程中创建可执行的视觉节点。

void ConfigureVision()
{
var qrLocationNode = QrLocalization(
maximumSymbols: 64
);
}