eVision Python API
Loading...
Searching...
No Matches
eVision.Legacy.EWedgeGauge Class Reference

Manages a wedge fitting gauge. More...

Inheritance diagram for eVision.Legacy.EWedgeGauge:
Collaboration diagram for eVision.Legacy.EWedgeGauge:

Public Member Functions

None __init__ (self)
 Constructs a wedge measurement context.
None __init__ (self, eVision.Legacy.EWedgeGauge other)
 Constructs a wedge 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.EWedgeGauge.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.EWedgeGauge.AddSkipRange.
None CopyTo (self, eVision.Legacy.EWedgeGauge other, bool recursive)
 Copies all the data of the current eVision.Legacy.EWedgeGauge object into another eVision.Legacy.EWedgeGauge object, and returns it.
None CopyTo (self, eVision.Legacy.EWedgeGauge other)
 Copies all the data of the current eVision.Legacy.EWedgeGauge object into another eVision.Legacy.EWedgeGauge object, and returns it.
None SetFromTwoPoints (self, eVision.EPoint center, eVision.EPoint origin, float breadth, bool direct)
 Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.
None SetFromTwoPoints (self, eVision.EPoint center, eVision.EPoint origin, float breadth)
 Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.
None SetFromTwoPoints (self, eVision.EPoint center, eVision.EPoint origin)
 Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.
None SetFromOriginMiddleEnd (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end, float breadth, bool fullCircle)
 Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.
None SetFromOriginMiddleEnd (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end, float breadth)
 Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.
None SetFromOriginMiddleEnd (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end)
 Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.
None SetDiameters (self, float diameter, float breadth)
 Sets the nominal inner/outer diameter and breadth of the eVision.Legacy.EWedgeGauge.
None SetRadii (self, float radius, float breadth)
 Sets the nominal radius and breadth of the eVision.Legacy.EWedgeGauge.
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 wedge fitting operation.
None MeasureWithoutFitting (self, eVision.EROIBW8|None sourceImage, eVision.ERegion region)
 Triggers the point location without wedge 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.
bool GetSamplea (self, eVision.EPoint pt, int index)
 Allows to retrieve information on the samples found along the a edge.
None GetSamplea (self, eVision.Legacy.ESamplePoint sp, int index)
 Allows to retrieve information on the samples found along the a edge.
bool GetSamplea (self, eVision.EPeak pk, int index)
 Allows to retrieve information on the samples found along the a edge.
bool GetSampler (self, eVision.EPoint pt, int index)
 Allows to retrieve information on the samples found along the r edge.
None GetSampler (self, eVision.Legacy.ESamplePoint sp, int index)
 Allows to retrieve information on the samples found along the r edge.
bool GetSampler (self, eVision.EPeak pk, int index)
 Allows to retrieve information on the samples found along the r edge.
bool GetSampleA (self, eVision.EPoint pt, int index)
 Allows to retrieve information on the samples found along the A edge.
None GetSampleA (self, eVision.Legacy.ESamplePoint sp, int index)
 Allows to retrieve information on the samples found along the A edge.
bool GetSampleA (self, eVision.EPeak pk, int index)
 Allows to retrieve information on the samples found along the A edge.
bool GetSampleR (self, eVision.EPoint pt, int index)
 Allows to retrieve information on the samples found along the R edge.
None GetSampleR (self, eVision.Legacy.ESamplePoint sp, int index)
 Allows to retrieve information on the samples found along the R edge.
bool GetSampleR (self, eVision.EPeak pk, int index)
 Allows to retrieve information on the samples found along the R edge.
bool GetSampleLeftEdge (self, eVision.EPoint pt, int index)
 Allows to retrieve information on the samples found along the left edge.
None GetSampleLeftEdge (self, eVision.Legacy.ESamplePoint sp, int index)
 Allows to retrieve information on the samples found along the left edge.
bool GetSampleLeftEdge (self, eVision.EPeak pk, int index)
 Allows to retrieve information on the samples found along the left edge.
bool GetSampleOuterEdge (self, eVision.EPoint pt, int index)
 Allows to retrieve information on the samples found along the outer edge.
None GetSampleOuterEdge (self, eVision.Legacy.ESamplePoint sp, int index)
 Allows to retrieve information on the samples found along the outer edge.
bool GetSampleOuterEdge (self, eVision.EPeak pk, int index)
 Allows to retrieve information on the samples found along the outer 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 GetSampleInnerEdge (self, eVision.EPoint pt, int index)
 Allows to retrieve information on the samples found along the inner edge.
None GetSampleInnerEdge (self, eVision.Legacy.ESamplePoint sp, int index)
 Allows to retrieve information on the samples found along the inner edge.
