ZV_McFindShapesState -- 多模板匹配并输出轮廓状态

类型

形状模板匹配

描述

使用形状模板列表,在图像img上进行多模板匹配,并输出模板轮廓点的匹配状态

根据模板类型及扩展算法参数,可以支持扩展算法,但匹配状态stat不支持,结果为空

语法

ZV_McFindShapesState(models,param,img,matchs,stat,[minScore=0,nums=0])

 

参数:

models:ZVOBJECT类型,形状模板列表

param:ZVOBJECT类型,参数矩阵,行数为1或等于mods列表长度,列数小于等于9列,各列依次为最小分数、数量、最大重叠率、最低阈值、精度、速度、极性、变形、边界,列数不足则对应列取默认值,行数为0,则全部取默认值,行数为1则所有模板共用参数,否则行数必须等于mods列表长度,模板使用对应行参数,保留逗号不填或填入未使用过的变量则全部使用默认参数

img:ZVOBJECT类型,待匹配的搜索图像,8U单通道,尺寸必须大于模板图片

matchs:ZVOBJECT类型,输出参数,匹配结果,矩阵,n行6列,每行一个匹配目标,列依次为匹配分数、x坐标、y坐标、旋转角度、缩放比例、模板序号

stat:ZVOBJECT类型,输出参数,匹配轮廓点每个点的匹配状态,n行m列8U图像类型,m为最长模板轮廓长度,不足的补0,每行对应一个匹配结果,行上依次存储每个轮廓点的匹配状态,即对于某个轮廓点来说,匹配分数大于等于设置分数时为1,小于匹配分数时为0。匹配失败或参数为空时(保留逗号不填或填入未使用过的变量)不输出,此输出参数结合绘制模板指令ZV_DraShapeMatch可将匹配成功点和失败点绘制不同的颜色

minScore:最小匹配分值,范围[0,100],分值越高匹配的目标越准确,越低容易将非目标当成目标,大于0时针对所有匹配目标,等于0时则使用param中的分值参数

nums:最大匹配数量,[0, 无穷),当num大于真实目标时,以目标分数从高到低输出所有目标;当num小于真实目标时,以目标分数从高到低输出num个目标;当num为0时,则使用param中的数量参数,各模板匹配的目标根据对应的数量参数进行处理,所有保留的目标以分数降序输出

适用控制器

支持ZV功能或者5系列以上的控制器

相关指令

ZV_McCreateShape、ZV_McCreateShapeScale、ZV_DraShapeMatch