跳到主要内容

一维码

用于定位和读取生产现场常见的一维条码。

Code 128 条码解码​

BARCODECODE128 · 可执行

仅接受 CODE_128 类型的一维条码;OCR 族合同与 OCRDispatcher 已接通。

签名​

var code128Node = BARCODECODE128(downsamplingThreshold: 512, gradientThreshold: 64, maximumPayloadCharacters: 65536, maximumPayloadUtf8Bytes: 65536, maximumSymbols: 64, maximumTotalPayloadUtf8Bytes: 1048576);

输入​

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

参数​

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

输出​

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

行为​

  • BarcodeDetector 返回结果后只接受类型 CODE_128;其他类型和空类型计入 rejectedOtherTypeCount。
  • 接受结果按最小 Y、最小 X、文本序稳定排序,并校验四角点有限、位于图像内且构成非退化凸四边形。
  • 未检测到匹配码时返回 BGR 图像、空文本观察和零计数,不伪造内容。
  • payload 或结果数量越过显式上限时 fail-closed。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_OCR_INPUT_TYPE_UNSUPPORTED:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_OCR_DEGENERATE_GEOMETRY:检测器返回的文本、类型与四边形数量不一致,或四边形无效。
  • VISION_OCR_PAYLOAD_LIMIT_EXCEED:单条或累计 payload 超过显式字符/字节上限。
  • VISION_OCR_RESULT_LIMIT_EXCEED:接受的 CODE_128 数量超过 maximumSymbols。

示例​

按 OCR/识别族合同声明节点。

var code128Node = BARCODECODE128(downsamplingThreshold: 512, gradientThreshold: 64, maximumPayloadCharacters: 65536, maximumPayloadUtf8Bytes: 65536, maximumSymbols: 64, maximumTotalPayloadUtf8Bytes: 1048576);

一维码解码​

BarcodeDecode · 可执行

检测并解码 EAN-8、EAN-13 与 UPC-A 一维条码,输出规范化文本观察、四角几何和有界测量。

签名​

var barcodeNode = BarcodeDecode(downsamplingThreshold: 512, gradientThreshold: 64, maximumPayloadCharacters: 4096, maximumPayloadUtf8Bytes: 4096, maximumSymbols: 8, maximumTotalPayloadUtf8Bytes: 65536);

输入​

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

参数​

maximumSymbolsint
  • 输入
  • 可选
  • 默认 8
  • 约束 范围 1–64。
允许返回的非 QR 条码数上限。
maximumPayloadCharactersint
  • 输入
  • 可选
  • 默认 4096
  • 约束 范围 1–16384。
单个条码文本的字符数上限。
maximumPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 4096
  • 约束 范围 1–16384。
单个条码文本的 UTF-8 字节数上限。
maximumTotalPayloadUtf8Bytesint
  • 输入
  • 可选
  • 默认 65536
  • 约束 范围 1–262144。
本节点全部接受结果的累计 UTF-8 字节数上限。
downsamplingThresholddouble
  • 输入
  • 可选
  • 默认 512
  • 约束 范围 64–32768。
传给 BarcodeDetector 的降采样阈值。
gradientThresholddouble
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 0.000001–1024。
传给 BarcodeDetector 的梯度阈值。

输出​

outputImage
在接受条码四边形上绘制绿色轮廓的 8-bit BGR 图像。
textObservations文本结果列表
Kind=Barcode:EAN_8、Barcode:EAN_13 或 Barcode:UPC_A 的文本观察;每项包含文本、UTF-8 计数和四个角点。
measurements量测值集合
节点前缀键:symbolCount、payloadUtf8Bytes、rejectedQrCount。当前实现不接受 QR,rejectedQrCount 保持 0。