bool GetSampleInnerEdge (self, eVision.EPeak pk, int index)
 Allows to retrieve information on the samples found along the inner edge.
bool GetSample (self, eVision.EPoint pt, int index)
None GetSample (self, eVision.Legacy.ESamplePoint sp, int index)
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.
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.EWedgeGauge.AddSkipRange.
eVision.EShapeType Type (self)
 Shape type.
eVision.Legacy.EWedge 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.
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 wedge fitting gauge.
 Tolerance (self, float value)
 Searching area half thickness of the wedge 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 NumSamplesa (self)
 Number of sampled points found on edge a during the measure operation.
int NumSamplesr (self)
 Number of sampled points found on edge r during the measure operation.
int NumSamplesA (self)
 Number of sampled points found on edge A during the measure operation.
int NumSamplesR (self)
 Number of sampled points found on edge R 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 NumSamplesOuterEdge (self)
 Number of sampled points found on outer edge during the measure operation.
int NumSamplesInnerEdge (self)
 Number of sampled points found on inner edge during the measure operation.
eVision.Legacy.EWedge MeasuredWedge (self)
 Information pertaining to the fitted wedge.
bool Valid (self)
 Flag indicating if at least one valid transition has been found.
Public Member Functions inherited from eVision.Legacy.EWedgeShape
None SetCenterXY (self, float centerX, float centerY)
 Sets the center coordinates of a eVision.Legacy.EWedgeShape object.
None SetFromCenterAndOrigin (self, eVision.EPoint center, eVision.EPoint origin, float breadth, bool direct)
 Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeShape object.
None SetFromCenterAndOrigin (self, eVision.EPoint center, eVision.EPoint origin, float breadth)
 Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeShape object.
None SetFromCenterAndOrigin (self, eVision.EPoint center, eVision.EPoint origin)
 Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeShape object.
eVision.EPoint GetInnerPoint (self, float fraction)
 Returns the coordinates of a particular point specified by its location along the inner circle arc.
eVision.EPoint GetOuterPoint (self, float fraction)
 Returns the coordinates of a particular point specified by its location along the outter circle arc.
eVision.EPoint GetPoint (self, float breadthFraction, float angleFraction)
 Returns the coordinates of a particular point specified by its location along the wedge perimeter.
None GetMidEdges (self, eVision.EPoint a, eVision.EPoint AA, eVision.EPoint r, eVision.EPoint RR)
 Retrieves the center coordinates of each edge of the wedge fitting gauge.
None GetCorners (self, eVision.EPoint ar, eVision.EPoint AAr, eVision.EPoint aRR, eVision.EPoint AARR)
 Retrieves the coordinates of each corner of the eVision.Legacy.EWedgeShape.
None GetEdges (self, eVision.Legacy.ELine a, eVision.Legacy.ELine AA, eVision.Legacy.ECircle r, eVision.Legacy.ECircle RR)
 Retrieves each edge of the eVision.Legacy.EWedgeShape.
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 Amplitude (self)
 Angular amplitude of the eVision.Legacy.EWedgeShape.
 Amplitude (self, float value)
 Angular amplitude of the eVision.Legacy.EWedgeShape.
float InnerDiameter (self)
 Inner diameter of the eVision.Legacy.EWedgeShape.
float OuterDiameter (self)
 Outer diameter of the eVision.Legacy.EWedgeShape.
float InnerRadius (self)
 Inner radius of the eVision.Legacy.EWedgeShape.
float OuterRadius (self)
 Outer radius of the eVision.Legacy.EWedgeShape.
float Breadth (self)
 Breadth of the eVision.Legacy.EWedgeShape.
float InnerArcLength (self)
 Inner circle arc length of the eVision.Legacy.EWedgeShape.
float OuterArcLength (self)
 Outer circle arc length of the eVision.Legacy.EWedgeShape.
float OrgAngle (self)
 Angular position from where the eVision.Legacy.EWedgeShape extents.
float ApexAngle (self)
 Angular position at the apex of the eVision.Legacy.EWedgeShape.
float EndAngle (self)
 Ending angular position of the eVision.Legacy.EWedgeShape.
eVision.EPoint InnerOrg (self)
 Inner origin point coordinates of the eVision.Legacy.EWedgeShape.
eVision.EPoint InnerApex (self)
 Inner apex point coordinates of the eVision.Legacy.EWedgeShape.
eVision.EPoint InnerEnd (self)
 Inner end point coordinates of the eVision.Legacy.EWedgeShape.
