eVision.Legacy.ERectangleGauge Class Reference

Manages a rectangle fitting gauge. More...

Inheritance diagram for eVision.Legacy.ERectangleGauge:

Collaboration diagram for eVision.Legacy.ERectangleGauge:

Public Member Functions
None	__init__ (self)
	Constructs a rectangle measurement context.
None	__init__ (self, eVision.Legacy.ERectangleGauge other)
	Constructs a rectangle measurement context.
int	AddSkipRange (self, eVision.EIntegerRange range)
	Adds an item to the set of skip ranges and returns the index of the newly added range.
eVision.EIntegerRange	GetSkipRange (self, int index)
	Allows to retrieve the start and end values of the skip range corresponding to the given index, if it is valid (i.e.
None	RemoveSkipRange (self, int index)
	After a call to eVision.Legacy.ERectangleGauge.AddSkipRange, removes the skip range with the given index.
None	RemoveAllSkipRanges (self)
	Removes all the skip ranges previously created by a call to eVision.Legacy.ERectangleGauge.AddSkipRange.
None	CopyTo (self, eVision.Legacy.ERectangleGauge other, bool recursive)
	Copies all the data of the current eVision.Legacy.ERectangleGauge object into another eVision.Legacy.ERectangleGauge object, and returns it.
None	CopyTo (self, eVision.Legacy.ERectangleGauge other)
	Copies all the data of the current eVision.Legacy.ERectangleGauge object into another eVision.Legacy.ERectangleGauge object, and returns it.
None	DisableInnerFiltering (self)
	Disables inner sampled point filtering.
None	Process (self, eVision.EROIBW8|None sourceImage, bool daughters)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
None	Process (self, eVision.EROIBW8|None sourceImage)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
None	Process (self, eVision.EROIBW8|None sourceImage, eVision.ERegion region, bool daughters)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
None	Process (self, eVision.EROIBW8|None sourceImage, eVision.ERegion region)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
None	Measure (self, eVision.EROIBW8|None sourceImage)
	Triggers the point location or the model fitting operation.
None	Measure (self, eVision.EROIBW8|None sourceImage, eVision.ERegion region)
	Triggers the point location or the model fitting operation.
None	MeasureWithoutFitting (self, eVision.EROIBW8|None sourceImage)
	Triggers the point location without rectangle fitting operation.
None	MeasureWithoutFitting (self, eVision.EROIBW8|None sourceImage, eVision.ERegion region)
	Triggers the point location without rectangle fitting operation.
None	MeasureSample (self, eVision.EROIBW8|None sourceImage, int pathIndex)
	Computes the sample points along the sample path whose index in the list is given by the pathIndex parameter.
None	MeasureSample (self, eVision.EROIBW8|None sourceImage, eVision.ERegion region, int pathIndex)
	Computes the sample points along the sample path whose index in the list is given by the pathIndex parameter.
eVision.EPoint	GetMeasuredPoint (self, int index)
	Returns the coordinates of a sample point, measured along one of the sample paths of the gauge.
eVision.EPoint	GetMeasuredPoint (self)
	Returns the coordinates of a sample point, measured along one of the sample paths of the gauge.
None	Draw (self, eVision.EDrawAdapter|None graphicContext, eVision.EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter|None graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter|None graphicContext)
	Draws a graphical representation of a point location or model fitting gauge, as defined by eVision.EDrawingMode.
None	Plot (self, eVision.EDrawAdapter|None graphicContext, eVision.EPlotItem drawItems, float width, float height, float originX, float originY)
	Draws the profile that is crossed by one of the sample paths of the gauge, as defined by eVision.EPlotItem.
None	Plot (self, eVision.EDrawAdapter|None graphicContext, eVision.EPlotItem drawItems, float width, float height, float originX)
	Draws the profile that is crossed by one of the sample paths of the gauge, as defined by eVision.EPlotItem.
None	Plot (self, eVision.EDrawAdapter|None graphicContext, eVision.EPlotItem drawItems, float width, float height)
	Draws the profile that is crossed by one of the sample paths of the gauge, as defined by eVision.EPlotItem.
bool	HitTest (self, bool daughters)
	Checks whether the cursor is positioned over a handle (true) or not (false).
bool	HitTest (self)
	Checks whether the cursor is positioned over a handle (true) or not (false).
None	Drag (self, int x, int y)
	Moves a handle to a new position and updates the position parameters of the gauge.
bool	GetSamplex (self, eVision.EPoint pt, int index)
	Allows to retrieve information on the samples found along the x edge.
None	GetSamplex (self, eVision.Legacy.ESamplePoint sp, int index)
	Allows to retrieve information on the samples found along the x edge.
bool	GetSamplex (self, eVision.EPeak pk, int index)
	Allows to retrieve information on the samples found along the x edge.
bool	GetSampley (self, eVision.EPoint pt, int index)
	Allows to retrieve information on the samples found along the y edge.
None	GetSampley (self, eVision.Legacy.ESamplePoint sp, int index)
	Allows to retrieve information on the samples found along the y edge.
bool	GetSampley (self, eVision.EPeak pk, int index)
	Allows to retrieve information on the samples found along the y edge.
bool	GetSampleX (self, eVision.EPoint pt, int index)
	Allows to retrieve information on the samples found along the X edge.
None	GetSampleX (self, eVision.Legacy.ESamplePoint sp, int index)
	Allows to retrieve information on the samples found along the X edge.
bool	GetSampleX (self, eVision.EPeak pk, int index)
	Allows to retrieve information on the samples found along the X edge.
bool	GetSampleY (self, eVision.EPoint pt, int index)
	Allows to retrieve information on the samples found along the Y edge.
None	GetSampleY (self, eVision.Legacy.ESamplePoint sp, int index)
	Allows to retrieve information on the samples found along the Y edge.
bool	GetSampleY (self, eVision.EPeak pk, int index)
	Allows to retrieve information on the samples found along the Y edge.
bool	GetSampleLeftEdge (self, eVision.EPoint pt, int index)
	Allows to retrieve information on the samples found along the leftmost edge.
None	GetSampleLeftEdge (self, eVision.Legacy.ESamplePoint sp, int index)
	Allows to retrieve information on the samples found along the leftmost edge.
bool	GetSampleLeftEdge (self, eVision.EPeak pk, int index)
	Allows to retrieve information on the samples found along the leftmost edge.
bool	GetSampleLowerEdge (self, eVision.EPoint pt, int index)
	Allows to retrieve information on the samples found along the lower edge.
None	GetSampleLowerEdge (self, eVision.Legacy.ESamplePoint sp, int index)
	Allows to retrieve information on the samples found along the lower edge.
bool	GetSampleLowerEdge (self, eVision.EPeak pk, int index)
	Allows to retrieve information on the samples found along the lower edge.
bool	GetSampleRightEdge (self, eVision.EPoint pt, int index)
	Allows to retrieve information on the samples found along the rightmost edge.
None	GetSampleRightEdge (self, eVision.Legacy.ESamplePoint sp, int index)
	Allows to retrieve information on the samples found along the rightmost edge.
bool	GetSampleRightEdge (self, eVision.EPeak pk, int index)
	Allows to retrieve information on the samples found along the rightmost edge.
bool	GetSampleUpperEdge (self, eVision.EPoint pt, int index)
	Allows to retrieve information on the samples found along the upper edge.
None	GetSampleUpperEdge (self, eVision.Legacy.ESamplePoint sp, int index)
	Allows to retrieve information on the samples found along the upper edge.
bool	GetSampleUpperEdge (self, eVision.EPeak pk, int index)
	Allows to retrieve information on the samples found along the upper edge.
bool	GetSample (self, eVision.EPoint pt, int index)
None	GetSample (self, eVision.Legacy.ESamplePoint sp, int index)
float	FilteringThreshold (self)
	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.
	FilteringThreshold (self, float value)
	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.
int	NumFilteringPasses (self)
	Number of filtering passes for a model fitting operation.
	NumFilteringPasses (self, int value)
	Number of filtering passes for a model fitting operation.
int	NumValidSamples (self)
	Number of valid sample points remaining after a model fitting operation.
float	AverageDistance (self)
	Average distance between the sampled points and the fitted model.
list[int]	MinNumFitSamples (self)
	Sets/Gets the minimum number of samples required for fitting the shape.
	MinNumFitSamples (self, list[int] value)
	Sets/Gets the minimum number of samples required for fitting the shape.
int	NumSkipRanges (self)
	Number of skip ranges in the gauge after a call to eVision.Legacy.ERectangleGauge.AddSkipRange.
eVision.EShapeType	Type (self)
	Shape type.
eVision.Legacy.ERectangle	Shape (self)
bool	Active (self)
	Sets the flag indicating whether the gauge is active or not.
	Active (self, bool value)
	Sets the flag indicating whether the gauge is active or not.
bool	RectangularSamplingArea (self)
	Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.
	RectangularSamplingArea (self, bool value)
	Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.
float	InnerFilteringThreshold (self)
	Sampled point inner filtering threshold.
	InnerFilteringThreshold (self, float value)
	Sampled point inner filtering threshold.
bool	InnerFilteringEnabled (self)
	Getter method for the GetInnerFilteringEnabled property.
int	ActiveEdges (self)
	Active edges as defined in eVision.EDragHandle.
	ActiveEdges (self, int value)
	Active edges as defined in eVision.EDragHandle.
float	Tolerance (self)
	Searching area half thickness of the rectangle fitting gauge.
	Tolerance (self, float value)
	Searching area half thickness of the rectangle fitting gauge.
bool	HVConstraint (self)
	Status of the restriction on the orientation of the point location gauge or model fitting sample paths.
	HVConstraint (self, bool value)
	Status of the restriction on the orientation of the point location gauge or model fitting sample paths.
eVision.ETransitionType	TransitionType (self)
	Transition type.
	TransitionType (self, eVision.ETransitionType value)
	Transition type.
eVision.ETransitionChoice	TransitionChoice (self)
	Transition choice.
	TransitionChoice (self, eVision.ETransitionChoice value)
	Transition choice.
int	TransitionIndex (self)
	Index (from 0 on) of the transition to be retained when the transition choice parameter is set to eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd.
	TransitionIndex (self, int value)
	Index (from 0 on) of the transition to be retained when the transition choice parameter is set to eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd.
int	Threshold (self)
	Threshold level used to delimit significant peaks in the data profile.
	Threshold (self, int value)
	Threshold level used to delimit significant peaks in the data profile.
int	MinAmplitude (self)
	Offset added to the Threshold when a peak is to be detected.
	MinAmplitude (self, int value)
	Offset added to the Threshold when a peak is to be detected.
int	MinArea (self)
	Minimum area value.
	MinArea (self, int value)
	Minimum area value.
int	Thickness (self)
	Number of parallel segments used to extract the data profile.
	Thickness (self, int value)
	Number of parallel segments used to extract the data profile.
int	Smoothing (self)
	Number of pixels used for the low-pass filtering operation.
	Smoothing (self, int value)
	Number of pixels used for the low-pass filtering operation.
float	SamplingStep (self)
	Approximate distance between sampled points during a model fitting operation.
	SamplingStep (self, float value)
	Approximate distance between sampled points during a model fitting operation.
int	NumSamples (self)
	Number of sampled points during the model fitting operation.
int	NumSamplesx (self)
	Number of sampled points found on edge x during the measure operation.
int	NumSamplesy (self)
	Number of sampled points found on edge y during the measure operation.
int	NumSamplesX (self)
	Number of sampled points found on edge X during the measure operation.
int	NumSamplesY (self)
	Number of sampled points found on edge Y during the measure operation.
int	NumSamplesLeftEdge (self)
	Number of sampled points found on leftmost edge during the measure operation.
int	NumSamplesRightEdge (self)
	Number of sampled points found on rightmost edge during the measure operation.
int	NumSamplesLowerEdge (self)
	Number of sampled points found on lower edge during the measure operation.
int	NumSamplesUpperEdge (self)
	Number of sampled points found on upper edge during the measure operation.
bool	KnownAngle (self)
	Flag indicating whether the rotation angle of the rectangle to be fitted is known or not.
	KnownAngle (self, bool value)
	Flag indicating whether the rotation angle of the rectangle to be fitted is known or not.
eVision.Legacy.ERectangle	MeasuredRectangle (self)
	Information pertaining to the fitted rectangle.
bool	Valid (self)
	Flag indicating if at least one valid transition has been found.
Public Member Functions inherited from eVision.Legacy.ERectangleShape
None	SetCenterXY (self, float centerX, float centerY)
	Sets the center coordinates of a eVision.Legacy.ERectangleShape object.
None	SetFromTwoPoints (self, eVision.EPoint origin, eVision.EPoint end)
	Sets the geometric parameters of an eVision.Legacy.ERectangleShape object using two opposed corners.
None	SetFromOppositeCorners (self, eVision.EPoint origin, eVision.EPoint end)
	Sets the geometric parameters of an eVision.Legacy.ERectangleShape object using two opposed corners.
None	SetFromOriginMiddleEnd (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end)
	Sets the geometric parameters of an eVision.Legacy.ERectangleShape object using three corners.
None	SetFromThreeCorners (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end)
	Sets the geometric parameters of an eVision.Legacy.ERectangleShape object using three corners.
None	SetSize (self, float sizeX, float sizeY)
	Sets the size of a eVision.Legacy.ERectangleShape object.
eVision.EPoint	GetPoint (self, float fractionX, float fractionY)
	Returns the coordinates of a particular point, specified by its location in the eVision.Legacy.ERectangleShape area.
None	GetMidEdges (self, eVision.EPoint x, eVision.EPoint XX, eVision.EPoint y, eVision.EPoint YY)
	Retrieves the center coordinates of each edge of a eVision.Legacy.ERectangleShape object.
None	GetCorners (self, eVision.EPoint xy, eVision.EPoint XXy, eVision.EPoint xYY, eVision.EPoint XXYY)
	Retrieves the coordinates of each corner of a eVision.Legacy.ERectangleShape object.
None	GetEdges (self, eVision.Legacy.ELine x, eVision.Legacy.ELine XX, eVision.Legacy.ELine y, eVision.Legacy.ELine YY)
	Retrieves each edge of a eVision.Legacy.ERectangleShape object.
None	Closest (self)
	Find the daughter shape that is the closest to this shape.
eVision.EPoint	Center (self)
	Center point of the shape.
	Center (self, eVision.EPoint value)
	Center point of the shape.
float	CenterX (self)
	Abscissa of the origin point of the shape.
float	CenterY (self)
	Ordinate of the origin point of the shape.
float	Angle (self)
	Orientation of the shape.
	Angle (self, float value)
	Orientation of the shape.
float	Scale (self)
	Horizontal sensor resolution, in pixels per unit.
	Scale (self, float value)
	Horizontal sensor resolution, in pixels per unit.
float	SizeX (self)
	X size of the eVision.Legacy.ERectangleShape.
float	SizeY (self)
	Y size of the eVision.Legacy.ERectangleShape.
Public Member Functions inherited from eVision.Legacy.EShape
eVision.Legacy.EShape|None	GetShapeNamed (self, str name)
	Returns a pointer to a daughter gauge or shape specified by its name.
bool	GetFound (self)
	Flag indicating whether a measured shape has been found.
bool	GetAutoArrange (self)
None	SetAutoArrange (self, bool bAutoArrange, bool bDaughters)
None	SetAutoArrange (self, bool bAutoArrange)
None	SetFound (self, bool bFound, bool bDaughters)
None	SetFound (self, bool bFound)
bool	GetInspected (self)
None	SetInspected (self, bool bFound, bool bDaughters)
None	SetInspected (self, bool bFound)
bool	GetPassed (self)
None	SetPassed (self, bool bFound, bool bDaughters)
None	SetPassed (self, bool bFound)
bool	GetQuickDraw (self)
None	SetQuickDraw (self, bool bFound, bool bDaughters)
None	SetQuickDraw (self, bool bFound)
bool	GetOptionalDraw (self)
None	SetOptionalDraw (self, bool bFound, bool bDaughters)
None	SetOptionalDraw (self, bool bFound)
bool	GetUserFlag (self)
None	SetUserFlag (self, bool bUserFlag, bool bDaughters)
None	SetUserFlag (self, bool bUserFlag)
bool	GetAllocated (self)
	Gets the allocated flag.
None	EnableBehaviorFilter (self, 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.
None	EnableBehaviorFilter (self, 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.
None	DisableBehaviorFilter (self, eVision.EShapeBehavior behavior)
	Disables (i.e.
None	Attach (self, eVision.Legacy.EShape|None mother)
	Attaches the gauge to a mother gauge or shape.
None	Detach (self)
	Detaches the gauge from its mother gauge or shape.
None	DetachDaughters (self)
	Detaches the daughter gauges or shapes.
eVision.Legacy.EShape|None	GetDaughter (self, int index)
	Returns a pointer to the specified daughter gauge or shape.
bool	IsWorld (self)
None	InvalidateWorld (self)
	Invalidates the world shape for this shape and all its ancestors.
eVision.EPoint	LocalToSensor (self, eVision.EPoint LPoint)
	Transforms a point from local coordinates to sensor coordinates.
eVision.EPoint	SensorToLocal (self, eVision.EPoint SPoint)
	Transforms a point from sensor coordinates to local coordinates.
None	SetZoom (self, float zoomX, float zoomY)
	Sets the horizontal and vertical zooming factors for drawing operations.
None	SetZoom (self, float zoomX)
	Sets the horizontal and vertical zooming factors for drawing operations.
None	SetZoom (self)
	Sets the horizontal and vertical zooming factors for drawing operations.
None	SetPan (self, float panX, float panY)
	Sets the horizontal and vertical panning values for drawing operations, expressed in pixels.
None	SetPan (self, float panX)
	Sets the horizontal and vertical panning values for drawing operations, expressed in pixels.
None	SetPan (self)
	Sets the horizontal and vertical panning values for drawing operations, expressed in pixels.
None	SetDraggingMode (self, eVision.EDraggingMode eDraggingMode, bool bDaughters)
	Sets the dragging mode which defines how the shape could be dragged.
None	SetDraggingMode (self, eVision.EDraggingMode eDraggingMode)
	Sets the dragging mode which defines how the shape could be dragged.
eVision.EDraggingMode	GetDraggingMode (self)
	Gets the dragging mode which defines how the shape could be dragged.
None	SetCursor (self, int x, int y)
	Sets the cursor current coordinates.
None	Save (self, str path, bool daughters)
	Loads a Shape.The given eVision.ESerializer must have been created for writing.
None	Save (self, str path)
	Loads a Shape.The given eVision.ESerializer must have been created for writing.
None	Save (self, eVision.ESerializer|None serializer, bool daughters)
	Loads a Shape.The given eVision.ESerializer must have been created for writing.
None	Save (self, eVision.ESerializer|None serializer)
	Loads a Shape.The given eVision.ESerializer must have been created for writing.
None	Load (self, str path, bool daughters)
	Loads a Shape.The given eVision.ESerializer must have been created for reading.
None	Load (self, str path)
	Loads a Shape.The given eVision.ESerializer must have been created for reading.
None	Load (self, eVision.ESerializer|None serializer, bool daughters)
	Loads a Shape.The given eVision.ESerializer must have been created for reading.
None	Load (self, eVision.ESerializer|None serializer)
	Loads a Shape.The given eVision.ESerializer must have been created for reading.
bool	HasProperty (self, str aProperty)
	Returns whether a eVision.Legacy.EShape has a property named aProperty.
str	GetProperty (self, str aProperty)
	Gets the value of property aProperty.
None	SetProperty (self, str aProperty, str aValue)
	Sets the value of property aProperty to aValue for this eVision.Legacy.EShape.
None	SetPropertyRecursive (self, str aProperty, str aValue)
	Sets the value of property aProperty to aValue for this eVision.Legacy.EShape and all of its daughters.
None	RemoveProperty (self, str aProperty)
	Removes the property name aProperty from the eVision.Legacy.EShape.
bool	HasValidPolarityProperty (self)
	Returns whether the eVision.Legacy.EShape has a valid polarity property.
None	EnableTypeFilter (self, int un32Types)
	Enables the filter of the specified shape type.
None	DisableTypeFilter (self)
	Enables all shape types.
str	Name (self)
	Name of the eVision.Legacy.EShape object.
	Name (self, str value)
	Name of the eVision.Legacy.EShape object.
bool	Visible (self)
	Flag indicating whether the shape is visible or not.
	Visible (self, bool value)
	Flag indicating whether the shape is visible or not.
bool	Selected (self)
	Flag indicating whether the shape is selected or not.
	Selected (self, bool value)
	Flag indicating whether the shape is selected or not.
bool	Selectable (self)
	Flag indicating whether the shape can be selected or not.
	Selectable (self, bool value)
	Flag indicating whether the shape can be selected or not.
bool	Dragable (self)
	Flag indicating whether the shape can be dragged or not.
	Dragable (self, bool value)
	Flag indicating whether the shape can be dragged or not.
bool	Resizable (self)
	Flag indicating whether the shape can be resized or not.
	Resizable (self, bool value)
	Flag indicating whether the shape can be resized or not.
bool	Rotatable (self)
	Flag indicating whether the shape can be rotated or not.
	Rotatable (self, bool value)
	Flag indicating whether the shape can be rotated or not.
bool	Labeled (self)
	Flag indicating whether the shape label should be displayed or not.
	Labeled (self, bool value)
	Flag indicating whether the shape label should be displayed or not.
bool	ActualShape (self)
	Flag indicating whether an inquiry returns a result pertaining to the nominal gauge (false, default) or the fitted model (true).
	ActualShape (self, bool value)
	Flag indicating whether an inquiry returns a result pertaining to the nominal gauge (false, default) or the fitted model (true).
int	NumDaughters (self)
	Number of daughters attached to the shape.
eVision.Legacy.EShape|None	Mother (self)
	Pointer to the mother shape.
eVision.Legacy.EWorldShape|None	WorldShape (self)
	World ancestor.
float	ZoomX (self)
	Current horizontal zooming factor for drawing operations.
float	ZoomY (self)
	Current vertical zooming factor for drawing operations.
float	PanX (self)
	Current horizontal panning value for drawing operations, expressed in pixels.
float	PanY (self)
	Current vertical panning value for drawing operations, expressed in pixels.
eVision.EDragHandle	HitHandle (self)
	Handle currently under the cursor.
eVision.Legacy.EShape|None	HitShape (self)
	Pointer to the shape currently under the cursor.
eVision.Legacy.EShape|None	ClosestShape (self)
	Closest shape among the daughters.

Additional Inherited Members
Protected Member Functions inherited from eVision.Legacy.ERectangleShape
	_Rectangle__setter (self, eVision.Legacy.ERectangle value)
	Sets the parameters of the rectangle according to a known eVision.Legacy.ERectangle object.
Protected Member Functions inherited from eVision.Legacy.EShape
	_VisibleRecursive__setter (self, bool value)
	Sets the flag indicating whether the shape and its daughter shapes are visible or not.
	_SelectedRecursive__setter (self, bool value)
	Sets the flag indicating whether the shape and all its daughters are selected or not.
	_SelectableRecursive__setter (self, bool value)
	Sets the flag indicating whether the shape and all its daughters can be selected or not.
	_DragableRecursive__setter (self, bool value)
	Sets the flag indicating whether the shape and all its daughters can be dragged or not.
	_ResizableRecursive__setter (self, bool value)
	Sets the flag indicating whether the shape and all its daughters can be resized or not.
	_RotatableRecursive__setter (self, bool value)
	Sets the flag indicating whether the shape and all its daughters can be rotated or not.
	_LabeledRecursive__setter (self, bool value)
	Sets the flag indicating whether the shape label should be displayed or not.
	_ActiveRecursive__setter (self, bool value)
	Sets the flag indicating whether the shape and all its daughters are active or not.
	_ActualShapeRecursive__setter (self, bool value)
	Sets the flag indicating whether an inquiry returns a result pertaining to the nominal gauge (false, default) or the fitted model (true).
Properties inherited from eVision.Legacy.ERectangleShape
	Rectangle
Properties inherited from eVision.Legacy.EShape
	VisibleRecursive
	SelectedRecursive
	SelectableRecursive
	DragableRecursive
	ResizableRecursive
	RotatableRecursive
	LabeledRecursive
	ActiveRecursive
	ActualShapeRecursive

Detailed Description

Manages a rectangle fitting gauge.

Remarks:

License(s): EasyGauge

Constructor & Destructor Documentation

__init__() [1/2]

None eVision.Legacy.ERectangleGauge.__init__

(

self

)

Constructs a rectangle measurement context.

Remarks:

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

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

__init__() [2/2]

None eVision.Legacy.ERectangleGauge.__init__	(		self,
		eVision.Legacy.ERectangleGauge	other )

Constructs a rectangle measurement context.

Remarks:

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

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

Parameters

other

Another eVision.Legacy.ERectangleGauge object to be copied in the new eVision.Legacy.ERectangleGauge object.

Member Function Documentation

Active() [1/2]

bool eVision.Legacy.ERectangleGauge.Active

(

self

)

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

Remarks:

When complex gauging is required, several gauges can be grouped together. Applying eVision.Legacy.ERectangleGauge.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).

Reimplemented from eVision.Legacy.EShape.

Active() [2/2]

eVision.Legacy.ERectangleGauge.Active	(		self,
		bool	value )

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

Remarks:

When complex gauging is required, several gauges can be grouped together. Applying eVision.Legacy.ERectangleGauge.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).

Reimplemented from eVision.Legacy.EShape.

ActiveEdges() [1/2]

int eVision.Legacy.ERectangleGauge.ActiveEdges

(

self

)

Active edges as defined in eVision.EDragHandle.

Remarks:

In the case of a rectangle fitting gauge, each edge can have its own transition detection parameters. Updating the transition parameters only affect the current active edges. By default, all edges are active.

ActiveEdges() [2/2]

eVision.Legacy.ERectangleGauge.ActiveEdges	(		self,
		int	value )

Active edges as defined in eVision.EDragHandle.

Remarks:

In the case of a rectangle fitting gauge, each edge can have its own transition detection parameters. Updating the transition parameters only affect the current active edges. By default, all edges are active.

AddSkipRange()

int eVision.Legacy.ERectangleGauge.AddSkipRange	(		self,
		eVision.EIntegerRange	range )

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

Remarks:

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 eVision.Legacy.ERectangleGauge. 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 eVision.Legacy.ERectangleGauge.NumSamples).

Parameters

range

The skip range.

AverageDistance()

float eVision.Legacy.ERectangleGauge.AverageDistance

(

self

)

Average distance between the sampled points and the fitted model.

Remarks:

Irrelevant in case of a point location operation.

CopyTo() [1/2]

None eVision.Legacy.ERectangleGauge.CopyTo	(		self,
		eVision.Legacy.ERectangleGauge	other )

Copies all the data of the current eVision.Legacy.ERectangleGauge object into another eVision.Legacy.ERectangleGauge object, and returns it.

Remarks:

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

Parameters

other

Pointer to the eVision.Legacy.ERectangleGauge object in which the current eVision.Legacy.ERectangleGauge object data have to be copied.

Reimplemented from eVision.Legacy.ERectangleShape.

CopyTo() [2/2]

None eVision.Legacy.ERectangleGauge.CopyTo	(		self,
		eVision.Legacy.ERectangleGauge	other,
		bool	recursive )

Copies all the data of the current eVision.Legacy.ERectangleGauge object into another eVision.Legacy.ERectangleGauge object, and returns it.

Remarks:

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

Parameters

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

Reimplemented from eVision.Legacy.ERectangleShape.

DisableInnerFiltering()

None eVision.Legacy.ERectangleGauge.DisableInnerFiltering

(

self

)

Disables inner sampled point filtering.

Remarks:

The inner sampled point filtering is activated as soon as the corresponding eVision.Legacy.ERectangleGauge.InnerFilteringThreshold is set.

Drag()

None eVision.Legacy.ERectangleGauge.Drag	(		self,
		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.

Reimplemented from eVision.Legacy.ERectangleShape.

Draw() [1/3]

None eVision.Legacy.ERectangleGauge.Draw	(		self,
		eVision.EDrawAdapter | None	graphicContext )

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

Parameters

graphicContext

Handle of the device context on which to draw.

Reimplemented from eVision.Legacy.ERectangleShape.

Draw() [2/3]

None eVision.Legacy.ERectangleGauge.Draw	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		eVision.EDrawingMode	drawingMode )

Draws a graphical representation of a point location or model fitting gauge, as defined by eVision.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 eVision.EDrawingMode.

Reimplemented from eVision.Legacy.ERectangleShape.

Draw() [3/3]

None eVision.Legacy.ERectangleGauge.Draw	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		eVision.EDrawingMode	drawingMode,
		bool	daughters )

