Manages a wedge fitting gauge. More...

#include <eVision/EasyGauge/Legacy/EWedgeGauge.h>

Inheritance diagram for eVision::Legacy::EWedgeGauge:

Collaboration diagram for eVision::Legacy::EWedgeGauge:

Public Member Functions
	EWedgeGauge ()
	Constructs a wedge measurement context.
	EWedgeGauge (const eVision::Legacy::EWedgeGauge &other)
	Constructs a wedge measurement context.
virtual	~EWedgeGauge () throw ()
eVision::Legacy::EWedgeGauge &	operator= (const eVision::Legacy::EWedgeGauge &other)
	Copies all the data from another EWedgeGauge object into the current EWedgeGauge object.
float	GetFilteringThreshold () const
	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.
void	SetFilteringThreshold (float f32FilteringThreshold)
	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.
uint32_t	GetNumFilteringPasses () const
	Number of filtering passes for a model fitting operation.
void	SetNumFilteringPasses (uint32_t un32NumFilteringPasses)
	Number of filtering passes for a model fitting operation.
uint32_t	GetNumValidSamples () const
	Number of valid sample points remaining after a model fitting operation.
float	GetAverageDistance () const
	Average distance between the sampled points and the fitted model.
void	SetMinNumFitSamples (int32_t side0, int32_t side1, int32_t side2, int32_t side3)
	Sets the minimum number of samples required for fitting on each side of the shape.
void	SetMinNumFitSamples (int32_t side0, int32_t side1, int32_t side2)
	Sets the minimum number of samples required for fitting on each side of the shape.
void	SetMinNumFitSamples (int32_t side0, int32_t side1)
	Sets the minimum number of samples required for fitting on each side of the shape.
void	SetMinNumFitSamples (int32_t side0)
	Sets the minimum number of samples required for fitting on each side of the shape.
void	GetMinNumFitSamples (int32_t &side0, int32_t &side1, int32_t &side2, int32_t &side3)
	Returns the minimum number of samples required for fitting on each side of the shape.
void	SetMinNumFitSamples (const std::vector< int32_t > &sides)
	Sets/Gets the minimum number of samples required for fitting the shape.
std::vector< int32_t >	GetMinNumFitSamples () const
	Sets/Gets the minimum number of samples required for fitting the shape.
uint32_t	AddSkipRange (const uint32_t start, const uint32_t end)
	Adds an item to the set of skip ranges and returns the index of the newly added range.
uint32_t	AddSkipRange (const eVision::EIntegerRange &range)
	Adds an item to the set of skip ranges and returns the index of the newly added range.
uint32_t	GetNumSkipRanges () const
	Number of skip ranges in the gauge after a call to EWedgeGauge::AddSkipRange.
void	GetSkipRange (const uint32_t index, uint32_t &start, uint32_t &end) const
	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 EWedgeGauge::AddSkipRange method.
eVision::EIntegerRange	GetSkipRange (uint32_t index) const
	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 EWedgeGauge::AddSkipRange method.
void	RemoveSkipRange (const uint32_t index)
	After a call to EWedgeGauge::AddSkipRange, removes the skip range with the given index.
void	RemoveAllSkipRanges ()
	Removes all the skip ranges previously created by a call to EWedgeGauge::AddSkipRange.
void	CopyTo (eVision::Legacy::EWedgeGauge &other, bool recursive) const
	Copies all the data of the current EWedgeGauge object into another EWedgeGauge object, and returns it.
void	CopyTo (eVision::Legacy::EWedgeGauge &other) const
	Copies all the data of the current EWedgeGauge object into another EWedgeGauge object, and returns it.
eVision::Legacy::EWedgeGauge *	CopyTo (eVision::Legacy::EWedgeGauge *other, bool recursive) const
	Copies all the data of the current EWedgeGauge object into another EWedgeGauge object, and returns it.
virtual eVision::EShapeType	GetType () const
	Shape type.
eVision::Legacy::EWedge	GetShape ()
virtual void	SetWedge (const eVision::Legacy::EWedge &wedge)
	Sets the nominal position (center coordinates), diameter, breadth, angular origin and amplitude of the wedge fitting gauge according to a known wedge.
virtual void	SetFromTwoPoints (const eVision::EPoint &center, const eVision::EPoint &origin, float breadth, bool direct)
	Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an EWedgeGauge object.
virtual void	SetFromTwoPoints (const eVision::EPoint &center, const eVision::EPoint &origin, float breadth)
	Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an EWedgeGauge object.
virtual void	SetFromTwoPoints (const eVision::EPoint &center, const eVision::EPoint &origin)
	Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an EWedgeGauge object.
virtual void	SetFromOriginMiddleEnd (const eVision::EPoint &origin, const eVision::EPoint &middle, const eVision::EPoint &end, float breadth, bool fullCircle)
	Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an EWedgeGauge object.
virtual void	SetFromOriginMiddleEnd (const eVision::EPoint &origin, const eVision::EPoint &middle, const eVision::EPoint &end, float breadth)
	Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an EWedgeGauge object.
virtual void	SetFromOriginMiddleEnd (const eVision::EPoint &origin, const eVision::EPoint &middle, const eVision::EPoint &end)
	Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an EWedgeGauge object.
bool	GetActive ()
	Sets the flag indicating whether the gauge is active or not.
virtual void	SetActive (bool active)
	Sets the flag indicating whether the gauge is active or not.
void	SetRectangularSamplingArea (bool bRectangularSamplingArea)
	Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.
bool	GetRectangularSamplingArea ()
	Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.
uint32_t	GetActiveEdges () const
	Active edges as defined in EDragHandle.
void	SetActiveEdges (uint32_t un32ActiveEdges)
	Active edges as defined in EDragHandle.
virtual void	SetDiameters (float diameter, float breadth)
	Sets the nominal inner/outer diameter and breadth of the EWedgeGauge.
virtual void	SetRadii (float radius, float breadth)
	Sets the nominal radius and breadth of the EWedgeGauge.
void	SetTolerance (float f32Tolerance)
	Searching area half thickness of the wedge fitting gauge.
float	GetTolerance ()
	Searching area half thickness of the wedge fitting gauge.
void	SetHVConstraint (bool bHVConstraint)
	Status of the restriction on the orientation of the point location gauge or model fitting sample paths.
bool	GetHVConstraint ()
	Status of the restriction on the orientation of the point location gauge or model fitting sample paths.
void	SetTransitionType (eVision::ETransitionType transitionType)
	Transition type.
eVision::ETransitionType	GetTransitionType ()
	Transition type.
void	SetTransitionChoice (eVision::ETransitionChoice transitionChoice)
	Transition choice.
eVision::ETransitionChoice	GetTransitionChoice ()
	Transition choice.
void	SetTransitionIndex (uint32_t un32TransitionIndex)
	Index (from 0 on) of the transition to be retained when the transition choice parameter is set to ETransitionChoice::ETransitionChoice_NthFromBegin or ETransitionChoice::ETransitionChoice_NthFromEnd.
uint32_t	GetTransitionIndex ()
	Index (from 0 on) of the transition to be retained when the transition choice parameter is set to ETransitionChoice::ETransitionChoice_NthFromBegin or ETransitionChoice::ETransitionChoice_NthFromEnd.
void	SetThreshold (uint32_t un32Threshold)
	Threshold level used to delimit significant peaks in the data profile.
uint32_t	GetThreshold ()
	Threshold level used to delimit significant peaks in the data profile.
void	SetMinAmplitude (uint32_t un32MinAmplitude)
	Offset added to the Threshold when a peak is to be detected.
uint32_t	GetMinAmplitude ()
	Offset added to the Threshold when a peak is to be detected.
void	SetMinArea (uint32_t un32MinArea)
	Minimum area value.
uint32_t	GetMinArea ()
	Minimum area value.
uint32_t	GetThickness ()
	Number of parallel segments used to extract the data profile.
void	SetThickness (uint32_t un32Thickness)
	Number of parallel segments used to extract the data profile.
uint32_t	GetSmoothing ()
	Number of pixels used for the low-pass filtering operation.
void	SetSmoothing (uint32_t un32Smoothing)
	Number of pixels used for the low-pass filtering operation.
float	GetSamplingStep () const
	Approximate distance between sampled points during a model fitting operation.
void	SetSamplingStep (float f32SamplingStep)
	Approximate distance between sampled points during a model fitting operation.
uint32_t	GetNumSamples () const
	Number of sampled points during the model fitting operation.
uint32_t	GetNumSamplesa () const
	Number of sampled points found on edge a during the measure operation.
uint32_t	GetNumSamplesr () const
	Number of sampled points found on edge r during the measure operation.
