eVision.EMatcher Class Reference

Manages a complete matching context in EasyMatch. More...

Inheritance diagram for eVision.EMatcher:

Collaboration diagram for eVision.EMatcher:

Public Member Functions
	EMatcher ()
	Constructs a matching context.
	EMatcher (uint maxNumDOF)
	Constructs a matching context.
	EMatcher (eVision.EMatcher other)
	Constructs a matching context.
void	CopyTo (eVision.EMatcher other)
	Copies all the data of the current EMatcher object into another EMatcher object and returns it.
void	Save (string path)
	Saves the EMatcher. The given ESerializer must have been created for writing.
void	Save (eVision.ESerializer serializer)
	Saves the EMatcher. The given ESerializer must have been created for writing.
void	Load (string path)
	Loads the EMatcher. The given ESerializer must have been created for reading.
void	Load (eVision.ESerializer serializer)
	Loads the EMatcher. The given ESerializer must have been created for reading.
void	LearnPattern (eVision.EROIBW8 pattern)
	Learns a pattern to subsequently match in an image.
void	LearnPattern (eVision.EROIC24 pattern)
	Learns a pattern to subsequently match in an image.
void	LearnPattern (eVision.EROIBW8 pattern, eVision.ERegion region)
	Learns a pattern to subsequently match in an image.
void	LearnPattern (eVision.EROIC24 pattern, eVision.ERegion region)
	Learns a pattern to subsequently match in an image.
void	LearnPattern (eVision.EROIBW8 pattern, eVision.EFrame frame)
	Learns a pattern to subsequently match in an image.
void	LearnPattern (eVision.EROIC24 pattern, eVision.EFrame frame)
	Learns a pattern to subsequently match in an image.
void	LearnPattern (eVision.EROIBW8 pattern, eVision.ERegion region, eVision.EFrame frame)
	Learns a pattern to subsequently match in an image.
void	LearnPattern (eVision.EROIC24 pattern, eVision.ERegion region, eVision.EFrame frame)
	Learns a pattern to subsequently match in an image.
void	LearnPatterns (eVision.EROIBW8[] patterns)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EROIBW8[] patterns, eVision.ERegion[] regions)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EROIBW8[] patterns, eVision.ERegion[] regions, eVision.EFrame frame)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EROIBW8[] patterns, eVision.EFrame frame)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EROIC24[] patterns)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EROIC24[] patterns, eVision.ERegion[] regions)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EROIC24[] patterns, eVision.ERegion[] regions, eVision.EFrame frame)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EROIC24[] patterns, eVision.EFrame frame)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EBaseROI[] patterns)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EBaseROI[] patterns, eVision.ERegion[] regions)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EBaseROI[] patterns, eVision.ERegion[] regions, eVision.EFrame frame)
	Learns multiple (at least 2) patterns.
void	LearnPatterns (eVision.EBaseROI[] patterns, eVision.EFrame frame)
	Learns multiple (at least 2) patterns.
void	ClearImage ()
	Releases the pointer to the image object that has been passed to the EMatcher object.
void	SetExtension (int n32ExtensionX, int n32ExtensionY)
	Sets the extension of the matching ROI, i.e. puts the horizontal and vertical distances, in pixels, that the found pattern occurrences may fall outside the matching ROI. Such occurrences partially outside the ROI have their score corrected by the ratio between the pattern area outside the ROI and the pattern area inside.
void	GetExtension (out int n32ExtensionX, out int n32ExtensionY)
	Gets the extension of the matching ROI, i.e. the horizontal and vertical distances, in pixels, that the found pattern occurrences may fall outside the matching ROI. Such occurrences partially outside the ROI have their score corrected by the ratio between the pattern area outside the ROI and the pattern area inside.
void	CopyLearntPattern (eVision.EImageBW8 image, uint learntPatternIndex)
	Copies the learned pattern in the supplied image. If no pattern has been learned, an exception with code EError.EError_NoPatternLearnt will be thrown.
void	CopyLearntPattern (eVision.EImageBW8 image)
	Copies the learned pattern in the supplied image. If no pattern has been learned, an exception with code EError.EError_NoPatternLearnt will be thrown.
void	CopyLearntPattern (eVision.EImageC24 image, uint learntPatternIndex)
	Copies the learned pattern in the supplied image. If no pattern has been learned, an exception with code EError.EError_NoPatternLearnt will be thrown.
void	CopyLearntPattern (eVision.EImageC24 image)
	Copies the learned pattern in the supplied image. If no pattern has been learned, an exception with code EError.EError_NoPatternLearnt will be thrown.
eVision.EFoundPattern[]	Match (eVision.EROIBW8 image)
	Matches the pattern against an image.
eVision.EFoundPattern[]	Match (eVision.EROIBW8 image, eVision.ERegion region)
	Matches the pattern against an image.
eVision.EFoundPattern[]	Match (eVision.EROIC24 image)
	Matches the pattern against an image.
eVision.EFoundPattern[]	Match (eVision.EROIC24 image, eVision.ERegion region)
	Matches the pattern against an image.
eVision.EFoundPattern[]	Match (eVision.EROIBW8 image, eVision.EFrame frame)
	Matches the pattern against an image.
eVision.EFoundPattern[]	Match (eVision.EROIBW8 image, eVision.ERegion region, eVision.EFrame frame)
	Matches the pattern against an image.
eVision.EFoundPattern[]	Match (eVision.EROIC24 image, eVision.EFrame frame)
	Matches the pattern against an image.
eVision.EFoundPattern[]	Match (eVision.EROIC24 image, eVision.ERegion region, eVision.EFrame frame)
	Matches the pattern against an image.
float	GetAngleStep (uint reduction, uint learntPatternIndex)
	Gets the angle step used at the given reduction.
float	GetAngleStep (uint reduction)
	Gets the angle step used at the given reduction.
float	GetScaleStep (uint reduction, uint learntPatternIndex)
	Gets the scale step used at the given reduction.
float	GetScaleStep (uint reduction)
	Gets the scale step used at the given reduction.
float	GetScaleXStep (uint reduction, uint learntPatternIndex)
	Gets the scale step used on the X axis at the given reduction.
float	GetScaleXStep (uint reduction)
	Gets the scale step used on the X axis at the given reduction.
float	GetScaleYStep (uint reduction, uint learntPatternIndex)
	Gets the scale step used on the Y axis at the given reduction.
float	GetScaleYStep (uint reduction)
	Gets the scale step used on the Y axis at the given reduction.
void	SetPixelDimensions (float width, float height)
	Sets the physical pixel dimensions.
void	GetPixelDimensions (out float width, out float height)
	Gets the physical pixel dimensions.
eVision.EMatchPosition	GetPosition (uint index)
	Returns an EMatchPosition object containing the position coordinates.