Draws a graphical representation of a point location or model fitting gauge, as defined by eVision.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 eVision.EDrawingMode.
daughters	true if the daughters gauges are to be displayed also.

Reimplemented from eVision.Legacy.ERectangleShape.

FilteringThreshold() [1/2]

float eVision.Legacy.ERectangleGauge.FilteringThreshold

(

self

)

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.

Remarks:

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

FilteringThreshold() [2/2]

eVision.Legacy.ERectangleGauge.FilteringThreshold	(		self,
		float	value )

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.

Remarks:

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

GetMeasuredPoint() [1/2]

eVision.EPoint eVision.Legacy.ERectangleGauge.GetMeasuredPoint

(

self

)

Returns the coordinates of a sample point, measured along one of the sample paths of the gauge.

Remarks:

These coordinates pertain to the world space; they are expressed in the reference frame to which the current eVision.Legacy.ERectangleGauge object belongs.

The gauging process uses a list of sample points to find the shape position and size that best fit a given image. These sample points are measured along the sample paths defined by the gauge geometry. eVision.Legacy.ERectangleGauge.GetMeasuredPoint returns the coordinates of the sample point that meets the following two requirements:

1. It lies on the sample path inspected with the last call to eVision.Legacy.ERectangleGauge.MeasureSample, and
2. Among all the sample points along the latter sample path, it is the one selected by the eVision.Legacy.ERectangleGauge.TransitionChoice property.

