eVision .NET API
Loading...
Searching...
No Matches
eVision.EMatchPosition Struct Reference

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

Public Member Functions

eVision.ERegion ToRegion (int modelWidth, int modelHeight)
 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 )

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

Parameters
modelWidthWidth of the corresponding EasyMatch model.
modelHeightHeight 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).