eVision.EPoint OuterOrg (self)
 Outer origin point coordinates of the eVision.Legacy.EWedgeShape.
eVision.EPoint OuterApex (self)
 Outer apex point coordinates of the eVision.Legacy.EWedgeShape.
eVision.EPoint OuterEnd (self)
 Outer end point coordinates of the eVision.Legacy.EWedgeShape.
bool FullBreadth (self)
 Flag indicating if the eVision.Legacy.EWedgeShape has a full breadth (breadth = radius).
bool FullCircle (self)
 Flag indicating if the eVision.Legacy.EWedgeShape is a full circle (amplitude = 2 PI).
bool Direct (self)
 Flag indicating whether positive angles correspond to a clockwise or an anticlockwise rotation.
 Direct (self, bool value)
 Flag indicating whether positive angles correspond to a clockwise or an anticlockwise rotation.
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.

Protected Member Functions

 _Wedge__setter (self, eVision.Legacy.EWedge value)
 Sets the nominal position (center coordinates), diameter, breadth, angular origin and amplitude of the wedge fitting gauge according to a known wedge.
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

 Wedge
Properties inherited from eVision.Legacy.EWedgeShape
 Wedge
Properties inherited from eVision.Legacy.EShape
 VisibleRecursive
 SelectedRecursive
 SelectableRecursive
 DragableRecursive
 ResizableRecursive
 RotatableRecursive
 LabeledRecursive
 ActiveRecursive
 ActualShapeRecursive

Detailed Description

Manages a wedge fitting gauge.

Remarks:

License(s): EasyGauge

Constructor & Destructor Documentation

◆ __init__() [1/2]

None eVision.Legacy.EWedgeGauge.__init__ ( self)

Constructs a wedge measurement context.

Remarks:

With the default constructor, all the parameters are initialized to their respective default values. With the copy constructor, the constructed wedge measurement context is based on a pre-existing eVision.Legacy.EWedgeGauge 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.EWedgeGauge.CopyTo method.

◆ __init__() [2/2]

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

Constructs a wedge measurement context.

Remarks:

With the default constructor, all the parameters are initialized to their respective default values. With the copy constructor, the constructed wedge measurement context is based on a pre-existing eVision.Legacy.EWedgeGauge 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.EWedgeGauge.CopyTo method.

Parameters
otherAnother eVision.Legacy.EWedgeGauge object to be copied in the new eVision.Legacy.EWedgeGauge object.

Member Function Documentation

◆ _Wedge__setter()

eVision.Legacy.EWedgeGauge._Wedge__setter ( self,
eVision.Legacy.EWedge value )
protected

Sets the nominal position (center coordinates), diameter, breadth, angular origin and amplitude of the wedge fitting gauge according to a known wedge.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ Active() [1/2]

bool eVision.Legacy.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.ActiveEdges ( self)

Active edges as defined in eVision.EDragHandle.

Remarks:

In the case of a wedge 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.EWedgeGauge.ActiveEdges ( self,
int value )

Active edges as defined in eVision.EDragHandle.

Remarks:

In the case of a wedge 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.EWedgeGauge.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.EWedgeGauge. 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.EWedgeGauge.NumSamples).

Parameters
rangeThe skip range.

◆ AverageDistance()

float eVision.Legacy.EWedgeGauge.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.EWedgeGauge.CopyTo ( self,
eVision.Legacy.EWedgeGauge other )

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

Remarks:

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

Parameters
otherPointer to the eVision.Legacy.EWedgeGauge object in which the current eVision.Legacy.EWedgeGauge object data have to be copied.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ CopyTo() [2/2]

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

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

Remarks:

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

Parameters
otherPointer to the eVision.Legacy.EWedgeGauge object in which the current eVision.Legacy.EWedgeGauge object data have to be copied.
recursivetrue if the children gauges have to be copied as well, false otherwise.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ Drag()

None eVision.Legacy.EWedgeGauge.Drag ( self,
int x,
int y )

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

Parameters
xCursor current X coordinate.
yCursor current Y coordinate.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ Draw() [1/3]

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

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

Parameters
graphicContextHandle of the device context on which to draw.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ Draw() [2/3]

None eVision.Legacy.EWedgeGauge.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
graphicContextHandle of the device context on which to draw.
drawingModeIndicates how the point location or model fitting gauge must be displayed, as defined by eVision.EDrawingMode.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ Draw() [3/3]

None eVision.Legacy.EWedgeGauge.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
graphicContextHandle of the device context on which to draw.
drawingModeIndicates how the point location or model fitting gauge must be displayed, as defined by eVision.EDrawingMode.
daughterstrue if the daughters gauges are to be displayed also.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ FilteringThreshold() [1/2]