Note

For this method to succeed, it is necessary to previously call eVision.Legacy.ERectangleGauge.MeasureSample.

GetMeasuredPoint() [2/2]

eVision.EPoint eVision.Legacy.ERectangleGauge.GetMeasuredPoint	(		self,
		int	index )

Returns the coordinates of a sample point, measured along one of the sample paths of the gauge.

Remarks:

These coordinates pertain to the world space; they are expressed in the reference frame to which the current eVision.Legacy.ERectangleGauge object belongs.

The gauging process uses a list of sample points to find the shape position and size that best fit a given image. These sample points are measured along the sample paths defined by the gauge geometry. eVision.Legacy.ERectangleGauge.GetMeasuredPoint returns the coordinates of the sample point that meets the following two requirements:

1. It lies on the sample path inspected with the last call to eVision.Legacy.ERectangleGauge.MeasureSample, and
2. Among all the sample points along the latter sample path, it is the one selected by the eVision.Legacy.ERectangleGauge.TransitionChoice property.

Note

For this method to succeed, it is necessary to previously call eVision.Legacy.ERectangleGauge.MeasureSample.

Parameters

index

This argument must be left unchanged from its default value, i.e. ~0 (= 0xFFFFFFFF).

GetSample() [1/2]

bool eVision.Legacy.ERectangleGauge.GetSample	(		self,
		eVision.EPoint	pt,
		int	index )

