图像处理

清晰度评估

按四种频域或梯度算子逐帧计算清晰度评分，可叠加输出梯度可视化图
SharpnessEval · v1.0 · by system

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待评估清晰度的图像帧列表，逐帧独立计算后取均值；空帧或转灰度失败的帧原样透传且不参与计分
评估方法	`method`	enum	0	否	清晰度算子按 0~3 索引选择，分别为拉普拉斯方差、Sobel 均值、Tenengrad 与 FFT 高频能量，取其他值时该帧得分记为 0
模糊阈值	`blurThreshold`	double	100	否	模糊判定参考阈值，默认 100.0；本工具把它原样写回输出供下游比较，自身不据此判定模糊
输出梯度图	`outputGradient`	bool	false	否	是否追加梯度可视化图；开启且梯度非空时，把归一化到 0~255 的梯度图追加到输出帧列表末尾

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功并输出评分与原帧列表；-1=输入帧容器缺失或运算抛错（内存不足、OpenCV 异常），此时不产出图像
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时为具体原因（输入图像为空、OpenCV 处理异常、内存不足或处理失败），用于定位连线
图像	`images`	vec_img	—	否	输出原始输入帧的透传副本，帧数与输入一致；开启输出梯度时会在末尾额外追加一张归一化梯度图
评分	`score`	double	—	否	各有效帧清晰度评分的算术平均值；空帧与转灰度失败的帧不计入，有效帧为 0 时按 1 做分母避免除零
模糊阈值	`blurThreshold`	double	—	否	原样回显输入的模糊判定阈值，便于下游节点用同一阈值比较 score 高低，本工具不修改该值

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

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

联系与反馈

获取安装包与技术反馈

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

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