uint32_t	GetNumSamplesA () const
	Number of sampled points found on edge A during the measure operation.
uint32_t	GetNumSamplesR () const
	Number of sampled points found on edge R during the measure operation.
uint32_t	GetNumSamplesLeftEdge () const
	Number of sampled points found on leftmost edge during the measure operation.
uint32_t	GetNumSamplesRightEdge () const
	Number of sampled points found on rightmost edge during the measure operation.
uint32_t	GetNumSamplesOuterEdge () const
	Number of sampled points found on outer edge during the measure operation.
uint32_t	GetNumSamplesInnerEdge () const
	Number of sampled points found on inner edge during the measure operation.
virtual void	Process (eVision::EROIBW8 *sourceImage, bool daughters)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
virtual void	Process (eVision::EROIBW8 *sourceImage)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
virtual void	Process (eVision::EROIBW8 *sourceImage, const eVision::ERegion &region, bool daughters)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
virtual void	Process (eVision::EROIBW8 *sourceImage, const eVision::ERegion &region)
	Triggers the process pertaining to a shape or gauge and all the daughter gauges attach to it.
void	Measure (eVision::EROIBW8 *sourceImage)
	Triggers the point location or the model fitting operation.
void	Measure (eVision::EROIBW8 *sourceImage, const eVision::ERegion &region)
	Triggers the point location or the model fitting operation.
void	MeasureWithoutFitting (eVision::EROIBW8 *sourceImage)
	Triggers the point location without wedge fitting operation.
void	MeasureWithoutFitting (eVision::EROIBW8 *sourceImage, const eVision::ERegion &region)
	Triggers the point location without wedge fitting operation.
void	MeasureSample (eVision::EROIBW8 *sourceImage, uint32_t pathIndex)
	Computes the sample points along the sample path whose index in the list is given by the pathIndex parameter.
void	MeasureSample (eVision::EROIBW8 *sourceImage, const eVision::ERegion &region, uint32_t pathIndex)
	Computes the sample points along the sample path whose index in the list is given by the pathIndex parameter.
eVision::Legacy::EWedge	GetMeasuredWedge ()
	Information pertaining to the fitted wedge.
eVision::EPoint	GetMeasuredPoint (uint32_t index)
	Returns the coordinates of a sample point, measured along one of the sample paths of the gauge.
eVision::EPoint	GetMeasuredPoint ()
	Returns the coordinates of a sample point, measured along one of the sample paths of the gauge.
bool	GetValid ()
	Flag indicating if at least one valid transition has been found.
bool	GetSamplea (eVision::EPoint &pt, uint32_t index)
	Allows to retrieve information on the samples found along the a edge.
void	GetSamplea (eVision::Legacy::ESamplePoint &sp, uint32_t index)
	Allows to retrieve information on the samples found along the a edge.
bool	GetSamplea (eVision::EPeak &pk, uint32_t index)
	Allows to retrieve information on the samples found along the a edge.
bool	GetSampler (eVision::EPoint &pt, uint32_t index)
	Allows to retrieve information on the samples found along the r edge.
void	GetSampler (eVision::Legacy::ESamplePoint &sp, uint32_t index)
	Allows to retrieve information on the samples found along the r edge.
bool	GetSampler (eVision::EPeak &pk, uint32_t index)
	Allows to retrieve information on the samples found along the r edge.
bool	GetSampleA (eVision::EPoint &pt, uint32_t index)
	Allows to retrieve information on the samples found along the A edge.
void	GetSampleA (eVision::Legacy::ESamplePoint &sp, uint32_t index)
	Allows to retrieve information on the samples found along the A edge.
bool	GetSampleA (eVision::EPeak &pk, uint32_t index)
	Allows to retrieve information on the samples found along the A edge.
bool	GetSampleR (eVision::EPoint &pt, uint32_t index)
	Allows to retrieve information on the samples found along the R edge.
void	GetSampleR (eVision::Legacy::ESamplePoint &sp, uint32_t index)
	Allows to retrieve information on the samples found along the R edge.
bool	GetSampleR (eVision::EPeak &pk, uint32_t index)
	Allows to retrieve information on the samples found along the R edge.
bool	GetSampleLeftEdge (eVision::EPoint &pt, uint32_t index)
	Allows to retrieve information on the samples found along the left edge.
void	GetSampleLeftEdge (eVision::Legacy::ESamplePoint &sp, uint32_t index)
	Allows to retrieve information on the samples found along the left edge.
bool	GetSampleLeftEdge (eVision::EPeak &pk, uint32_t index)
	Allows to retrieve information on the samples found along the left edge.
bool	GetSampleOuterEdge (eVision::EPoint &pt, uint32_t index)
	Allows to retrieve information on the samples found along the outer edge.
void	GetSampleOuterEdge (eVision::Legacy::ESamplePoint &sp, uint32_t index)
	Allows to retrieve information on the samples found along the outer edge.
bool	GetSampleOuterEdge (eVision::EPeak &pk, uint32_t index)
	Allows to retrieve information on the samples found along the outer edge.
bool	GetSampleRightEdge (eVision::EPoint &pt, uint32_t index)
	Allows to retrieve information on the samples found along the rightmost edge.
void	GetSampleRightEdge (eVision::Legacy::ESamplePoint &sp, uint32_t index)
	Allows to retrieve information on the samples found along the rightmost edge.
bool	GetSampleRightEdge (eVision::EPeak &pk, uint32_t index)
	Allows to retrieve information on the samples found along the rightmost edge.
bool	GetSampleInnerEdge (eVision::EPoint &pt, uint32_t index)
	Allows to retrieve information on the samples found along the inner edge.
void	GetSampleInnerEdge (eVision::Legacy::ESamplePoint &sp, uint32_t index)
	Allows to retrieve information on the samples found along the inner edge.
bool	GetSampleInnerEdge (eVision::EPeak &pk, uint32_t index)
	Allows to retrieve information on the samples found along the inner edge.
