eVision.Legacy.EPolygonGauge Class Reference

Manages a polygon fitting gauge. More...

Inheritance diagram for eVision.Legacy.EPolygonGauge:

Collaboration diagram for eVision.Legacy.EPolygonGauge:

Public Member Functions
	EPolygonGauge ()
	Constructs a polygon measurement context.
	EPolygonGauge (eVision.Legacy.EPolygonGauge other)
	Constructs a polygon measurement context.
uint	AddSkipRange (uint start, uint end)
	Adds an item to the set of skip ranges and returns the index of the newly added range.
uint	AddSkipRange (eVision.EIntegerRange range)
	Adds an item to the set of skip ranges and returns the index of the newly added range.
void	GetSkipRange (uint index, ref uint start, ref uint end)
	Allows to retrieve the start and end values of the skip range corresponding to the given index, if it is valid (i.e. if it has previously been created by a call to the EPolygonGauge.AddSkipRange method.
eVision.EIntegerRange	GetSkipRange (uint index)
	Allows to retrieve the start and end values of the skip range corresponding to the given index, if it is valid (i.e. if it has previously been created by a call to the EPolygonGauge.AddSkipRange method.
void	RemoveSkipRange (uint index)
	After a call to EPolygonGauge.AddSkipRange, removes the skip range with the given index.
void	RemoveAllSkipRanges ()
	Removes all the skip ranges previously created by a call to EPolygonGauge.AddSkipRange.
void	CopyTo (eVision.Legacy.EPolygonGauge other, bool recursive)
	Copies all the data of the current EPolygonGauge object into another EPolygonGauge object, and returns it.
void	CopyTo (eVision.Legacy.EPolygonGauge other)
	Copies all the data of the current EPolygonGauge object into another EPolygonGauge object, and returns it.
override void	Process (eVision.EROIBW8 sourceImage, bool daughters)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
override void	Process (eVision.EROIBW8 sourceImage)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
override void	Process (eVision.EROIBW8 sourceImage, eVision.ERegion region, bool daughters)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
override void	Process (eVision.EROIBW8 sourceImage, eVision.ERegion region)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
void	Measure (eVision.EROIBW8 sourceImage)
	Triggers the point location or the model fitting operation.
void	Measure (eVision.EROIBW8 sourceImage, eVision.ERegion region)
	Triggers the point location or the model fitting operation.
void	MeasureSample (eVision.EROIBW8 image, int edgeIndex, int sampleIndex)
	Computes the sample points along the sample path whose index in the list is given by the edgeIndex and sampleIndex parameters.
void	MeasureSample (eVision.EROIBW8 image, eVision.ERegion region, int edgeIndex, int sampleIndex)
	Computes the sample points along the sample path whose index in the list is given by the edgeIndex and sampleIndex parameters.
override void	Draw (eVision.EDrawAdapter drawAdapter, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (eVision.EDrawAdapter drawAdapter, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (eVision.EDrawAdapter drawAdapter)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.ERGBColor color)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	DrawWithCurrentPen (IntPtr graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	DrawWithCurrentPen (IntPtr graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	DrawWithCurrentPen (IntPtr graphicContext)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override bool	HitTest (bool daughters)
	Checks whether the cursor is positioned over a handle (true) or not (false).
override bool	HitTest ()
	Checks whether the cursor is positioned over a handle (true) or not (false).
override void	Drag (int x, int y)
	Moves a handle to a new position and updates the position parameters of the gauge.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.ERGBColor color)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
Public Member Functions inherited from eVision.Legacy.EPolygonShape
	EPolygonShape ()
	Constructs a EPolygonShape.
	EPolygonShape (eVision.Legacy.EPolygonShape other)
	Constructs a EPolygonShape.
	EPolygonShape (eVision.EPoint[] vertices, bool closed)
	Constructs a EPolygonShape.
	EPolygonShape (eVision.EPoint[] vertices)
	Constructs a EPolygonShape.
void	AddVertexAtDisplayPosition (int x, int y)
	Add a vertex to the polygon at a position depending on a display coordinate. The current display parameters (zoom and pan) are used to find the best insert position.
void	RemoveVertexAtDisplayPosition (int x, int y)
	Remove the closest vertex to the display position (x,y).
void	SetCenterXY (float centerX, float centerY)
	Sets the center coordinates of a EPolygonShape object.
eVision.EPoint	GetVertex (int index)
	Gets a polygon vertex.
void	SetVertex (int index, eVision.EPoint pt)
	Sets a polygon vertex.
void	AppendVertex (eVision.EPoint pt)
	Append a polygon vertex after the last.
void	CopyTo (eVision.Legacy.EPolygonShape other, bool bRecursive)
	Copies all the data of the current EPolygonShape object into another EPolygonShape object and returns it.
void	CopyTo (eVision.Legacy.EPolygonShape other)
	Copies all the data of the current EPolygonShape object into another EPolygonShape object and returns it.
override void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (eVision.EDrawAdapter graphicContext)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (IntPtr graphicContext, eVision.ERGBColor color)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	DrawWithCurrentPen (IntPtr graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	DrawWithCurrentPen (IntPtr graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	DrawWithCurrentPen (IntPtr graphicContext)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Closest ()
	Find the daughter shape that is the closest to this shape. To retrieve the closest shape, use EShape.ClosestShape.
override bool	HitTest (bool bDaughters)
	Checks if there is a handle under the cursor.
override bool	HitTest ()
	Checks if there is a handle under the cursor.
override void	Drag (int n32CursorX, int n32CursorY)
	Moves a handle to a new position and updates the position parameters of the shape.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
override void	Draw (System.Drawing.Graphics graphicContext, eVision.ERGBColor color)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
Public Member Functions inherited from eVision.Legacy.EShape
eVision.Legacy.EShape	GetShapeNamed (string name)
	Returns a pointer to a daughter gauge or shape specified by its name.
bool	GetFound ()
	Flag indicating whether a measured shape has been found.
bool	GetAutoArrange ()
void	SetAutoArrange (bool bAutoArrange, bool bDaughters)
void	SetAutoArrange (bool bAutoArrange)
virtual void	SetFound (bool bFound, bool bDaughters)
virtual void	SetFound (bool bFound)
bool	GetInspected ()
void	SetInspected (bool bFound, bool bDaughters)
void	SetInspected (bool bFound)
bool	GetPassed ()
void	SetPassed (bool bFound, bool bDaughters)
void	SetPassed (bool bFound)
bool	GetQuickDraw ()
void	SetQuickDraw (bool bFound, bool bDaughters)
void	SetQuickDraw (bool bFound)
bool	GetOptionalDraw ()
void	SetOptionalDraw (bool bFound, bool bDaughters)
void	SetOptionalDraw (bool bFound)
bool	GetUserFlag ()
void	SetUserFlag (bool bUserFlag, bool bDaughters)
void	SetUserFlag (bool bUserFlag)
bool	GetAllocated ()
	Gets the allocated flag.
void	EnableBehaviorFilter (eVision.EShapeBehavior behavior, bool value)
	Modifies the so-called behavior filter that is a conjunction of conditions specifying when a shape or a gauge should be displayed or taken into consideration when monitoring the mouse interactions.
void	EnableBehaviorFilter (eVision.EShapeBehavior behavior)
	Modifies the so-called behavior filter that is a conjunction of conditions specifying when a shape or a gauge should be displayed or taken into consideration when monitoring the mouse interactions.
void	DisableBehaviorFilter (eVision.EShapeBehavior behavior)
	Disables (i.e. removes) a condition from the list of conditions in the behavior filter.
void	Attach (eVision.Legacy.EShape mother)
	Attaches the gauge to a mother gauge or shape.
void	Detach ()
	Detaches the gauge from its mother gauge or shape.
void	DetachDaughters ()
	Detaches the daughter gauges or shapes.
virtual eVision.Legacy.EShape	GetDaughter (uint index)
	Returns a pointer to the specified daughter gauge or shape.
bool	IsWorld ()
void	InvalidateWorld ()
	Invalidates the world shape for this shape and all its ancestors.
eVision.EPoint	LocalToSensor (eVision.EPoint LPoint)
	Transforms a point from local coordinates to sensor coordinates.
eVision.EPoint	SensorToLocal (eVision.EPoint SPoint)
	Transforms a point from sensor coordinates to local coordinates.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (IntPtr graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (IntPtr graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (IntPtr graphicContext)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (IntPtr graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (IntPtr graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (IntPtr graphicContext, eVision.ERGBColor color)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	DrawWithCurrentPen (IntPtr graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	DrawWithCurrentPen (IntPtr graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	DrawWithCurrentPen (IntPtr graphicContext)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
virtual void	SetZoom (float zoomX, float zoomY)
	Sets the horizontal and vertical zooming factors for drawing operations.
virtual void	SetZoom (float zoomX)
	Sets the horizontal and vertical zooming factors for drawing operations.
virtual void	SetZoom ()
	Sets the horizontal and vertical zooming factors for drawing operations.
virtual void	SetPan (float panX, float panY)
	Sets the horizontal and vertical panning values for drawing operations, expressed in pixels.
virtual void	SetPan (float panX)
	Sets the horizontal and vertical panning values for drawing operations, expressed in pixels.
virtual void	SetPan ()
	Sets the horizontal and vertical panning values for drawing operations, expressed in pixels.
bool	HitTest (bool bDaughters)
	Checks if there is a handle under the cursor.
bool	HitTest ()
	Checks if there is a handle under the cursor.
void	SetDraggingMode (eVision.EDraggingMode eDraggingMode, bool bDaughters)
	Sets the dragging mode which defines how the shape could be dragged.
void	SetDraggingMode (eVision.EDraggingMode eDraggingMode)
	Sets the dragging mode which defines how the shape could be dragged.
eVision.EDraggingMode	GetDraggingMode ()
	Gets the dragging mode which defines how the shape could be dragged.
void	SetCursor (int x, int y)
	Sets the cursor current coordinates.
void	Drag (int n32CursorX, int n32CursorY)
	Moves a handle to a new position and updates the position parameters of the shape.
void	Closest ()
	Find the daughter shape that is the closest to this shape. To retrieve the closest shape, use EShape.ClosestShape.
void	Save (string path, bool daughters)
	Loads a Shape.The given ESerializer must have been created for writing.
void	Save (string path)
	Loads a Shape.The given ESerializer must have been created for writing.
void	Save (eVision.ESerializer serializer, bool daughters)
	Loads a Shape.The given ESerializer must have been created for writing.
void	Save (eVision.ESerializer serializer)
	Loads a Shape.The given ESerializer must have been created for writing.
void	Load (string path, bool daughters)
	Loads a Shape.The given ESerializer must have been created for reading.
void	Load (string path)
	Loads a Shape.The given ESerializer must have been created for reading.
void	Load (eVision.ESerializer serializer, bool daughters)
	Loads a Shape.The given ESerializer must have been created for reading.
void	Load (eVision.ESerializer serializer)
	Loads a Shape.The given ESerializer must have been created for reading.
bool	HasProperty (string aProperty)
	Returns whether a EShape has a property named aProperty.
string	GetProperty (string aProperty)
	Gets the value of property aProperty. Throws an exception if no such property exists.
void	SetProperty (string aProperty, string aValue)
	Sets the value of property aProperty to aValue for this EShape.
void	SetPropertyRecursive (string aProperty, string aValue)
	Sets the value of property aProperty to aValue for this EShape and all of its daughters.
void	RemoveProperty (string aProperty)
	Removes the property name aProperty from the EShape.
bool	HasValidPolarityProperty ()
	Returns whether the EShape has a valid polarity property.
virtual void	EnableTypeFilter (uint un32Types)
	Enables the filter of the specified shape type.
virtual void	DisableTypeFilter ()
	Enables all shape types.
void	Draw (System.Drawing.Graphics graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (System.Drawing.Graphics graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (System.Drawing.Graphics graphicContext)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (System.Drawing.Graphics graphicContext, eVision.ERGBColor color, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (System.Drawing.Graphics graphicContext, eVision.ERGBColor color)
	Draws a graphical representation of a shape, as defined by EDrawingMode.

Properties
float	FilteringThreshold [get, set]
	Relative filtering threshold, that is the fraction of the average distance between the sampled points and the fitted model above which a point is filtered out.
uint	NumFilteringPasses [get, set]
	Number of filtering passes for a model fitting operation.
int	NumFilteringPassesInt [get, set]
uint	NumValidSamples [get]
	Number of valid sample points remaining after a model fitting operation.
float	AverageDistance [get]
	Average distance between the sampled points and the fitted model.
int	MinNumFitSamples [get, set]
	Returns the minimum number of samples required for fitting on each edges of the polygon.
uint	NumSkipRanges [get]
	Number of skip ranges in the gauge after a call to EPolygonGauge.AddSkipRange.
override eVision.EShapeType	Type [get]
	Shape type.
eVision.Legacy.EPolygon	Shape [get]
new bool	Active [get, set]
	Sets the flag indicating whether the gauge is active or not.
float	Tolerance [get, set]
	Searching area half thickness of the polygon fitting gauge.
bool	HVConstraint [get, set]
	Status of the restriction on the orientation of the point location gauge or model fitting sample paths.
eVision.ETransitionType	TransitionType [get, set]
	Transition type.
eVision.ETransitionChoice	TransitionChoice [get, set]
	Transition choice.
uint	TransitionIndex [get, set]
	Index (from 0 on) of the transition to be retained when the transition choice parameter is set to ETransitionChoice.ETransitionChoice_NthFromBegin or ETransitionChoice.ETransitionChoice_NthFromEnd.
uint	Threshold [get, set]
	Threshold level used to delimit significant peaks in the data profile.
uint	MinAmplitude [get, set]
	Offset added to the Threshold when a peak is to be detected.
uint	MinArea [get, set]
	Minimum area value.
uint	Thickness [get, set]
	Number of parallel segments used to extract the data profile.
uint	Smoothing [get, set]
	Number of pixels used for the low-pass filtering operation.
float	SamplingStep [get, set]
	Approximate distance between sampled points during a model fitting operation.
uint	NumSamples [get]
	Number of sampled points during the model fitting operation. The samples are distributed evenly on the polygon.
eVision.Legacy.EPolygonMeasurementMode	MeasurementMode [get, set]
	The polygon gauge measurement mode, in EPolygonMeasurementMode. The default mode is EPolygonMeasurementMode.EPolygonMeasurementMode_Global.
bool	EnableScaling [get, set]
	When using the EPolygonMeasurementMode.EPolygonMeasurementMode_Global mode, if EPolygonGauge.EnableScaling is enable then the best scale is evaluated.
eVision.Legacy.EPolygon	MeasuredPolygon [get]
	Returns the measured polygon (if found) or the nominal polygon otherwise.
Properties inherited from eVision.Legacy.EPolygonShape
eVision.EPoint	Center [get, set]
	Center point of the shape.
float	CenterX [get]
	Abscissa of the origin point of the shape.
float	CenterY [get]
	Ordinate of the origin point of the shape.
float	Angle [get, set]
	Orientation of the shape.
float	Scale [get, set]
	Scale of the polygon.
float	Length [get]
	Returns the length (perimeter) of the polygon.
bool	IsClosed [get, set]
	The polygon close attribute.
eVision.Legacy.EPolygon	Polygon [get, set]
	Sets/Gets the polygon according to a known EPolygon object.
int	NumVertices [get]
	Returns the number of polygon's vertices.
int	NumEdges [get]
	Returns the number of polygon's edges (or sides). Depends on the EPolygon.IsClosed status.
override eVision.EShapeType	Type [get]
	Shape type.
Properties inherited from eVision.Legacy.EShape
eVision.EShapeType	Type [get]
	Shape type.
string	Name [get, set]
	Name of the EShape object.
bool	Visible [get, set]
	Flag indicating whether the shape is visible or not.
bool	VisibleRecursive [set]
	Sets the flag indicating whether the shape and its daughter shapes are visible or not.
bool	Selected [get, set]
	Flag indicating whether the shape is selected or not.
bool	SelectedRecursive [set]
	Sets the flag indicating whether the shape and all its daughters are selected or not.
bool	Selectable [get, set]
	Flag indicating whether the shape can be selected or not.
bool	SelectableRecursive [set]
	Sets the flag indicating whether the shape and all its daughters can be selected or not.
bool	Dragable [get, set]
	Flag indicating whether the shape can be dragged or not.
bool	DragableRecursive [set]
	Sets the flag indicating whether the shape and all its daughters can be dragged or not.
bool	Resizable [get, set]
	Flag indicating whether the shape can be resized or not.
bool	ResizableRecursive [set]
	Sets the flag indicating whether the shape and all its daughters can be resized or not.
bool	Rotatable [get, set]
	Flag indicating whether the shape can be rotated or not.
bool	RotatableRecursive [set]
	Sets the flag indicating whether the shape and all its daughters can be rotated or not.
bool	Labeled [get, set]
	Flag indicating whether the shape label should be displayed or not.
bool	LabeledRecursive [set]
	Sets the flag indicating whether the shape label should be displayed or not. The flag is set in this shape and all its daughters.
virtual bool	Active [get, set]
	Flag indicating whether the shape is active or not.
virtual bool	ActiveRecursive [set]
	Sets the flag indicating whether the shape and all its daughters are active or not.
bool	ActualShape [get, set]
	Flag indicating whether an inquiry returns a result pertaining to the nominal gauge (false, default) or the fitted model (true).
bool	ActualShapeRecursive [set]
	Sets the flag indicating whether an inquiry returns a result pertaining to the nominal gauge (false, default) or the fitted model (true). The flag is set in this shape and all its daughters.
uint	NumDaughters [get]
	Number of daughters attached to the shape.
eVision.Legacy.EShape	Mother [get]
	Pointer to the mother shape.
eVision.Legacy.EWorldShape	WorldShape [get]
	World ancestor.
virtual float	ZoomX [get]
	Current horizontal zooming factor for drawing operations.
virtual float	ZoomY [get]
	Current vertical zooming factor for drawing operations.
virtual float	PanX [get]
	Current horizontal panning value for drawing operations, expressed in pixels. By default, no panning occurs.
virtual float	PanY [get]
	Current vertical panning value for drawing operations, expressed in pixels. By default, no panning occurs.
eVision.EDragHandle	HitHandle [get]
	Handle currently under the cursor.
eVision.Legacy.EShape	HitShape [get]
	Pointer to the shape currently under the cursor.
eVision.Legacy.EShape	ClosestShape [get]
	Closest shape among the daughters.

Detailed Description

Manages a polygon fitting gauge.

License(s): EasyGauge

Constructor & Destructor Documentation

EPolygonGauge() [1/2]

eVision.Legacy.EPolygonGauge.EPolygonGauge

(

)

Constructs a polygon measurement context.

With the default constructor, all the parameters are initialized to their respective default values.

With the copy constructor, the constructed polygon measurement context is based on a pre-existing EPolygonGauge object. The gauge children are also copied. Hierarchy copying through a copy constructor is always recursive. To disable this recursion, use instead the EPolygonGauge.CopyTo method.

EPolygonGauge() [2/2]

eVision.Legacy.EPolygonGauge.EPolygonGauge

(

eVision.Legacy.EPolygonGauge

other

)

Constructs a polygon measurement context.

Parameters

other

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

With the default constructor, all the parameters are initialized to their respective default values.

With the copy constructor, the constructed polygon measurement context is based on a pre-existing EPolygonGauge object. The gauge children are also copied. Hierarchy copying through a copy constructor is always recursive. To disable this recursion, use instead the EPolygonGauge.CopyTo method.

Member Function Documentation

AddSkipRange() [1/2]

uint eVision.Legacy.EPolygonGauge.AddSkipRange

(

eVision.EIntegerRange

range

)

Adds an item to the set of skip ranges and returns the index of the newly added range.

Parameters

range

The skip range.

The samples indices between start and end (including the boundaries) will be discarded during the measurement process.

This method allows to define skip ranges in an EPolygonGauge. This means that, at measure time, samples belonging to these ranges will not be taken into account.

A sample may belong to more than one skip range; to be discarded, a sample has to pertain to at least one range. Moreover, the skip ranges are allowed to overlap one another.

The range is allowed to be reversed (i.e. end is not required to be greater than start).

Also, start and end are not required to reference valid indices at the time of the call (i.e. the range may lie outside of the current return value for EPolygonGauge.NumSamples).

AddSkipRange() [2/2]

uint eVision.Legacy.EPolygonGauge.AddSkipRange	(	uint	start,
		uint	end )

Adds an item to the set of skip ranges and returns the index of the newly added range.

Parameters

start	Beginning of the skip range.
end	End of the skip range.

The samples indices between start and end (including the boundaries) will be discarded during the measurement process.

This method allows to define skip ranges in an EPolygonGauge. This means that, at measure time, samples belonging to these ranges will not be taken into account.

A sample may belong to more than one skip range; to be discarded, a sample has to pertain to at least one range. Moreover, the skip ranges are allowed to overlap one another.

The range is allowed to be reversed (i.e. end is not required to be greater than start).

Also, start and end are not required to reference valid indices at the time of the call (i.e. the range may lie outside of the current return value for EPolygonGauge.NumSamples).

Deprecated

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

CopyTo() [1/2]

void eVision.Legacy.EPolygonGauge.CopyTo

(

eVision.Legacy.EPolygonGauge

other

)

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

Parameters

other

Pointer to the EPolygonGauge object in which the current EPolygonGauge object data have to be copied.

In the overload taking a pointer, in case of a NULL pointer, a new EPolygonGauge object will be created and returned.

CopyTo() [2/2]

void eVision.Legacy.EPolygonGauge.CopyTo	(	eVision.Legacy.EPolygonGauge	other,
		bool	recursive )

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

Parameters

other	Pointer to the EPolygonGauge object in which the current EPolygonGauge object data have to be copied.
recursive	true if the children gauges have to be copied as well, false otherwise.

In the overload taking a pointer, in case of a NULL pointer, a new EPolygonGauge object will be created and returned.

Drag()

override void eVision.Legacy.EPolygonGauge.Drag	(	int	x,
		int	y )

Moves a handle to a new position and updates the position parameters of the gauge.

Parameters

x	Cursor current X coordinate.
y	Cursor current Y coordinate.

Draw() [1/15]

override void eVision.Legacy.EPolygonGauge.Draw

(

eVision.EDrawAdapter

drawAdapter

)

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

drawAdapter

A pointer to an EDrawAdapter (like the EWindowsDrawAdapter).

Draw() [2/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	eVision.EDrawAdapter	drawAdapter,
		eVision.EDrawingMode	drawingMode )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

drawAdapter	A pointer to an EDrawAdapter (like the EWindowsDrawAdapter).
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.

Draw() [3/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	eVision.EDrawAdapter	drawAdapter,
		eVision.EDrawingMode	drawingMode,
		bool	daughters )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

drawAdapter	A pointer to an EDrawAdapter (like the EWindowsDrawAdapter).
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.
daughters	true if the daughters gauges are to be displayed also.

Draw() [4/15]

override void eVision.Legacy.EPolygonGauge.Draw

(

IntPtr

graphicContext

)

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext

Handle of the device context on which to draw.

Deprecated

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

Draw() [5/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	IntPtr	graphicContext,
		eVision.EDrawingMode	drawingMode )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.

Deprecated

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

Draw() [6/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	IntPtr	graphicContext,
		eVision.EDrawingMode	drawingMode,
		bool	daughters )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.
daughters	true if the daughters gauges are to be displayed also.

Deprecated

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

Draw() [7/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	IntPtr	graphicContext,
		eVision.ERGBColor	color )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

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

Deprecated

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

Draw() [8/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		eVision.EDrawingMode	drawingMode )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.

Deprecated

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

Draw() [9/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	IntPtr	graphicContext,
		eVision.ERGBColor	color,
		eVision.EDrawingMode	drawingMode,
		bool	daughters )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.
daughters	true if the daughters gauges are to be displayed also.

Deprecated

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

Draw() [10/15]

override void eVision.Legacy.EPolygonGauge.Draw

(

System.Drawing.Graphics

graphicContext

)

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext

Handle of the device context on which to draw.

Deprecated

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

Draw() [11/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.EDrawingMode	drawingMode )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.

Deprecated

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

Draw() [12/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.EDrawingMode	drawingMode,
		bool	daughters )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.
daughters	true if the daughters gauges are to be displayed also.

Deprecated

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

Draw() [13/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

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

Deprecated

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

Draw() [14/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		eVision.EDrawingMode	drawingMode )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.

Deprecated

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

Draw() [15/15]

override void eVision.Legacy.EPolygonGauge.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.ERGBColor	color,
		eVision.EDrawingMode	drawingMode,
		bool	daughters )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.
daughters	true if the daughters gauges are to be displayed also.

Deprecated

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

DrawWithCurrentPen() [1/3]

override void eVision.Legacy.EPolygonGauge.DrawWithCurrentPen

(

IntPtr

graphicContext

)

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext

Handle of the device context on which to draw.

Deprecated

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

DrawWithCurrentPen() [2/3]

override void eVision.Legacy.EPolygonGauge.DrawWithCurrentPen	(	IntPtr	graphicContext,
		eVision.EDrawingMode	drawingMode )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.

Deprecated

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

DrawWithCurrentPen() [3/3]

override void eVision.Legacy.EPolygonGauge.DrawWithCurrentPen	(	IntPtr	graphicContext,
		eVision.EDrawingMode	drawingMode,
		bool	daughters )

Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.

Parameters

graphicContext	Handle of the device context on which to draw.
drawingMode	Indicates how the point location or model fitting gauge must be displayed, as defined by EDrawingMode.
daughters	true if the daughters gauges are to be displayed also.

Deprecated

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

GetSkipRange() [1/2]

eVision.EIntegerRange eVision.Legacy.EPolygonGauge.GetSkipRange

(

uint

index

)

Allows to retrieve the start and end values of the skip range corresponding to the given index, if it is valid (i.e. if it has previously been created by a call to the EPolygonGauge.AddSkipRange method.

Parameters

index

Index of the skip range.

Start is guaranteed to be smaller or equal to end.

GetSkipRange() [2/2]

void eVision.Legacy.EPolygonGauge.GetSkipRange	(	uint	index,
		ref uint	start,
		ref uint	end )

Allows to retrieve the start and end values of the skip range corresponding to the given index, if it is valid (i.e. if it has previously been created by a call to the EPolygonGauge.AddSkipRange method.

Parameters

index	Index of the skip range.
start	Beginning of the skip range.
end	End of the skip range.

Start is guaranteed to be smaller or equal to end.

Deprecated

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

HitTest() [1/2]

override bool eVision.Legacy.EPolygonGauge.HitTest

(

)

Checks whether the cursor is positioned over a handle (true) or not (false).

HitTest() [2/2]

override bool eVision.Legacy.EPolygonGauge.HitTest

(

bool

daughters

)

Checks whether the cursor is positioned over a handle (true) or not (false).

Parameters

daughters

true if the daughters gauges handles have to be considered as well.

Measure() [1/2]

void eVision.Legacy.EPolygonGauge.Measure

(

eVision.EROIBW8

sourceImage

)

Triggers the point location or the model fitting operation.

Parameters

sourceImage

Pointer to the source image.

When this method is called, and if not enough valid points are detected, then the method returns directly, and the measured gauge is set to the nominal parameters.

Measure() [2/2]

void eVision.Legacy.EPolygonGauge.Measure	(	eVision.EROIBW8	sourceImage,
		eVision.ERegion	region )

Triggers the point location or the model fitting operation.

Parameters

sourceImage	Pointer to the source image.
region	Region to use with the source image.

When this method is called, and if not enough valid points are detected, then the method returns directly, and the measured gauge is set to the nominal parameters.

MeasureSample() [1/2]

void eVision.Legacy.EPolygonGauge.MeasureSample	(	eVision.EROIBW8	image,
		eVision.ERegion	region,
		int	edgeIndex,
		int	sampleIndex )

Computes the sample points along the sample path whose index in the list is given by the edgeIndex and sampleIndex parameters.

Parameters

image	Pointer to the source image/ROI.
region	Region on which to measure.
edgeIndex	Index of the edge to inspect within the edges of the polygon.
sampleIndex	Index of the sample to inspect within the selected edge.

This method stores its results into a temporary variable inside the EPolygonGauge object.

MeasureSample() [2/2]

void eVision.Legacy.EPolygonGauge.MeasureSample	(	eVision.EROIBW8	image,
		int	edgeIndex,
		int	sampleIndex )

Computes the sample points along the sample path whose index in the list is given by the edgeIndex and sampleIndex parameters.

Parameters

image	Pointer to the source image/ROI.
edgeIndex	Index of the edge to inspect within the edges of the polygon.
sampleIndex	Index of the sample to inspect within the selected edge.

This method stores its results into a temporary variable inside the EPolygonGauge object.

Process() [1/4]

override void eVision.Legacy.EPolygonGauge.Process ( eVision.EROIBW8 sourceImage )

virtual

Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.

Parameters

sourceImage

Pointer to the source image.

When complex gauging is required, several gauges can be grouped together. Applying Process to the mother gauge or shape triggers the measurement of the whole. Only the active gauges will participate in the process.

Reimplemented from eVision.Legacy.EShape.

Process() [2/4]

override void eVision.Legacy.EPolygonGauge.Process ( eVision.EROIBW8 sourceImage, bool daughters )

virtual

Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.

Parameters

sourceImage	Pointer to the source image.
daughters	Flag indicating whether the daughters shapes inherit of the same behavior.

When complex gauging is required, several gauges can be grouped together. Applying Process to the mother gauge or shape triggers the measurement of the whole. Only the active gauges will participate in the process.

Reimplemented from eVision.Legacy.EShape.

Process() [3/4]

override void eVision.Legacy.EPolygonGauge.Process ( eVision.EROIBW8 sourceImage, eVision.ERegion region )

virtual

Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.

Parameters

sourceImage	Pointer to the source image.
region	Region to use with the source image.

When complex gauging is required, several gauges can be grouped together. Applying Process to the mother gauge or shape triggers the measurement of the whole. Only the active gauges will participate in the process.

Reimplemented from eVision.Legacy.EShape.

Process() [4/4]

override void eVision.Legacy.EPolygonGauge.Process ( eVision.EROIBW8 sourceImage, eVision.ERegion region, bool daughters )

virtual

Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.

Parameters

sourceImage	Pointer to the source image.
region	Region to use with the source image.
daughters	Flag indicating whether the daughters shapes inherit of the same behavior.

When complex gauging is required, several gauges can be grouped together. Applying Process to the mother gauge or shape triggers the measurement of the whole. Only the active gauges will participate in the process.

Reimplemented from eVision.Legacy.EShape.

RemoveAllSkipRanges()

void eVision.Legacy.EPolygonGauge.RemoveAllSkipRanges

(

)

Removes all the skip ranges previously created by a call to EPolygonGauge.AddSkipRange.

RemoveSkipRange()

void eVision.Legacy.EPolygonGauge.RemoveSkipRange

(

uint

index

)

After a call to EPolygonGauge.AddSkipRange, removes the skip range with the given index.

Parameters

index

Index of the skip range to remove, as returned by EPolygonGauge.AddSkipRange.

Property Documentation

Active

new bool eVision.Legacy.EPolygonGauge.Active

getset

Sets the flag indicating whether the gauge is active or not.

When complex gauging is required, several gauges can be grouped together. Applying EPolygonGauge.Process to the mother gauge or shape triggers the measurement of the whole. Only the active gauges will participate in the process. By default, the gauge is active (true).

AverageDistance

float eVision.Legacy.EPolygonGauge.AverageDistance

get

Average distance between the sampled points and the fitted model.

Irrelevant in case of a point location operation.

EnableScaling

bool eVision.Legacy.EPolygonGauge.EnableScaling

getset

When using the EPolygonMeasurementMode.EPolygonMeasurementMode_Global mode, if EPolygonGauge.EnableScaling is enable then the best scale is evaluated.

FilteringThreshold

float eVision.Legacy.EPolygonGauge.FilteringThreshold

getset

Relative filtering threshold, that is the fraction of the average distance between the sampled points and the fitted model above which a point is filtered out.

Irrelevant in case of a point location operation.

During a model fitting operation, the "filtering" process can be invoked to remove outliers, i.e. points that were located significantly far away from the fitted model (so that their position is dubious).

HVConstraint

bool eVision.Legacy.EPolygonGauge.HVConstraint

getset

Status of the restriction on the orientation of the point location gauge or model fitting sample paths.

Sample paths are the point location gauges placed along the model to be fitted.

MeasuredPolygon

eVision.Legacy.EPolygon eVision.Legacy.EPolygonGauge.MeasuredPolygon

get

Returns the measured polygon (if found) or the nominal polygon otherwise.

Use method EShape.GetFound to get the status of the measurement. EPolygonGauge.MeasuredPolygon returns a successful fitted polygon if EShape.GetFound is true, otherwise it returns the orginal (nominal) polygon.

MeasurementMode

eVision.Legacy.EPolygonMeasurementMode eVision.Legacy.EPolygonGauge.MeasurementMode

getset

The polygon gauge measurement mode, in EPolygonMeasurementMode. The default mode is EPolygonMeasurementMode.EPolygonMeasurementMode_Global.

MinAmplitude

uint eVision.Legacy.EPolygonGauge.MinAmplitude

getset

Offset added to the Threshold when a peak is to be detected.

When analyzing a derivative profile, a peak is made up of consecutive pixel values above Threshold. To detect weak [strong] transitions, lower [raise] the Threshold value.

To avoid interference of noise, an additional parameter is provided. The MinAmplitude parameter is an offset added to Threshold when a peak is to be detected.

When the pixel values of the derivative profile do not reach Threshold + MinAmplitude, the peak is not taken into account. Anyway, when a peak is taken into account, all the pixels with values above Threshold are considered (for more accuracy). Setting the MinAmplitude value to 0 merely cancels its effect.

MinArea

uint eVision.Legacy.EPolygonGauge.MinArea

getset

Minimum area value.

A transition is detected if its derivative peak reaches Threshold + MinAmplitude value, and then declared valid if the area between the peak curve and the horizontal at level Threshold reaches the MinArea value.

MinNumFitSamples

int eVision.Legacy.EPolygonGauge.MinNumFitSamples

getset

Returns the minimum number of samples required for fitting on each edges of the polygon.

NumFilteringPasses

uint eVision.Legacy.EPolygonGauge.NumFilteringPasses

getset

Number of filtering passes for a model fitting operation.

Irrelevant in case of a point location operation.

During a filtering pass, the points that are too distant from the model are discarded.

During a model fitting operation, the "filtering" process can be invoked to remove outliers, i.e. points that were located significantly far away from the fitted model (so that their position is dubious).

By default (the number of filtering passes is 0), the outliers rejection process is disabled.

NumFilteringPassesInt

int eVision.Legacy.EPolygonGauge.NumFilteringPassesInt

getset

NumSamples

uint eVision.Legacy.EPolygonGauge.NumSamples

get

Number of sampled points during the model fitting operation. The samples are distributed evenly on the polygon.

After a model fitting operation, a number of points have been fitted along the model. Among them, some are not reliable because of their Area value. Among the remaining ones, some are filtered out (NumFilteringPasses, FilteringThreshold).

NumSkipRanges

uint eVision.Legacy.EPolygonGauge.NumSkipRanges

get

Number of skip ranges in the gauge after a call to EPolygonGauge.AddSkipRange.

NumValidSamples

uint eVision.Legacy.EPolygonGauge.NumValidSamples

get

Number of valid sample points remaining after a model fitting operation.

Irrelevant in case of a point location operation.

After a model fitting operation, a number of points have been fitted along the model. Among them, some are not reliable because of their Area value. Among the remaining ones, some are filtered out (NumFilteringPasses, FilteringThreshold).

SamplingStep

float eVision.Legacy.EPolygonGauge.SamplingStep

getset

Approximate distance between sampled points during a model fitting operation.

Irrelevant in case of a point location operation.

To fit a model, a series of point location operations are performed along the model. The point location gauges spacing is given by the sampling step.

By default, the sampling step is set to 5, which means 5 pixels when the field of view is not calibrated, and 5 physical units in case of a calibrated field of view.

Be aware that if the sampling step is too large, the number of sampled points along the model will not be sufficient enough to accurately locate it.

Shape

eVision.Legacy.EPolygon eVision.Legacy.EPolygonGauge.Shape

get

Smoothing

uint eVision.Legacy.EPolygonGauge.Smoothing

getset

Number of pixels used for the low-pass filtering operation.

To reduce the effect of noise, the profile data can be low-pass filtered along the point location gauge direction.

Thickness

uint eVision.Legacy.EPolygonGauge.Thickness

getset

Number of parallel segments used to extract the data profile.

To reduce the effect of noise and/or strengthen a transition, several parallel profiles can be accumulated.

Threshold

uint eVision.Legacy.EPolygonGauge.Threshold

getset

Threshold level used to delimit significant peaks in the data profile.

When analyzing a derivative profile, a peak is made up of consecutive pixel values above Threshold. To detect weak [strong] transitions, lower [raise] the Threshold value.

To avoid interference of noise, an additional parameter is provided. The MinAmplitude parameter is an offset added to Threshold when a peak is to be detected.

When the pixel values of the derivative profile do not reach Threshold + MinAmplitude, the peak is not taken into account. Anyway, when a peak is taken into account, all the pixels with values above Threshold are considered (for more accuracy). Setting the MinAmplitude value to 0 merely cancels its effect.

Tolerance

float eVision.Legacy.EPolygonGauge.Tolerance

getset

Searching area half thickness of the polygon fitting gauge.

A polygon fitting gauge is fully defined knowing its nominal positions (vertices), its nominal origin, angle and scale, and its outline tolerance.

By default, the searching area thickness of the polygon fitting gauge is 20 (2x10), which means 20 pixels when the field of view is not calibrated, and 20 physical units in case of a calibrated field of view.

TransitionChoice

eVision.ETransitionChoice eVision.Legacy.EPolygonGauge.TransitionChoice

getset

Transition choice.

Several peaks may be detected along a point location gauge. This parameter helps to select the desired transition.

In case of ETransitionChoice.ETransitionChoice_NthFromBegin or ETransitionChoice.ETransitionChoice_NthFromEnd transition choice, set EPolygonGauge.TransitionIndex to specify the desired transition.

By default, the selected transition corresponds to the one with the largest amplitude (ETransitionChoice.ETransitionChoice_LargestAmplitude).

TransitionIndex

uint eVision.Legacy.EPolygonGauge.TransitionIndex

getset

Index (from 0 on) of the transition to be retained when the transition choice parameter is set to ETransitionChoice.ETransitionChoice_NthFromBegin or ETransitionChoice.ETransitionChoice_NthFromEnd.

Several peaks may be detected along a point location gauge. This parameter helps to select the desired transition.

By default, the first transition is retained (the index value is 0).

TransitionType

eVision.ETransitionType eVision.Legacy.EPolygonGauge.TransitionType

getset

Transition type.

The type of a transition tells whether it crosses increasing or decreasing gray-level values. This helps discriminate between nearby edges of an object.

By default, the searched transition type is indifferently a black to white or a white to black transition (ETransitionType.ETransitionType_BwOrWb).

Type

override eVision.EShapeType eVision.Legacy.EPolygonGauge.Type

get

Shape type.