float eVision.Legacy.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge 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.EWedgeGauge.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.EWedgeGauge.MeasureSample, and
  2. Among all the sample points along the latter sample path, it is the one selected by the eVision.Legacy.EWedgeGauge.TransitionChoice property.
Note
For this method to succeed, it is necessary to previously call eVision.Legacy.EWedgeGauge.MeasureSample.

◆ GetMeasuredPoint() [2/2]

eVision.EPoint eVision.Legacy.EWedgeGauge.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.EWedgeGauge 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.EWedgeGauge.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.EWedgeGauge.MeasureSample, and
  2. Among all the sample points along the latter sample path, it is the one selected by the eVision.Legacy.EWedgeGauge.TransitionChoice property.
Note
For this method to succeed, it is necessary to previously call eVision.Legacy.EWedgeGauge.MeasureSample.
Parameters
indexThis argument must be left unchanged from its default value, i.e. ~0 (= 0xFFFFFFFF).

◆ GetSample() [1/2]

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

◆ GetSample() [2/2]

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

◆ GetSampleA() [1/3]

bool eVision.Legacy.EWedgeGauge.GetSampleA ( self,
eVision.EPeak pk,
int index )

Allows to retrieve information on the samples found along the A 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.EWedgeGauge.GetSampleRightEdge instead.

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

Parameters
pkeVision.EPeak structure that will contain the sample peak properties.
indexThe sample index

◆ GetSampleA() [2/3]

bool eVision.Legacy.EWedgeGauge.GetSampleA ( self,
eVision.EPoint pt,
int index )

Allows to retrieve information on the samples found along the A 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.EWedgeGauge.GetSampleRightEdge instead.

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

Parameters
pteVision.EPoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleA() [3/3]

None eVision.Legacy.EWedgeGauge.GetSampleA ( self,
eVision.Legacy.ESamplePoint sp,
int index )

Allows to retrieve information on the samples found along the A 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.EWedgeGauge.GetSampleRightEdge instead.

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

Parameters
speVision.Legacy.ESamplePoint structure that will receive the sample position.
indexThe sample index

◆ GetSamplea() [1/3]

bool eVision.Legacy.EWedgeGauge.GetSamplea ( self,
eVision.EPeak pk,
int index )

Allows to retrieve information on the samples found along the a 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.EWedgeGauge.GetSampleLeftEdge instead.

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

Parameters
pkeVision.EPeak structure that will contain the sample peak properties.
indexThe sample index

◆ GetSamplea() [2/3]

bool eVision.Legacy.EWedgeGauge.GetSamplea ( self,
eVision.EPoint pt,
int index )

Allows to retrieve information on the samples found along the a 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.EWedgeGauge.GetSampleLeftEdge instead.

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

Parameters
pteVision.EPoint structure that will receive the sample position.
indexThe sample index

◆ GetSamplea() [3/3]

None eVision.Legacy.EWedgeGauge.GetSamplea ( self,
eVision.Legacy.ESamplePoint sp,
int index )

Allows to retrieve information on the samples found along the a 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.EWedgeGauge.GetSampleLeftEdge instead.

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

Parameters
speVision.Legacy.ESamplePoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleInnerEdge() [1/3]

bool eVision.Legacy.EWedgeGauge.GetSampleInnerEdge ( self,
eVision.EPeak pk,
int index )

Allows to retrieve information on the samples found along the inner 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
pkeVision.EPeak structure that will contain the sample peak properties.
indexThe sample index

◆ GetSampleInnerEdge() [2/3]

bool eVision.Legacy.EWedgeGauge.GetSampleInnerEdge ( self,
eVision.EPoint pt,
int index )

Allows to retrieve information on the samples found along the inner 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
pteVision.EPoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleInnerEdge() [3/3]

None eVision.Legacy.EWedgeGauge.GetSampleInnerEdge ( self,
eVision.Legacy.ESamplePoint sp,
int index )

Allows to retrieve information on the samples found along the inner 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
speVision.Legacy.ESamplePoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleLeftEdge() [1/3]

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

Allows to retrieve information on the samples found along the left 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
pkeVision.EPeak structure that will contain the sample peak properties.
indexThe sample index

◆ GetSampleLeftEdge() [2/3]

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

Allows to retrieve information on the samples found along the left 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
pteVision.EPoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleLeftEdge() [3/3]

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

Allows to retrieve information on the samples found along the left 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
speVision.Legacy.ESamplePoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleOuterEdge() [1/3]

bool eVision.Legacy.EWedgeGauge.GetSampleOuterEdge ( self,
eVision.EPeak pk,
int index )