行为​

  • 仅接受检测器返回的 EAN_8、EAN_13 与 UPC_A;Code 128 和二维码不属于本算子合同。
  • 首位为 0 的 13 位 EAN-13 规范化为 12 位 UPC-A,再执行位数、ASCII 数字与 GS1 Mod-10 校验。
  • 结果按最小 Y、最小 X、类型和文本稳定排序;四角点必须有限、位于图像内且构成非退化凸四边形。
  • 未检测到条码时返回 BGR 图像、空文本观察和零计数;不修改输入图像。
  • payload、输入像素或结果数量越过显式上限时 fail-closed。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_WAVEB_INPUT_TYPE_UNSUPPORTED:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_WAVEB_INPUT_LIMIT_EXCEEDED:输入像素数超过 4194304。
  • VISION_WAVEB_RESULT_LIMIT_EXCEEDED:接受的条码数超过 maximumSymbols。
  • VISION_WAVEB_PAYLOAD_LIMIT_EXCEEDED:单条或累计 payload 超过显式字符/字节上限。
  • VISION_WAVEB_DEGENERATE_GEOMETRY:检测器返回数组不一致、类型超出合同、文本/校验位非法,或四边形无效。

示例​

以运行时默认阈值和 payload 预算创建可执行的 EAN/UPC 条码解码节点。

var barcodeNode = BarcodeDecode(downsamplingThreshold: 512, gradientThreshold: 64, maximumPayloadCharacters: 4096, maximumPayloadUtf8Bytes: 4096, maximumSymbols: 8, maximumTotalPayloadUtf8Bytes: 65536);

EAN-13 条码解码​

BARCODEEAN13 · 可执行

仅接受 13 位、首位非 0 且 GS1 Mod-10 校验正确的 EAN-13 条码;OCR 族分派器已接通。

签名​

var ean13Node = BARCODEEAN13(downsamplingThreshold: 512, gradientThreshold: 64, maximumPayloadCharacters: 65536, maximumPayloadUtf8Bytes: 65536, maximumSymbols: 64, maximumTotalPayloadUtf8Bytes: 1048576);

输入​

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

参数​

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

输出​

outputImage
在接受的 EAN-13 四边形上绘制绿色轮廓的 8-bit BGR 图像。
textObservations文本结果列表
Kind=OCR:BarcodeEan13 的文本观察;每项包含文本和四个角点。
measurements量测值集合
节点前缀键:symbolCount、payloadUtf8Bytes、rejectedOtherTypeCount、rejectedChecksumCount。

行为​

  • BarcodeDetector 返回结果后只接受类型 EAN_13;其他类型和空类型计入 rejectedOtherTypeCount。
  • 文本必须恰为 13 位 ASCII 数字、首位不能为 0,并通过 GS1 Mod-10 校验;校验失败计入 rejectedChecksumCount 后丢弃。
  • 接受结果按最小 Y、最小 X、文本序稳定排序,并校验四角点有限、位于图像内且构成非退化凸四边形。
  • 未检测到合规码时返回 BGR 图像、空文本观察和零接受计数,不伪造内容。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_OCR_INPUT_TYPE_UNSUPPORTED:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_OCR_DEGENERATE_GEOMETRY:检测器返回的文本、类型与四边形数量不一致,或四边形无效。
  • VISION_OCR_PAYLOAD_LIMIT_EXCEED:单条或累计 payload 超过显式字符/字节上限。
  • VISION_OCR_RESULT_LIMIT_EXCEED:接受的 EAN-13 数量超过 maximumSymbols。

示例​

按 OCR 族合同声明节点。

var ean13Node = BARCODEEAN13(downsamplingThreshold: 512, gradientThreshold: 64, maximumPayloadCharacters: 65536, maximumPayloadUtf8Bytes: 65536, maximumSymbols: 64, maximumTotalPayloadUtf8Bytes: 1048576);

一维条码定位​

BarcodeLocalize · 可执行

调用 BarcodeDetector 获取条码四边形并输出定位测量,不公开解码文本;识别族 BarcodeLocalize 已接通。

