Leaper Vision Toolkit
中文 / English 2.x
Public 成员函数 | 属性
ILMatchResult接口 参考

该接口提供单个模板匹配结果,可获取其具体属性。 更多...

类 ILMatchResult 继承关系图:
ILObject LMatchResult

Public 成员函数

void Draw (HDC hdc, LPVPatDrawFlags drawFlags, double zoomX, double zoomY, double panX, double panY)
 
ILPointsGetFeature (int level)
 
ILRectGetRect ()
 
LArray< ILPolygon * > GetShape (int level)
 
void Set (ILMatch *matchObject, double patX, double patY, double patAngle, double patScale, double patScore)
 
- Public 成员函数 继承自 ILObject
ILObjectCopy ()
 
LPVErrorCode Load (LString filename)
 
void Reset ()
 
LPVErrorCode Save (LString filename)
 
BOOL Valid ()
 

属性

double Angle [get]
 该结果的角度,在 (-180, 180) 范围内
 
ILPoint Center [get]
 该结果的中心位置
 
double GrayScore [get]
 该结果的灰度匹配分数。注意:当 GrayValueWeight 设置为 0 时,并不实际进行灰度匹配,因此灰度分数总为 0.
 
double Scale [get]
 该结果的缩放比例,在 (0.5, 1.5) 范围内表示相对与模板 50% ~ 150% 的缩放比例。
 
double ScaleX [get]
 该结果在 x 方向的缩放比例,在 (0.5, 1.5) 范围内表示相对与模板 50% ~ 150% 的缩放比例。
对于等比例缩放,::ScaleX 与 ScaleY 数值相同。对于非等比缩放,::Scale 为 ScaleXScaleY 的均值。
 
double ScaleY [get]
 该结果在 y 方向的缩放比例,在 (0.5, 1.5) 范围内表示相对与模板 50% ~ 150% 的缩放比例。
对于等比例缩放,::ScaleX 与 ScaleY 数值相同。对于非等比缩放,::Scale 为 ScaleXScaleY 的均值。
 
double Score [get]
 该结果的分数
 
double ShapeScore [get]
 该结果的形状匹配分数
 
- 属性 继承自 ILObject
LString Name [get, set]
 对象的名称,默认为空。
大多数情况下,LPV 算法类并不使用这个名称。
ILDrawable::SetDrawName() 启用,该名称将被绘制在对象的附近 更多...
 

详细描述

该接口提供单个模板匹配结果,可获取其具体属性。

通常通过 ILMatchResults::Item() 函数获得 LMatchResult 对象。可以使用该接口访问单个模板匹配结果的具体信息,如中心、分数等, 还可以调用绘制函数将单个对象绘制在界面上。

示例代码

成员函数说明

◆ Draw()

void Draw ( HDC  hdc,
LPVPatDrawFlags  drawFlags,
double  zoomX,
double  zoomY,
double  panX,
double  panY 
)

绘制该检测结果到给定设备。

参数
[in]drawFlags控制绘制内容,使用方式请查阅 LPVPatDrawFlags
参见
Use Draw Functions
备注
该函数在 Linux / MacOS 平台暂不可用。

◆ GetFeature()

ILPoints* GetFeature ( int  level)

获取变换到当前匹配结果位置的模板特征点

参数
level指定获取特征的层级。可能的取值有:-1 表示所有层级,0(默认值)表示原始尺度的 0 层特征,1 表示缩小尺度的 1 层特征
返回值
featurePoints返回特征点位置
自从
2.5.0

◆ GetRect()

ILRect* GetRect ( )

计算该检测结果的包围矩形

◆ GetShape()

LArray< ILPolygon *> GetShape ( int  level)

获取变换到当前匹配结果位置的模板形状线

参数
level指定获取特征的层级。可能的取值有:-1 表示所有层级,0(默认值)表示原始尺度的 0 层特征,1 表示缩小尺度的 1 层特征
返回值
shapePolys返回形状折线的集合
备注
为了保持形状索引的一致性,对于被 Prune() 剔除的形状线,仍旧在返回的形状集合中保留其位置但 LPolygon 对象为空。
自从
2.5.0

◆ Set()

void Set ( ILMatch matchObject,
double  patX,
double  patY,
double  patAngle,
double  patScale,
double  patScore 
)

设置匹配结果

参数
[in]matchObject指定匹配结果对应的 LMatch 对象,用于生成包围盒和特征的位置。
[in]patX匹配结果中心的 x 坐标
[in]patY匹配结果中心的 y 坐标
[in]patAngle匹配结果的角度
[in]patScale匹配结果的缩放比例
[in]patScore匹配结果的分数