eVision.EMatchPosition Class Reference

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

Public Member Functions
None	__init__ (self)
None	__init__ (self, float CenterX)
None	__init__ (self, float CenterX, float CenterY)
None	__init__ (self, float CenterX, float CenterY, float Angle)
None	__init__ (self, float CenterX, float CenterY, float Angle, float Scale)
None	__init__ (self, float CenterX, float CenterY, float Angle, float Scale, float ScaleX)
None	__init__ (self, float CenterX, float CenterY, float Angle, float Scale, float ScaleX, float ScaleY)
None	__init__ (self, float CenterX, float CenterY, float Angle, float Scale, float ScaleX, float ScaleY, float Score)
None	__init__ (self, float CenterX, float CenterY, float Angle, float Scale, float ScaleX, float ScaleY, float Score, bool Interpolated)
None	__init__ (self, float CenterX, float CenterY, float Angle, float Scale, float ScaleX, float ScaleY, float Score, bool Interpolated, float AreaRatio)
None	__init__ (self, float CenterX, float CenterY, float Angle, float Scale, float ScaleX, float ScaleY, float Score, bool Interpolated, float AreaRatio, float Reserved)
None	__init__ (self, float CenterX, float CenterY, float Angle, float Scale, float ScaleX, float ScaleY, float Score, bool Interpolated, float AreaRatio, float Reserved, float CachedRectangleSizeForOverlap)
None	__init__ (self, eVision.EMatchPosition other)
eVision.ERegion	ToRegion (self, int modelWidth, int modelHeight)
	Creates an ERegion from the eVision.EMatchPosition.

Properties
	CenterX = property(_CenterX__getter, _CenterX__setter)
	Abscissa of the center of the pattern found in the image.
	CenterY = property(_CenterY__getter, _CenterY__setter)
	Ordinate of the center of the pattern found in the image.
	Angle = property(_Angle__getter, _Angle__setter)
	Clockwise rotation angle, expressed using the current angle unit, of the pattern found in the image.
	Scale = property(_Scale__getter, _Scale__setter)
	Scale factor of the pattern found in the image.
	ScaleX = property(_ScaleX__getter, _ScaleX__setter)
	Measured horizontal scaling of the pattern found in the image, expressed as a dimensionless ratio.
	ScaleY = property(_ScaleY__getter, _ScaleY__setter)
	Measured vertical scaling of the pattern found in the image, expressed as a dimensionless ratio.
	Score = property(_Score__getter, _Score__setter)
	Indicates how good a matching was.
	Interpolated = property(_Interpolated__getter, _Interpolated__setter)
	Indicates whether sub-pixel interpolation was actually performed on the position.
	AreaRatio = property(_AreaRatio__getter, _AreaRatio__setter)
	Ratio between the found pattern area inside the search ROI and its complete area.
	Reserved = property(_Reserved__getter, _Reserved__setter)
	CachedRectangleSizeForOverlap = property(_CachedRectangleSizeForOverlap__getter, _CachedRectangleSizeForOverlap__setter)

Detailed Description

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

Remarks:

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

License(s): None

Deprecated

Use eVision.EFoundPattern instead.

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

Constructor & Destructor Documentation

__init__() [1/13]

None eVision.EMatchPosition.__init__

(

self

)

__init__() [2/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX )

Parameters

CenterX

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

__init__() [3/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY )

Parameters

CenterX	Abscissa of the center of the pattern found in the image.
CenterY	Ordinate of the center of the pattern found in the image.

__init__() [4/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY,
		float	Angle )

Parameters

CenterX	Abscissa of the center of the pattern found in the image.
CenterY	Ordinate of the center of the pattern found in the image.
Angle	Clockwise rotation angle, expressed using the current angle unit, of the pattern found in the image.

__init__() [5/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY,
		float	Angle,
		float	Scale )

Parameters

CenterX	Abscissa of the center of the pattern found in the image.
CenterY	Ordinate of the center of the pattern found in the image.
Angle	Clockwise rotation angle, expressed using the current angle unit, of the pattern found in the image.
Scale	Scale factor of the pattern found in the image.

__init__() [6/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY,
		float	Angle,
		float	Scale,
		float	ScaleX )

Parameters

CenterX	Abscissa of the center of the pattern found in the image.
CenterY	Ordinate of the center of the pattern found in the image.
Angle	Clockwise rotation angle, expressed using the current angle unit, of the pattern found in the image.
Scale	Scale factor of the pattern found in the image.
ScaleX	Measured horizontal scaling of the pattern found in the image, expressed as a dimensionless ratio.

__init__() [7/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY,
		float	Angle,
		float	Scale,
		float	ScaleX,
		float	ScaleY )

Parameters

