|
类型 |
形状模板匹配 |
|
描述 |
使用模板图像创建形状匹配模板。创建的模板基准位置为模板图像尺寸一半的整数部分,即整数除法(ImageWidth/2,ImageHeight/2) |
|
语法 |
ZV_SHAPECREATE(img,model,angleStart,angleEnd,scaleMin,scaleMax,thresh[,levelNum=0,ptReduce=0,angleStep=0,scaleStep=0,minContLen=20])
参数: img:ZVOBJECT类型,制作模板的图像,8U单通道 model:ZVOBJECT类型,制作的模板,输出参数 angleStart:角度匹配的起始值,由图像坐标系确定,范围[-360,360),若超出范围会自动归一化到此范围 angleEnd:角度匹配的终止值,范围[-360,360),angleEnd要大于等于angleStart,否则报错,并且差值要小于等于360,超出将裁剪angleEnd的值。创建模板后,位于起始和终止角度范围内的目标均可被匹配 scaleMin:匹配缩放最小比例,范围[0.5, 2.0] scaleMax:匹配缩放最大比例,范围[0.5, 2.0],大于等于scaleMin,创建模板后,位于最小和最大缩放范围内的目标均可被匹配 thresh:提取边缘轮廓的对比度阈值,范围[0,255],为0时内部会选取一个合适的阈值,对比度越大提取的边缘轮廓强度就越强,此参数可控制提取强边缘或弱边缘,阈值越小提取的弱边缘就越多,同时可能会带来一些噪声 levelNum:金字塔层数,范围[0,无穷),层数越小匹配越耗时,为0或层数过大时会自动选取合适层数,建议为0 ptReduce:优化减少模板点数量,如果设置在查找模板时贪婪度需设置低一些,0-不减少,1-轻微减少,2-减少适中,3-大量减少 angleStep:角度步长,范围[0,12],步长越小精度越好但匹配越耗时,步长越大精度越差但匹配越不耗时,步长设的太小不合理或者为0时内部会自动选择一个合适的步长,建议为0。注意:由于角度需要过0,因此使用指令ZV_SHAPEPARAM获取的角度步长与angleStep会有些差别,同理角度也是一样 scaleStep:缩放步长,[0,scaleMax - scaleMin],步长越小精度越好但匹配越耗时,步长越大精度越差但匹配越不耗时,步长设的太小不合理或者为0时内部会自动选择一个合适的步长,建议为0。注意:由于缩放需要过1,因此使用指令ZV_SHAPEDEFPARAM获取的缩放步长与scaleStep会有些差别 minContLen:最小轮廓长度,小于此长度的轮廓将不会被提取,此参数可控制删除一些短小轮廓
注意: 1.创建模板时通常选取轮廓分明且具有唯一特性的目标作为模板,特征最好不要具有对称性。
2.模板特征数据量大小通常与模板大小和模板参数有关,其数据量与模板大小、模板轮廓的复杂度、旋转角度范围、缩放范围成正比。模板越大使用的角度步长越小,在同等角度范围下特征数据量就越大,因此匹配时就越耗时。
3.创建模板和匹配具有超时机制,默认的均是5000ms,当创建模板超时可以通过适当地调整模板参数减小模板特征数据量(如缩放范围调小点或使用轮廓点精简参数ptReduce,此参数默认值为0即不精简轮廓点,精简的过于严重可能会影响匹配精度),或者是通过手动设置超时时间,如ZV_SysSetDbl("ShapeCreateTimeout",5000),ZV_SysSetDbl("ShapeFindTimeout",5000)。
4.创建模板也具有内存保护机制,当使用过大的模板图像创建具有缩放的模板时,占用的内存达到保护临界值时,此时报内存错误导致模板创建失败可以通过调整模板参数减少数据量,如使用ptReduce参数精简一些点,或阈值thresh设大点只提取更为明显的轮廓特征 |
|
适用控制器 |
支持ZV功能或者5系列以上的控制器 |
|
例子 |
ZVOBJECT model_img,model ZV_ImgRead(model_img,"model1.jpg",0) ' 读取模版图像 ZV_SHAPECREATE(model_img,model,0,360,1,1,50,0,0,0,0) '创建模板 |