测量

像素统计

在 ROI 外接矩形内按灰度区间筛选像素，统计总像素数、区间内像素数、占比、均值与标准差并输出 ROI 掩膜图
PixelStats · v1.0 · by system

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待统计的图像序列，逐帧取指定通道并在 ROI 区域内计算像素数与灰度统计量；空帧原样透传且不参与统计
矩形ROI	`roiRect`	roi	[]	否	矩形统计区域，与其他 ROI 条目合并后取各自外接框；未配置或全部无效时自动改用整幅图像作为统计范围
圆ROI	`roiCircle`	roi	[]	否	圆形统计区域，以其轴对齐外接矩形参与统计；与其他 ROI 条目一并合并，全部为空时按整幅图像处理
椭圆ROI	`roiEllipse`	roi	[]	否	椭圆统计区域，以其轴对齐外接矩形参与统计；与其他 ROI 条目一并合并，全部为空时按整幅图像处理
多边形ROI	`roiPolygon`	roi	[]	否	多边形统计区域，以其顶点包围盒参与统计；与其他 ROI 条目一并合并，全部为空时按整幅图像处理
低阈值	`lowThreshold`	int	0	否	灰度区间下限，像素值大于等于该值才计入范围像素；与高阈值组成闭区间，值越大纳入的像素越少
高阈值	`highThreshold`	int	255	否	灰度区间上限，像素值小于等于该值才计入范围像素；低于低阈值时区间为空，范围像素与比例都为 0
通道	`channel`	int	0	否	多通道图像参与统计的通道序号，从 0 开始；单通道灰度图忽略此项，序号越界会返回失败并给出原因

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功并输出各像素统计量；-1=输入图像容器缺失或为空、通道序号越界，或处理时抛出异常、内存不足，此时不产出统计
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因，如输入图像为空、通道序号越界及当前通道数、OpenCV 处理异常或内存不足
图像	`images`	vec_img	—	否	逐帧输出与输入等尺寸的 ROI 掩膜图，参与统计的外接矩形区域为白色、其余为黑色；空帧原样透传
总像素	`totalPixels`	int	—	否	参与统计的像素总数，即所有 ROI 外接矩形覆盖的像素个数之和，量纲为像素计数；矩形越界部分会被裁剪
范围像素	`inRangePixels`	int	—	否	灰度值落在低阈值与高阈值闭区间内的像素个数，量纲为像素计数；低阈值大于高阈值时该值为 0
比例	`ratio`	double	—	否	范围像素占总像素的比例，取值在 0 到 1 之间；总像素为 0 时按 0 处理，是无量纲比值
均值	`mean`	double	—	否	所选通道在 ROI 区域内的灰度均值，量纲与通道原始位深一致（8 位图为 0~255），不受灰度阈值筛选影响
标准差	`stddev`	double	—	否	所选通道在 ROI 区域内的灰度标准差，量纲与均值相同，反映像素值离散程度；同样不受灰度阈值影响

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

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

联系与反馈

获取安装包与技术反馈

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

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