GetSample() [2/2]

None eVision.Legacy.ERectangleGauge.GetSample	(		self,
		eVision.Legacy.ESamplePoint	sp,
		int	index )

GetSampleLeftEdge() [1/3]

bool eVision.Legacy.ERectangleGauge.GetSampleLeftEdge	(		self,
		eVision.EPeak	pk,
		int	index )

Allows to retrieve information on the samples found along the leftmost edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

pk	eVision.EPeak structure that will contain the sample peak properties.
index	The sample index

GetSampleLeftEdge() [2/3]

bool eVision.Legacy.ERectangleGauge.GetSampleLeftEdge	(		self,
		eVision.EPoint	pt,
		int	index )

Allows to retrieve information on the samples found along the leftmost edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

pt	eVision.EPoint structure that will receive the sample position.
index	The sample index

GetSampleLeftEdge() [3/3]

None eVision.Legacy.ERectangleGauge.GetSampleLeftEdge	(		self,
		eVision.Legacy.ESamplePoint	sp,
		int	index )

Allows to retrieve information on the samples found along the leftmost edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

sp	eVision.Legacy.ESamplePoint structure that will receive the sample position.
index	The sample index

GetSampleLowerEdge() [1/3]

bool eVision.Legacy.ERectangleGauge.GetSampleLowerEdge	(		self,
		eVision.EPeak	pk,
		int	index )