签名​

var barcodeRegionNode = BarcodeLocalize(downsamplingThreshold: 512, gradientThreshold: 64, maximumSymbols: 64);

输入​

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

参数​

maximumSymbolsint
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 1–64。
允许定位的最大条码四边形数量。
downsamplingThresholddouble
  • 输入
  • 可选
  • 默认 512
  • 约束 范围 64–32768。
传给 BarcodeDetector 的降采样阈值。
gradientThresholddouble
  • 输入
  • 可选
  • 默认 64
  • 约束 范围 0.000001–1024。
传给 BarcodeDetector 的梯度阈值。

输出​

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

行为​

  • 内部调用 BarcodeDetector.DetectAndDecode,但丢弃文本与类型,仅使用每四点一组的四边形。
  • 先把输入转为灰度执行检测,再在原输入的 BGR 投影上绘制轮廓;不修改输入图像。
  • 无检测结果时 symbolCount=0,firstCenterX/firstCenterY=-1。
  • 定位数超过 maximumSymbols 时以资源上限错误 fail-closed。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_PIPELINE_RESOURCE_LIMIT:定位四边形数量超过 maximumSymbols。

示例​

按识别族合同声明节点。

var barcodeRegionNode = BarcodeLocalize(downsamplingThreshold: 512, gradientThreshold: 64, maximumSymbols: 64);

UPC-A 条码解码​

BARCODEUPCA · 可执行

仅接受 12 位且 GS1 Mod-10 校验正确的 UPC-A 条码;OCR 族分派器已接通。

签名​

var upcNode = BARCODEUPCA(downsamplingThreshold: 512, gradientThreshold: 64, maximumPayloadCharacters: 65536, maximumPayloadUtf8Bytes: 65536, maximumSymbols: 64, maximumTotalPayloadUtf8Bytes: 1048576);

输入​

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

参数​

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

输出​

outputImage
在接受的 UPC-A 四边形上绘制绿色轮廓的 8-bit BGR 图像。
textObservations文本结果列表
Kind=OCR:BarcodeUpcA 的文本观察;每项包含文本和四个角点。
measurements量测值集合
节点前缀键:symbolCount、payloadUtf8Bytes、rejectedOtherTypeCount、rejectedChecksumCount。

行为​

  • BarcodeDetector 返回结果后只接受类型 UPC_A;其他类型和空类型计入 rejectedOtherTypeCount。
  • 文本必须恰为 12 位 ASCII 数字并通过 GS1 Mod-10 校验;校验失败计入 rejectedChecksumCount 后丢弃。
  • 接受结果按最小 Y、最小 X、文本序稳定排序,并校验四角点有限、位于图像内且构成非退化凸四边形。
  • 未检测到合规码时返回 BGR 图像、空文本观察和零接受计数,不伪造内容。

错误与限制​

  • VISION_PIPELINE_PARAMETER_TYPE:整数或浮点参数格式错误。
  • VISION_PIPELINE_PARAMETER_RANGE:任一参数越出 参数合同 范围。
  • VISION_OCR_INPUT_TYPE_UNSUPPORTED:输入为空、不是 8-bit,或不是灰度/BGR 图像。
  • VISION_OCR_DEGENERATE_GEOMETRY:检测器返回的文本、类型与四边形数量不一致,或四边形无效。
  • VISION_OCR_PAYLOAD_LIMIT_EXCEED:单条或累计 payload 超过显式字符/字节上限。
  • VISION_OCR_RESULT_LIMIT_EXCEED:接受的 UPC-A 数量超过 maximumSymbols。

示例​

按 OCR/识别族合同声明节点。

var upcNode = BARCODEUPCA(downsamplingThreshold: 512, gradientThreshold: 64, maximumPayloadCharacters: 65536, maximumPayloadUtf8Bytes: 65536, maximumSymbols: 64, maximumTotalPayloadUtf8Bytes: 1048576);