ZV_McFindShapeReState -- 匹配支持区域并输出轮廓状态

类型

形状模板匹配

描述

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

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

语法

ZV_McFindShapeReState(model,img,re,matchs,stat,minScore[,nums=0,maxOverlap=0.5,minThresh=-1,accuracy=1,speed=9,polar=0,deform=0,boundary=4])

 

参数:

model:ZVOBJECT类型,形状模板

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

re:ZVOBJECT类型,指定的匹配图像的有效区域,保留逗号不填或填入未使用过的变量则默认整个图像有效

matchs:ZVOBJECT类型,输出参数,匹配结果,矩阵,n行5列或7列(杂波功能开启),每行一个匹配目标,列依次为匹配分数score、x坐标、y坐标、旋转角度angle、缩放比例scale(、模板序号0、杂波分数)

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

minScore:最小匹配分值,(0,100],分值越高匹配的目标越准确,越低容易将非目标当成目标

nums:最大匹配数量,[0, 无穷),当num大于真实目标时,以目标分数从高到低输出所有目标;当num小于真实目标时,以目标分数从高到低输出num个目标;当num为0时,以目标分数从高到低输出所有目标

maxOverlap:目标重叠率,正常范围[0,1],0--不重叠,表示只找不重叠的目标,1-重叠,表示相隔很近的目标都能找到。重叠率表示目标允许的重叠比例。重叠率是目标轮廓特征的最小外接矩重叠面积除以最小外接矩的面积计算得来。当匹配结果重叠比例超出设置值时将只保留最好的结果,主要用于去除重叠的目标对象,当搜索图中只有一个目标时也可将参数设置小一些,会加快匹配速度但不明显

minThresh:目标轮廓的最低边缘阈值,minThresh取-1时将使用模板图像估算出的最小阈值。如果模板图像和匹配图像差异大可能导致匹配失败,这时应该自己设置阈值,比如设置成0

accuracy:匹配精度,0-像素精度,1-插值精度,2-最小二乘拟合精度,3-多次迭代的最小二乘拟合精度。精度1能满足大部分应用,在精度要求较高的场合使用2或3,但也会更耗时

speed:匹配速度0-10,越大速度越快,但可能丢失目标,大于10时取10,如果有丢失目标则建议设置小些

polar:匹配极性

polar

极性

解释

0

正极性

匹配目标所有轮廓点的明暗变化与模板所有轮廓点的明暗变化一致

1

正负极性

即正极性和负极性均可,匹配目标所有轮廓点的明暗变化与模板所有轮廓点的明暗变化一致或者相反

2

任意极性

匹配目标部分轮廓点的明暗变化与部分模板轮廓点的明暗变化一致或者相反

deform:变形尺寸,相对于模板,允许目标轮廓有少许变形,0-不支持变形;1-支持略微变形,但更耗时,可结合匹配阈值去掉一些噪声干扰提高速度

boundary:边界模式,目标轮廓超出图像边界的程度,0-不超出,1-少量超出,2-超出适中,3-大量超出,4-完全超出,匹配耗时依次增大。使用边界时需要结合系统参数"ShapeOnBorder"使用,只有这个参数设置为1时,边界模式才会起作用,建议根据实际情况设置该值

适用控制器

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

相关指令

ZV_McCreateShape、ZV_McCreateShapeScale、ZV_DraShapeMatch