Allows to retrieve information on the samples found along the lower edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

pk	eVision.EPeak structure that will contain the sample peak properties.
index	The sample index

GetSampleLowerEdge() [2/3]

bool eVision.Legacy.ERectangleGauge.GetSampleLowerEdge	(		self,
		eVision.EPoint	pt,
		int	index )

Allows to retrieve information on the samples found along the lower edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

pt	eVision.EPoint structure that will receive the sample position.
index	The sample index

GetSampleLowerEdge() [3/3]

None eVision.Legacy.ERectangleGauge.GetSampleLowerEdge	(		self,
		eVision.Legacy.ESamplePoint	sp,
		int	index )

Allows to retrieve information on the samples found along the lower edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

sp	eVision.Legacy.ESamplePoint structure that will receive the sample position.
index	The sample index

GetSampleRightEdge() [1/3]

bool eVision.Legacy.ERectangleGauge.GetSampleRightEdge	(		self,
		eVision.EPeak	pk,
		int	index )

Allows to retrieve information on the samples found along the rightmost edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

pk	eVision.EPeak structure that will contain the sample peak properties.
index	The sample index

GetSampleRightEdge() [2/3]

bool eVision.Legacy.ERectangleGauge.GetSampleRightEdge	(		self,
		eVision.EPoint	pt,
		int	index )

Allows to retrieve information on the samples found along the rightmost edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

pt	eVision.EPoint structure that will receive the sample position.
index	The sample index

GetSampleRightEdge() [3/3]

None eVision.Legacy.ERectangleGauge.GetSampleRightEdge	(		self,
		eVision.Legacy.ESamplePoint	sp,
		int	index )

Allows to retrieve information on the samples found along the rightmost edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

sp	eVision.Legacy.ESamplePoint structure that will receive the sample position.
index	The sample index

GetSampleUpperEdge() [1/3]

bool eVision.Legacy.ERectangleGauge.GetSampleUpperEdge	(		self,
		eVision.EPeak	pk,
		int	index )

Allows to retrieve information on the samples found along the upper edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

pk	eVision.EPeak structure that will contain the sample peak properties.
index	The sample index

GetSampleUpperEdge() [2/3]

bool eVision.Legacy.ERectangleGauge.GetSampleUpperEdge	(		self,
		eVision.EPoint	pt,
		int	index )

Allows to retrieve information on the samples found along the upper edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

pt	eVision.EPoint structure that will receive the sample position.
index	The sample index

GetSampleUpperEdge() [3/3]

None eVision.Legacy.ERectangleGauge.GetSampleUpperEdge	(		self,
		eVision.Legacy.ESamplePoint	sp,
		int	index )

Allows to retrieve information on the samples found along the upper edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Parameters

sp	eVision.Legacy.ESamplePoint structure that will receive the sample position.
index	The sample index

GetSampleX() [1/3]

bool eVision.Legacy.ERectangleGauge.GetSampleX	(		self,
		eVision.EPeak	pk,
		int	index )

Allows to retrieve information on the samples found along the X edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleRightEdge instead.

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

Parameters

pk	eVision.EPeak structure that will contain the sample peak properties.
index	The sample index

GetSampleX() [2/3]

bool eVision.Legacy.ERectangleGauge.GetSampleX	(		self,
		eVision.EPoint	pt,
		int	index )

Allows to retrieve information on the samples found along the X edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleRightEdge instead.

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

Parameters

pt	eVision.EPoint structure that will receive the sample position.
index	The sample index

GetSampleX() [3/3]

None eVision.Legacy.ERectangleGauge.GetSampleX	(		self,
		eVision.Legacy.ESamplePoint	sp,
		int	index )

Allows to retrieve information on the samples found along the X edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleRightEdge instead.

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

Parameters

sp	eVision.Legacy.ESamplePoint structure that will receive the sample position.
index	The sample index

GetSamplex() [1/3]

bool eVision.Legacy.ERectangleGauge.GetSamplex	(		self,
		eVision.EPeak	pk,
		int	index )

Allows to retrieve information on the samples found along the x edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleLeftEdge instead.

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

Parameters

pk	eVision.EPeak structure that will contain the sample peak properties.
index	The sample index

GetSamplex() [2/3]

bool eVision.Legacy.ERectangleGauge.GetSamplex	(		self,
		eVision.EPoint	pt,
		int	index )

