识别

颜色匹配

按所选颜色空间统计输入图颜色特征，直方图比较法结合模板给出相似度与是否匹配判定并叠加分数标注，同时输出各通道均值与标准差构成的颜色矩特征
ColorMatch · v1.0 · by system

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	逐帧参与颜色统计的图像序列，每帧按所选颜色空间转换后计算特征；空帧或空图像原样透传且不参与统计，整个图像容器缺失时返回 -1 并在运行信息提示输入图像为空
模板	`template`	vec_img	[]	是	直方图比较法使用的模板图像，可取单张图或图像帧的首张；提供有效模板时才计算与输入图的相似度与匹配判定，缺失或为空时不产生匹配分与是否匹配
方法	`method`	enum	0	否	选择颜色比较方式：取直方图比较时用直方图与模板比对并给出匹配分与是否匹配，取颜色矩比较时不做模板比对；两种方式都会写出颜色矩特征，默认取直方图比较
直方图方法	`histMethod`	enum	3	否	直方图比较法采用的相似度算法，可选相关、卡方、交叉与巴氏，默认取巴氏；各选项对应不同的直方图距离或相关性度量，工具把结果统一折算为 0~1 的相似度
颜色空间	`colorSpace`	enum	0	否	统计颜色特征时使用的通道空间，可选 RGB 与 HSV，默认取 RGB；取 HSV 时先把图像转到 HSV 再统计，取 RGB 时直接沿用原图通道

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=完成全部图像帧的颜色统计并写出图像、匹配结果与颜色矩特征；-1=输入图像容器缺失或处理过程中发生异常，运行信息写明具体原因
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因，如输入图像为空、OpenCV 处理异常、内存不足或一般处理异常，便于定位上游送帧与模板配置问题
图像	`images`	vec_img	—	否	逐帧输出的 BGR 灰度显示图，帧数与输入一致；直方图比较法且模板有效时会在图上叠加 Score 分数文字，空帧或空图像原样透传
匹配分	`matchScore`	double	—	否	输入图与模板图折算后的相似度，取值 0~1，数值越大越相似；仅在直方图比较法且模板有效时写出，是否匹配直接由该分数与 0.5 比较得到
是否匹配	`isMatch`	bool	—	否	相似度过半时的匹配结论，布尔值；仅当采用直方图比较法且提供了有效模板时才会写出，由匹配分是否大于 0.5 决定，不提供模板时该项不更新
颜色矩	`colorMoments`	vec_double	—	否	由各通道均值与标准差交替组成的 6 维特征，顺序为通道0均值、通道0标准差、通道1均值、通道1标准差、通道2均值、通道2标准差；每帧都会写出并覆盖

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

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

联系与反馈

获取安装包与技术反馈

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

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