bool	GetSample (eVision::EPoint &pt, uint32_t index)
void	GetSample (eVision::Legacy::ESamplePoint &sp, uint32_t index)
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	Draw (eVision::EDrawAdapter *graphicContext)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	Draw (HDC graphicContext, eVision::EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	Draw (HDC graphicContext, eVision::EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	Draw (HDC graphicContext)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	Draw (HDC graphicContext, const eVision::ERGBColor &color, eVision::EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	Draw (HDC graphicContext, const eVision::ERGBColor &color, eVision::EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	Draw (HDC graphicContext, const eVision::ERGBColor &color)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	DrawWithCurrentPen (HDC graphicContext, eVision::EDrawingMode drawingMode, bool daughters)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	DrawWithCurrentPen (HDC graphicContext, eVision::EDrawingMode drawingMode)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
virtual void	DrawWithCurrentPen (HDC graphicContext)
	Draws a graphical representation of a point location or model fitting gauge, as defined by EDrawingMode.
void	Plot (eVision::EDrawAdapter *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 EPlotItem.
void	Plot (eVision::EDrawAdapter *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 EPlotItem.
void	Plot (eVision::EDrawAdapter *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 EPlotItem.
void	Plot (HDC 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 EPlotItem.
void	Plot (HDC 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 EPlotItem.
void	Plot (HDC 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 EPlotItem.
void	Plot (HDC graphicContext, const eVision::ERGBColor &color, 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 EPlotItem.
void	Plot (HDC graphicContext, const eVision::ERGBColor &color, 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 EPlotItem.
void	Plot (HDC graphicContext, const eVision::ERGBColor &color, 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 EPlotItem.
void	PlotWithCurrentPen (HDC 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 EPlotItem.
void	PlotWithCurrentPen (HDC 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 EPlotItem.
void	PlotWithCurrentPen (HDC 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 EPlotItem.
virtual bool	HitTest (bool daughters)
	Checks whether the cursor is positioned over a handle (true) or not (false).
virtual bool	HitTest ()
	Checks whether the cursor is positioned over a handle (true) or not (false).
virtual void	Drag (int32_t x, int32_t y)
	Moves a handle to a new position and updates the position parameters of the gauge.
	EWedgeGauge (CppWrapperInternal::InternalConstructor)
Public Member Functions inherited from eVision::Legacy::EWedgeShape
virtual	~EWedgeShape () throw ()
eVision::Legacy::EWedgeShape &	operator= (const eVision::Legacy::EWedgeShape &other)
	Copies all the data from another EWedgeShape object into the current EWedgeShape object.
eVision::EPoint	GetCenter () const
	Center point of the shape.
void	SetCenter (const eVision::EPoint &center)
	Center point of the shape.
void	SetCenterXY (float centerX, float centerY)
	Sets the center coordinates of a EWedgeShape object.
float	GetCenterX () const
	Abscissa of the origin point of the shape.
float	GetCenterY () const
	Ordinate of the origin point of the shape.
float	GetAngle () const
	Orientation of the shape.
void	SetAngle (float f32Angle)
	Orientation of the shape.
float	GetScale () const
	Horizontal sensor resolution, in pixels per unit.
void	SetScale (float f32Scale)
	Horizontal sensor resolution, in pixels per unit.
void	CopyTo (eVision::Legacy::EWedgeShape &dest, bool bRecursive) const
	Copies all the data of the current EWedgeShape object into another EWedgeShape object and returns it.
void	CopyTo (eVision::Legacy::EWedgeShape &dest) const
	Copies all the data of the current EWedgeShape object into another EWedgeShape object and returns it.
eVision::Legacy::EWedgeShape *	CopyTo (eVision::Legacy::EWedgeShape *dest, bool bRecursive) const
	Copies all the data of the current EWedgeShape object into another EWedgeShape object and returns it.
void	SetFromCenterAndOrigin (const eVision::EPoint &center, const eVision::EPoint &origin, float breadth, bool direct)
	Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an EWedgeShape object.
void	SetFromCenterAndOrigin (const eVision::EPoint &center, const eVision::EPoint &origin, float breadth)
	Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an EWedgeShape object.
void	SetFromCenterAndOrigin (const eVision::EPoint &center, const eVision::EPoint &origin)
	Sets the geometric parameters (nominal position and diameter, breadth, angular position and amplitude) of an EWedgeShape object.
void	SetAmplitude (float amplitude)
	Angular amplitude of the EWedgeShape.
float	GetAmplitude () const
	Angular amplitude of the EWedgeShape.
virtual void	SetRadii (float outerRadius)
	Sets the nominal radius and breadth of the EWedgeShape.
virtual void	SetDiameters (float diameter)
	Sets the nominal inner/outer diameter and breadth of the EWedgeShape.
float	GetInnerDiameter () const
	Inner diameter of the EWedgeShape.
float	GetOuterDiameter () const
	Outer diameter of the EWedgeShape.
float	GetInnerRadius () const
	Inner radius of the EWedgeShape.
float	GetOuterRadius () const
	Outer radius of the EWedgeShape.
float	GetBreadth () const
	Breadth of the EWedgeShape.
float	GetInnerArcLength () const
	Inner circle arc length of the EWedgeShape.
float	GetOuterArcLength () const
	Outer circle arc length of the EWedgeShape.
float	GetOrgAngle () const
	Angular position from where the EWedgeShape extents.
float	GetApexAngle () const
	Angular position at the apex of the EWedgeShape.
float	GetEndAngle () const
	Ending angular position of the EWedgeShape.
eVision::EPoint	GetInnerOrg () const
	Inner origin point coordinates of the EWedgeShape.
eVision::EPoint	GetInnerApex () const
	Inner apex point coordinates of the EWedgeShape.
eVision::EPoint	GetInnerEnd () const
	Inner end point coordinates of the EWedgeShape.
eVision::EPoint	GetOuterOrg () const
	Outer origin point coordinates of the EWedgeShape.
eVision::EPoint	GetOuterApex () const
	Outer apex point coordinates of the EWedgeShape.
eVision::EPoint	GetOuterEnd () const
	Outer end point coordinates of the EWedgeShape.
eVision::EPoint	GetInnerPoint (float fraction) const
	Returns the coordinates of a particular point specified by its location along the inner circle arc.
eVision::EPoint	GetOuterPoint (float fraction) const
	Returns the coordinates of a particular point specified by its location along the outter circle arc.
eVision::EPoint	GetPoint (float breadthFraction, float angleFraction) const
	Returns the coordinates of a particular point specified by its location along the wedge perimeter.
bool	GetFullBreadth () const
	Flag indicating if the EWedgeShape has a full breadth (breadth = radius).
bool	GetFullCircle () const
	Flag indicating if the EWedgeShape is a full circle (amplitude = 2 PI).
bool	GetDirect ()
	Flag indicating whether positive angles correspond to a clockwise or an anticlockwise rotation.
void	SetDirect (bool direct)
void	GetMidEdges (eVision::EPoint &a, eVision::EPoint &AA, eVision::EPoint &r, eVision::EPoint &RR)
	Retrieves the center coordinates of each edge of the wedge fitting gauge.
void	GetCorners (eVision::EPoint &ar, eVision::EPoint &AAr, eVision::EPoint &aRR, eVision::EPoint &AARR)
	Retrieves the coordinates of each corner of the EWedgeShape.
void	GetEdges (eVision::Legacy::ELine &a, eVision::Legacy::ELine &AA, eVision::Legacy::ECircle &r, eVision::Legacy::ECircle &RR)
	Retrieves each edge of the EWedgeShape.
virtual void	Closest ()
	Find the daughter shape that is the closest to this shape. To retrieve the closest shape, use EShape::GetClosestShape.
	EWedgeShape (CppWrapperInternal::InternalConstructor)
Public Member Functions inherited from eVision::Legacy::EShape
virtual	~EShape () throw ()
std::string	GetName () const
	Name of the EShape object.
void	SetName (const std::string &name)
	Name of the EShape object.
eVision::Legacy::EShape *	GetShapeNamed (const std::string &name)
	Returns a pointer to a daughter gauge or shape specified by its name.
bool	GetVisible () const
	Flag indicating whether the shape is visible or not.
void	SetVisible (bool visible)
	Flag indicating whether the shape is visible or not.
void	SetVisibleRecursive (bool visible)
	Sets the flag indicating whether the shape and its daughter shapes are visible or not.
bool	GetSelected () const
	Flag indicating whether the shape is selected or not.
void	SetSelected (bool selected)
	Flag indicating whether the shape is selected or not.
void	SetSelectedRecursive (bool selected)
	Sets the flag indicating whether the shape and all its daughters are selected or not.
bool	GetSelectable () const
	Flag indicating whether the shape can be selected or not.
void	SetSelectable (bool selectable)
	Flag indicating whether the shape can be selected or not.
void	SetSelectableRecursive (bool selectable)
	Sets the flag indicating whether the shape and all its daughters can be selected or not.
bool	GetDragable () const
	Flag indicating whether the shape can be dragged or not.
void	SetDragable (bool dragable)
	Flag indicating whether the shape can be dragged or not.
void	SetDragableRecursive (bool dragable)
	Sets the flag indicating whether the shape and all its daughters can be dragged or not.
bool	GetResizable () const
	Flag indicating whether the shape can be resized or not.
void	SetResizable (bool resizable)
	Flag indicating whether the shape can be resized or not.
void	SetResizableRecursive (bool resizable)
	Sets the flag indicating whether the shape and all its daughters can be resized or not.
bool	GetRotatable () const
	Flag indicating whether the shape can be rotated or not.
void	SetRotatable (bool rotatable)
	Flag indicating whether the shape can be rotated or not.
void	SetRotatableRecursive (bool rotatable)
	Sets the flag indicating whether the shape and all its daughters can be rotated or not.
bool	GetLabeled () const
	Flag indicating whether the shape label should be displayed or not.
void	SetLabeled (bool labeled)
	Flag indicating whether the shape label should be displayed or not.
void	SetLabeledRecursive (bool labeled)
	Sets the flag indicating whether the shape label should be displayed or not. The flag is set in this shape and all its daughters.
virtual bool	GetActive () const
	Flag indicating whether the shape is active or not.
virtual void	SetActiveRecursive (bool active)
	Sets the flag indicating whether the shape and all its daughters are active or not.
bool	GetActualShape () const
	Flag indicating whether an inquiry returns a result pertaining to the nominal gauge (false, default) or the fitted model (true).
void	SetActualShape (bool actualShape)
	Flag indicating whether an inquiry returns a result pertaining to the nominal gauge (false, default) or the fitted model (true).
void	SetActualShapeRecursive (bool actualShape)
	Sets the flag indicating whether an inquiry returns a result pertaining to the nominal gauge (false, default) or the fitted model (true). The flag is set in this shape and all its daughters.
bool	GetFound () const
	Flag indicating whether a measured shape has been found.
bool	GetAutoArrange () const
void	SetAutoArrange (bool bAutoArrange, bool bDaughters)
void	SetAutoArrange (bool bAutoArrange)
virtual void	SetFound (bool bFound, bool bDaughters)
virtual void	SetFound (bool bFound)
bool	GetInspected () const
void	SetInspected (bool bFound, bool bDaughters)
void	SetInspected (bool bFound)
bool	GetPassed () const
void	SetPassed (bool bFound, bool bDaughters)
void	SetPassed (bool bFound)
bool	GetQuickDraw () const
void	SetQuickDraw (bool bFound, bool bDaughters)
void	SetQuickDraw (bool bFound)
bool	GetOptionalDraw () const
void	SetOptionalDraw (bool bFound, bool bDaughters)
void	SetOptionalDraw (bool bFound)
bool	GetUserFlag () const
void	SetUserFlag (bool bUserFlag, bool bDaughters)
void	SetUserFlag (bool bUserFlag)
bool	GetAllocated () const
	Gets the allocated flag.
void	EnableBehaviorFilter (eVision::EShapeBehavior behavior, bool value)
	Modifies the so-called behavior filter that is a conjunction of conditions specifying when a shape or a gauge should be displayed or taken into consideration when monitoring the mouse interactions.
void	EnableBehaviorFilter (eVision::EShapeBehavior behavior)
	Modifies the so-called behavior filter that is a conjunction of conditions specifying when a shape or a gauge should be displayed or taken into consideration when monitoring the mouse interactions.
void	DisableBehaviorFilter (eVision::EShapeBehavior behavior)
	Disables (i.e. removes) a condition from the list of conditions in the behavior filter.
void	Attach (eVision::Legacy::EShape *mother)
	Attaches the gauge to a mother gauge or shape.
void	Detach ()
	Detaches the gauge from its mother gauge or shape.
void	DetachDaughters ()
	Detaches the daughter gauges or shapes.
uint32_t	GetNumDaughters () const
	Number of daughters attached to the shape.
eVision::Legacy::EShape *	GetMother () const
	Pointer to the mother shape.
virtual eVision::Legacy::EShape *	GetDaughter (uint32_t index) const
	Returns a pointer to the specified daughter gauge or shape.
eVision::Legacy::EWorldShape *	GetWorldShape () const
	World ancestor.
bool	IsWorld () const
void	InvalidateWorld ()
	Invalidates the world shape for this shape and all its ancestors.
eVision::EPoint	LocalToSensor (const eVision::EPoint &LPoint)
	Transforms a point from local coordinates to sensor coordinates.
eVision::EPoint	SensorToLocal (const eVision::EPoint &SPoint)
	Transforms a point from sensor coordinates to local coordinates.
virtual float	GetZoomX () const
	Current horizontal zooming factor for drawing operations.
virtual float	GetZoomY () const
	Current vertical zooming factor for drawing operations.
virtual float	GetPanX () const
	Current horizontal panning value for drawing operations, expressed in pixels. By default, no panning occurs.
virtual float	GetPanY () const
	Current vertical panning value for drawing operations, expressed in pixels. By default, no panning occurs.
virtual void	SetZoom (float zoomX, float zoomY)
	Sets the horizontal and vertical zooming factors for drawing operations.
virtual void	SetZoom (float zoomX)
	Sets the horizontal and vertical zooming factors for drawing operations.
virtual void	SetZoom ()
	Sets the horizontal and vertical zooming factors for drawing operations.
virtual void	SetPan (float panX, float panY)
	Sets the horizontal and vertical panning values for drawing operations, expressed in pixels.
virtual void	SetPan (float panX)
	Sets the horizontal and vertical panning values for drawing operations, expressed in pixels.
virtual void	SetPan ()
	Sets the horizontal and vertical panning values for drawing operations, expressed in pixels.
eVision::EDragHandle	GetHitHandle () const
	Handle currently under the cursor.
eVision::Legacy::EShape *	GetHitShape () const
	Pointer to the shape currently under the cursor.
void	SetDraggingMode (eVision::EDraggingMode eDraggingMode, bool bDaughters)
	Sets the dragging mode which defines how the shape could be dragged.
void	SetDraggingMode (eVision::EDraggingMode eDraggingMode)
	Sets the dragging mode which defines how the shape could be dragged.
eVision::EDraggingMode	GetDraggingMode () const
	Gets the dragging mode which defines how the shape could be dragged.
void	SetCursor (int32_t x, int32_t y)
	Sets the cursor current coordinates.
eVision::Legacy::EShape *	GetClosestShape () const
	Closest shape among the daughters.
void	Save (const std::string &path, bool daughters)
	Loads a Shape.The given ESerializer must have been created for writing.
void	Save (const std::string &path)
	Loads a Shape.The given ESerializer must have been created for writing.
void	Save (eVision::ESerializer *serializer, bool daughters)
	Loads a Shape.The given ESerializer must have been created for writing.
void	Save (eVision::ESerializer *serializer)
	Loads a Shape.The given ESerializer must have been created for writing.
void	Load (const std::string &path, bool daughters)
	Loads a Shape.The given ESerializer must have been created for reading.
void	Load (const std::string &path)
	Loads a Shape.The given ESerializer must have been created for reading.
void	Load (eVision::ESerializer *serializer, bool daughters)
	Loads a Shape.The given ESerializer must have been created for reading.
void	Load (eVision::ESerializer *serializer)
	Loads a Shape.The given ESerializer must have been created for reading.
bool	HasProperty (const std::string &aProperty) const
	Returns whether a EShape has a property named aProperty.
std::string	GetProperty (const std::string &aProperty) const
	Gets the value of property aProperty. Throws an exception if no such property exists.
void	SetProperty (const std::string &aProperty, const std::string &aValue)
	Sets the value of property aProperty to aValue for this EShape.
void	SetPropertyRecursive (const std::string &aProperty, const std::string &aValue)
	Sets the value of property aProperty to aValue for this EShape and all of its daughters.
void	RemoveProperty (const std::string &aProperty)
	Removes the property name aProperty from the EShape.
bool	HasValidPolarityProperty () const
	Returns whether the EShape has a valid polarity property.
virtual void	EnableTypeFilter (uint32_t un32Types)
	Enables the filter of the specified shape type.
virtual void	DisableTypeFilter ()
	Enables all shape types.
	EShape (CppWrapperInternal::InternalConstructor)

Additional Inherited Members
Public Attributes inherited from eVision::Legacy::EShape
CppWrapperInternal::WrappedClass	wrappedClass_

Detailed Description

Manages a wedge fitting gauge.

License(s): EasyGauge

Constructor & Destructor Documentation

◆ EWedgeGauge() [1/3]

eVision::Legacy::EWedgeGauge::EWedgeGauge ( )

Constructs a wedge measurement context.

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 EWedgeGauge object. The gauge children are also copied. Hierarchy copying through a copy constructor is always recursive. To disable this recursion, use instead the EWedgeGauge::CopyTo method.

◆ EWedgeGauge() [2/3]

eVision::Legacy::EWedgeGauge::EWedgeGauge ( const eVision::Legacy::EWedgeGauge & other )

Constructs a wedge measurement context.

Parameters

other Another EWedgeGauge object to be copied in the new EWedgeGauge object.

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 EWedgeGauge object. The gauge children are also copied. Hierarchy copying through a copy constructor is always recursive. To disable this recursion, use instead the EWedgeGauge::CopyTo method.

◆ ~EWedgeGauge()

eVision::Legacy::EWedgeGauge::~EWedgeGauge	(		)
throw	(	)

virtual

◆ EWedgeGauge() [3/3]

eVision::Legacy::EWedgeGauge::EWedgeGauge ( CppWrapperInternal::InternalConstructor )

Member Function Documentation

◆ AddSkipRange() [1/2]

uint32_t eVision::Legacy::EWedgeGauge::AddSkipRange ( const eVision::EIntegerRange & range )

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

Parameters

range The skip range.

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

This method allows to define skip ranges in an 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 EWedgeGauge::GetNumSamples).

◆ AddSkipRange() [2/2]

uint32_t eVision::Legacy::EWedgeGauge::AddSkipRange	(	const uint32_t	start,
		const uint32_t	end )

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

Parameters

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

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

This method allows to define skip ranges in an 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 EWedgeGauge::GetNumSamples).

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

◆ CopyTo() [1/3]

void eVision::Legacy::EWedgeGauge::CopyTo ( eVision::Legacy::EWedgeGauge & other ) const

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

Parameters

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

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

◆ CopyTo() [2/3]

void eVision::Legacy::EWedgeGauge::CopyTo	(	eVision::Legacy::EWedgeGauge &	other,
		bool	recursive ) const

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

Parameters

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

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

◆ CopyTo() [3/3]

eVision::Legacy::EWedgeGauge * eVision::Legacy::EWedgeGauge::CopyTo	(	eVision::Legacy::EWedgeGauge *	other,
		bool	recursive ) const

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

Parameters

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

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

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

◆ Drag()

void eVision::Legacy::EWedgeGauge::Drag	(	int32_t	x,
		int32_t	y )

virtual

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::EWedgeShape.

◆ Draw() [1/9]

void eVision::Legacy::EWedgeGauge::Draw ( eVision::EDrawAdapter * graphicContext )

virtual

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

Parameters

graphicContext Handle of the device context on which to draw.

Reimplemented from eVision::Legacy::EWedgeShape.

◆ Draw() [2/9]

void eVision::Legacy::EWedgeGauge::Draw	(	eVision::EDrawAdapter *	graphicContext,
		eVision::EDrawingMode	drawingMode )

virtual

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

Parameters

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ Draw() [3/9]

void eVision::Legacy::EWedgeGauge::Draw	(	eVision::EDrawAdapter *	graphicContext,
		eVision::EDrawingMode	drawingMode,
		bool	daughters )

virtual

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

Parameters

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ Draw() [4/9]

void eVision::Legacy::EWedgeGauge::Draw ( HDC graphicContext )

virtual

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

Parameters

graphicContext Handle of the device context on which to draw.

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ Draw() [5/9]

void eVision::Legacy::EWedgeGauge::Draw	(	HDC	graphicContext,
		const eVision::ERGBColor &	color )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ Draw() [6/9]

void eVision::Legacy::EWedgeGauge::Draw	(	HDC	graphicContext,
		const eVision::ERGBColor &	color,
		eVision::EDrawingMode	drawingMode )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ Draw() [7/9]

void eVision::Legacy::EWedgeGauge::Draw	(	HDC	graphicContext,
		const eVision::ERGBColor &	color,
		eVision::EDrawingMode	drawingMode,
		bool	daughters )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ Draw() [8/9]

void eVision::Legacy::EWedgeGauge::Draw	(	HDC	graphicContext,
		eVision::EDrawingMode	drawingMode )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ Draw() [9/9]

void eVision::Legacy::EWedgeGauge::Draw	(	HDC	graphicContext,
		eVision::EDrawingMode	drawingMode,
		bool	daughters )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ DrawWithCurrentPen() [1/3]

void eVision::Legacy::EWedgeGauge::DrawWithCurrentPen ( HDC graphicContext )

virtual

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

Parameters

graphicContext Handle of the device context on which to draw.

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ DrawWithCurrentPen() [2/3]

void eVision::Legacy::EWedgeGauge::DrawWithCurrentPen	(	HDC	graphicContext,
		eVision::EDrawingMode	drawingMode )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ DrawWithCurrentPen() [3/3]

void eVision::Legacy::EWedgeGauge::DrawWithCurrentPen	(	HDC	graphicContext,
		eVision::EDrawingMode	drawingMode,
		bool	daughters )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ GetActive()

bool eVision::Legacy::EWedgeGauge::GetActive ( )

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

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

◆ GetActiveEdges()

uint32_t eVision::Legacy::EWedgeGauge::GetActiveEdges ( ) const

Active edges as defined in EDragHandle.

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.

◆ GetAverageDistance()

float eVision::Legacy::EWedgeGauge::GetAverageDistance ( ) const

Average distance between the sampled points and the fitted model.

Irrelevant in case of a point location operation.

◆ GetFilteringThreshold()

float eVision::Legacy::EWedgeGauge::GetFilteringThreshold ( ) const

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

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

◆ GetHVConstraint()

bool eVision::Legacy::EWedgeGauge::GetHVConstraint ( )

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

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

◆ GetMeasuredPoint() [1/2]

eVision::EPoint eVision::Legacy::EWedgeGauge::GetMeasuredPoint ( )

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

These coordinates pertain to the world space; they are expressed in the reference frame to which the current 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. EWedgeGauge::GetMeasuredPoint returns the coordinates of the sample point that meets the following two requirements:

It lies on the sample path inspected with the last call to EWedgeGauge::MeasureSample, and
Among all the sample points along the latter sample path, it is the one selected by the EWedgeGauge::SetTransitionChoice property.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

◆ GetMeasuredPoint() [2/2]

eVision::EPoint eVision::Legacy::EWedgeGauge::GetMeasuredPoint ( uint32_t index )

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

Parameters

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

These coordinates pertain to the world space; they are expressed in the reference frame to which the current 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. EWedgeGauge::GetMeasuredPoint returns the coordinates of the sample point that meets the following two requirements:

It lies on the sample path inspected with the last call to EWedgeGauge::MeasureSample, and
Among all the sample points along the latter sample path, it is the one selected by the EWedgeGauge::SetTransitionChoice property.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

◆ GetMeasuredWedge()

eVision::Legacy::EWedge eVision::Legacy::EWedgeGauge::GetMeasuredWedge ( )

Information pertaining to the fitted wedge.

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

◆ GetMinAmplitude()

uint32_t eVision::Legacy::EWedgeGauge::GetMinAmplitude ( )

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

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

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

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

◆ GetMinArea()

uint32_t eVision::Legacy::EWedgeGauge::GetMinArea ( )

Minimum area value.

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

◆ GetMinNumFitSamples() [1/2]

std::vector< int32_t > eVision::Legacy::EWedgeGauge::GetMinNumFitSamples ( ) const

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

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

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

When the 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.

◆ GetMinNumFitSamples() [2/2]

void eVision::Legacy::EWedgeGauge::GetMinNumFitSamples	(	int32_t &	side0,
		int32_t &	side1,
		int32_t &	side2,
		int32_t &	side3 )

Returns the minimum number of samples required for fitting on each side of the shape.

Parameters

side0	Minimum number of samples on the top side of the rectangle.
side1	Minimum number of samples on the left side of the rectangle.
side2	Minimum number of samples on the bottom side of the rectangle.
side3	Minimum number of samples on the right side of the rectangle.

Irrelevant in case of a point location operation.

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

◆ GetNumFilteringPasses()

uint32_t eVision::Legacy::EWedgeGauge::GetNumFilteringPasses ( ) const

Number of filtering passes for a model fitting operation.

Irrelevant in case of a point location operation. During a filtering pass, the points that are too distant from the model are discarded. During a model fitting operation, the "filtering" process can be invoked to remove outliers, i.e. points that were located significantly far away from the fitted model (so that their position is dubious). By default (the number of filtering passes is 0), the outliers rejection process is disabled.

◆ GetNumSamples()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSamples ( ) const

Number of sampled points during the model fitting operation.

Irrelevant in case of a point location operation.

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

◆ GetNumSamplesA()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSamplesA ( ) const

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

Deprecated

Use EWedgeGauge::GetNumSamplesRightEdge instead.

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

◆ GetNumSamplesa()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSamplesa ( ) const

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

Deprecated

Use EWedgeGauge::GetNumSamplesLeftEdge instead.

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

◆ GetNumSamplesInnerEdge()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSamplesInnerEdge ( ) const

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

◆ GetNumSamplesLeftEdge()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSamplesLeftEdge ( ) const

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

◆ GetNumSamplesOuterEdge()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSamplesOuterEdge ( ) const

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

◆ GetNumSamplesR()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSamplesR ( ) const

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

Deprecated

Use EWedgeGauge::GetNumSamplesInnerEdge instead.

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

◆ GetNumSamplesr()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSamplesr ( ) const

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

Deprecated

Use EWedgeGauge::GetNumSamplesOuterEdge instead.

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

◆ GetNumSamplesRightEdge()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSamplesRightEdge ( ) const

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

◆ GetNumSkipRanges()

uint32_t eVision::Legacy::EWedgeGauge::GetNumSkipRanges ( ) const

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

◆ GetNumValidSamples()

uint32_t eVision::Legacy::EWedgeGauge::GetNumValidSamples ( ) const

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

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

◆ GetRectangularSamplingArea()

bool eVision::Legacy::EWedgeGauge::GetRectangularSamplingArea ( )

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

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.

◆ GetSample() [1/2]

bool eVision::Legacy::EWedgeGauge::GetSample	(	eVision::EPoint &	pt,
		uint32_t	index )

◆ GetSample() [2/2]

void eVision::Legacy::EWedgeGauge::GetSample	(	eVision::Legacy::ESamplePoint &	sp,
		uint32_t	index )

◆ GetSampleA() [1/3]

bool eVision::Legacy::EWedgeGauge::GetSampleA	(	eVision::EPeak &	pk,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleRightEdge instead.

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

◆ GetSampleA() [2/3]

bool eVision::Legacy::EWedgeGauge::GetSampleA	(	eVision::EPoint &	pt,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleRightEdge instead.

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

◆ GetSampleA() [3/3]

void eVision::Legacy::EWedgeGauge::GetSampleA	(	eVision::Legacy::ESamplePoint &	sp,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleRightEdge instead.

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

◆ GetSamplea() [1/3]

bool eVision::Legacy::EWedgeGauge::GetSamplea	(	eVision::EPeak &	pk,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleLeftEdge instead.

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

◆ GetSamplea() [2/3]

bool eVision::Legacy::EWedgeGauge::GetSamplea	(	eVision::EPoint &	pt,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleLeftEdge instead.

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

◆ GetSamplea() [3/3]

void eVision::Legacy::EWedgeGauge::GetSamplea	(	eVision::Legacy::ESamplePoint &	sp,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleLeftEdge instead.

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

◆ GetSampleInnerEdge() [1/3]

bool eVision::Legacy::EWedgeGauge::GetSampleInnerEdge	(	eVision::EPeak &	pk,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleInnerEdge() [2/3]

bool eVision::Legacy::EWedgeGauge::GetSampleInnerEdge	(	eVision::EPoint &	pt,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleInnerEdge() [3/3]

void eVision::Legacy::EWedgeGauge::GetSampleInnerEdge	(	eVision::Legacy::ESamplePoint &	sp,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleLeftEdge() [1/3]

bool eVision::Legacy::EWedgeGauge::GetSampleLeftEdge	(	eVision::EPeak &	pk,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleLeftEdge() [2/3]

bool eVision::Legacy::EWedgeGauge::GetSampleLeftEdge	(	eVision::EPoint &	pt,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleLeftEdge() [3/3]

void eVision::Legacy::EWedgeGauge::GetSampleLeftEdge	(	eVision::Legacy::ESamplePoint &	sp,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleOuterEdge() [1/3]

bool eVision::Legacy::EWedgeGauge::GetSampleOuterEdge	(	eVision::EPeak &	pk,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleOuterEdge() [2/3]

bool eVision::Legacy::EWedgeGauge::GetSampleOuterEdge	(	eVision::EPoint &	pt,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleOuterEdge() [3/3]

void eVision::Legacy::EWedgeGauge::GetSampleOuterEdge	(	eVision::Legacy::ESamplePoint &	sp,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleR() [1/3]

bool eVision::Legacy::EWedgeGauge::GetSampleR	(	eVision::EPeak &	pk,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleInnerEdge instead.

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

◆ GetSampleR() [2/3]

bool eVision::Legacy::EWedgeGauge::GetSampleR	(	eVision::EPoint &	pt,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleInnerEdge instead.

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

◆ GetSampleR() [3/3]

void eVision::Legacy::EWedgeGauge::GetSampleR	(	eVision::Legacy::ESamplePoint &	sp,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleInnerEdge instead.

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

◆ GetSampler() [1/3]

bool eVision::Legacy::EWedgeGauge::GetSampler	(	eVision::EPeak &	pk,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleOuterEdge instead.

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

◆ GetSampler() [2/3]

bool eVision::Legacy::EWedgeGauge::GetSampler	(	eVision::EPoint &	pt,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleOuterEdge instead.

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

◆ GetSampler() [3/3]

void eVision::Legacy::EWedgeGauge::GetSampler	(	eVision::Legacy::ESamplePoint &	sp,
		uint32_t	index )

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

Parameters

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

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 EWedgeGauge::GetSampleOuterEdge instead.

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

◆ GetSampleRightEdge() [1/3]

bool eVision::Legacy::EWedgeGauge::GetSampleRightEdge	(	eVision::EPeak &	pk,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleRightEdge() [2/3]

bool eVision::Legacy::EWedgeGauge::GetSampleRightEdge	(	eVision::EPoint &	pt,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSampleRightEdge() [3/3]

void eVision::Legacy::EWedgeGauge::GetSampleRightEdge	(	eVision::Legacy::ESamplePoint &	sp,
		uint32_t	index )

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

Parameters

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

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

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

◆ GetSamplingStep()

float eVision::Legacy::EWedgeGauge::GetSamplingStep ( ) const

Approximate distance between sampled points during a model fitting operation.

Irrelevant in case of a point location operation.

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

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

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

◆ GetShape()

eVision::Legacy::EWedge eVision::Legacy::EWedgeGauge::GetShape ( )

◆ GetSkipRange() [1/2]

void eVision::Legacy::EWedgeGauge::GetSkipRange	(	const uint32_t	index,
		uint32_t &	start,
		uint32_t &	end ) const

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 EWedgeGauge::AddSkipRange method.

Parameters

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

Start is guaranteed to be smaller or equal to end.

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

◆ GetSkipRange() [2/2]

eVision::EIntegerRange eVision::Legacy::EWedgeGauge::GetSkipRange ( uint32_t index ) const

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 EWedgeGauge::AddSkipRange method.

Parameters

index Index of the skip range.

Start is guaranteed to be smaller or equal to end.

◆ GetSmoothing()

uint32_t eVision::Legacy::EWedgeGauge::GetSmoothing ( )

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

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

◆ GetThickness()

uint32_t eVision::Legacy::EWedgeGauge::GetThickness ( )

Number of parallel segments used to extract the data profile.

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

◆ GetThreshold()

uint32_t eVision::Legacy::EWedgeGauge::GetThreshold ( )

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

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

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

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

◆ GetTolerance()

float eVision::Legacy::EWedgeGauge::GetTolerance ( )

Searching area half thickness of the wedge fitting gauge.

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.

◆ GetTransitionChoice()

eVision::ETransitionChoice eVision::Legacy::EWedgeGauge::GetTransitionChoice ( )

Transition choice.

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

In case of ETransitionChoice::ETransitionChoice_NthFromBegin or ETransitionChoice::ETransitionChoice_NthFromEnd transition choice, set EWedgeGauge::SetTransitionIndex to specify the desired transition.

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

◆ GetTransitionIndex()

uint32_t eVision::Legacy::EWedgeGauge::GetTransitionIndex ( )

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

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

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

◆ GetTransitionType()

eVision::ETransitionType eVision::Legacy::EWedgeGauge::GetTransitionType ( )

Transition type.

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

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

◆ GetType()

eVision::EShapeType eVision::Legacy::EWedgeGauge::GetType ( ) const

virtual

Shape type.

Reimplemented from eVision::Legacy::EWedgeShape.

◆ GetValid()

bool eVision::Legacy::EWedgeGauge::GetValid ( )

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

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

◆ HitTest() [1/2]

bool eVision::Legacy::EWedgeGauge::HitTest ( )

virtual

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 ( bool daughters )

virtual

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::EWedgeShape.

◆ Measure() [1/2]

void eVision::Legacy::EWedgeGauge::Measure ( eVision::EROIBW8 * sourceImage )

Triggers the point location or the model fitting operation.

Parameters

sourceImage Pointer to the source image.

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

◆ Measure() [2/2]

void eVision::Legacy::EWedgeGauge::Measure	(	eVision::EROIBW8 *	sourceImage,
		const eVision::ERegion &	region )

Triggers the point location or the model fitting operation.

Parameters

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

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

◆ MeasureSample() [1/2]

void eVision::Legacy::EWedgeGauge::MeasureSample	(	eVision::EROIBW8 *	sourceImage,
		const eVision::ERegion &	region,
		uint32_t	pathIndex )

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

Parameters

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

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

◆ MeasureSample() [2/2]

void eVision::Legacy::EWedgeGauge::MeasureSample	(	eVision::EROIBW8 *	sourceImage,
		uint32_t	pathIndex )

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

Parameters

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

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

◆ MeasureWithoutFitting() [1/2]

void eVision::Legacy::EWedgeGauge::MeasureWithoutFitting ( eVision::EROIBW8 * sourceImage )

Triggers the point location without wedge fitting operation.

Parameters

sourceImage Source image.

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 EWedgeGauge::GetSamplea (Edge a), EWedgeGauge::GetSampler (Edge r), EWedgeGauge::GetSampleA (Edge A), 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.

◆ MeasureWithoutFitting() [2/2]

void eVision::Legacy::EWedgeGauge::MeasureWithoutFitting	(	eVision::EROIBW8 *	sourceImage,
		const eVision::ERegion &	region )

Triggers the point location without wedge fitting operation.

Parameters

sourceImage	Source image.
region	Region to delimit the source image.

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 EWedgeGauge::GetSamplea (Edge a), EWedgeGauge::GetSampler (Edge r), EWedgeGauge::GetSampleA (Edge A), 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.

◆ operator=()

eVision::Legacy::EWedgeGauge & eVision::Legacy::EWedgeGauge::operator= ( const eVision::Legacy::EWedgeGauge & other )

Copies all the data from another EWedgeGauge object into the current EWedgeGauge object.

Parameters

other EWedgeGauge object to be copied

◆ Plot() [1/9]

void eVision::Legacy::EWedgeGauge::Plot	(	eVision::EDrawAdapter *	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 EPlotItem.

Parameters

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

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

◆ Plot() [2/9]

void eVision::Legacy::EWedgeGauge::Plot	(	eVision::EDrawAdapter *	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 EPlotItem.

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of 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.

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

◆ Plot() [3/9]

void eVision::Legacy::EWedgeGauge::Plot	(	eVision::EDrawAdapter *	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 EPlotItem.

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of 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.

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

◆ Plot() [4/9]

void eVision::Legacy::EWedgeGauge::Plot	(	HDC	graphicContext,
		const eVision::ERGBColor &	color,
		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 EPlotItem.

Parameters

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

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

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

◆ Plot() [5/9]

void eVision::Legacy::EWedgeGauge::Plot	(	HDC	graphicContext,
		const eVision::ERGBColor &	color,
		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 EPlotItem.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
drawItems	Boolean combination of 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.

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

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

◆ Plot() [6/9]

void eVision::Legacy::EWedgeGauge::Plot	(	HDC	graphicContext,
		const eVision::ERGBColor &	color,
		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 EPlotItem.

Parameters

graphicContext	Handle of the device context on which to draw.
color	The color in which to draw the overlay.
drawItems	Boolean combination of 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.

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

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

◆ Plot() [7/9]

void eVision::Legacy::EWedgeGauge::Plot	(	HDC	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 EPlotItem.

Parameters

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

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

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

◆ Plot() [8/9]

void eVision::Legacy::EWedgeGauge::Plot	(	HDC	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 EPlotItem.

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of 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.

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

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

◆ Plot() [9/9]

void eVision::Legacy::EWedgeGauge::Plot	(	HDC	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 EPlotItem.

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of 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.

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

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

◆ PlotWithCurrentPen() [1/3]

void eVision::Legacy::EWedgeGauge::PlotWithCurrentPen	(	HDC	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 EPlotItem.

Parameters

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

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

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

◆ PlotWithCurrentPen() [2/3]

void eVision::Legacy::EWedgeGauge::PlotWithCurrentPen	(	HDC	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 EPlotItem.

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of 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.

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

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

◆ PlotWithCurrentPen() [3/3]

void eVision::Legacy::EWedgeGauge::PlotWithCurrentPen	(	HDC	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 EPlotItem.

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of 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.

The sample path that is taken into considered is the one inspected with the last call to EWedgeGauge::MeasureSample.

Note: For this method to succeed, it is necessary to previously call EWedgeGauge::MeasureSample.

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

◆ Process() [1/4]

void eVision::Legacy::EWedgeGauge::Process ( eVision::EROIBW8 * sourceImage )

virtual

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

Parameters

sourceImage Pointer to the source image.

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

Reimplemented from eVision::Legacy::EShape.

◆ Process() [2/4]

void eVision::Legacy::EWedgeGauge::Process	(	eVision::EROIBW8 *	sourceImage,
		bool	daughters )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EShape.

◆ Process() [3/4]

void eVision::Legacy::EWedgeGauge::Process	(	eVision::EROIBW8 *	sourceImage,
		const eVision::ERegion &	region )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EShape.

◆ Process() [4/4]

void eVision::Legacy::EWedgeGauge::Process	(	eVision::EROIBW8 *	sourceImage,
		const eVision::ERegion &	region,
		bool	daughters )

virtual

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

Parameters

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

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

Reimplemented from eVision::Legacy::EShape.

◆ RemoveAllSkipRanges()

void eVision::Legacy::EWedgeGauge::RemoveAllSkipRanges ( )

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

◆ RemoveSkipRange()

void eVision::Legacy::EWedgeGauge::RemoveSkipRange ( const uint32_t index )

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

Parameters

index Index of the skip range to remove, as returned by EWedgeGauge::AddSkipRange.

◆ SetActive()

void eVision::Legacy::EWedgeGauge::SetActive ( bool active )

virtual

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

Parameters

active Flag indicating whether the gauge is active (true) or not (false).

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

◆ SetActiveEdges()

void eVision::Legacy::EWedgeGauge::SetActiveEdges ( uint32_t un32ActiveEdges )

Active edges as defined in EDragHandle.

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.

◆ SetDiameters()

void eVision::Legacy::EWedgeGauge::SetDiameters	(	float	diameter,
		float	breadth )

virtual

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

Parameters

diameter	Outer diameter of the EWedgeGauge. The default value is 100.
breadth	Breadth of the EWedgeGauge. It must be negative or zero. Its default value is -50.

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ SetFilteringThreshold()

void eVision::Legacy::EWedgeGauge::SetFilteringThreshold ( float f32FilteringThreshold )

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

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

◆ SetFromOriginMiddleEnd() [1/3]

void eVision::Legacy::EWedgeGauge::SetFromOriginMiddleEnd	(	const eVision::EPoint &	origin,
		const eVision::EPoint &	middle,
		const eVision::EPoint &	end )

virtual

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

Parameters

origin	Origin point coordinates of the wedge.
middle	Middle point coordinates of the wedge.
end	End point coordinates of the wedge.

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.

Reimplemented from eVision::Legacy::EWedgeShape.

◆ SetFromOriginMiddleEnd() [2/3]

void eVision::Legacy::EWedgeGauge::SetFromOriginMiddleEnd	(	const eVision::EPoint &	origin,
		const eVision::EPoint &	middle,
		const eVision::EPoint &	end,
		float	breadth )

virtual

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

Parameters

origin	Origin point coordinates of the wedge.
middle	Middle point coordinates of the wedge.
end	End point coordinates of the wedge.
breadth	Nominal breadth of the wedge. It must be negative or zero. The default value is -50.

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.

Reimplemented from eVision::Legacy::EWedgeShape.

◆ SetFromOriginMiddleEnd() [3/3]

void eVision::Legacy::EWedgeGauge::SetFromOriginMiddleEnd	(	const eVision::EPoint &	origin,
		const eVision::EPoint &	middle,
		const eVision::EPoint &	end,
		float	breadth,
		bool	fullCircle )

virtual

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

Parameters

origin	Origin point coordinates of the wedge.
middle	Middle point coordinates of the wedge.
end	End point coordinates of the wedge.
breadth	Nominal breadth of the wedge. It must be negative or zero. The default value is -50.
fullCircle	true (default) in case of a full turn wedge. If fullCircle is false, origin and end give the wedge's amplitude.

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.

Reimplemented from eVision::Legacy::EWedgeShape.

◆ SetFromTwoPoints() [1/3]

void eVision::Legacy::EWedgeGauge::SetFromTwoPoints	(	const eVision::EPoint &	center,
		const eVision::EPoint &	origin )

virtual

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

Parameters

center	Center coordinates of the wedge at its nominal position. The default value is (0,0).
origin	Origin point coordinates of the wedge.

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.

Reimplemented from eVision::Legacy::EWedgeShape.

◆ SetFromTwoPoints() [2/3]

void eVision::Legacy::EWedgeGauge::SetFromTwoPoints	(	const eVision::EPoint &	center,
		const eVision::EPoint &	origin,
		float	breadth )

virtual

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

Parameters

center	Center coordinates of the wedge at its nominal position. The default value is (0,0).
origin	Origin point coordinates of the wedge.
breadth	Nominal breadth of the wedge. It must be negative or zero. The default value is -50.

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.

Reimplemented from eVision::Legacy::EWedgeShape.

◆ SetFromTwoPoints() [3/3]

void eVision::Legacy::EWedgeGauge::SetFromTwoPoints	(	const eVision::EPoint &	center,
		const eVision::EPoint &	origin,
		float	breadth,
		bool	direct )

virtual

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

Parameters

center	Center coordinates of the wedge at its nominal position. The default value is (0,0).
origin	Origin point coordinates of the wedge.
breadth	Nominal breadth of the wedge. It must be negative or zero. The default value is -50.
direct	true (default) means that angles increase anticlockwise in a direct coordinate system and clockwise in an inverse coordinate system.

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.

Reimplemented from eVision::Legacy::EWedgeShape.

◆ SetHVConstraint()

void eVision::Legacy::EWedgeGauge::SetHVConstraint ( bool bHVConstraint )

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

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

◆ SetMinAmplitude()

void eVision::Legacy::EWedgeGauge::SetMinAmplitude ( uint32_t un32MinAmplitude )

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

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

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

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

◆ SetMinArea()

void eVision::Legacy::EWedgeGauge::SetMinArea ( uint32_t un32MinArea )

Minimum area value.

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

◆ SetMinNumFitSamples() [1/5]

void eVision::Legacy::EWedgeGauge::SetMinNumFitSamples ( const std::vector< int32_t > & sides )

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

Parameters

sides The list of the minimum number of samples to fit the wedge.

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

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

When the 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.

◆ SetMinNumFitSamples() [2/5]

void eVision::Legacy::EWedgeGauge::SetMinNumFitSamples ( int32_t side0 )

Sets the minimum number of samples required for fitting on each side of the shape.

Parameters

side0 Minimum number of samples on the outer circle of the wedge. The default value is 3.

Irrelevant in case of a point location operation. When the 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.

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

◆ SetMinNumFitSamples() [3/5]

void eVision::Legacy::EWedgeGauge::SetMinNumFitSamples	(	int32_t	side0,
		int32_t	side1 )

Sets the minimum number of samples required for fitting on each side of the shape.

Parameters

side0	Minimum number of samples on the outer circle of the wedge. The default value is 3.
side1	Minimum number of samples on the original border of the wedge. If this value is not specified, it is equal to n32Side0. The default value is 2.

Irrelevant in case of a point location operation. When the 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.

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

◆ SetMinNumFitSamples() [4/5]

void eVision::Legacy::EWedgeGauge::SetMinNumFitSamples	(	int32_t	side0,
		int32_t	side1,
		int32_t	side2 )

Sets the minimum number of samples required for fitting on each side of the shape.

Parameters

side0	Minimum number of samples on the outer circle of the wedge. The default value is 3.
side1	Minimum number of samples on the original border of the wedge. If this value is not specified, it is equal to n32Side0. The default value is 2.
side2	Minimum number of samples on the inner circle of the wedge. If this value is not specified, it is equal to n32Side0. The default value is 3.

Irrelevant in case of a point location operation. When the 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.

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

◆ SetMinNumFitSamples() [5/5]

void eVision::Legacy::EWedgeGauge::SetMinNumFitSamples	(	int32_t	side0,
		int32_t	side1,
		int32_t	side2,
		int32_t	side3 )

Sets the minimum number of samples required for fitting on each side of the shape.

Parameters

side0	Minimum number of samples on the outer circle of the wedge. The default value is 3.
side1	Minimum number of samples on the original border of the wedge. If this value is not specified, it is equal to n32Side0. The default value is 2.
side2	Minimum number of samples on the inner circle of the wedge. If this value is not specified, it is equal to n32Side0. The default value is 3.
side3	Minimum number of samples on the end border of the wedge. If this value is not specified, it is equal to n32Side1. The default value is 2.

Irrelevant in case of a point location operation. When the 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.

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

◆ SetNumFilteringPasses()

void eVision::Legacy::EWedgeGauge::SetNumFilteringPasses ( uint32_t un32NumFilteringPasses )

Number of filtering passes for a model fitting operation.

Irrelevant in case of a point location operation. During a filtering pass, the points that are too distant from the model are discarded. During a model fitting operation, the "filtering" process can be invoked to remove outliers, i.e. points that were located significantly far away from the fitted model (so that their position is dubious). By default (the number of filtering passes is 0), the outliers rejection process is disabled.

◆ SetRadii()

void eVision::Legacy::EWedgeGauge::SetRadii	(	float	radius,
		float	breadth )

virtual

Sets the nominal radius and breadth of the EWedgeGauge.

Parameters

radius	Outer radius of the EWedgeGauge. The default value is 50.
breadth	Breadth of the EWedgeGauge, which must be negative or zero. Its default value is -50.

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

Reimplemented from eVision::Legacy::EWedgeShape.

◆ SetRectangularSamplingArea()

void eVision::Legacy::EWedgeGauge::SetRectangularSamplingArea ( bool bRectangularSamplingArea )

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

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.

◆ SetSamplingStep()

void eVision::Legacy::EWedgeGauge::SetSamplingStep ( float f32SamplingStep )

Approximate distance between sampled points during a model fitting operation.

Irrelevant in case of a point location operation.

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

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

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

◆ SetSmoothing()

void eVision::Legacy::EWedgeGauge::SetSmoothing ( uint32_t un32Smoothing )

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

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

◆ SetThickness()

void eVision::Legacy::EWedgeGauge::SetThickness ( uint32_t un32Thickness )

Number of parallel segments used to extract the data profile.

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

◆ SetThreshold()

void eVision::Legacy::EWedgeGauge::SetThreshold ( uint32_t un32Threshold )

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

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

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

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

◆ SetTolerance()

void eVision::Legacy::EWedgeGauge::SetTolerance ( float f32Tolerance )

Searching area half thickness of the wedge fitting gauge.

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.

◆ SetTransitionChoice()

void eVision::Legacy::EWedgeGauge::SetTransitionChoice ( eVision::ETransitionChoice transitionChoice )

Transition choice.

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

In case of ETransitionChoice::ETransitionChoice_NthFromBegin or ETransitionChoice::ETransitionChoice_NthFromEnd transition choice, set EWedgeGauge::SetTransitionIndex to specify the desired transition.

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

◆ SetTransitionIndex()

void eVision::Legacy::EWedgeGauge::SetTransitionIndex ( uint32_t un32TransitionIndex )

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

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

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

◆ SetTransitionType()

void eVision::Legacy::EWedgeGauge::SetTransitionType ( eVision::ETransitionType transitionType )

Transition type.

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

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

◆ SetWedge()

void eVision::Legacy::EWedgeGauge::SetWedge ( const eVision::Legacy::EWedge & wedge )

virtual

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

Parameters

wedge Wedge of known position (center coordinates), diameter, breadth, angular origin and amplitude. By default, a wedge positioned at (0,0), with diameter of 1 and breadth of 1 is assumed.

Reimplemented from eVision::Legacy::EWedgeShape.

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ EWedgeGauge() [1/3]

◆ EWedgeGauge() [2/3]

◆ ~EWedgeGauge()

◆ EWedgeGauge() [3/3]

Member Function Documentation

◆ AddSkipRange() [1/2]

◆ AddSkipRange() [2/2]

◆ CopyTo() [1/3]

◆ CopyTo() [2/3]

◆ CopyTo() [3/3]

◆ Drag()

◆ Draw() [1/9]

◆ Draw() [2/9]

◆ Draw() [3/9]

◆ Draw() [4/9]

◆ Draw() [5/9]

◆ Draw() [6/9]

◆ Draw() [7/9]

◆ Draw() [8/9]

◆ Draw() [9/9]

◆ DrawWithCurrentPen() [1/3]

◆ DrawWithCurrentPen() [2/3]

◆ DrawWithCurrentPen() [3/3]

◆ GetActive()

◆ GetActiveEdges()

◆ GetAverageDistance()

◆ GetFilteringThreshold()

◆ GetHVConstraint()

◆ GetMeasuredPoint() [1/2]

◆ GetMeasuredPoint() [2/2]

◆ GetMeasuredWedge()

◆ GetMinAmplitude()

◆ GetMinArea()

◆ GetMinNumFitSamples() [1/2]

◆ GetMinNumFitSamples() [2/2]

◆ GetNumFilteringPasses()

◆ GetNumSamples()

◆ GetNumSamplesA()

◆ GetNumSamplesa()

◆ GetNumSamplesInnerEdge()

◆ GetNumSamplesLeftEdge()

◆ GetNumSamplesOuterEdge()

◆ GetNumSamplesR()

◆ GetNumSamplesr()

◆ GetNumSamplesRightEdge()

◆ GetNumSkipRanges()

◆ GetNumValidSamples()

◆ GetRectangularSamplingArea()

◆ GetSample() [1/2]

◆ GetSample() [2/2]

◆ GetSampleA() [1/3]

◆ GetSampleA() [2/3]

◆ GetSampleA() [3/3]

◆ GetSamplea() [1/3]

◆ GetSamplea() [2/3]

◆ GetSamplea() [3/3]

◆ GetSampleInnerEdge() [1/3]

◆ GetSampleInnerEdge() [2/3]

◆ GetSampleInnerEdge() [3/3]

◆ GetSampleLeftEdge() [1/3]

◆ GetSampleLeftEdge() [2/3]

◆ GetSampleLeftEdge() [3/3]

◆ GetSampleOuterEdge() [1/3]

◆ GetSampleOuterEdge() [2/3]

◆ GetSampleOuterEdge() [3/3]

◆ GetSampleR() [1/3]

◆ GetSampleR() [2/3]

◆ GetSampleR() [3/3]

◆ GetSampler() [1/3]

◆ GetSampler() [2/3]

◆ GetSampler() [3/3]

◆ GetSampleRightEdge() [1/3]

◆ GetSampleRightEdge() [2/3]

◆ GetSampleRightEdge() [3/3]

◆ GetSamplingStep()

◆ GetShape()