void	DrawPosition (eVision.EDrawAdapter graphicContext, uint index, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (eVision.EDrawAdapter graphicContext, uint index, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (eVision.EDrawAdapter graphicContext, uint index, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (eVision.EDrawAdapter graphicContext, uint index, bool bCorner, float zoomX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (eVision.EDrawAdapter graphicContext, uint index, bool bCorner)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (eVision.EDrawAdapter graphicContext, uint index)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, uint index, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, uint index, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, uint index, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, uint index, bool bCorner, float zoomX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, uint index, bool bCorner)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, uint index)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, eVision.ERGBColor color, uint index, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, eVision.ERGBColor color, uint index, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, eVision.ERGBColor color, uint index, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, eVision.ERGBColor color, uint index, bool bCorner, float zoomX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, eVision.ERGBColor color, uint index, bool bCorner)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (IntPtr graphicContext, eVision.ERGBColor color, uint index)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionWithCurrentPen (IntPtr graphicContext, uint index, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionWithCurrentPen (IntPtr graphicContext, uint index, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionWithCurrentPen (IntPtr graphicContext, uint index, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionWithCurrentPen (IntPtr graphicContext, uint index, bool bCorner, float zoomX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionWithCurrentPen (IntPtr graphicContext, uint index, bool bCorner)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionWithCurrentPen (IntPtr graphicContext, uint index)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (eVision.EDrawAdapter graphicContext, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (eVision.EDrawAdapter graphicContext, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (eVision.EDrawAdapter graphicContext, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (eVision.EDrawAdapter graphicContext, bool bCorner, float zoomX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (eVision.EDrawAdapter graphicContext, bool bCorner)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (eVision.EDrawAdapter graphicContext)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, bool bCorner, float zoomX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, bool bCorner)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, eVision.ERGBColor color, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, eVision.ERGBColor color, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, eVision.ERGBColor color, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, eVision.ERGBColor color, bool bCorner, float zoomX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, eVision.ERGBColor color, bool bCorner)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (IntPtr graphicContext, eVision.ERGBColor color)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionsWithCurrentPen (IntPtr graphicContext, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionsWithCurrentPen (IntPtr graphicContext, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionsWithCurrentPen (IntPtr graphicContext, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionsWithCurrentPen (IntPtr graphicContext, bool bCorner, float zoomX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionsWithCurrentPen (IntPtr graphicContext, bool bCorner)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositionsWithCurrentPen (IntPtr graphicContext)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
int	GetPatternWidth (uint learntPatternIndex)
	Learned pattern width.
int	GetPatternHeight (uint learntPatternIndex)
	Learned pattern height.
void	DrawPosition (System.Drawing.Graphics graphicContext, uint index, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, uint index, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, uint index, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, uint index, bool bCorner, float zoomX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, uint index, bool bCorner)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, uint index)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, uint index, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, uint index, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, uint index, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, uint index, bool bCorner, float zoomX)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, uint index, bool bCorner)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPosition (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, uint index)
	Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, bool bCorner, float zoomX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, bool bCorner)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, bool bCorner, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, bool bCorner, float zoomX, float zoomY, float panX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, bool bCorner, float zoomX, float zoomY)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, bool bCorner, float zoomX)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, bool bCorner)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.
void	DrawPositions (System.Drawing.Graphics graphicContext, eVision.ERGBColor color)
	Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

Properties
ulong	LearnTimeOut [get, set]
	Time-out for the EMatcher.LearnPattern and EMatcher.LearnPatterns methods.
ulong	MatchTimeOut [get, set]
	Time-out for the EMatcher.Match method.
uint	NumLearnedPatterns [get]
	Indicates the number of patterns learnt. 0 is returned if no learning was performed.
bool	PatternLearnt [get]
	Returns true after a learning operation has been successfully performed, indicating that the EMatcher object is ready for matching, and false otherwise.
bool	LearningHasRegion [get]
	Indicates whether a ERegion was used alongside the last learned pattern. Returns false if no learning was performed.
eVision.EIntSize	Extension [get, set]
	Sets/Gets the extension of the matching ROI, i.e. puts the horizontal and vertical distances, in pixels, that the found pattern occurrences may fall outside the matching ROI. Such occurrences partially outside the ROI have their score corrected by the ratio between the pattern area outside the ROI and the pattern area inside.
uint	MinReducedArea [get, set]
	Minimum reduced area parameter.
bool	AdvancedLearning [get, set]
	Toggle advanced learning.
uint	DontCareThreshold [get, set]
	"Don't care" threshold.
eVision.ECorrelationMode	CorrelationMode [get, set]
	Correlation mode.
eVision.EMatchContrastMode	ContrastMode [get, set]
	Contrast mode.
uint	MaxPositions [get, set]
	Maximum number of positions.
uint	MaxInitialPositions [get, set]
	Maximum number of positions at the first stage of the matching process.
float	InitialMinScore [get, set]
	Minimum score applied as a selection criterion in the early stages of the matching process.
float	MinScore [get, set]
	Minimum score.
float	MinAngle [get, set]
	Minimum angle, in the current angle unit.
float	MaxAngle [get, set]
	Maximum angle, in the current angle unit.
float	MinScale [get, set]
	Minimum scale factor for isotropic scaling.
float	MaxScale [get, set]
	Maximum scale factor for isotropic scaling.
float	MinScaleX [get, set]
	Minimum horizontal scale factor for anisotropic scaling.
float	MaxScaleX [get, set]
	Maximum horizontal scale factor for anisotropic scaling.
float	MinScaleY [get, set]
	Minimum vertical scale factor for anisotropic scaling.
float	MaxScaleY [get, set]
	Maximum vertical scale factor for anisotropic scaling.
bool	IsotropicScale [get]
	Flag indicating whether isotropic (as opposed to anisotropic) scaling is used.
eVision.ESize	PixelDimensions [get, set]
	Gets/Sets the physical pixel dimensions.
bool	Interpolate [get, set]
	Interpolation mode.
bool	EnableEarlyCandidateRejection [get, set]
	Whether to remove bad candidates in the early phases of the processing or not. Enabled by default.
eVision.EFilteringMode	FilteringMode [get, set]
	Filtering mode.
float	MaxOverlap [get, set]
	Overlapping tolerance.
uint	NumPositions [get]
	Number of good matches found, as defined by EMatcher.MinScore and EMatcher.MaxPositions properties.
eVision.EMatchPosition[]	Positions [get]
	Returns a vector of EMatchPosition objects, each containing the position coordinates and other matching results.
uint	NumReductions [get]
	Number of reduction steps used in the matching process.
eVision.EImageType	PatternType [get]
	Pixel type of the learned pattern.
uint	FinalReduction [get, set]
	Index of the last reduction.
int	PatternWidth [get]
	Learned pattern width.
int	PatternHeight [get]
	Learned pattern height.
static uint	Version [get]
	Version number of the EMatcher object.

Detailed Description

Manages a complete matching context in EasyMatch.

A matching context consists of a learned pattern and of the parameters required to locate one or more instances of the pattern in a search field.

License(s): EasyMatch

Constructor & Destructor Documentation

EMatcher() [1/3]

eVision.EMatcher.EMatcher

(

)

Constructs a matching context.

With the default constructor (no argument), all parameters are initialized to their respective default values. The copy constructor constructs a matching context based on a pre-existing EMatcher object. The last constructor constructs a matching context with a specified number of degrees of freedom. maximumNumberOfDegreesOfFreedom is the maximum number of degrees of freedom that the EMatcher object being constructed will be allowed to use during its life. All other parameters are initialized to their respective default values. The degrees of freedom for a matching operation are the translation (2 modes), the rotation (1 mode), the isotropic scaling (1 mode) and the anisotropic scaling (1 more mode). There is no way to modify this parameter for an existing EMatcher object. The default value for maximumNumberOfDegreesOfFreedom is 5, that is the maximum value. The minimum value for the number of degrees of freedom is 2, in order to allow, at least, the pattern translation.

EMatcher() [2/3]

eVision.EMatcher.EMatcher

(

uint

maxNumDOF

)

Constructs a matching context.

Parameters

maxNumDOF

Maximum number of degrees of freedom (this number must be comprised between 2 and 5).

With the default constructor (no argument), all parameters are initialized to their respective default values. The copy constructor constructs a matching context based on a pre-existing EMatcher object. The last constructor constructs a matching context with a specified number of degrees of freedom. maximumNumberOfDegreesOfFreedom is the maximum number of degrees of freedom that the EMatcher object being constructed will be allowed to use during its life. All other parameters are initialized to their respective default values. The degrees of freedom for a matching operation are the translation (2 modes), the rotation (1 mode), the isotropic scaling (1 mode) and the anisotropic scaling (1 more mode). There is no way to modify this parameter for an existing EMatcher object. The default value for maximumNumberOfDegreesOfFreedom is 5, that is the maximum value. The minimum value for the number of degrees of freedom is 2, in order to allow, at least, the pattern translation.

EMatcher() [3/3]

eVision.EMatcher.EMatcher

(

eVision.EMatcher

other

)

Constructs a matching context.

Parameters

other

Another EMatcher object to be copied in the new EMatcher object.

With the default constructor (no argument), all parameters are initialized to their respective default values. The copy constructor constructs a matching context based on a pre-existing EMatcher object. The last constructor constructs a matching context with a specified number of degrees of freedom. maximumNumberOfDegreesOfFreedom is the maximum number of degrees of freedom that the EMatcher object being constructed will be allowed to use during its life. All other parameters are initialized to their respective default values. The degrees of freedom for a matching operation are the translation (2 modes), the rotation (1 mode), the isotropic scaling (1 mode) and the anisotropic scaling (1 more mode). There is no way to modify this parameter for an existing EMatcher object. The default value for maximumNumberOfDegreesOfFreedom is 5, that is the maximum value. The minimum value for the number of degrees of freedom is 2, in order to allow, at least, the pattern translation.

Member Function Documentation

ClearImage()

void eVision.EMatcher.ClearImage

(

)

Releases the pointer to the image object that has been passed to the EMatcher object.

It is the way to tell to the EMatcher object that its pointer is not valid anymore. The EMatcher.Match method keeps a copy of the image pointer given as parameter. So, if the user deletes this pointer, the EMatcher object should be informed.

CopyLearntPattern() [1/4]

void eVision.EMatcher.CopyLearntPattern

(

eVision.EImageBW8

image

)

Copies the learned pattern in the supplied image. If no pattern has been learned, an exception with code EError.EError_NoPatternLearnt will be thrown.

Parameters

image

Pointer to the image in which the learned pattern will be returned.

CopyLearntPattern() [2/4]

void eVision.EMatcher.CopyLearntPattern	(	eVision.EImageBW8	image,
		uint	learntPatternIndex )

Copies the learned pattern in the supplied image. If no pattern has been learned, an exception with code EError.EError_NoPatternLearnt will be thrown.

Parameters

image	Pointer to the image in which the learned pattern will be returned.
learntPatternIndex	Index of the learnt pattern. Default: 0.

CopyLearntPattern() [3/4]

void eVision.EMatcher.CopyLearntPattern

(

eVision.EImageC24

image

)

Copies the learned pattern in the supplied image. If no pattern has been learned, an exception with code EError.EError_NoPatternLearnt will be thrown.

Parameters

image

Pointer to the image in which the learned pattern will be returned.

CopyLearntPattern() [4/4]

void eVision.EMatcher.CopyLearntPattern	(	eVision.EImageC24	image,
		uint	learntPatternIndex )

Copies the learned pattern in the supplied image. If no pattern has been learned, an exception with code EError.EError_NoPatternLearnt will be thrown.

Parameters

image	Pointer to the image in which the learned pattern will be returned.
learntPatternIndex	Index of the learnt pattern. Default: 0.

CopyTo()

void eVision.EMatcher.CopyTo

(

eVision.EMatcher

other

)

Copies all the data of the current EMatcher object into another EMatcher object and returns it.

Parameters

other

Reference to the EMatcher object in which the current EMatcher object parameters are to be copied.

DrawPosition() [1/30]

void eVision.EMatcher.DrawPosition	(	eVision.EDrawAdapter	graphicContext,
		uint	index )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [2/30]

void eVision.EMatcher.DrawPosition	(	eVision.EDrawAdapter	graphicContext,
		uint	index,
		bool	bCorner )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [3/30]

void eVision.EMatcher.DrawPosition	(	eVision.EDrawAdapter	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [4/30]

void eVision.EMatcher.DrawPosition	(	eVision.EDrawAdapter	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [5/30]

void eVision.EMatcher.DrawPosition	(	eVision.EDrawAdapter	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [6/30]

void eVision.EMatcher.DrawPosition	(	eVision.EDrawAdapter	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [7/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		uint	index )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [8/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [9/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [10/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [11/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [12/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [13/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		uint	index )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [14/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [15/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [16/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [17/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [18/30]

void eVision.EMatcher.DrawPosition	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [19/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		uint	index )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [20/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [21/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [22/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [23/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [24/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [25/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		uint	index )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [26/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		uint	index,
		bool	bCorner )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [27/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [28/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [29/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPosition() [30/30]

void eVision.EMatcher.DrawPosition	(	System.Drawing.Graphics	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [1/30]

void eVision.EMatcher.DrawPositions

(

eVision.EDrawAdapter

graphicContext

)

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext

Handle of the device context on which to draw.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [2/30]

void eVision.EMatcher.DrawPositions	(	eVision.EDrawAdapter	graphicContext,
		bool	bCorner )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [3/30]

void eVision.EMatcher.DrawPositions	(	eVision.EDrawAdapter	graphicContext,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [4/30]

void eVision.EMatcher.DrawPositions	(	eVision.EDrawAdapter	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [5/30]

void eVision.EMatcher.DrawPositions	(	eVision.EDrawAdapter	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [6/30]

void eVision.EMatcher.DrawPositions	(	eVision.EDrawAdapter	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [7/30]

void eVision.EMatcher.DrawPositions

(

IntPtr

graphicContext

)

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext

Handle of the device context on which to draw.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [8/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		bool	bCorner )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [9/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [10/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [11/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [12/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [13/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		eVision.ERGBColor	color )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [14/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [15/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [16/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [17/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [18/30]

void eVision.EMatcher.DrawPositions	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [19/30]

void eVision.EMatcher.DrawPositions

(

System.Drawing.Graphics

graphicContext

)

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext

Handle of the device context on which to draw.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [20/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		bool	bCorner )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [21/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [22/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [23/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [24/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [25/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [26/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [27/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [28/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [29/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositions() [30/30]

void eVision.EMatcher.DrawPositions	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionsWithCurrentPen() [1/6]

void eVision.EMatcher.DrawPositionsWithCurrentPen

(

IntPtr

graphicContext

)

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext

Handle of the device context on which to draw.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionsWithCurrentPen() [2/6]

void eVision.EMatcher.DrawPositionsWithCurrentPen	(	IntPtr	graphicContext,
		bool	bCorner )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionsWithCurrentPen() [3/6]

void eVision.EMatcher.DrawPositionsWithCurrentPen	(	IntPtr	graphicContext,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionsWithCurrentPen() [4/6]

void eVision.EMatcher.DrawPositionsWithCurrentPen	(	IntPtr	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionsWithCurrentPen() [5/6]

void eVision.EMatcher.DrawPositionsWithCurrentPen	(	IntPtr	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionsWithCurrentPen() [6/6]

void eVision.EMatcher.DrawPositionsWithCurrentPen	(	IntPtr	graphicContext,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of all occurrences of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used for all occurrences (to vary the colors, draw the objects separately using the EMatcher.DrawPosition method instead).

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionWithCurrentPen() [1/6]

void eVision.EMatcher.DrawPositionWithCurrentPen	(	IntPtr	graphicContext,
		uint	index )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionWithCurrentPen() [2/6]

void eVision.EMatcher.DrawPositionWithCurrentPen	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionWithCurrentPen() [3/6]

void eVision.EMatcher.DrawPositionWithCurrentPen	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionWithCurrentPen() [4/6]

void eVision.EMatcher.DrawPositionWithCurrentPen	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionWithCurrentPen() [5/6]

void eVision.EMatcher.DrawPositionWithCurrentPen	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

DrawPositionWithCurrentPen() [6/6]

void eVision.EMatcher.DrawPositionWithCurrentPen	(	IntPtr	graphicContext,
		uint	index,
		bool	bCorner,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws a graphical representation of a given occurrence of the pattern in the image, using a rectangle and possibly a small line segment in the upper-left corner.

When multiple patterns are learned, only the positions corresponding to the first pattern are drawn.

Parameters

graphicContext	Handle of the device context on which to draw.
index	Occurrence index, in range 0..NumPositions-1.
bCorner	true if the corner mark is to be drawn. false by default. (This mark is useful when large rotations are allowed.)
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window. The current pen is used.

Deprecated

Use the EFoundPattern.Draw method of the EFoundPattern objects returned by EMatcher.Match instead.

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

GetAngleStep() [1/2]

float eVision.EMatcher.GetAngleStep

(

uint

reduction

)

Gets the angle step used at the given reduction.

Parameters

reduction

Offset of the reduction in the pyramid, must be between EMatcher.FinalReduction and EMatcher.NumReductions - 1.

GetAngleStep() [2/2]

float eVision.EMatcher.GetAngleStep	(	uint	reduction,
		uint	learntPatternIndex )

Gets the angle step used at the given reduction.

Parameters

reduction	Offset of the reduction in the pyramid, must be between EMatcher.FinalReduction and EMatcher.NumReductions - 1.
learntPatternIndex	Index of the learnt pattern. Defaults to 0.

GetExtension()

void eVision.EMatcher.GetExtension	(	out int	n32ExtensionX,
		out int	n32ExtensionY )

Gets the extension of the matching ROI, i.e. the horizontal and vertical distances, in pixels, that the found pattern occurrences may fall outside the matching ROI. Such occurrences partially outside the ROI have their score corrected by the ratio between the pattern area outside the ROI and the pattern area inside.

Parameters

n32ExtensionX	extension outside the matching ROI along its Width, in pixels.
n32ExtensionY	extension outside the matching ROI along its Height, in pixels.

Deprecated

Use EMatcher.Extension instead.

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

GetPatternHeight()

int eVision.EMatcher.GetPatternHeight

(

uint

learntPatternIndex

)

Learned pattern height.

Parameters

learntPatternIndex

Index of the learnt pattern.

GetPatternWidth()

int eVision.EMatcher.GetPatternWidth

(

uint

learntPatternIndex

)

Learned pattern width.

Parameters

learntPatternIndex

Index of the learnt pattern.

GetPixelDimensions()

void eVision.EMatcher.GetPixelDimensions	(	out float	width,
		out float	height )

Gets the physical pixel dimensions.

Parameters

width	Width of a pixel.
height	Height of a pixel.

Deprecated

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

GetPosition()

eVision.EMatchPosition eVision.EMatcher.GetPosition

(

uint

index

)

Returns an EMatchPosition object containing the position coordinates.

When multiple patterns are learned, the position corresponding to the first pattern at the given index is returned.

Parameters

index

0-based index to the desired position. The positions are ordered by decreasing score.

Deprecated

Use the EFoundPattern objects returned by EMatcher.Match instead.

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

GetScaleStep() [1/2]

float eVision.EMatcher.GetScaleStep

(

uint

reduction

)

Gets the scale step used at the given reduction.

When multiple patterns are learned, the scale step corresponding to the first pattern at the given reduction is returned.

Parameters

reduction

Offset of the reduction in the pyramid, must be between EMatcher.FinalReduction and EMatcher.NumReductions - 1.

GetScaleStep() [2/2]

float eVision.EMatcher.GetScaleStep	(	uint	reduction,
		uint	learntPatternIndex )

Gets the scale step used at the given reduction.

When multiple patterns are learned, the scale step corresponding to the first pattern at the given reduction is returned.

Parameters

reduction	Offset of the reduction in the pyramid, must be between EMatcher.FinalReduction and EMatcher.NumReductions - 1.
learntPatternIndex	Index of the learnt pattern. Defaults to 0.

GetScaleXStep() [1/2]

float eVision.EMatcher.GetScaleXStep

(

uint

reduction

)

Gets the scale step used on the X axis at the given reduction.

When multiple patterns are learned, the scale X step corresponding to the first pattern at the given reduction is returned.

Parameters

reduction

Offset of the reduction in the pyramid, must be between EMatcher.FinalReduction and EMatcher.NumReductions - 1.

GetScaleXStep() [2/2]

float eVision.EMatcher.GetScaleXStep	(	uint	reduction,
		uint	learntPatternIndex )

Gets the scale step used on the X axis at the given reduction.

When multiple patterns are learned, the scale X step corresponding to the first pattern at the given reduction is returned.

Parameters

reduction	Offset of the reduction in the pyramid, must be between EMatcher.FinalReduction and EMatcher.NumReductions - 1.
learntPatternIndex	Index of the learnt pattern. Defaults to 0.

GetScaleYStep() [1/2]

float eVision.EMatcher.GetScaleYStep

(

uint

reduction

)

Gets the scale step used on the Y axis at the given reduction.

When multiple patterns are learned, the scale Y step corresponding to the first pattern at the given reduction is returned.

Parameters

reduction

Offset of the reduction in the pyramid, must be between EMatcher.FinalReduction and EMatcher.NumReductions - 1.

GetScaleYStep() [2/2]

float eVision.EMatcher.GetScaleYStep	(	uint	reduction,
		uint	learntPatternIndex )

Gets the scale step used on the Y axis at the given reduction.

When multiple patterns are learned, the scale Y step corresponding to the first pattern at the given reduction is returned.

Parameters

reduction	Offset of the reduction in the pyramid, must be between EMatcher.FinalReduction and EMatcher.NumReductions - 1.
learntPatternIndex	Index of the learnt pattern. Defaults to 0.

LearnPattern() [1/8]

void eVision.EMatcher.LearnPattern

(

eVision.EROIBW8

pattern

)

Learns a pattern to subsequently match in an image.

Parameters

pattern

Pattern to learn.

The maximum size for a pattern is \((\sqrt{Minimum Reduced Area} - 1) * 2^8\). For the default Minimum Reduced Area of 64, this corresponds to a 1792x1792 maximum size. Increasing the Minimum Reduced Area enables larger pattern size but reduces the processing speed.

When a region is given, the method will ignore the pixels outside the region by internally setting them to 0 and setting EMatcher.DontCareThreshold to 1 if it wasn't set by the user. Thus, when working with an ERegion, all pixels that are black in the pattern will be discarded.

Consequently, when using binary images, the value 0 shouldn't be used if you use an ERegion for learning. 0's in your images should be replaced by 1's. This can be done with the EArithmeticLogicOperation.EArithmeticLogicOperation_Add mode of EasyImage.Oper.

LearnPattern() [2/8]

void eVision.EMatcher.LearnPattern	(	eVision.EROIBW8	pattern,
		eVision.EFrame	frame )

Learns a pattern to subsequently match in an image.

Parameters

pattern	Pattern to learn.
frame	Reference frame of the learned image

The maximum size for a pattern is \((\sqrt{Minimum Reduced Area} - 1) * 2^8\). For the default Minimum Reduced Area of 64, this corresponds to a 1792x1792 maximum size. Increasing the Minimum Reduced Area enables larger pattern size but reduces the processing speed.

When a region is given, the method will ignore the pixels outside the region by internally setting them to 0 and setting EMatcher.DontCareThreshold to 1 if it wasn't set by the user. Thus, when working with an ERegion, all pixels that are black in the pattern will be discarded.

Consequently, when using binary images, the value 0 shouldn't be used if you use an ERegion for learning. 0's in your images should be replaced by 1's. This can be done with the EArithmeticLogicOperation.EArithmeticLogicOperation_Add mode of EasyImage.Oper.

LearnPattern() [3/8]

void eVision.EMatcher.LearnPattern	(	eVision.EROIBW8	pattern,
		eVision.ERegion	region )

Learns a pattern to subsequently match in an image.

Parameters

pattern	Pattern to learn.
region	Region in the pattern image to consider

The maximum size for a pattern is \((\sqrt{Minimum Reduced Area} - 1) * 2^8\). For the default Minimum Reduced Area of 64, this corresponds to a 1792x1792 maximum size. Increasing the Minimum Reduced Area enables larger pattern size but reduces the processing speed.

When a region is given, the method will ignore the pixels outside the region by internally setting them to 0 and setting EMatcher.DontCareThreshold to 1 if it wasn't set by the user. Thus, when working with an ERegion, all pixels that are black in the pattern will be discarded.

Consequently, when using binary images, the value 0 shouldn't be used if you use an ERegion for learning. 0's in your images should be replaced by 1's. This can be done with the EArithmeticLogicOperation.EArithmeticLogicOperation_Add mode of EasyImage.Oper.

LearnPattern() [4/8]

void eVision.EMatcher.LearnPattern	(	eVision.EROIBW8	pattern,
		eVision.ERegion	region,
		eVision.EFrame	frame )

Learns a pattern to subsequently match in an image.

Parameters

pattern	Pattern to learn.
region	Region in the pattern image to consider
frame	Reference frame of the learned image

The maximum size for a pattern is \((\sqrt{Minimum Reduced Area} - 1) * 2^8\). For the default Minimum Reduced Area of 64, this corresponds to a 1792x1792 maximum size. Increasing the Minimum Reduced Area enables larger pattern size but reduces the processing speed.

When a region is given, the method will ignore the pixels outside the region by internally setting them to 0 and setting EMatcher.DontCareThreshold to 1 if it wasn't set by the user. Thus, when working with an ERegion, all pixels that are black in the pattern will be discarded.

Consequently, when using binary images, the value 0 shouldn't be used if you use an ERegion for learning. 0's in your images should be replaced by 1's. This can be done with the EArithmeticLogicOperation.EArithmeticLogicOperation_Add mode of EasyImage.Oper.

LearnPattern() [5/8]

void eVision.EMatcher.LearnPattern

(

eVision.EROIC24

pattern

)

Learns a pattern to subsequently match in an image.

Parameters

pattern

Pattern to learn.

The maximum size for a pattern is \((\sqrt{Minimum Reduced Area} - 1) * 2^8\). For the default Minimum Reduced Area of 64, this corresponds to a 1792x1792 maximum size. Increasing the Minimum Reduced Area enables larger pattern size but reduces the processing speed.

When a region is given, the method will ignore the pixels outside the region by internally setting them to 0 and setting EMatcher.DontCareThreshold to 1 if it wasn't set by the user. Thus, when working with an ERegion, all pixels that are black in the pattern will be discarded.

Consequently, when using binary images, the value 0 shouldn't be used if you use an ERegion for learning. 0's in your images should be replaced by 1's. This can be done with the EArithmeticLogicOperation.EArithmeticLogicOperation_Add mode of EasyImage.Oper.

LearnPattern() [6/8]

void eVision.EMatcher.LearnPattern	(	eVision.EROIC24	pattern,
		eVision.EFrame	frame )

Learns a pattern to subsequently match in an image.

Parameters

pattern	Pattern to learn.
frame	Reference frame of the learned image

The maximum size for a pattern is \((\sqrt{Minimum Reduced Area} - 1) * 2^8\). For the default Minimum Reduced Area of 64, this corresponds to a 1792x1792 maximum size. Increasing the Minimum Reduced Area enables larger pattern size but reduces the processing speed.

When a region is given, the method will ignore the pixels outside the region by internally setting them to 0 and setting EMatcher.DontCareThreshold to 1 if it wasn't set by the user. Thus, when working with an ERegion, all pixels that are black in the pattern will be discarded.

Consequently, when using binary images, the value 0 shouldn't be used if you use an ERegion for learning. 0's in your images should be replaced by 1's. This can be done with the EArithmeticLogicOperation.EArithmeticLogicOperation_Add mode of EasyImage.Oper.

LearnPattern() [7/8]

void eVision.EMatcher.LearnPattern	(	eVision.EROIC24	pattern,
		eVision.ERegion	region )

Learns a pattern to subsequently match in an image.

Parameters

pattern	Pattern to learn.
region	Region in the pattern image to consider

The maximum size for a pattern is \((\sqrt{Minimum Reduced Area} - 1) * 2^8\). For the default Minimum Reduced Area of 64, this corresponds to a 1792x1792 maximum size. Increasing the Minimum Reduced Area enables larger pattern size but reduces the processing speed.

When a region is given, the method will ignore the pixels outside the region by internally setting them to 0 and setting EMatcher.DontCareThreshold to 1 if it wasn't set by the user. Thus, when working with an ERegion, all pixels that are black in the pattern will be discarded.

Consequently, when using binary images, the value 0 shouldn't be used if you use an ERegion for learning. 0's in your images should be replaced by 1's. This can be done with the EArithmeticLogicOperation.EArithmeticLogicOperation_Add mode of EasyImage.Oper.

LearnPattern() [8/8]

void eVision.EMatcher.LearnPattern	(	eVision.EROIC24	pattern,
		eVision.ERegion	region,
		eVision.EFrame	frame )

Learns a pattern to subsequently match in an image.

Parameters

pattern	Pattern to learn.
region	Region in the pattern image to consider
frame	Reference frame of the learned image

The maximum size for a pattern is \((\sqrt{Minimum Reduced Area} - 1) * 2^8\). For the default Minimum Reduced Area of 64, this corresponds to a 1792x1792 maximum size. Increasing the Minimum Reduced Area enables larger pattern size but reduces the processing speed.

When a region is given, the method will ignore the pixels outside the region by internally setting them to 0 and setting EMatcher.DontCareThreshold to 1 if it wasn't set by the user. Thus, when working with an ERegion, all pixels that are black in the pattern will be discarded.

Consequently, when using binary images, the value 0 shouldn't be used if you use an ERegion for learning. 0's in your images should be replaced by 1's. This can be done with the EArithmeticLogicOperation.EArithmeticLogicOperation_Add mode of EasyImage.Oper.

LearnPatterns() [1/12]

void eVision.EMatcher.LearnPatterns

(

eVision.EBaseROI[]

patterns

)

Learns multiple (at least 2) patterns.

Parameters

patterns

Vector of models to be learned (ROI).

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [2/12]

void eVision.EMatcher.LearnPatterns	(	eVision.EBaseROI[]	patterns,
		eVision.EFrame	frame )

Learns multiple (at least 2) patterns.

Parameters

patterns	Vector of models to be learned (ROI).
frame	Reference frame of the learned image

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [3/12]

void eVision.EMatcher.LearnPatterns	(	eVision.EBaseROI[]	patterns,
		eVision.ERegion[]	regions )

Learns multiple (at least 2) patterns.

Parameters

patterns	Vector of models to be learned (ROI).
regions	Vector of regions into the ROI where the learning is performed

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [4/12]

void eVision.EMatcher.LearnPatterns	(	eVision.EBaseROI[]	patterns,
		eVision.ERegion[]	regions,
		eVision.EFrame	frame )

Learns multiple (at least 2) patterns.

Parameters

patterns	Vector of models to be learned (ROI).
regions	Vector of regions into the ROI where the learning is performed
frame	Reference frame of the learned image

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [5/12]

void eVision.EMatcher.LearnPatterns

(

eVision.EROIBW8[]

patterns

)

Learns multiple (at least 2) patterns.

Parameters

patterns

Vector of models to be learned (ROI).

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [6/12]

void eVision.EMatcher.LearnPatterns	(	eVision.EROIBW8[]	patterns,
		eVision.EFrame	frame )

Learns multiple (at least 2) patterns.

Parameters

patterns	Vector of models to be learned (ROI).
frame	Reference frame of the learned image

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [7/12]

void eVision.EMatcher.LearnPatterns	(	eVision.EROIBW8[]	patterns,
		eVision.ERegion[]	regions )

Learns multiple (at least 2) patterns.

Parameters

patterns	Vector of models to be learned (ROI).
regions	Vector of regions into the ROI where the learning is performed

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [8/12]

void eVision.EMatcher.LearnPatterns	(	eVision.EROIBW8[]	patterns,
		eVision.ERegion[]	regions,
		eVision.EFrame	frame )

Learns multiple (at least 2) patterns.

Parameters

patterns	Vector of models to be learned (ROI).
regions	Vector of regions into the ROI where the learning is performed
frame	Reference frame of the learned image

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [9/12]

void eVision.EMatcher.LearnPatterns

(

eVision.EROIC24[]

patterns

)

Learns multiple (at least 2) patterns.

Parameters

patterns

Vector of models to be learned (ROI).

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [10/12]

void eVision.EMatcher.LearnPatterns	(	eVision.EROIC24[]	patterns,
		eVision.EFrame	frame )

Learns multiple (at least 2) patterns.

Parameters

patterns	Vector of models to be learned (ROI).
frame	Reference frame of the learned image

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [11/12]

void eVision.EMatcher.LearnPatterns	(	eVision.EROIC24[]	patterns,
		eVision.ERegion[]	regions )

Learns multiple (at least 2) patterns.

Parameters

patterns	Vector of models to be learned (ROI).
regions	Vector of regions into the ROI where the learning is performed

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

LearnPatterns() [12/12]

void eVision.EMatcher.LearnPatterns	(	eVision.EROIC24[]	patterns,
		eVision.ERegion[]	regions,
		eVision.EFrame	frame )

Learns multiple (at least 2) patterns.

Parameters

patterns	Vector of models to be learned (ROI).
regions	Vector of regions into the ROI where the learning is performed
frame	Reference frame of the learned image

Learning multiple patterns is useful when your object presents slight variations: shape deformation, lighting, perspective,... Each pattern is Learned and Matched independently and only the best patterns are kept. The options of the EMatcher are used for all of the patterns. We recommend setting a EMatcher.MaxOverlap when using this feature.

Load() [1/2]

void eVision.EMatcher.Load

(

eVision.ESerializer

serializer

)

Loads the EMatcher. The given ESerializer must have been created for reading.

Parameters

serializer

The serializer.

Load() [2/2]

void eVision.EMatcher.Load

(

string

path

)

Loads the EMatcher. The given ESerializer must have been created for reading.

Parameters

path	The file path.

Match() [1/8]

eVision.EFoundPattern[] eVision.EMatcher.Match

(

eVision.EROIBW8

image

)

Matches the pattern against an image.

Parameters

image

Pointer to the image/ROI within which the pattern will be searched for.

Match() [2/8]

eVision.EFoundPattern[] eVision.EMatcher.Match	(	eVision.EROIBW8	image,
		eVision.EFrame	frame )

Matches the pattern against an image.

Parameters

image	Pointer to the image/ROI within which the pattern will be searched for.
frame	Reference frame of the image

Match() [3/8]

eVision.EFoundPattern[] eVision.EMatcher.Match	(	eVision.EROIBW8	image,
		eVision.ERegion	region )

Matches the pattern against an image.

Parameters

image	Pointer to the image/ROI within which the pattern will be searched for.
region	Region within which the pattern will be searched for.

Match() [4/8]

eVision.EFoundPattern[] eVision.EMatcher.Match	(	eVision.EROIBW8	image,
		eVision.ERegion	region,
		eVision.EFrame	frame )

Matches the pattern against an image.

Parameters

image	Pointer to the image/ROI within which the pattern will be searched for.
region	Region within which the pattern will be searched for.
frame	Reference frame of the image

Match() [5/8]

eVision.EFoundPattern[] eVision.EMatcher.Match

(

eVision.EROIC24

image

)

Matches the pattern against an image.

Parameters

image

Pointer to the image/ROI within which the pattern will be searched for.

Match() [6/8]

eVision.EFoundPattern[] eVision.EMatcher.Match	(	eVision.EROIC24	image,
		eVision.EFrame	frame )

Matches the pattern against an image.

Parameters

image	Pointer to the image/ROI within which the pattern will be searched for.
frame	Reference frame of the image

Match() [7/8]

eVision.EFoundPattern[] eVision.EMatcher.Match	(	eVision.EROIC24	image,
		eVision.ERegion	region )

Matches the pattern against an image.

Parameters

image	Pointer to the image/ROI within which the pattern will be searched for.
region	Region within which the pattern will be searched for.

Match() [8/8]

eVision.EFoundPattern[] eVision.EMatcher.Match	(	eVision.EROIC24	image,
		eVision.ERegion	region,
		eVision.EFrame	frame )

Matches the pattern against an image.

Parameters

image	Pointer to the image/ROI within which the pattern will be searched for.
region	Region within which the pattern will be searched for.
frame	Reference frame of the image

Save() [1/2]

void eVision.EMatcher.Save

(

eVision.ESerializer

serializer

)

Saves the EMatcher. The given ESerializer must have been created for writing.

Parameters

serializer

The serializer.

Save() [2/2]

void eVision.EMatcher.Save

(

string

path

)

Saves the EMatcher. The given ESerializer must have been created for writing.

Parameters

path	The file path.

SetExtension()

void eVision.EMatcher.SetExtension	(	int	n32ExtensionX,
		int	n32ExtensionY )

Sets the extension of the matching ROI, i.e. puts the horizontal and vertical distances, in pixels, that the found pattern occurrences may fall outside the matching ROI. Such occurrences partially outside the ROI have their score corrected by the ratio between the pattern area outside the ROI and the pattern area inside.

Parameters

n32ExtensionX	extension outside the matching ROI along its Width, in pixels.
n32ExtensionY	extension outside the matching ROI along its Height, in pixels.

Deprecated

Use EMatcher.Extension instead.

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

SetPixelDimensions()

void eVision.EMatcher.SetPixelDimensions	(	float	width,
		float	height )

Sets the physical pixel dimensions.

Parameters

width	Width of a pixel.
height	Height of a pixel.

When an image has been acquired in such a way that the pixels are "non-square" the physical width and height of the area covered by a pixel are unequal, a form of anisotropy results. When rotated, the objects become skewed; rectangles become parallelograms. In such a situation, the pixel aspect ratio must be known to compensate it during matching. The aspect ratio is given by specifying the true width and height of a pixel. The specification of the pixel dimensions is only useful when rotation is used. Only the aspect ratio matters, so that relative width and height values can be given. By default, the pixel width and height are set to 1.0.

Deprecated

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

Property Documentation

AdvancedLearning

bool eVision.EMatcher.AdvancedLearning

getset

Toggle advanced learning.

When enabled, the advanced learning process will try to optimize learning parameters like the Minimum Reduced Area. Advanced learning uses the whole image context (parent EImage for an EROI) to optimize the parameters. The learning will take more time (from 1x to 5x longer) but the matching probability could be improved. The improvement strongly depends on the pattern source image.

The advanced learning is automatically disabled when the method EMatcher.MinReducedArea is called. In addition, advanced learning does not work when using EMatcher.DontCareThreshold and a masked image. However, it is compatible with the overload of EMatcher.LearnPattern taking an ERegion, which allows to do the same as EMatcher.DontCareThreshold.

ContrastMode

eVision.EMatchContrastMode eVision.EMatcher.ContrastMode

getset

Contrast mode.

By default, the contrast mode is set to EMatchContrastMode.EMatchContrastMode_Normal.

CorrelationMode

eVision.ECorrelationMode eVision.EMatcher.CorrelationMode

getset

Correlation mode.

This property tells what normalization rule is used to correlate the pattern to the image. By default, the correlation mode is set to ECorrelationMode.ECorrelationMode_Normalized.

DontCareThreshold

uint eVision.EMatcher.DontCareThreshold

getset

"Don't care" threshold.

If the pattern cannot be inscribed in a rectangle because there are foreign objects in a close neighborhood, mismatches can be avoided by using "don't care" pixels: all the pattern pixels whose value is strictly below DontCareThreshold will be ignored. By default, this property is set to 0: no "don't care" pixel exists.

Note

When you use the "don't care" feature, either the pattern is well contrasted from its background -then set DontCareThreshold to an appropriate thresholding value- or it is not -then set the background pixels of the pattern to some low value (by a masking operation) and set DontCareThreshold to this low value plus one.

In addition, EMatcher.AdvancedLearning does not work when using a don't care threshold and a masked image. However, it is compatible with the overload of EMatcher.LearnPattern taking an ERegion, which allows to do the same as EMatcher.DontCareThreshold.

EnableEarlyCandidateRejection

bool eVision.EMatcher.EnableEarlyCandidateRejection

getset

Whether to remove bad candidates in the early phases of the processing or not. Enabled by default.

To reduce the number of candidates, those failing to fill some criterion are removed. This makes processing faster, a downside is that some good candidates can be erroneously removed. We recommend setting this parameter to false if you observe that a slight change in the input conditions make processing fail. For example: changing the search ROI in the image slightly.

After disabling the early candidate rejection, you will probably have to increase EMatcher.MaxInitialPositions as more candidates will now be kept.

Extension

eVision.EIntSize eVision.EMatcher.Extension

getset

Sets/Gets the extension of the matching ROI, i.e. puts the horizontal and vertical distances, in pixels, that the found pattern occurrences may fall outside the matching ROI. Such occurrences partially outside the ROI have their score corrected by the ratio between the pattern area outside the ROI and the pattern area inside.

FilteringMode

eVision.EFilteringMode eVision.EMatcher.FilteringMode

getset

Filtering mode.

To achieve acceptable time performance, EasyMatch works by sub-sampling the pattern in the early phases of the processing. The filtering mode parameter allows to select the pre-processing type applied to the image before the decimation: averaging or low-pass filtering. By default, this property is set to EFilteringMode.EFilteringMode_Uniform, whereas the EFilteringMode.EFilteringMode_LowPass mode is indicated if the image presents sharp gray-level transitions.

FinalReduction

uint eVision.EMatcher.FinalReduction

getset

Index of the last reduction.

The pattern matching process is comprised of a few passes (typically 4) during which the position accuracy is improved by a factor of 2 (for all degrees of freedom). This is called a reduction. By default, the computation continues until an accuracy of one pixel is obtained. To speed up the process, the last reduction passes can be dropped, so lowering the accuracy. Anyway, the interpolation mode can then still be used. By default, this property is set to 0 (pixel accuracy). Value 1 corresponds to 2-pixels accuracy, 2 to 4, and so on. The range of values that can be used for this property is 0 to NumReductions-1.

InitialMinScore

float eVision.EMatcher.InitialMinScore

getset

Minimum score applied as a selection criterion in the early stages of the matching process.

When the search for matches starts, EasyMatch considers a set of candidate positions that it progressively refines. When they later appear to be bad candidates, they are rejected. Though it is the minimum score level that is used to reject bad matching positions at the final step of the matching process, the "initial minimum score" parameter is used to eliminate bad positions (whose score is not high enough) in the early stages of the matching processing. If the matching process is achieved in one step, only the minimum score parameter will be considered. By default, this property is set to -1.

Interpolate

bool eVision.EMatcher.Interpolate

getset

Interpolation mode.

By default, matching is done with a one-pixel precision for all degrees of freedom (translation, rotation and scaling). You can use an additional interpolation process to achieve sub-pixel accuracy. This generally leads to an improvement of the sub-pixel accuracy by a factor larger than 10. This is possible only when the found instances match closely the model. A score higher than 0.99 indicates that the instances are a close match of the model. In other words, the instance is considered to be more accurate when the score is higher. The added computational cost is low. By default, this property is set to false.

IsotropicScale

bool eVision.EMatcher.IsotropicScale

get

Flag indicating whether isotropic (as opposed to anisotropic) scaling is used.

true if isotropic (as opposed to anisotropic) scaling is used, i.e. when the scale factors in both the X and Y directions are equal.

LearningHasRegion

bool eVision.EMatcher.LearningHasRegion

get

Indicates whether a ERegion was used alongside the last learned pattern. Returns false if no learning was performed.

LearnTimeOut

ulong eVision.EMatcher.LearnTimeOut

getset

Time-out for the EMatcher.LearnPattern and EMatcher.LearnPatterns methods.

If the processing time of one of these functions becomes longer than the set time-out, the processing is stopped and an exception is thrown. In that case, the error code of the exception is EError.EError_TimeoutReached.

The time-out is set in microseconds.

This time-out is not a real time-out. The processing is stopped as soon as possible after the time-out has been reached. This means that the time elapsed effectively in the method can be greater than the time-out itself.

MatchTimeOut

ulong eVision.EMatcher.MatchTimeOut

getset

Time-out for the EMatcher.Match method.

If the processing time of one of these functions becomes longer than the set time-out, the processing is stopped and an exception is thrown. In that case, the error code of the exception is EError.EError_TimeoutReached.

The time-out is set in microseconds.

This time-out is not a real time-out. The processing is stopped as soon as possible after the time-out has been reached. This means that the time elapsed effectively in the method can be greater than the time-out itself.

MaxAngle

float eVision.EMatcher.MaxAngle

getset

Maximum angle, in the current angle unit.

The rotation of the pattern is allowed within the range (-1 <= MinAngle < MaxAngle <= 1 revolution). By default, both remain 0.

MaxInitialPositions

uint eVision.EMatcher.MaxInitialPositions

getset

Maximum number of positions at the first stage of the matching process.

When the search for matches starts, EasyMatch considers a set of candidate positions that it progressively refines. When they later appear to be bad candidates, they are rejected. Eventually, a maximum of EMatcher.MaxPositions is returned. In some circumstances, when the image contains features roughly similar to the pattern, these can confuse the matching process, resulting in false matches. To overcome this situation, increasing the number of initial positions will help. By default, this property is set to 0, indicating that the value of EMatcher.MaxPositions should be used instead.

MaxOverlap

float eVision.EMatcher.MaxOverlap

getset

Overlapping tolerance.

0.0 means all found patterns must be disconnected, 1.0 means they can fully overlap. Default: 1.0.

MaxPositions

uint eVision.EMatcher.MaxPositions

getset

Maximum number of positions.

Indicates how many matching positions have to be returned at a maximum. This number corresponds to the expected maximum number of occurrences of the pattern (it is sometimes advisable to use a few additional positions). By default, this property is set to 1.

MaxScale

float eVision.EMatcher.MaxScale

getset

Maximum scale factor for isotropic scaling.

Two scaling modes are allowed: in isotropic mode, the scale factor is identical in all directions; in anisotropic mode, the scale factors differ in the horizontal and vertical directions. To select the appropriate mode, it suffices to call the relevant Set member. The scaling of the pattern is recommended within the range (0.5 <= MinScale < MaxScale <= 2). By default, both remain 1. The same holds for anisotropic scale factors.

MaxScaleX

float eVision.EMatcher.MaxScaleX

getset

Maximum horizontal scale factor for anisotropic scaling.

Two scaling modes are allowed: in isotropic mode, the scale factor is identical in all directions; in anisotropic mode, the scale factors differ in the horizontal and vertical directions. To select the appropriate mode, it suffices to call the relevant Set member. The scaling of the pattern is recommended within the range (0.5 <= MinScaleX < MaxScaleX <= 2). By default, both remain 1. The same holds for anisotropic scale factors.

MaxScaleY

float eVision.EMatcher.MaxScaleY

getset

Maximum vertical scale factor for anisotropic scaling.

Two scaling modes are allowed: in isotropic mode, the scale factor is identical in all directions; in anisotropic mode, the scale factors differ in the horizontal and vertical directions. To select the appropriate mode, it suffices to call the relevant Set member. The scaling of the pattern is recommended within the range (0.5 <= MinScaleY < MaxScaleY <= 2). By default, both remain 1. The same holds for anisotropic scale factors.

MinAngle

float eVision.EMatcher.MinAngle

getset

Minimum angle, in the current angle unit.

The rotation of the pattern is allowed within the range (-1 <= MinAngle < MaxAngle <= 1 revolution). By default, both remain 0.

MinReducedArea

uint eVision.EMatcher.MinReducedArea

getset

Minimum reduced area parameter.

To achieve acceptable time performance, EasyMatch works by under-sampling the pattern in the early phases of the processing. This property tells how many pixels of the pattern are kept, at a minimum. By default, this property is set to 64, which is the right choice in most situations. Higher values are not recommended. Lower values can speed up the processing, but sometimes cause the matching process fail to find the best matches. To circumvent this problem, you can use guard positions, that is find more matches than expected and keep the good ones only.

Note

Changing this property invalidates any previous learning.

MinScale

float eVision.EMatcher.MinScale

getset

Minimum scale factor for isotropic scaling.

Two scaling modes are allowed: in isotropic mode, the scale factor is identical in all directions; in anisotropic mode, the scale factors differ in the horizontal and vertical directions. To select the appropriate mode, it suffices to call the relevant Set member. The scaling of the pattern is recommended within the range (0.5 <= MinScale < MaxScale <= 2). By default, both remain 1. The same holds for anisotropic scale factors.

MinScaleX

float eVision.EMatcher.MinScaleX

getset

Minimum horizontal scale factor for anisotropic scaling.

Two scaling modes are allowed: in isotropic mode, the scale factor is identical in all directions; in anisotropic mode, the scale factors differ in the horizontal and vertical directions. To select the appropriate mode, it suffices to call the relevant Set member. The scaling of the pattern is recommended within the range (0.5 <= MinScaleX < MaxScaleX <= 2). By default, both remain 1. The same holds for anisotropic scale factors.

MinScaleY

float eVision.EMatcher.MinScaleY

getset

Minimum vertical scale factor for anisotropic scaling.

Two scaling modes are allowed: in isotropic mode, the scale factor is identical in all directions; in anisotropic mode, the scale factors differ in the horizontal and vertical directions. To select the appropriate mode, it suffices to call the relevant Set member. The scaling of the pattern is recommended within the range (0.5 <= MinScaleY < MaxScaleY <= 2). By default, both remain 1. The same holds for anisotropic scale factors.

MinScore

float eVision.EMatcher.MinScore

getset

Minimum score.

This property indicates what score a match must reach to be considered as good, and to be returned in the list of positions; this selection criterion is applied at the final stage of the matching process. One good way to select the appropriate EMatcher.MinScore in a given context is to set it to -1 (any match will be retained), set EMatcher.MaxPositions to more than needed, and examine the returned scores after a matching. By default, this property is set to -1.

NumLearnedPatterns

uint eVision.EMatcher.NumLearnedPatterns

get

Indicates the number of patterns learnt. 0 is returned if no learning was performed.

NumPositions

uint eVision.EMatcher.NumPositions

get

Number of good matches found, as defined by EMatcher.MinScore and EMatcher.MaxPositions properties.

When multiple patterns are learned, the number of positions corresponding to the first pattern is returned.

Deprecated

Use the number of EFoundPattern objects returned by EMatcher.Match instead.

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

NumReductions

uint eVision.EMatcher.NumReductions

get

Number of reduction steps used in the matching process.

These depend on the actual pattern size, and on the MinReducedArea property. The FinalReduction property, used to speed up matching when coarse location is sufficient, must be set in range 0..NumReductions-1.

PatternHeight

int eVision.EMatcher.PatternHeight

get

Learned pattern height.

When multiple patterns are learned, the height of the first pattern is returned. Use EMatcher.GetPatternHeight for other learnt patterns.

PatternLearnt

bool eVision.EMatcher.PatternLearnt

get

Returns true after a learning operation has been successfully performed, indicating that the EMatcher object is ready for matching, and false otherwise.

PatternType

eVision.EImageType eVision.EMatcher.PatternType

get

Pixel type of the learned pattern.

PatternWidth

int eVision.EMatcher.PatternWidth

get

Learned pattern width.

When multiple patterns are learned, the width of the first pattern is returned. Use EMatcher.GetPatternWidth for other learnt patterns.

PixelDimensions

eVision.ESize eVision.EMatcher.PixelDimensions

getset

Gets/Sets the physical pixel dimensions.

When an image has been acquired in such a way that the pixels are "non-square" the physical width and height of the area covered by a pixel are unequal, a form of anisotropy results. When rotated, the objects become skewed; rectangles become parallelograms.

In such a situation, the pixel aspect ratio must be known to compensate it during matching. The aspect ratio is given by specifying the true width and height of a pixel.

The specification of the pixel dimensions is only useful when rotation is used.

Only the aspect ratio matters, so that relative width and height values can be given.

By default, the pixel width and height are set to 1.0.

Positions

eVision.EMatchPosition [] eVision.EMatcher.Positions

get

Returns a vector of EMatchPosition objects, each containing the position coordinates and other matching results.

When multiple patterns are learned, the positions corresponding to the first pattern are returned.

Deprecated

Use the EFoundPattern objects returned by EMatcher.Match instead.

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

Version

uint eVision.EMatcher.Version

staticget

Version number of the EMatcher object.