识别
颜色识别
计算每帧图像的二维颜色直方图，与参考类别直方图逐一比较取最高得分，达到匹配阈值时判定为对应类别并输出类别名、索引与置信度ColorRecognize · v1.0 · by system
输入参数 5
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 图像 | images | vec_img | [] | 是 | 逐帧参与颜色分类的图像序列，每帧先按需转换颜色空间并计算二维直方图，再转成灰度彩色图用于标注；空帧或空指针帧原样透传且不参与分类，整个图像容器缺失或类型不符时返回 -1 并在运行信息提示输入图像为空 |
| 参考直方图 | refHistograms | vec_double | [] | 是 | 参考类别直方图数据，作为类别比对的模板，可来自上游连线；按每类一个直方图首尾相接的一维序列、逐行矩阵或二维序列三种载体读取，每段长度与工具内部直方图维数一致才参与比较，长度不符的段被跳过 |
| 最大类别 | maxClasses | int | 10 | 否 | 参与比对的最多参考类别数，默认 10；工具按参考类别顺序逐一比较，仅序号小于该值的类别参与，超出的类别被忽略；参考类别本身不足时按实际类别数全部比较 |
| 匹配阈值 | matchThreshold | double | 0.8 | 否 | 判定是否命中某一类别的得分数下限，默认 0.8；只有当最高比对得分大于或等于该值时才把结果判为对应类别并给出类别名与索引，否则输出 unknown；取值越低越容易命中，越高要求越严格 |
| 颜色空间 | colorSpace | enum | 0 | 否 | 计算颜色直方图所用的颜色空间，可选 RGB 与 HSV，默认 RGB；选 HSV 时先把每帧转成 HSV 再取前两个通道统计，选 RGB 时直接按原图通道统计；该选择同时决定参考直方图应基于哪种空间生成 |
输出参数 6
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 运行结果 | resultCode | int | — | 否 | 0=完成逐帧直方图比对并写出类别名、类别索引与置信度；-1=输入图像容器缺失或处理过程中发生异常，此时运行信息写明具体原因 |
| 运行信息 | resultInfo | string | — | 否 | 成功时固定为 Success；失败时改为具体原因，例如输入图像为空、OpenCV 处理异常或内存不足，颜色直方图未命中任何类别仍属于成功并正常输出 unknown |
| 图像 | images | vec_img | — | 否 | 逐帧输出的标注图像，帧数与输入一致；每帧先转成灰度再转回 BGR，命中类别时在左上角画绿色文字显示类别名与两位小数得分，空帧原样透传 |
| 类别名称 | className | string | — | 否 | 分类结果的类别名称，命中时形如 class_ 加类别索引，未命中任何参考类别时固定为 unknown；多帧输入时由最后处理的一帧决定，空帧不更新该结果 |
| 类别索引 | classIndex | int | — | 否 | 分类结果对应的参考类别序号，从 0 开始编号，命中时等于得分最高类别的索引，未命中时保持 -1；多帧输入时由最后处理的一帧决定，可与类别名称配合定位具体模板 |
| 置信度 | confidence | double | — | 否 | 逐类比对得到的最高得分，命中时即入选类别的比对分数，未命中时仍是所有参考类别中的最高得分，没有可用参考类别时为 0；多帧输入时由最后处理的一帧决定，可与匹配阈值比较判断是否达标 |
接入方式
联系与反馈
获取安装包与技术反馈
安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。
- 安装包获取与部署说明
- 界面组态与工具配置
- 功能建议与问题反馈
微信扫码 · 安装包与问题反馈