eVision::EMatchPosition Struct Reference

Represents a single instance of the pattern in the search field, as returned by the EasyMatch matching process. More...

#include <eVision/EasyMatch/EMatchPosition.h>

Public Member Functions
eVision::ERegion	ToRegion (int modelWidth, int modelHeight) const
	Creates an ERegion from the EMatchPosition. The ERegion represents all the pixels which are within the bounding box of the EMatchPosition.

Public Attributes
float	CenterX
	Abscissa of the center of the pattern found in the image.
float	CenterY
	Ordinate of the center of the pattern found in the image.
float	Angle
	Clockwise rotation angle, expressed using the current angle unit, of the pattern found in the image.
float	Scale
	Scale factor of the pattern found in the image.
float	ScaleX
	Measured horizontal scaling of the pattern found in the image, expressed as a dimensionless ratio.
float	ScaleY
	Measured vertical scaling of the pattern found in the image, expressed as a dimensionless ratio.
float	Score
	Indicates how good a matching was.
bool	Interpolated
	Indicates whether sub-pixel interpolation was actually performed on the position.
float	AreaRatio
	Ratio between the found pattern area inside the search ROI and its complete area.
float	Reserved
float	CachedRectangleSizeForOverlap

Detailed Description

Represents a single instance of the pattern in the search field, as returned by the EasyMatch matching process.

EMatcher::GetPosition returns instances of this class. A EMatchPosition object represents one matched instance, with all the needed information about it.

License(s): None

Deprecated

Use EFoundPattern instead.

Deprecated in version 25.2. Scheduled to be removed in version 27.6.

Member Function Documentation

ToRegion()

eVision::ERegion eVision::EMatchPosition::ToRegion	(	int	modelWidth,
		int	modelHeight ) const

Creates an ERegion from the EMatchPosition. The ERegion represents all the pixels which are within the bounding box of the EMatchPosition.

Parameters

modelWidth	Width of the corresponding EasyMatch model.
modelHeight	Height of the corresponding EasyMatch model.

Member Data Documentation

Angle

float eVision::EMatchPosition::Angle

Clockwise rotation angle, expressed using the current angle unit, of the pattern found in the image.

0 if no rotation is allowed.

AreaRatio

float eVision::EMatchPosition::AreaRatio

Ratio between the found pattern area inside the search ROI and its complete area.

CachedRectangleSizeForOverlap

float eVision::EMatchPosition::CachedRectangleSizeForOverlap

CenterX

float eVision::EMatchPosition::CenterX

Abscissa of the center of the pattern found in the image.

CenterY

float eVision::EMatchPosition::CenterY

Ordinate of the center of the pattern found in the image.

Interpolated

bool eVision::EMatchPosition::Interpolated

Indicates whether sub-pixel interpolation was actually performed on the position.

In some cases, when the pattern is found close to the ROI edge, sub-pixel interpolation cannot be used.

Reserved

float eVision::EMatchPosition::Reserved

Scale

float eVision::EMatchPosition::Scale

Scale factor of the pattern found in the image.

1 if no scaling is allowed.

ScaleX

float eVision::EMatchPosition::ScaleX

Measured horizontal scaling of the pattern found in the image, expressed as a dimensionless ratio.

ScaleY

float eVision::EMatchPosition::ScaleY

Measured vertical scaling of the pattern found in the image, expressed as a dimensionless ratio.

Score

float eVision::EMatchPosition::Score

Indicates how good a matching was.

1 means that the matching was perfect. Lower values correspond to approximate matching; -1 corresponds to a perfect mismatch (pattern superimposed on its negative image).