CenterX	Abscissa of the center of the pattern found in the image.
CenterY	Ordinate of the center of the pattern found in the image.
Angle	Clockwise rotation angle, expressed using the current angle unit, of the pattern found in the image.
Scale	Scale factor of the pattern found in the image.
ScaleX	Measured horizontal scaling of the pattern found in the image, expressed as a dimensionless ratio.
ScaleY	Measured vertical scaling of the pattern found in the image, expressed as a dimensionless ratio.

__init__() [8/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY,
		float	Angle,
		float	Scale,
		float	ScaleX,
		float	ScaleY,
		float	Score )

Parameters

CenterX	Abscissa of the center of the pattern found in the image.
CenterY	Ordinate of the center of the pattern found in the image.
Angle	Clockwise rotation angle, expressed using the current angle unit, of the pattern found in the image.
Scale	Scale factor of the pattern found in the image.
ScaleX	Measured horizontal scaling of the pattern found in the image, expressed as a dimensionless ratio.
ScaleY	Measured vertical scaling of the pattern found in the image, expressed as a dimensionless ratio.
Score	Indicates how good a matching was.

__init__() [9/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY,
		float	Angle,
		float	Scale,
		float	ScaleX,
		float	ScaleY,
		float	Score,
		bool	Interpolated )

Parameters

CenterX	Abscissa of the center of the pattern found in the image.
CenterY	Ordinate of the center of the pattern found in the image.
Angle	Clockwise rotation angle, expressed using the current angle unit, of the pattern found in the image.
Scale	Scale factor of the pattern found in the image.
ScaleX	Measured horizontal scaling of the pattern found in the image, expressed as a dimensionless ratio.
ScaleY	Measured vertical scaling of the pattern found in the image, expressed as a dimensionless ratio.
Score	Indicates how good a matching was.
Interpolated	Indicates whether sub-pixel interpolation was actually performed on the position.

__init__() [10/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY,
		float	Angle,
		float	Scale,
		float	ScaleX,
		float	ScaleY,
		float	Score,
		bool	Interpolated,
		float	AreaRatio )

Parameters

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

__init__() [11/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY,
		float	Angle,
		float	Scale,
		float	ScaleX,
		float	ScaleY,
		float	Score,
		bool	Interpolated,
		float	AreaRatio,
		float	Reserved )

Parameters

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

__init__() [12/13]

None eVision.EMatchPosition.__init__	(		self,
		float	CenterX,
		float	CenterY,
		float	Angle,
		float	Scale,
		float	ScaleX,
		float	ScaleY,
		float	Score,
		bool	Interpolated,
		float	AreaRatio,
		float	Reserved,
		float	CachedRectangleSizeForOverlap )

Parameters

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

__init__() [13/13]

None eVision.EMatchPosition.__init__	(		self,
		eVision.EMatchPosition	other )

Parameters

other

Other instance

Member Function Documentation

ToRegion()

eVision.ERegion eVision.EMatchPosition.ToRegion	(		self,
		int	modelWidth,
		int	modelHeight )

Creates an ERegion from the eVision.EMatchPosition.

The ERegion represents all the pixels which are within the bounding box of the eVision.EMatchPosition.

Parameters

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

Property Documentation

Angle

eVision.EMatchPosition.Angle = property(_Angle__getter, _Angle__setter)

static

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

Remarks:

0 if no rotation is allowed.

AreaRatio

eVision.EMatchPosition.AreaRatio = property(_AreaRatio__getter, _AreaRatio__setter)

static

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

CachedRectangleSizeForOverlap

eVision.EMatchPosition.CachedRectangleSizeForOverlap = property(_CachedRectangleSizeForOverlap__getter, _CachedRectangleSizeForOverlap__setter)

static

CenterX

eVision.EMatchPosition.CenterX = property(_CenterX__getter, _CenterX__setter)

static

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

CenterY

eVision.EMatchPosition.CenterY = property(_CenterY__getter, _CenterY__setter)

static

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

Interpolated

eVision.EMatchPosition.Interpolated = property(_Interpolated__getter, _Interpolated__setter)

static

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

Remarks:

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

Reserved

eVision.EMatchPosition.Reserved = property(_Reserved__getter, _Reserved__setter)

static

Scale

eVision.EMatchPosition.Scale = property(_Scale__getter, _Scale__setter)

static

Scale factor of the pattern found in the image.

Remarks:

1 if no scaling is allowed.

ScaleX

eVision.EMatchPosition.ScaleX = property(_ScaleX__getter, _ScaleX__setter)

static

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

ScaleY

eVision.EMatchPosition.ScaleY = property(_ScaleY__getter, _ScaleY__setter)

static

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

Score

eVision.EMatchPosition.Score = property(_Score__getter, _Score__setter)

static

Indicates how good a matching was.

Remarks:

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).