Allows to retrieve information on the samples found along the outer 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
pkeVision.EPeak structure that will contain the sample peak properties.
indexThe sample index

◆ GetSampleOuterEdge() [2/3]

bool eVision.Legacy.EWedgeGauge.GetSampleOuterEdge ( self,
eVision.EPoint pt,
int index )

Allows to retrieve information on the samples found along the outer 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
pteVision.EPoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleOuterEdge() [3/3]

None eVision.Legacy.EWedgeGauge.GetSampleOuterEdge ( self,
eVision.Legacy.ESamplePoint sp,
int index )

Allows to retrieve information on the samples found along the outer 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
speVision.Legacy.ESamplePoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleR() [1/3]

bool eVision.Legacy.EWedgeGauge.GetSampleR ( self,
eVision.EPeak pk,
int index )

Allows to retrieve information on the samples found along the R 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.EWedgeGauge.GetSampleInnerEdge instead.

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

Parameters
pkeVision.EPeak structure that will contain the sample peak properties.
indexThe sample index

◆ GetSampleR() [2/3]

bool eVision.Legacy.EWedgeGauge.GetSampleR ( self,
eVision.EPoint pt,
int index )

Allows to retrieve information on the samples found along the R 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.EWedgeGauge.GetSampleInnerEdge instead.

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

Parameters
pteVision.EPoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleR() [3/3]

None eVision.Legacy.EWedgeGauge.GetSampleR ( self,
eVision.Legacy.ESamplePoint sp,
int index )

Allows to retrieve information on the samples found along the R 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.EWedgeGauge.GetSampleInnerEdge instead.

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

Parameters
speVision.Legacy.ESamplePoint structure that will receive the sample position.
indexThe sample index

◆ GetSampler() [1/3]

bool eVision.Legacy.EWedgeGauge.GetSampler ( self,
eVision.EPeak pk,
int index )

Allows to retrieve information on the samples found along the r 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.EWedgeGauge.GetSampleOuterEdge instead.

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

Parameters
pkeVision.EPeak structure that will contain the sample peak properties.
indexThe sample index

◆ GetSampler() [2/3]

bool eVision.Legacy.EWedgeGauge.GetSampler ( self,
eVision.EPoint pt,
int index )

Allows to retrieve information on the samples found along the r 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.EWedgeGauge.GetSampleOuterEdge instead.

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

Parameters
pteVision.EPoint structure that will receive the sample position.
indexThe sample index

◆ GetSampler() [3/3]

None eVision.Legacy.EWedgeGauge.GetSampler ( self,
eVision.Legacy.ESamplePoint sp,
int index )

Allows to retrieve information on the samples found along the r 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.EWedgeGauge.GetSampleOuterEdge instead.

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

Parameters
speVision.Legacy.ESamplePoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleRightEdge() [1/3]

bool eVision.Legacy.EWedgeGauge.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
pkeVision.EPeak structure that will contain the sample peak properties.
indexThe sample index

◆ GetSampleRightEdge() [2/3]

bool eVision.Legacy.EWedgeGauge.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
pteVision.EPoint structure that will receive the sample position.
indexThe sample index

◆ GetSampleRightEdge() [3/3]

None eVision.Legacy.EWedgeGauge.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
speVision.Legacy.ESamplePoint structure that will receive the sample position.
indexThe sample index

◆ GetSkipRange()

eVision.EIntegerRange eVision.Legacy.EWedgeGauge.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.EWedgeGauge.AddSkipRange method.

Remarks:

Start is guaranteed to be smaller or equal to end.

Parameters
indexIndex of the skip range.

◆ HitTest() [1/2]

bool eVision.Legacy.EWedgeGauge.HitTest ( self)

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

Reimplemented from eVision.Legacy.EWedgeShape.

◆ HitTest() [2/2]

bool eVision.Legacy.EWedgeGauge.HitTest ( self,
bool daughters )

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

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

Reimplemented from eVision.Legacy.EWedgeShape.

◆ HVConstraint() [1/2]

bool eVision.Legacy.EWedgeGauge.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.EWedgeGauge.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.

◆ Measure() [1/2]

None eVision.Legacy.EWedgeGauge.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
sourceImagePointer to the source image.

◆ Measure() [2/2]

None eVision.Legacy.EWedgeGauge.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
sourceImagePointer to the source image.
regionRegion to use with the source image.

◆ MeasuredWedge()

eVision.Legacy.EWedge eVision.Legacy.EWedgeGauge.MeasuredWedge ( self)

Information pertaining to the fitted wedge.

Remarks:

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