Allows to retrieve information on the samples found along the x edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleLeftEdge instead.

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

Parameters

pt	eVision.EPoint structure that will receive the sample position.
index	The sample index

GetSamplex() [3/3]

None eVision.Legacy.ERectangleGauge.GetSamplex	(		self,
		eVision.Legacy.ESamplePoint	sp,
		int	index )

Allows to retrieve information on the samples found along the x edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleLeftEdge instead.

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

Parameters

sp	eVision.Legacy.ESamplePoint structure that will receive the sample position.
index	The sample index

GetSampleY() [1/3]

bool eVision.Legacy.ERectangleGauge.GetSampleY	(		self,
		eVision.EPeak	pk,
		int	index )

Allows to retrieve information on the samples found along the Y edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleUpperEdge instead.

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

Parameters

pk	eVision.EPeak structure that will contain the sample peak properties.
index	The sample index

GetSampleY() [2/3]

bool eVision.Legacy.ERectangleGauge.GetSampleY	(		self,
		eVision.EPoint	pt,
		int	index )

Allows to retrieve information on the samples found along the Y edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleUpperEdge instead.

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

Parameters

pt	eVision.EPoint structure that will receive the sample position.
index	The sample index

GetSampleY() [3/3]

None eVision.Legacy.ERectangleGauge.GetSampleY	(		self,
		eVision.Legacy.ESamplePoint	sp,
		int	index )

Allows to retrieve information on the samples found along the Y edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleUpperEdge instead.

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

Parameters

sp	eVision.Legacy.ESamplePoint structure that will receive the sample position.
index	The sample index

GetSampley() [1/3]

bool eVision.Legacy.ERectangleGauge.GetSampley	(		self,
		eVision.EPeak	pk,
		int	index )

Allows to retrieve information on the samples found along the y edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleLowerEdge instead.

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

Parameters

pk	eVision.EPeak structure that will contain the sample peak properties.
index	The sample index

GetSampley() [2/3]

bool eVision.Legacy.ERectangleGauge.GetSampley	(		self,
		eVision.EPoint	pt,
		int	index )

Allows to retrieve information on the samples found along the y edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleLowerEdge instead.

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

Parameters

pt	eVision.EPoint structure that will receive the sample position.
index	The sample index

GetSampley() [3/3]

None eVision.Legacy.ERectangleGauge.GetSampley	(		self,
		eVision.Legacy.ESamplePoint	sp,
		int	index )

Allows to retrieve information on the samples found along the y edge.

Remarks:

The method provides the sample point corresponding to the supplied index.

The returned value is true when the sample is valid, and false otherwise.

Deprecated

Use eVision.Legacy.ERectangleGauge.GetSampleLowerEdge instead.

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

Parameters

sp	eVision.Legacy.ESamplePoint structure that will receive the sample position.
index	The sample index

GetSkipRange()

eVision.EIntegerRange eVision.Legacy.ERectangleGauge.GetSkipRange	(		self,
		int	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 eVision.Legacy.ERectangleGauge.AddSkipRange method.

Remarks:

Start is guaranteed to be smaller or equal to end.

Parameters

index

Index of the skip range.

HitTest() [1/2]

bool eVision.Legacy.ERectangleGauge.HitTest

(

self

)

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

Reimplemented from eVision.Legacy.ERectangleShape.

HitTest() [2/2]

bool eVision.Legacy.ERectangleGauge.HitTest	(		self,
		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.

Reimplemented from eVision.Legacy.ERectangleShape.

HVConstraint() [1/2]

bool eVision.Legacy.ERectangleGauge.HVConstraint

(

self

)

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

Remarks:

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

HVConstraint() [2/2]

eVision.Legacy.ERectangleGauge.HVConstraint	(		self,
		bool	value )

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

Remarks:

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

InnerFilteringEnabled()

bool eVision.Legacy.ERectangleGauge.InnerFilteringEnabled

(

self

)

Getter method for the GetInnerFilteringEnabled property.

This property is the flag indicating if the inner sampled point filtering is enabled (true).

Remarks:

The inner sampled point filtering is activated as soon as the corresponding threshold is set, getting the eVision.Legacy.ERectangleGauge.InnerFilteringThreshold property. To disable inner filtering, use the eVision.Legacy.ERectangleGauge.DisableInnerFiltering method.

InnerFilteringThreshold() [1/2]

float eVision.Legacy.ERectangleGauge.InnerFilteringThreshold

(

self

)

Sampled point inner filtering threshold.

Remarks:

If inner filtering is enabled, the sampled points that have been found inside the measured rectangle are filtered in regard of their distance to it. If this distance is greater than the threshold, the sampled point is set as invalid, and removed from the measure. This distance is in physical units.

The inner sampled point filtering is activated as soon as the corresponding threshold is set. To disable inner filtering, use the DisableInnerFiltering method.

InnerFilteringThreshold() [2/2]

eVision.Legacy.ERectangleGauge.InnerFilteringThreshold	(		self,
		float	value )

Sampled point inner filtering threshold.

Remarks:

If inner filtering is enabled, the sampled points that have been found inside the measured rectangle are filtered in regard of their distance to it. If this distance is greater than the threshold, the sampled point is set as invalid, and removed from the measure. This distance is in physical units.

The inner sampled point filtering is activated as soon as the corresponding threshold is set. To disable inner filtering, use the DisableInnerFiltering method.

KnownAngle() [1/2]

bool eVision.Legacy.ERectangleGauge.KnownAngle

(

self

)

Flag indicating whether the rotation angle of the rectangle to be fitted is known or not.

Remarks:

A rectangle model to be fitted may have a well-known orientation. It is possible to impose the value of this rotation angle, thus removing one degree of freedom.

The sign of the rotation angle depends whether the field of view is calibrated or not.

• When the field of view is calibrated, the coordinate system is said to be direct, the abscissa extends rightwards and the ordinate extends upwards. In this case, an anticlockwise rotation leads to a positive angle value.
• When the field of view is not calibrated, the coordinate system is said to be inverse, the abscissa extends rightwards and the ordinate extends downwards. In this case, a clockwise rotation leads to a positive angle value.

KnownAngle() [2/2]

eVision.Legacy.ERectangleGauge.KnownAngle	(		self,
		bool	value )

Flag indicating whether the rotation angle of the rectangle to be fitted is known or not.

Remarks:

A rectangle model to be fitted may have a well-known orientation. It is possible to impose the value of this rotation angle, thus removing one degree of freedom.

The sign of the rotation angle depends whether the field of view is calibrated or not.

• When the field of view is calibrated, the coordinate system is said to be direct, the abscissa extends rightwards and the ordinate extends upwards. In this case, an anticlockwise rotation leads to a positive angle value.
• When the field of view is not calibrated, the coordinate system is said to be inverse, the abscissa extends rightwards and the ordinate extends downwards. In this case, a clockwise rotation leads to a positive angle value.

Measure() [1/2]

None eVision.Legacy.ERectangleGauge.Measure	(		self,
		eVision.EROIBW8 | None	sourceImage )

Triggers the point location or the model fitting operation.

Remarks:

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.

Parameters

sourceImage

Pointer to the source image.

Measure() [2/2]

None eVision.Legacy.ERectangleGauge.Measure	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.ERegion	region )

Triggers the point location or the model fitting operation.

Remarks:

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.

Parameters

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

MeasuredRectangle()

eVision.Legacy.ERectangle eVision.Legacy.ERectangleGauge.MeasuredRectangle

(

self

)

Information pertaining to the fitted rectangle.

Remarks:

Use method eVision.Legacy.EShape.GetFound to get the status of the measurement. eVision.Legacy.ERectangleGauge.MeasuredRectangle returns a successful fitted rectangle if eVision.Legacy.EShape.GetFound is true, otherwise it returns the orginal (nominal) rectangle.

MeasureSample() [1/2]

None eVision.Legacy.ERectangleGauge.MeasureSample	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.ERegion	region,
		int	pathIndex )

