识别

颜色抽取

按所选颜色空间把图像转到对应通道，再用三个通道各自的上下限做阈值分割，输出单通道掩膜，并给出命中像素数与占全图比例
ColorExtract · v1.0 · by system

输入参数 8

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	逐帧参与颜色分割的图像序列，每帧按所选颜色空间转换后做阈值判断；空帧或空指针原样透传到输出且不参与统计，整个图像容器缺失时返回 -1 并在运行信息提示输入图像为空
颜色空间	`colorSpace`	enum	0	否	决定按哪种通道组合做阈值分割，可选 RGB、HSV、HSI，默认 RGB；RGB 直接沿用图像原有的三个颜色通道，HSV 转到色调、饱和度与明度，HSI 转到色调、饱和度与亮度均值，三路阈值始终依次对应第一、第二、第三通道
通道1低	`low1`	int	0	否	第一通道的下限值，默认 0，与通道1上限配对；像素该通道值不小于此值才可能落入掩膜，数值直接参与阈值比较，三路通道同时满足时像素才被保留
通道1高	`high1`	int	255	否	第一通道的上限值，默认 255，与通道1下限配对；像素该通道值不大于此值才可能落入掩膜，数值直接参与阈值比较，调低它会收紧第一通道的保留范围
通道2低	`low2`	int	0	否	第二通道的下限值，默认 0，与通道2上限配对；像素该通道值不小于此值才可能落入掩膜，数值直接参与阈值比较，三路通道同时满足时像素才被保留
通道2高	`high2`	int	255	否	第二通道的上限值，默认 255，与通道2下限配对；像素该通道值不大于此值才可能落入掩膜，数值直接参与阈值比较，调低它会收紧第二通道的保留范围
通道3低	`low3`	int	0	否	第三通道的下限值，默认 0，与通道3上限配对；像素该通道值不小于此值才可能落入掩膜，数值直接参与阈值比较，三路通道同时满足时像素才被保留
通道3高	`high3`	int	255	否	第三通道的上限值，默认 255，与通道3下限配对；像素该通道值不大于此值才可能落入掩膜，数值直接参与阈值比较，调低它会收紧第三通道的保留范围

输出参数 5

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=完成颜色分割并输出掩膜图像、命中像素数与占比；-1=输入图像容器缺失或处理过程中发生异常，此时运行信息写明具体原因
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因，如输入图像为空、OpenCV 处理异常或内存不足，便于定位是输入容器还是参数规模导致的问题
图像	`images`	vec_img	—	否	逐帧输出的单通道 8 位掩膜图像，帧数与输入一致；满足三通道阈值的像素置为 255、其余置为 0，空帧原样透传，输出帧保留输入帧的来源标识与时序信息
掩膜像素	`maskPixels`	int	—	否	最后一帧掩膜中满足三通道阈值的像素个数，由非零像素计数得到；逐帧处理时每帧都会刷新该值，多帧输入时只保留最后一帧的结果，空帧不参与统计
比例	`ratio`	double	—	否	最后一帧掩膜中命中像素占全图像素总数的比例，取值在 0 到 1 之间；由命中像素数除以掩膜总像素数得到，总像素数为 0 时取 0.0，多帧输入时只保留最后一帧的结果

接入方式

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

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

← 字符定位返回识别颜色匹配 →

联系与反馈

获取安装包与技术反馈

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

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

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