测量

BLOB分析

对图像做二值化与连通域分析，按面积、圆形度和边界条件筛选 Blob，输出质心、周长、角度及外接框等特征
BlobAnalysis · v1.0 · by system

输入参数 15

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待检测的图像序列，逐帧转灰度并做连通域分析；空帧或无法转灰度的帧原样透传，不参与统计也不影响返回码
矩形ROI	`roiRect`	roi	[]	否	矩形检测区域，与其他 ROI 条目合并后逐个分析；全部为空时按整幅图像作为检测范围
圆ROI	`roiCircle`	roi	[]	否	圆形检测区域，与其他 ROI 条目一并参与分析；全部为空时按整幅图像处理
椭圆ROI	`roiEllipse`	roi	[]	否	椭圆检测区域，与其他 ROI 条目一并参与分析；全部为空时按整幅图像处理
多边形ROI	`roiPolygon`	roi	[]	否	多边形检测区域，与其他 ROI 条目一并参与分析；全部为空时按整幅图像处理
二值化模式	`thresholdMode`	enum	0	否	生成二值图所依据的阈值方式，可选固定阈值、OTSU 或区间阈值；各选项的实际效果见释义
阈值低	`thresholdLow`	int	128	否	固定阈值模式的分割下限，灰度大于该值的像素判为目标；OTSU 模式下该值不生效，区间阈值模式下作为区间下限
阈值高	`thresholdHigh`	int	255	否	区间阈值模式的上限，与阈值低共同决定保留的灰度区间；固定阈值与 OTSU 模式下该值不生效
最小面积	`minArea`	double	10	否	保留 Blob 的最小像素面积，低于该值的连通域被丢弃；与最大面积按填入值直接比较，不会自动交换大小
最大面积	`maxArea`	double	100000	否	保留 Blob 的最大像素面积，高于该值的连通域被丢弃；若设得比最小面积更小，会导致几乎没有 Blob 通过
最小圆形度	`minCircularity`	double	0	否	保留 Blob 的最小圆形度，低于该值的目标被剔除；与最大圆形度会自动整理成下界和上界再比较
最大圆形度	`maxCircularity`	double	1	否	保留 Blob 的最大圆形度，高于该值的目标被剔除；上下限顺序颠倒时内部会自动交换
连通性	`connectivity`	enum	0	否	判定相邻像素是否属于同一连通域的方式，可选 4 连通或 8 连通；各选项含义见释义
排除边界	`excludeBorder`	bool	true	否	开启后紧贴 ROI 或图像边缘的 Blob 不进入结果；关闭时贴边目标也参与统计，默认开启
最大Blob数	`maxBlobs`	int	100	否	每张图像最多输出的 Blob 数量，达到上限即停止收集并按图像独立计数；设为 0 或负数时按极大上限处理，默认 100

输出参数 14

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功完成连通域分析并输出各特征向量；-1=输入图像容器缺失或处理过程异常，此时不产出统计结果
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因，如输入图像为空、OpenCV 处理异常或内存不足，便于排查连线与参数
图像	`images`	vec_img	—	否	逐帧输出绘制了绿色外接框与红色质心的彩色图像，帧数与输入一致；空帧或转灰度失败的帧原样透传
Blob数	`blobCount`	int	—	否	全部图像与 ROI 中累计检出的 Blob 总数，与各特征向量及 Blob 区域的长度一致；无合格目标时为 0
面积	`area`	vec_double	—	否	各 Blob 的像素面积，即连通域内像素个数，单位像素；按检出顺序与其余特征向量一一对应
中心X	`centerX`	vec_double	—	否	各 Blob 质心的 X 坐标，采用整图坐标系并已叠加 ROI 偏移，与中心 Y 按序一一对应
中心Y	`centerY`	vec_double	—	否	各 Blob 质心的 Y 坐标，采用整图坐标系并已叠加 ROI 偏移，顺序与中心 X 保持一致
角度	`angle`	vec_double	—	否	各 Blob 最小外接矩形的旋转角度，由轮廓的最小面积矩形求得，单位为度；取不到轮廓时为 0
长度	`length`	vec_double	—	否	各 Blob 外接框的横向宽度，取自连通域统计的宽即 X 方向像素数，与宽度项按序对应
宽度	`width`	vec_double	—	否	各 Blob 外接框的纵向高度，取自连通域统计的高即 Y 方向像素数，与长度项按序对应
周长	`perimeter`	vec_double	—	否	各 Blob 轮廓的周长，优先取轮廓真实弧长，取不到轮廓时退化为外接框周长 2×(宽+高)，单位为像素
圆形度	`circularity`	vec_double	—	否	各 Blob 的圆形度，按 4π×面积÷周长² 计算并限制在 0~1；越接近 1 越接近正圆
矩形度	`rectangularity`	vec_double	—	否	各 Blob 面积与其外接框面积之比，反映填充外接框的饱满程度，取值在 0~1 之间
Blob区域	`roiRectOut`	roi	—	否	各 Blob 的外接框，格式为 [0,x,y,w,h,角度]，坐标采用整图坐标系，可直接作为其他工具的 ROI 输入

接入方式

在 FlowDesigner 中将「BLOB分析」节点加入流程画布，把上游图像或数据连接至「图像」，并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见使用文档；安装与使用问题可通过联系页反馈。

← 线线测量返回测量表面缺陷检测 →

联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。

安装包获取与部署说明
界面组态与工具配置
功能建议与问题反馈

微信扫码 · 安装包与问题反馈