Computes the sample points along the sample path whose index in the list is given by the pathIndex parameter.

Remarks:

This method stores its results into a temporary variable inside the eVision.Legacy.ERectangleGauge object.

Parameters

sourceImage	Pointer to the source image/ROI.
region	Region on which to measure.
pathIndex	Sample path index.

MeasureSample() [2/2]

None eVision.Legacy.ERectangleGauge.MeasureSample	(		self,
		eVision.EROIBW8 | None	sourceImage,
		int	pathIndex )

Computes the sample points along the sample path whose index in the list is given by the pathIndex parameter.

Remarks:

This method stores its results into a temporary variable inside the eVision.Legacy.ERectangleGauge object.

Parameters

sourceImage	Pointer to the source image/ROI.
pathIndex	Sample path index.

MeasureWithoutFitting() [1/2]

None eVision.Legacy.ERectangleGauge.MeasureWithoutFitting	(		self,
		eVision.EROIBW8 | None	sourceImage )

Triggers the point location without rectangle fitting operation.

Remarks:

This method performs the actual measurement for each transition, but does not perform the rectangle fitting. This means that individual samples will be available for each edges through the eVision.Legacy.ERectangleGauge.GetSamplex (Edge x), eVision.Legacy.ERectangleGauge.GetSampley (Edge y), eVision.Legacy.ERectangleGauge.GetSampleX (Edge X), eVision.Legacy.ERectangleGauge.GetSampleY (Edge Y) methods, but the gauge position will not be changed.

Please note that the filtering will not be performed in this method, since it relies upon the fitting process. The filtering parameters will thus be unused.

Parameters

sourceImage

Source image.

MeasureWithoutFitting() [2/2]

None eVision.Legacy.ERectangleGauge.MeasureWithoutFitting	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.ERegion	region )

Triggers the point location without rectangle fitting operation.

Remarks:

This method performs the actual measurement for each transition, but does not perform the rectangle fitting. This means that individual samples will be available for each edges through the eVision.Legacy.ERectangleGauge.GetSamplex (Edge x), eVision.Legacy.ERectangleGauge.GetSampley (Edge y), eVision.Legacy.ERectangleGauge.GetSampleX (Edge X), eVision.Legacy.ERectangleGauge.GetSampleY (Edge Y) methods, but the gauge position will not be changed.

Please note that the filtering will not be performed in this method, since it relies upon the fitting process. The filtering parameters will thus be unused.

Parameters

sourceImage	Source image.
region	Region on which to measure.

MinAmplitude() [1/2]

int eVision.Legacy.ERectangleGauge.MinAmplitude

(

self

)

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

Remarks:

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.

MinAmplitude() [2/2]

eVision.Legacy.ERectangleGauge.MinAmplitude	(		self,
		int	value )

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

Remarks:

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() [1/2]

int eVision.Legacy.ERectangleGauge.MinArea

(

self

)

Minimum area value.

Remarks:

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.

MinArea() [2/2]

eVision.Legacy.ERectangleGauge.MinArea	(		self,
		int	value )

Minimum area value.

Remarks:

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() [1/2]

list[int] eVision.Legacy.ERectangleGauge.MinNumFitSamples

(

self

)

Sets/Gets the minimum number of samples required for fitting the shape.

Remarks:

In case of a ERectangleGauge, 4 values are used, one for each side of the rectangle. When the eVision.Legacy.ERectangleGauge.Measure 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.

MinNumFitSamples() [2/2]

eVision.Legacy.ERectangleGauge.MinNumFitSamples	(		self,
		list[int]	value )

Sets/Gets the minimum number of samples required for fitting the shape.

Remarks:

In case of a ERectangleGauge, 4 values are used, one for each side of the rectangle. When the eVision.Legacy.ERectangleGauge.Measure 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.

NumFilteringPasses() [1/2]

int eVision.Legacy.ERectangleGauge.NumFilteringPasses

(

self

)

Number of filtering passes for a model fitting operation.

Remarks:

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.

NumFilteringPasses() [2/2]

eVision.Legacy.ERectangleGauge.NumFilteringPasses	(		self,
		int	value )

Number of filtering passes for a model fitting operation.

Remarks:

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.

NumSamples()

int eVision.Legacy.ERectangleGauge.NumSamples

(

self

)

Number of sampled points during the model fitting operation.

Remarks:

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

NumSamplesLeftEdge()

int eVision.Legacy.ERectangleGauge.NumSamplesLeftEdge

(

self

)

Number of sampled points found on leftmost edge during the measure operation.

NumSamplesLowerEdge()

int eVision.Legacy.ERectangleGauge.NumSamplesLowerEdge

(

self

)

Number of sampled points found on lower edge during the measure operation.

NumSamplesRightEdge()

int eVision.Legacy.ERectangleGauge.NumSamplesRightEdge

(

self

)

Number of sampled points found on rightmost edge during the measure operation.

NumSamplesUpperEdge()

int eVision.Legacy.ERectangleGauge.NumSamplesUpperEdge

(

self

)

Number of sampled points found on upper edge during the measure operation.

NumSamplesX()

int eVision.Legacy.ERectangleGauge.NumSamplesX

(

self

)

Number of sampled points found on edge X during the measure operation.

Deprecated

Use eVision.Legacy.ERectangleGauge.NumSamplesRightEdge instead.

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

NumSamplesx()

int eVision.Legacy.ERectangleGauge.NumSamplesx

(

self

)

Number of sampled points found on edge x during the measure operation.

Deprecated

Use eVision.Legacy.ERectangleGauge.NumSamplesLeftEdge instead.

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

NumSamplesY()

int eVision.Legacy.ERectangleGauge.NumSamplesY

(

self

)

Number of sampled points found on edge Y during the measure operation.

Deprecated

Use eVision.Legacy.ERectangleGauge.NumSamplesUpperEdge instead.

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

NumSamplesy()

int eVision.Legacy.ERectangleGauge.NumSamplesy

(

self

)

Number of sampled points found on edge y during the measure operation.

Deprecated

Use eVision.Legacy.ERectangleGauge.NumSamplesLowerEdge instead.

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

NumSkipRanges()

int eVision.Legacy.ERectangleGauge.NumSkipRanges

(

self

)

Number of skip ranges in the gauge after a call to eVision.Legacy.ERectangleGauge.AddSkipRange.

NumValidSamples()

int eVision.Legacy.ERectangleGauge.NumValidSamples

(

self

)

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

Remarks:

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

Plot() [1/3]

None eVision.Legacy.ERectangleGauge.Plot	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		eVision.EPlotItem	drawItems,
		float	width,
		float	height )

Draws the profile that is crossed by one of the sample paths of the gauge, as defined by eVision.EPlotItem.

Remarks:

The sample path that is taken into considered is the one inspected with the last call to eVision.Legacy.ERectangleGauge.MeasureSample.

Note

For this method to succeed, it is necessary to previously call eVision.Legacy.ERectangleGauge.MeasureSample.

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
width	Width of the plot.
height	Height of the plot.

Plot() [2/3]

None eVision.Legacy.ERectangleGauge.Plot	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		eVision.EPlotItem	drawItems,
		float	width,
		float	height,
		float	originX )