◆ MeasureSample() [1/2]

None eVision.Legacy.EWedgeGauge.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.EWedgeGauge object.

Parameters
sourceImagePointer to the source image/ROI.
regionRegion on which to measure.
pathIndexSample path index.

◆ MeasureSample() [2/2]

None eVision.Legacy.EWedgeGauge.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.EWedgeGauge object.

Parameters
sourceImagePointer to the source image/ROI.
pathIndexSample path index.

◆ MeasureWithoutFitting() [1/2]

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

Triggers the point location without wedge fitting operation.

Remarks:

This method performs the actual measurement for each transition, but does not perform the wedge fitting. This means that individual samples will be available for each edges through the eVision.Legacy.EWedgeGauge.GetSamplea (Edge a), eVision.Legacy.EWedgeGauge.GetSampler (Edge r), eVision.Legacy.EWedgeGauge.GetSampleA (Edge A), eVision.Legacy.EWedgeGauge.GetSampleR (Edge R) 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
sourceImageSource image.

◆ MeasureWithoutFitting() [2/2]

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

Triggers the point location without wedge fitting operation.

Remarks:

This method performs the actual measurement for each transition, but does not perform the wedge fitting. This means that individual samples will be available for each edges through the eVision.Legacy.EWedgeGauge.GetSamplea (Edge a), eVision.Legacy.EWedgeGauge.GetSampler (Edge r), eVision.Legacy.EWedgeGauge.GetSampleA (Edge A), eVision.Legacy.EWedgeGauge.GetSampleR (Edge R) 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
sourceImageSource image.
regionRegion to delimit the source image.

◆ MinAmplitude() [1/2]

int eVision.Legacy.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.MinNumFitSamples ( self)

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

Remarks:

In case of a EWedgeGauge, a vector of 4 values are used:

  1. Minimum number of samples on the outer circle of the wedge, default value is 3.
  2. Minimum number of samples on the original border of the wedge, default value is 1.
  3. Minimum number of samples on the inner circle of the wedge, default value is 3.
  4. Minimum number of samples on the end border of the wedge, default value is 1.

When the eVision.Legacy.EWedgeGauge.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.EWedgeGauge.MinNumFitSamples ( self,
list[int] value )

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

Remarks:

In case of a EWedgeGauge, a vector of 4 values are used:

  1. Minimum number of samples on the outer circle of the wedge, default value is 3.
  2. Minimum number of samples on the original border of the wedge, default value is 1.
  3. Minimum number of samples on the inner circle of the wedge, default value is 3.
  4. Minimum number of samples on the end border of the wedge, default value is 1.

When the eVision.Legacy.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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).

◆ NumSamplesA()

int eVision.Legacy.EWedgeGauge.NumSamplesA ( self)

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

Deprecated

Use eVision.Legacy.EWedgeGauge.NumSamplesRightEdge instead.

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

◆ NumSamplesa()

int eVision.Legacy.EWedgeGauge.NumSamplesa ( self)

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

Deprecated

Use eVision.Legacy.EWedgeGauge.NumSamplesLeftEdge instead.

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

◆ NumSamplesInnerEdge()

int eVision.Legacy.EWedgeGauge.NumSamplesInnerEdge ( self)

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

◆ NumSamplesLeftEdge()

int eVision.Legacy.EWedgeGauge.NumSamplesLeftEdge ( self)

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

◆ NumSamplesOuterEdge()

int eVision.Legacy.EWedgeGauge.NumSamplesOuterEdge ( self)

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

◆ NumSamplesR()

int eVision.Legacy.EWedgeGauge.NumSamplesR ( self)

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

Deprecated

Use eVision.Legacy.EWedgeGauge.NumSamplesInnerEdge instead.

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

◆ NumSamplesr()

int eVision.Legacy.EWedgeGauge.NumSamplesr ( self)

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

Deprecated

Use eVision.Legacy.EWedgeGauge.NumSamplesOuterEdge instead.

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

◆ NumSamplesRightEdge()

int eVision.Legacy.EWedgeGauge.NumSamplesRightEdge ( self)

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

◆ NumSkipRanges()

int eVision.Legacy.EWedgeGauge.NumSkipRanges ( self)

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

◆ NumValidSamples()

int eVision.Legacy.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.MeasureSample.

Note
For this method to succeed, it is necessary to previously call eVision.Legacy.EWedgeGauge.MeasureSample.
Parameters
graphicContextHandle of the device context on which to draw.
drawItemsBoolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
widthWidth of the plot.
heightHeight of the plot.

◆ Plot() [2/3]

