缺陷检测
用于检测表面、边缘、颗粒和参考图差异,适合在线质量检查。
斑点缺陷检测
BLOBDEFECT · 可执行
以连通域分析和面积筛选标记斑点缺陷。主目录已聚合本算子,ExecuteNode 主链可分派。
签名
var blob = BLOBDEFECT(areaMin: 16, threshold: 128, blurKsize: 3, morphCloseKsize: 5);
输入
inputImage- 经入站图连接提供的非空 8-bit 灰度或 BGR 图像。
参数
areaMindouble- 保留连通域的面积下限。
areaMaxdouble- 保留连通域的面积上限。
thresholddouble- 灰度二值化阈值。
blurKsizeint- 高斯模糊核边长。
morphCloseKsizeint- 椭圆形态学闭运算核边长。
输出
outputImage- 8-bit 三通道 BGR 图像,符合面积范围的缺陷连通域以红色高亮。
measurements量测值集合- 键为 {nodeId}.regionCount、{nodeId}.totalArea、{nodeId}.labelCount,值均为有限数。
行为
- 将输入转灰度后依次执行高斯模糊、固定阈值二值化和椭圆核闭运算。
- 视觉运行时.ConnectedComponentsWithStats 按 8 邻接提取连通域,背景标签不计入缺陷。
- 仅保留面积落在 [areaMin, areaMax] 内的区域,并写入接受数量、总面积和背景外标签总数。
- 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。
错误与限制
VISION_DEFECT_PARAMETER_OUT_OF_RANGE:areaMin/areaMax 关系无效,或 blurKsize、morphCloseKsize 不是允许范围内的奇数。VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。VISION_DEFECT_DEGENERATE_GEOMETRY:连通域分析没有返回有效标签。VISION_DEFECT_RESULT_LIMIT_EXCEEDED:背景外连通域数量超过 1024。
示例
按面积范围筛选斑点缺陷。
var blob = BLOBDEFECT(areaMin: 50, areaMax: 5000, threshold: 128, blurKsize: 3, morphCloseKsize: 5);
裂纹线段检测
CRACKDETECT · 可执行
以 Canny 和概率霍夫变换检测线段状裂纹。主目录已聚合本算子,ExecuteNode 主链可分派。
签名
var crack = CRACKDETECT(cannyLow: 50, cannyHigh: 150, minLineLength: 20, maxLineGap: 5, threshold: 30, blurKsize: 3);
输入
inputImage- 经入站图连接提供的非空 8-bit 灰度或 BGR 图像。
参数
cannyLowdouble- Canny 低阈值。
cannyHighdouble- Canny 高阈值。
minLineLengthdouble- HoughLinesP 接受的最小线段长度。
maxLineGapdouble- 同一线段内允许的最大间隙。
thresholdint- HoughLinesP 累加器投票阈值。
blurKsizeint- 高斯模糊核边长。
输出
outputImage- 8-bit 三通道 BGR 图像,检测到的线段以红色绘制。
measurements量测值集合- 键为 {nodeId}.lineCount、{nodeId}.totalLength、{nodeId}.maxLength,值均为有限数。
行为
- 将输入转灰度并经高斯模糊后执行 Canny 边缘检测。
- 视觉运行时.HoughLinesP 按投票阈值、最小长度和最大间隙检测线段状裂纹。
- 实现把每条线段以红色叠加,并写入线段数量、总长度和最大长度。
- 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。
错误与限制
VISION_DEFECT_PARAMETER_OUT_OF_RANGE:Canny 阈值关系、线段长度/间隙、投票阈值或模糊核不满足合同。VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。VISION_DEFECT_RESULT_LIMIT_EXCEEDED:HoughLinesP 返回的线段数量超过 8192。
示例
检测线段状裂纹。
var crack = CRACKDETECT(cannyLow: 50, cannyHigh: 150, minLineLength: 20, maxLineGap: 10, threshold: 80, blurKsize: 3);
边缘轮廓缺陷检测
EDGEDEFECT · 可执行
以 Canny 外轮廓及面积筛选标记边缘缺陷。主目录已聚合本算子,ExecuteNode 主链可分派。
签名
var edge = EDGEDEFECT(cannyLow: 50, cannyHigh: 150, minContourArea: 16);
输入
inputImage- 经入站图连接提供的非空 8-bit 灰度或 BGR 图像。
参数
cannyLowdouble- Canny 低阈值。
cannyHighdouble- Canny 高阈值。
minContourAreadouble- 保留轮廓的面积下限。
maxContourAreadouble- 保留轮廓的面积上限。
输出
outputImage- 8-bit 三通道 BGR 图像,符合面积范围的边缘轮廓以红色绘制。
measurements量测值集合- 键为 {nodeId}.contourCount、{nodeId}.totalLength、{nodeId}.totalArea,值均为有限数。
行为
- 将输入转灰度后执行 视觉运行时.Canny,并以 External/ApproxSimple 模式调用 视觉运行时.FindContours。
- 仅保留面积落在 [minContourArea, maxContourArea] 内的轮廓。
- 实现把接受轮廓以红色叠加,并写入轮廓数量、总周长和总面积。
- 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。
错误与限制
VISION_DEFECT_PARAMETER_OUT_OF_RANGE:Canny 阈值未满足 0 <= cannyLow < cannyHigh,或轮廓面积上下限关系无效。VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。VISION_DEFECT_RESULT_LIMIT_EXCEEDED:FindContours 返回的轮廓数量超过 4096。
示例
按面积范围筛选边缘轮廓缺陷。
var edge = EDGEDEFECT(cannyLow: 50, cannyHigh: 150, minContourArea: 10, maxContourArea: 10000);
微粒轮廓计数
PARTICLECOUNT · 可执行
以 Otsu 二值化、外轮廓与面积筛选统计微粒。主目录已聚合本算子,ExecuteNode 主链可分派。
签名
var particles = PARTICLECOUNT(threshold: 128, minContourArea: 1, maxContourArea: 10000, blurKsize: 3);
输入
inputImage- 经入站图连接提供的非空 8-bit 灰度或 BGR 图像。
参数
thresholddouble- 传给 Otsu 二值化调用的初始阈值;实际分割阈值由 Otsu 计算。
minContourAreadouble- 计入微粒统计的轮廓面积下限。
maxContourAreadouble- 计入微粒统计的轮廓面积上限。
blurKsizeint- 高斯模糊核边长。
输出
outputImage- 8-bit 三通道 BGR 图像,符合面积范围的微粒轮廓以绿色绘制并以红点标出中心。
measurements量测值集合- 键为 {nodeId}.particleCount、{nodeId}.totalArea、{nodeId}.avgArea,值均为有限数。
行为
- 将输入转灰度并经高斯模糊后执行 Binary + Otsu 二值化;传入 threshold 被读取,但 Otsu 决定实际分割阈值。
- 视觉运行时.FindContours 以 External/ApproxSimple 模式提取外轮廓,并按面积上下限筛选微粒。
- 实现把轮廓以绿色叠加、有效中心以红点标记,并写入数量、总面积和平均面积。
- 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。
错误与限制
VISION_DEFECT_PARAMETER_OUT_OF_RANGE:阈值、轮廓面积上下限关系或模糊核不满足合同。VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。VISION_DEFECT_RESULT_LIMIT_EXCEEDED:FindContours 返回的微粒候选数量超过 65536。
示例
统计面积范围内的微粒轮廓。
var particles = PARTICLECOUNT(threshold: 128, minContourArea: 5, maxContourArea: 500, blurKsize: 3);
表面纹理异常检测
SURFACEDEFECT · 可执行
以 Laplacian 响应的自适应阈值标记表面纹理异常。主目录已聚合本算子,ExecuteNode 主链可分派。
签名
var surface = SURFACEDEFECT(laplacianKsize: 3, blurKsize: 3, sensitivity: 3.0, threshold: 32);
输入
inputImage- 经入站图连接提供的非空 8-bit 灰度或 BGR 图像。
参数
laplacianKsizeint- Laplacian 核边长。
blurKsizeint- 高斯模糊核边长。
sensitivitydouble- 自适应阈值中标准差的倍率。
thresholddouble- schema 声明的阈值参数;当前计算使用 mean + sensitivity × standardDeviation,不消费该值。
输出
outputImage- 8-bit 三通道 BGR 图像,自适应阈值筛出的纹理异常轮廓以黄色绘制。
measurements量测值集合- 键为 {nodeId}.roughness、{nodeId}.adaptiveThreshold、{nodeId}.regionCount、{nodeId}.totalArea,值均为有限数。
行为
- 将输入转灰度并经高斯模糊后执行 CV_64F Laplacian,再转换为 8-bit 绝对响应图。
- 执行器以 mean + sensitivity × standardDeviation 计算 adaptiveThreshold;已声明并读取的 threshold 参数当前不参与计算。
- 视觉运行时.FindContours 提取全部异常外轮廓,以黄色叠加,并写入粗糙度、自适应阈值、区域数量和总面积。
- 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。
错误与限制
VISION_DEFECT_PARAMETER_OUT_OF_RANGE:Laplacian/模糊核不是允许范围内的奇数,或 sensitivity 不是正有限值。VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。VISION_DEFECT_RESULT_LIMIT_EXCEEDED:FindContours 返回的异常区域数量超过 1024。
示例
标记表面纹理异常;threshold 当前无运行效果。
var surface = SURFACEDEFECT(laplacianKsize: 3, blurKsize: 3, sensitivity: 1.5, threshold: 50);
参考图差异检测
TEMPLATEDEFECT · 可执行
以参考灰度图和 Absdiff 标记差异区域。主目录已聚合本算子,referencePath 为必需字符串参数。
签名
var template = TEMPLATEDEFECT(referencePath: "golden.png", threshold: 32, blurKsize: 3, minContourArea: 8);
输入
inputImage- 经入站图连接提供的非空 8-bit 灰度或 BGR 图像。
参数
referencePathstring- 授权资源根内的参考图路径;相对路径以视觉资源授权根为基准。
thresholddouble- 参考图差值的二值化阈值。
blurKsizeint- 输入图像高斯模糊核边长。
minContourAreadouble- 保留差异轮廓的面积下限。
输出
outputImage- 8-bit 三通道 BGR 图像,符合最小面积的参考图差异轮廓以品红色绘制。
measurements量测值集合- 键为 {nodeId}.defectCount、{nodeId}.totalArea、{nodeId}.maxArea,值均为有限数。
行为
- 以灰度模式加载 referencePath 指向的参考图,并要求其尺寸与 input 完全一致。
- 输入图先经高斯模糊,再以 视觉运行时.Absdiff 计算逐像素差异并执行固定阈值二值化。
- 视觉运行时.FindContours 以 External/ApproxSimple 模式提取差异外轮廓,仅把面积不小于 minContourArea 的区域以品红色叠加,并写入数量、总面积和最大面积。
- 取消令牌在原生处理前后被检查,取消时抛出 OperationCanceledException。
错误与限制
VISION_DEFECT_PARAMETER_OUT_OF_RANGE:referencePath 缺失,或阈值、模糊核、最小轮廓面积不满足合同。VISION_DEFECT_INPUT_TYPE_UNSUPPORTED:输入为空、不是 CV_8U,或通道数不是 1/3。VISION_DEFECT_DETECTOR_UNAVAILABLE:referencePath 指向的参考图无法以灰度图加载。VISION_DEFECT_DEGENERATE_GEOMETRY:参考图尺寸与 input 不一致。VISION_DEFECT_RESULT_LIMIT_EXCEEDED:差异轮廓数量超过 1024。
示例
与授权根内参考图做差异检测。
var template = TEMPLATEDEFECT(referencePath: "golden.png", threshold: 30, blurKsize: 5, minContourArea: 100);