Draws the profile that is crossed by one of the sample paths of the gauge, as defined by eVision.EPlotItem.

Remarks:

The sample path that is taken into considered is the one inspected with the last call to eVision.Legacy.ERectangleGauge.MeasureSample.

Note

For this method to succeed, it is necessary to previously call eVision.Legacy.ERectangleGauge.MeasureSample.

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
width	Width of the plot.
height	Height of the plot.
originX	Origin point coordinates of the plot along the X axis.

Plot() [3/3]

None eVision.Legacy.ERectangleGauge.Plot	(		self,
		eVision.EDrawAdapter | None	graphicContext,
		eVision.EPlotItem	drawItems,
		float	width,
		float	height,
		float	originX,
		float	originY )

Draws the profile that is crossed by one of the sample paths of the gauge, as defined by eVision.EPlotItem.

Remarks:

The sample path that is taken into considered is the one inspected with the last call to eVision.Legacy.ERectangleGauge.MeasureSample.

Note

For this method to succeed, it is necessary to previously call eVision.Legacy.ERectangleGauge.MeasureSample.

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
width	Width of the plot.
height	Height of the plot.
originX	Origin point coordinates of the plot along the X axis.
originY	Origin point coordinates of the plot along the Y axis.

Process() [1/4]

None eVision.Legacy.ERectangleGauge.Process	(		self,
		eVision.EROIBW8 | None	sourceImage )

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

Remarks:

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.

Parameters

sourceImage

Pointer to the source image.

Reimplemented from eVision.Legacy.EShape.

Process() [2/4]

None eVision.Legacy.ERectangleGauge.Process	(		self,
		eVision.EROIBW8 | None	sourceImage,
		bool	daughters )

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

Remarks:

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.

Parameters

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

Reimplemented from eVision.Legacy.EShape.

Process() [3/4]

None eVision.Legacy.ERectangleGauge.Process	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.ERegion	region )

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

Remarks:

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.

Parameters

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

Reimplemented from eVision.Legacy.EShape.

Process() [4/4]

None eVision.Legacy.ERectangleGauge.Process	(		self,
		eVision.EROIBW8 | None	sourceImage,
		eVision.ERegion	region,
		bool	daughters )

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

Remarks:

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.

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.

Reimplemented from eVision.Legacy.EShape.

RectangularSamplingArea() [1/2]

bool eVision.Legacy.ERectangleGauge.RectangularSamplingArea

(

self

)

Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.

Remarks:

By default, this flag is set to true: the sampling area always remains a rectangle.

Setting this property is only useful when the thickness transition parameter is greater than 1. In fact, when thickness transition parameter is equal to 1, rectangle and parallelogram reduce to the same segment.

RectangularSamplingArea() [2/2]

eVision.Legacy.ERectangleGauge.RectangularSamplingArea	(		self,
		bool	value )

Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.

Remarks:

By default, this flag is set to true: the sampling area always remains a rectangle.

Setting this property is only useful when the thickness transition parameter is greater than 1. In fact, when thickness transition parameter is equal to 1, rectangle and parallelogram reduce to the same segment.

RemoveAllSkipRanges()

None eVision.Legacy.ERectangleGauge.RemoveAllSkipRanges

(

self

)

Removes all the skip ranges previously created by a call to eVision.Legacy.ERectangleGauge.AddSkipRange.

RemoveSkipRange()

None eVision.Legacy.ERectangleGauge.RemoveSkipRange	(		self,
		int	index )

After a call to eVision.Legacy.ERectangleGauge.AddSkipRange, removes the skip range with the given index.

Parameters

index

Index of the skip range to remove, as returned by eVision.Legacy.ERectangleGauge.AddSkipRange.

SamplingStep() [1/2]

float eVision.Legacy.ERectangleGauge.SamplingStep

(

self

)

Approximate distance between sampled points during a model fitting operation.

Remarks:

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.

SamplingStep() [2/2]

eVision.Legacy.ERectangleGauge.SamplingStep	(		self,
		float	value )

Approximate distance between sampled points during a model fitting operation.

Remarks:

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.ERectangle eVision.Legacy.ERectangleGauge.Shape

(

self

)

Smoothing() [1/2]

int eVision.Legacy.ERectangleGauge.Smoothing

(

self

)

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

Remarks:

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

Smoothing() [2/2]

eVision.Legacy.ERectangleGauge.Smoothing	(		self,
		int	value )

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

Remarks:

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

Thickness() [1/2]

int eVision.Legacy.ERectangleGauge.Thickness

(

self

)

Number of parallel segments used to extract the data profile.

Remarks:

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

Thickness() [2/2]

eVision.Legacy.ERectangleGauge.Thickness	(		self,
		int	value )

Number of parallel segments used to extract the data profile.

Remarks:

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

Threshold() [1/2]

int eVision.Legacy.ERectangleGauge.Threshold

(

self

)

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

Remarks:

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.

Threshold() [2/2]

eVision.Legacy.ERectangleGauge.Threshold	(		self,
		int	value )

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

Remarks:

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() [1/2]

float eVision.Legacy.ERectangleGauge.Tolerance

(

self

)

Searching area half thickness of the rectangle fitting gauge.

Remarks:

A rectangle fitting gauge is fully defined knowing its nominal position (its center coordinates), its nominal size, its rotation angle, and its outline tolerance.

By default, the searching area thickness of the rectangle 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.

Tolerance() [2/2]

eVision.Legacy.ERectangleGauge.Tolerance	(		self,
		float	value )

Searching area half thickness of the rectangle fitting gauge.

Remarks:

A rectangle fitting gauge is fully defined knowing its nominal position (its center coordinates), its nominal size, its rotation angle, and its outline tolerance.

By default, the searching area thickness of the rectangle 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() [1/2]

eVision.ETransitionChoice eVision.Legacy.ERectangleGauge.TransitionChoice

(

self

)

Transition choice.

Remarks:

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

In case of eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd transition choice, set eVision.Legacy.ERectangleGauge.TransitionIndex to specify the desired transition.

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

TransitionChoice() [2/2]

eVision.Legacy.ERectangleGauge.TransitionChoice	(		self,
		eVision.ETransitionChoice	value )

Transition choice.

Remarks:

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

In case of eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd transition choice, set eVision.Legacy.ERectangleGauge.TransitionIndex to specify the desired transition.

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

TransitionIndex() [1/2]

int eVision.Legacy.ERectangleGauge.TransitionIndex

(

self

)

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

Remarks:

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

TransitionIndex() [2/2]

eVision.Legacy.ERectangleGauge.TransitionIndex	(		self,
		int	value )

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

Remarks:

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() [1/2]

eVision.ETransitionType eVision.Legacy.ERectangleGauge.TransitionType

(

self

)

Transition type.

Remarks:

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 (eVision.ETransitionType.BwOrWb).

TransitionType() [2/2]

eVision.Legacy.ERectangleGauge.TransitionType	(		self,
		eVision.ETransitionType	value )

Transition type.

Remarks:

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 (eVision.ETransitionType.BwOrWb).

Type()

eVision.EShapeType eVision.Legacy.ERectangleGauge.Type

(

self

)

Shape type.

Reimplemented from eVision.Legacy.ERectangleShape.

Valid()

bool eVision.Legacy.ERectangleGauge.Valid

(

self

)

Flag indicating if at least one valid transition has been found.

Remarks:

A false value means that no measurement has been performed.

A true value means that a transition was found along the sample path inspected with the last call to eVision.Legacy.ERectangleGauge.MeasureSample, and thus a point has been measured.