None eVision.Legacy.EWedgeGauge.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.EWedgeGauge.MeasureSample.

Note
For this method to succeed, it is necessary to previously call eVision.Legacy.EWedgeGauge.MeasureSample.
Parameters
graphicContextHandle of the device context on which to draw.
drawItemsBoolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
widthWidth of the plot.
heightHeight of the plot.
originXOrigin point coordinates of the plot along the X axis.

◆ Plot() [3/3]

None eVision.Legacy.EWedgeGauge.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.EWedgeGauge.MeasureSample.

Note
For this method to succeed, it is necessary to previously call eVision.Legacy.EWedgeGauge.MeasureSample.
Parameters
graphicContextHandle of the device context on which to draw.
drawItemsBoolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
widthWidth of the plot.
heightHeight of the plot.
originXOrigin point coordinates of the plot along the X axis.
originYOrigin point coordinates of the plot along the Y axis.

◆ Process() [1/4]

None eVision.Legacy.EWedgeGauge.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
sourceImagePointer to the source image.

Reimplemented from eVision.Legacy.EShape.

◆ Process() [2/4]

None eVision.Legacy.EWedgeGauge.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
sourceImagePointer to the source image.
daughtersFlag indicating whether the daughters shapes inherit of the same behavior.

Reimplemented from eVision.Legacy.EShape.

◆ Process() [3/4]

None eVision.Legacy.EWedgeGauge.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
sourceImagePointer to the source image.
regionRegion to use with the source image.

Reimplemented from eVision.Legacy.EShape.

◆ Process() [4/4]

None eVision.Legacy.EWedgeGauge.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
sourceImagePointer to the source image.
regionRegion to use with the source image.
daughtersFlag indicating whether the daughters shapes inherit of the same behavior.

Reimplemented from eVision.Legacy.EShape.

◆ RectangularSamplingArea() [1/2]

bool eVision.Legacy.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.RemoveAllSkipRanges ( self)

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

◆ RemoveSkipRange()

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

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

Parameters
indexIndex of the skip range to remove, as returned by eVision.Legacy.EWedgeGauge.AddSkipRange.

◆ SamplingStep() [1/2]

float eVision.Legacy.EWedgeGauge.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.EWedgeGauge.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.

◆ SetDiameters()

None eVision.Legacy.EWedgeGauge.SetDiameters ( self,
float diameter,
float breadth )

Sets the nominal inner/outer diameter and breadth of the eVision.Legacy.EWedgeGauge.

Remarks:

A eVision.Legacy.EWedgeGauge is fully defined knowing its nominal position (given by the coordinates of its center), its nominal outer radius (diameter), its breadth, the angular position from where it extents, its angular amplitude and its outline tolerance.

By default, the eVision.Legacy.EWedgeGauge diameter value is 100, which means 100 pixels when the field of view is not calibrated and 100 "units" in case of a calibrated field of view.

Parameters
diameterOuter diameter of the eVision.Legacy.EWedgeGauge. The default value is 100.
breadthBreadth of the eVision.Legacy.EWedgeGauge. It must be negative or zero. Its default value is -50.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ SetFromOriginMiddleEnd() [1/3]

None eVision.Legacy.EWedgeGauge.SetFromOriginMiddleEnd ( self,
eVision.EPoint origin,
eVision.EPoint middle,
eVision.EPoint end )

Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.

Remarks:

In a direct coordinate system, the abscissa extends rightwards and the ordinate extends upwards. The coordinate system is said to be inverse if the abscissa extends rightwards and the ordinate extends downwards.

Parameters
originOrigin point coordinates of the wedge.
middleMiddle point coordinates of the wedge.
endEnd point coordinates of the wedge.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ SetFromOriginMiddleEnd() [2/3]

None eVision.Legacy.EWedgeGauge.SetFromOriginMiddleEnd ( self,
eVision.EPoint origin,
eVision.EPoint middle,
eVision.EPoint end,
float breadth )

Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.

Remarks:

In a direct coordinate system, the abscissa extends rightwards and the ordinate extends upwards. The coordinate system is said to be inverse if the abscissa extends rightwards and the ordinate extends downwards.

Parameters
originOrigin point coordinates of the wedge.
middleMiddle point coordinates of the wedge.
endEnd point coordinates of the wedge.
breadthNominal breadth of the wedge. It must be negative or zero. The default value is -50.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ SetFromOriginMiddleEnd() [3/3]

None eVision.Legacy.EWedgeGauge.SetFromOriginMiddleEnd ( self,
eVision.EPoint origin,
eVision.EPoint middle,
eVision.EPoint end,
float breadth,
bool fullCircle )

Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.

