图像处理

直方图

对图像做全局或分块直方图均衡，或只统计灰度分布并写出最小/最大/均值/标准差/对比度
HistogramTool · v1.0 · by system

输入参数 12

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待处理的图像帧列表，逐帧独立运算；空帧或空矩阵原样透传，不参与统计也不报错
矩形ROI	`roiRect`	roi	[]	否	矩形 ROI 条目数组，绘制后自动写回；其外接矩形并入掩码，与圆/椭圆/多边形 ROI 一起取并集
圆ROI	`roiCircle`	roi	[]	否	圆形 ROI 条目数组，绘制后自动写回；按外接矩形并入并集掩码，供均衡化与统计限定作用区域
椭圆ROI	`roiEllipse`	roi	[]	否	椭圆 ROI 条目数组，绘制后自动写回；外接矩形并入掩码，多个 ROI 取并集，无 ROI 时按全图处理
多边形ROI	`roiPolygon`	roi	[]	否	多边形 ROI 条目数组，绘制后自动写回；外接矩形并入掩码，掩码内没有有效区域时按整幅图像处理
操作	`op`	enum	0	否	直方图操作类型，按索引 0~2 分别对应均衡化、自适应均衡化(CLAHE)与直方图统计；越界值返回 -1 并报未知操作类型
通道	`channel`	int	-1	否	参与运算的通道序号，默认 -1 表示对全部通道分别处理；大于等于图像通道数时返回 -1 并给出越界提示
bins	`bins`	int	256	否	直方图统计的分箱数，默认 256，内部夹到 2~4096；仅在统计操作下传给 calcHist，过大值不会触发超大分配
范围低	`rangeLow`	int	0	否	直方图统计的像素范围下限，默认 0；与上限共同组成 calcHist 的 ranges，仅在统计操作下生效
范围高	`rangeHigh`	int	255	否	直方图统计的像素范围上限，默认 255；若小于等于下限，上下限会自动一并重置为 0~255
裁剪限制	`clipLimit`	double	2	否	CLAHE 对比度裁剪限制，默认 2.0，非正数按 2.0 处理后夹到 0.1~100；仅在自适应均衡化下生效
分块大小	`tileSize`	int	8	否	CLAHE 分块网格边长，默认 8，内部夹到 1~64 以防分块数过多导致内存暴涨；仅自适应均衡化下生效

输出参数 8

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功，输出逐帧结果；-1=输入帧容器缺失、处理抛错、通道越界或未知操作类型，此时不产出图像
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时为具体原因（输入图像为空、通道序号越界、未知操作类型或 OpenCV/内存异常），用于定位连线与参数
图像	`images`	vec_img	—	否	逐帧输出处理结果：均衡化/自适应均衡化为变换后图像，直方图统计为归一化到 8 位的源图；帧数与输入一致，空帧原样透传
最小值	`min`	double	—	否	直方图统计下各参与通道灰度最小值中的最小者，由 minMaxLoc 在掩码内计算；其它操作不写入该值
最大值	`max`	double	—	否	直方图统计下各参与通道灰度最大值中的最大者，由 minMaxLoc 在掩码内计算；其它操作不写入该值
均值	`mean`	double	—	否	直方图统计下各通道均值的算术平均，由 meanStdDev 累加后统一除以通道数得到；其它操作不写入该值
标准差	`stddev`	double	—	否	直方图统计下各通道标准差的算术平均，反映灰度离散程度；其它操作不写入该值
对比度	`contrast`	double	—	否	对比度指标，直接取 stddev 的标准差数值写出；仅在直方图统计操作下产生

接入方式

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

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

← 图像运算返回图像处理清晰度评估 →

联系与反馈

获取安装包与技术反馈

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

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

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