Remarks:

In a direct coordinate system, the abscissa extends rightwards and the ordinate extends upwards. The coordinate system is said to be inverse if the abscissa extends rightwards and the ordinate extends downwards.

Parameters
originOrigin point coordinates of the wedge.
middleMiddle point coordinates of the wedge.
endEnd point coordinates of the wedge.
breadthNominal breadth of the wedge. It must be negative or zero. The default value is -50.
fullCircletrue (default) in case of a full turn wedge. If fullCircle is false, origin and end give the wedge's amplitude.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ SetFromTwoPoints() [1/3]

None eVision.Legacy.EWedgeGauge.SetFromTwoPoints ( self,
eVision.EPoint center,
eVision.EPoint origin )

Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.

Remarks:

In a direct coordinate system, the abscissa extends rightwards and the ordinate extends upwards. The coordinate system is said to be inverse if the abscissa extends rightwards and the ordinate extends downwards.

Parameters
centerCenter coordinates of the wedge at its nominal position. The default value is (0,0).
originOrigin point coordinates of the wedge.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ SetFromTwoPoints() [2/3]

None eVision.Legacy.EWedgeGauge.SetFromTwoPoints ( self,
eVision.EPoint center,
eVision.EPoint origin,
float breadth )

Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.

Remarks:

In a direct coordinate system, the abscissa extends rightwards and the ordinate extends upwards. The coordinate system is said to be inverse if the abscissa extends rightwards and the ordinate extends downwards.

Parameters
centerCenter coordinates of the wedge at its nominal position. The default value is (0,0).
originOrigin point coordinates of the wedge.
breadthNominal breadth of the wedge. It must be negative or zero. The default value is -50.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ SetFromTwoPoints() [3/3]

None eVision.Legacy.EWedgeGauge.SetFromTwoPoints ( self,
eVision.EPoint center,
eVision.EPoint origin,
float breadth,
bool direct )

Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an eVision.Legacy.EWedgeGauge object.

Remarks:

In a direct coordinate system, the abscissa extends rightwards and the ordinate extends upwards. The coordinate system is said to be inverse if the abscissa extends rightwards and the ordinate extends downwards.

Parameters
centerCenter coordinates of the wedge at its nominal position. The default value is (0,0).
originOrigin point coordinates of the wedge.
breadthNominal breadth of the wedge. It must be negative or zero. The default value is -50.
directtrue (default) means that angles increase anticlockwise in a direct coordinate system and clockwise in an inverse coordinate system.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ SetRadii()

None eVision.Legacy.EWedgeGauge.SetRadii ( self,
float radius,
float breadth )

Sets the nominal radius and breadth of the eVision.Legacy.EWedgeGauge.

Remarks:

A eVision.Legacy.EWedgeGauge is fully defined knowing its nominal position (given by the coordinates of its center), its nominal radius (diameter), its breadth, the angular position from where it extents, its angular amplitude and its outline tolerance.

By default, the eVision.Legacy.EWedgeGauge radius value is 50, which means 50 pixels when the field of view is not calibrated and 50 "units" in case of a calibrated field of view.

Parameters
radiusOuter radius of the eVision.Legacy.EWedgeGauge. The default value is 50.
breadthBreadth of the eVision.Legacy.EWedgeGauge, which must be negative or zero. Its default value is -50.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ Shape()

eVision.Legacy.EWedge eVision.Legacy.EWedgeGauge.Shape ( self)

◆ Smoothing() [1/2]

int eVision.Legacy.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.Tolerance ( self)

Searching area half thickness of the wedge fitting gauge.

Remarks:

A wedge fitting gauge is fully defined knowing its nominal position (its center coordinates), its outer nominal radius (diameter), its breadth, the angular position from where it extents, its angular amplitude, and its outline tolerance.

By default, the searching area thickness of the wedge 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.EWedgeGauge.Tolerance ( self,
float value )

Searching area half thickness of the wedge fitting gauge.

Remarks:

A wedge fitting gauge is fully defined knowing its nominal position (its center coordinates), its outer nominal radius (diameter), its breadth, the angular position from where it extents, its angular amplitude, and its outline tolerance.

By default, the searching area thickness of the wedge 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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.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.EWedgeGauge.Type ( self)

Shape type.

Reimplemented from eVision.Legacy.EWedgeShape.

◆ Valid()

bool eVision.Legacy.EWedgeGauge.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.EWedgeGauge.MeasureSample, and thus a point has been measured.

Property Documentation

◆ Wedge

eVision.Legacy.EWedgeGauge.Wedge
static
Initial value:
= property(None, _Wedge__setter, None,
)