eVision.EPointGauge Class Reference

Point gauge. More...

Inheritance diagram for eVision.EPointGauge:

Collaboration diagram for eVision.EPointGauge:

Public Member Functions
	EPointGauge ()
	Constructs a EPointGauge.
	EPointGauge (eVision.EPointGauge other)
	Copy constructor.
void	CopyTo (eVision.EPointGauge other)
	Copy the object to the other object.
void	Plot (eVision.EDrawAdapter graphicContext, eVision.EPlotItem drawItems, float width, float height, float originX, float originY)
	Draws the profile of the sample path of the point gauge, as defined by EPlotItem.
void	Plot (eVision.EDrawAdapter graphicContext, eVision.EPlotItem drawItems, float width, float height, float originX)
	Draws the profile of the sample path of the point gauge, as defined by EPlotItem.
void	Plot (eVision.EDrawAdapter graphicContext, eVision.EPlotItem drawItems, float width, float height)
	Draws the profile of the sample path of the point gauge, as defined by EPlotItem.
void	Plot (eVision.EDrawAdapter graphicContext, eVision.EPlotItem drawItems, eVision.EPlotDecorationOptions opts, float width, float height, float originX, float originY)
	Draws the profile of the sample path of the point gauge, as defined by EPlotItem.
void	Plot (eVision.EDrawAdapter graphicContext, eVision.EPlotItem drawItems, eVision.EPlotDecorationOptions opts, float width, float height, float originX)
	Draws the profile of the sample path of the point gauge, as defined by EPlotItem.
void	Plot (eVision.EDrawAdapter graphicContext, eVision.EPlotItem drawItems, eVision.EPlotDecorationOptions opts, float width, float height)
	Draws the profile of the sample path of the point gauge, as defined by EPlotItem.
new eVision.EPointSet	Measure (eVision.EROIBW8 sourceImage, eVision.EFrame frame)
	Performs the gauge measurement.
new eVision.EPointSet	Measure (eVision.EROIBW8 sourceImage)
	Performs the gauge measurement.
new eVision.EPointSet	Measure (eVision.EROIBW8 sourceImage, eVision.ERegion region, eVision.EFrame frame)
	Performs the gauge measurement.
new eVision.EPointSet	Measure (eVision.EROIBW8 sourceImage, eVision.ERegion region)
	Performs the gauge measurement.
eVision.EPoint	GetMeasuredPoint (uint index)
	Coordinates of a sample point measured along the path of the point gauge.
eVision.EPoint	GetMeasuredPoint ()
	Coordinates of a sample point measured along the path of the point gauge.
eVision.EPeak	GetMeasuredPeak (uint index)
	Returns information pertaining to the default derivative peak along the path of the point gauge.
eVision.EPeak	GetMeasuredPeak ()
	Returns information pertaining to the default derivative peak along the path of the point gauge.
Public Member Functions inherited from eVision.EBaseGauge
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, float zoomX, float zoomY)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, float zoomX)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame, float zoomX, float zoomY)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame, float zoomX)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame)
	Draws a graphical representation of a shape, as defined by EDrawingMode.
eVision.EEditionMode	HitTest (int x, int y, float zoomX, float zoomY, float panX, float panY)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (int x, int y, float zoomX, float zoomY, float panX)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (int x, int y, float zoomX, float zoomY)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (int x, int y, float zoomX)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (int x, int y)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (int x, int y, eVision.EFrame frame, float zoomX, float zoomY)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (int x, int y, eVision.EFrame frame, float zoomX)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (int x, int y, eVision.EFrame frame)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
void	Drag (int x, int y, float zoomX, float zoomY, float panX, float panY)
	Moves a handle to a new position and updates the position parameters of the shape.
void	Drag (int x, int y, float zoomX, float zoomY, float panX)
	Moves a handle to a new position and updates the position parameters of the shape.
void	Drag (int x, int y, float zoomX, float zoomY)
	Moves a handle to a new position and updates the position parameters of the shape.
void	Drag (int x, int y, float zoomX)
	Moves a handle to a new position and updates the position parameters of the shape.
void	Drag (int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Moves a handle to a new position and updates the position parameters of the shape.
void	Drag (int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Moves a handle to a new position and updates the position parameters of the shape.
void	Drag (int x, int y, eVision.EFrame frame, float zoomX, float zoomY)
	Moves a handle to a new position and updates the position parameters of the shape.
void	Drag (int x, int y, eVision.EFrame frame, float zoomX)
	Moves a handle to a new position and updates the position parameters of the shape.
void	Save (string path)
	Saves a gauge.The given ESerializer must have been created for writing.
void	Save (eVision.ESerializer serializer)
	Saves a gauge.The given ESerializer must have been created for writing.
void	Load (string path)
	Loads a gauge.The given ESerializer must have been created for reading.
void	Load (eVision.ESerializer serializer)
	Loads a gauge.The given ESerializer must have been created for reading.
bool	HasProperty (string aProperty)
	Returns whether a EBaseGauge has a property named aProperty.
string	GetProperty (string aProperty)
	Gets the value of property aProperty. Throws an exception if no such property exists.
void	SetProperty (string aProperty, string aValue)
	Sets the value of property aProperty to aValue for this EBaseGauge.
void	RemoveProperty (string aProperty)
	Removes the property name aProperty from the EBaseGauge.
bool	HasValidPolarityProperty ()
	Returns whether the EBaseGauge has a valid polarity property.
eVision.ESamplePoint	GetSample (uint index)
	Retrieves sampled points used during the model fitting operation.
bool	HasSamples ()
	Whether the samples are available or not.
uint	AddSkipRange (eVision.EIntegerRange range)
	Adds an item to the set of skip ranges and returns the index of the newly added range.
eVision.EIntegerRange	GetSkipRange (uint index)
	Allows to retrieve the start and end values of the skip range corresponding to the given index, if it is valid (i.e. if it has previously been created by a call to the EBaseGauge.AddSkipRange method).
void	RemoveSkipRange (uint index)
	After a call to EBaseGauge.AddSkipRange, removes the skip range with the given index.
void	RemoveAllSkipRanges ()
	Removes all the skip ranges previously created by a call to EBaseGauge.AddSkipRange.
eVision.EShape	Measure (eVision.EROIBW8 sourceImage, eVision.EFrame frame)
	Performs the gauge measurement.
eVision.EShape	Measure (eVision.EROIBW8 sourceImage)
	Performs the gauge measurement.
eVision.EShape	Measure (eVision.EROIBW8 sourceImage, eVision.ERegion region, eVision.EFrame frame)
	Performs the gauge measurement.
eVision.EShape	Measure (eVision.EROIBW8 sourceImage, eVision.ERegion region)
	Performs the gauge measurement.
void	MeasureWithoutFitting (eVision.EROIBW8 sourceImage, eVision.EFrame frame)
	Triggers the point location without line fitting operation.
void	MeasureWithoutFitting (eVision.EROIBW8 sourceImage)
	Triggers the point location without line fitting operation.
void	MeasureWithoutFitting (eVision.EROIBW8 sourceImage, eVision.ERegion region, eVision.EFrame frame)
	Triggers the point location without line fitting operation.
void	MeasureWithoutFitting (eVision.EROIBW8 sourceImage, eVision.ERegion region)
	Triggers the point location without line fitting operation.
bool	IsFound ()
	Flag indicating whether a measured shape has been found.
virtual eVision.ESamplePath	MeasureSamplePath (eVision.EROIBW8 sourceImage, uint pathIndex, eVision.EFrame frame)
	Measures the specified sample path.
virtual eVision.ESamplePath	MeasureSamplePath (eVision.EROIBW8 sourceImage, uint pathIndex)
	Measures the specified sample path.
virtual eVision.ESamplePath	MeasureSamplePath (eVision.EROIBW8 sourceImage, uint pathIndex, eVision.ERegion region, eVision.EFrame frame)
	Measures the specified sample path.
virtual eVision.ESamplePath	MeasureSamplePath (eVision.EROIBW8 sourceImage, uint pathIndex, eVision.ERegion region)
	Measures the specified sample path.

Properties
override float	Tolerance [get, set]
	Half thickness of the model fitting gauge.
eVision.EPoint	Center [get, set]
	Center of the EPointGauge.NominalLine.
float	NominalLineLength [get, set]
	Length of the EPointGauge.NominalLine.
float	NominalLineAngle [get, set]
	Angle of the EPointGauge.NominalLine.
eVision.ELine	NominalLine [get, set]
	The line upon which we try to measure edge crossing points.
override eVision.EShapeType	Type [get]
	Shape type.
override eVision.EShape	Nominal [get, set]
	Nominal shape of the gauge.
override eVision.EEditionMode	AvailableEditionModes [get]
	Returns all possible edition modes of the gauge.
override bool	HVConstraint [get, set]
	Status of the restriction on the orientation of the point location gauge or model fitting sample paths.
override eVision.ETransitionType	TransitionType [get, set]
	Transition type.
override eVision.ETransitionChoice	TransitionChoice [get, set]
	Transition choice.
override uint	TransitionIndex [get, set]
	Index (from 0 on) of the transition to be retained when the transition choice parameter is set to ETransitionChoice.ETransitionChoice_NthFromBegin or ETransitionChoice.ETransitionChoice_NthFromEnd.
override uint	Threshold [get, set]
	Threshold level used to delimit significant peaks in the data profile.
override uint	MinAmplitude [get, set]
	Offset added to the Threshold when a peak is to be detected.
override uint	MinArea [get, set]
	Minimum area value.
override uint	Thickness [get, set]
	Number of parallel segments used to extract the data profile.
override uint	Smoothing [get, set]
	Number of pixels used for the low-pass filtering operation.
override bool	RectangularSamplingArea [get, set]
	Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.
override uint	NumSamples [get]
	Number of sampled points during the model fitting operation.
override eVision.EShape	Measured [get]
	Copy of the measured shape.
uint	NumMeasuredPoints [get]
	Number of edge-crossing points measured along the path of the point gauge.
eVision.EPointSet	MeasuredPointSet [get]
	Coordinates of a sample point measured along the path of the point gauge.
eVision.EPoint[]	MeasuredPoints [get]
	Coordinates of all edge-crossing points measured along the path of the point gauge.
eVision.EPeak[]	MeasuredPeaks [get]
	Returns information pertaining to the derivative peaks associated with all the edge-crossing point, such as their area, amplitude, start, length and center.
Properties inherited from eVision.EBaseGauge
eVision.EShapeType	Type [get]
	Shape type.
string	Name [get, set]
	Name of the EBaseGauge object.
eVision.EShape	Nominal [get, set]
	Nominal shape of the gauge.
eVision.EEditionMode	EditionMode [get, set]
	Graphical edition mode (default: EBaseGauge.AvailableEditionModes).
virtual eVision.EEditionMode	AvailableEditionModes [get]
	Returns all possible edition modes of the gauge.
bool	Labeled [get, set]
	Whether to draw a label describing the gauge (default: no).
float	Tolerance [get, set]
	Half thickness of the model fitting gauge.
bool	HVConstraint [get, set]
	Status of the restriction on the orientation of the point location gauge or model fitting sample paths.
eVision.ETransitionType	TransitionType [get, set]
	Transition type.
eVision.ETransitionChoice	TransitionChoice [get, set]
	Transition choice.
uint	TransitionIndex [get, set]
	Index (from 0 on) of the transition to be retained when the transition choice parameter is set to ETransitionChoice.ETransitionChoice_NthFromBegin or ETransitionChoice.ETransitionChoice_NthFromEnd.
uint	Threshold [get, set]
	Threshold level used to delimit significant peaks in the data profile.
uint	MinAmplitude [get, set]
	Offset added to the Threshold when a peak is to be detected.
uint	MinArea [get, set]
	Minimum area value.
uint	Thickness [get, set]
	Number of parallel segments used to extract the data profile.
uint	Smoothing [get, set]
	Number of pixels used for the low-pass filtering operation.
bool	RectangularSamplingArea [get, set]
	Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.
float	SamplingStep [get, set]
	Approximate distance between sampled points during a model fitting operation.
uint	NumSamples [get]
	Number of sampled points during the model fitting operation.
float	FilteringThreshold [get, set]
	Relative filtering threshold, that is the fraction of the average distance between the sampled points and the fitted model above which a point is filtered out.
uint	NumFilteringPasses [get, set]
	Number of filtering passes for a model fitting operation.
uint	NumValidSamples [get]
	Number of valid sample points remaining after a model fitting operation.
uint	SamplePointIndex [get, set]
	Sampled.
float	AverageDistance [get]
	Average distance between the sampled points and the fitted model.
int[]	MinNumFitSamples [get, set]
	Sets/Gets the minimum number of samples required for fitting the shape.
uint	NumSkipRanges [get]
	Number of skip ranges in the gauge after a call to EBaseGauge.AddSkipRange.
eVision.EShape	Measured [get]
	Copy of the measured shape.

Additional Inherited Members
Static Public Member Functions inherited from eVision.EBaseGauge
static eVision.EBaseGauge	Make (string path)
	Creates a gauge of the correct type.

Detailed Description

Point gauge.

Its nominal shape can be instances of ELine or EPointSet. The returned nominal shape will always be a EPointSet.

Its measured shape is an instance of EPointSet.

License(s): EasyGauge

Constructor & Destructor Documentation

EPointGauge() [1/2]

eVision.EPointGauge.EPointGauge

(

)

Constructs a EPointGauge.

EPointGauge() [2/2]

eVision.EPointGauge.EPointGauge

(

eVision.EPointGauge

other

)

Copy constructor.

Parameters

other

Other EPointGauge object to copy.

Member Function Documentation

CopyTo()

void eVision.EPointGauge.CopyTo

(

eVision.EPointGauge

other

)

Copy the object to the other object.

Parameters

other

Other EPointGauge object in which to copy the content of this object.

GetMeasuredPeak() [1/2]

eVision.EPeak eVision.EPointGauge.GetMeasuredPeak

(

)

Returns information pertaining to the default derivative peak along the path of the point gauge.

If index is left unchanged from its default value (i.e. ~0 = 0xFFFFFFFF), the default edge-crossing point is inspected. This default point is chosen according to the transition choice parameter that is managed by the EPointGauge.TransitionChoice property.

If you want to query more than 10 points, using EPointGauge.MeasuredPeaks should be faster.

GetMeasuredPeak() [2/2]

eVision.EPeak eVision.EPointGauge.GetMeasuredPeak

(

uint

index

)

Returns information pertaining to the default derivative peak along the path of the point gauge.

Parameters

index

Index of the edge-crossing point along the probed line segment, between 0 and EPointGauge.NumMeasuredPoints (excluded).

If index is left unchanged from its default value (i.e. ~0 = 0xFFFFFFFF), the default edge-crossing point is inspected. This default point is chosen according to the transition choice parameter that is managed by the EPointGauge.TransitionChoice property.

If you want to query more than 10 points, using EPointGauge.MeasuredPeaks should be faster.

GetMeasuredPoint() [1/2]

eVision.EPoint eVision.EPointGauge.GetMeasuredPoint

(

)

Coordinates of a sample point measured along the path of the point gauge.

These coordinates pertain to the World space.

If index is left unchanged from its default value (i.e. ~0 = 0xFFFFFFFF), the default edge-crossing point is inspected. This default point is chosen according to the transition choice parameter that is managed by the EPointGauge.TransitionChoice property.

If you want to query more than 10 points, using EPointGauge.MeasuredPoints should be faster.

GetMeasuredPoint() [2/2]

eVision.EPoint eVision.EPointGauge.GetMeasuredPoint

(

uint

index

)

Coordinates of a sample point measured along the path of the point gauge.

Parameters

index

Index of the edge-crossing point along the path of the point gauge, between 0 and EPointGauge.NumMeasuredPoints (excluded).

These coordinates pertain to the World space.

If index is left unchanged from its default value (i.e. ~0 = 0xFFFFFFFF), the default edge-crossing point is inspected. This default point is chosen according to the transition choice parameter that is managed by the EPointGauge.TransitionChoice property.

If you want to query more than 10 points, using EPointGauge.MeasuredPoints should be faster.

Measure() [1/4]

new eVision.EPointSet eVision.EPointGauge.Measure

(

eVision.EROIBW8

sourceImage

)

Performs the gauge measurement.

Parameters

sourceImage

Source image.

Measure() [2/4]

new eVision.EPointSet eVision.EPointGauge.Measure	(	eVision.EROIBW8	sourceImage,
		eVision.EFrame	frame )

Performs the gauge measurement.

Parameters

sourceImage	Source image.
frame	Frame of reference

Measure() [3/4]

new eVision.EPointSet eVision.EPointGauge.Measure	(	eVision.EROIBW8	sourceImage,
		eVision.ERegion	region )

Performs the gauge measurement.

Parameters

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

Measure() [4/4]

new eVision.EPointSet eVision.EPointGauge.Measure	(	eVision.EROIBW8	sourceImage,
		eVision.ERegion	region,
		eVision.EFrame	frame )

Performs the gauge measurement.

Parameters

sourceImage	Source image.
region	Region to use with the source image.
frame	Frame of reference

Plot() [1/6]

void eVision.EPointGauge.Plot	(	eVision.EDrawAdapter	graphicContext,
		eVision.EPlotItem	drawItems,
		eVision.EPlotDecorationOptions	opts,
		float	width,
		float	height )

Draws the profile of the sample path of the point 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.
opts	Options to control the drawing of the plot decorations (axes, ticks, etc.).
width	Width of the plot.
height	Height of the plot.

The data will be plotted with the current pen of the EDrawAdapter. If there is no pen set, then the following color will be used:

• Red for EPlotItem.EPlotItem_Transitions
• Blue for EPlotItem.EPlotItem_Peak
• Blue for EPlotItem.EPlotItem_Thresholds
• Green for EPlotItem.EPlotItem_Points
• Red for any combinations of EPlotItem

Plot() [2/6]

void eVision.EPointGauge.Plot	(	eVision.EDrawAdapter	graphicContext,
		eVision.EPlotItem	drawItems,
		eVision.EPlotDecorationOptions	opts,
		float	width,
		float	height,
		float	originX )

Draws the profile of the sample path of the point 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.
opts	Options to control the drawing of the plot decorations (axes, ticks, etc.).
width	Width of the plot.
height	Height of the plot.
originX	Origin point coordinates of the plot along the X axis.

The data will be plotted with the current pen of the EDrawAdapter. If there is no pen set, then the following color will be used:

• Red for EPlotItem.EPlotItem_Transitions
• Blue for EPlotItem.EPlotItem_Peak
• Blue for EPlotItem.EPlotItem_Thresholds
• Green for EPlotItem.EPlotItem_Points
• Red for any combinations of EPlotItem

Plot() [3/6]

void eVision.EPointGauge.Plot	(	eVision.EDrawAdapter	graphicContext,
		eVision.EPlotItem	drawItems,
		eVision.EPlotDecorationOptions	opts,
		float	width,
		float	height,
		float	originX,
		float	originY )

Draws the profile of the sample path of the point 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.
opts	Options to control the drawing of the plot decorations (axes, ticks, etc.).
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 data will be plotted with the current pen of the EDrawAdapter. If there is no pen set, then the following color will be used:

• Red for EPlotItem.EPlotItem_Transitions
• Blue for EPlotItem.EPlotItem_Peak
• Blue for EPlotItem.EPlotItem_Thresholds
• Green for EPlotItem.EPlotItem_Points
• Red for any combinations of EPlotItem

Plot() [4/6]

void eVision.EPointGauge.Plot	(	eVision.EDrawAdapter	graphicContext,
		eVision.EPlotItem	drawItems,
		float	width,
		float	height )

Draws the profile of the sample path of the point 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 data will be plotted with the current pen of the EDrawAdapter. If there is no pen set, then the following color will be used:

• Red for EPlotItem.EPlotItem_Transitions
• Blue for EPlotItem.EPlotItem_Peak
• Blue for EPlotItem.EPlotItem_Thresholds
• Green for EPlotItem.EPlotItem_Points
• Red for any combinations of EPlotItem

Plot() [5/6]

void eVision.EPointGauge.Plot	(	eVision.EDrawAdapter	graphicContext,
		eVision.EPlotItem	drawItems,
		float	width,
		float	height,
		float	originX )

Draws the profile of the sample path of the point 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 data will be plotted with the current pen of the EDrawAdapter. If there is no pen set, then the following color will be used:

• Red for EPlotItem.EPlotItem_Transitions
• Blue for EPlotItem.EPlotItem_Peak
• Blue for EPlotItem.EPlotItem_Thresholds
• Green for EPlotItem.EPlotItem_Points
• Red for any combinations of EPlotItem

Plot() [6/6]

void eVision.EPointGauge.Plot	(	eVision.EDrawAdapter	graphicContext,
		eVision.EPlotItem	drawItems,
		float	width,
		float	height,
		float	originX,
		float	originY )

Draws the profile of the sample path of the point 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 data will be plotted with the current pen of the EDrawAdapter. If there is no pen set, then the following color will be used:

• Red for EPlotItem.EPlotItem_Transitions
• Blue for EPlotItem.EPlotItem_Peak
• Blue for EPlotItem.EPlotItem_Thresholds
• Green for EPlotItem.EPlotItem_Points
• Red for any combinations of EPlotItem

Property Documentation

AvailableEditionModes

override eVision.EEditionMode eVision.EPointGauge.AvailableEditionModes

get

Returns all possible edition modes of the gauge.

Center

eVision.EPoint eVision.EPointGauge.Center

getset

Center of the EPointGauge.NominalLine.

This is an accessor for the center of the nominal shape.

HVConstraint

override bool eVision.EPointGauge.HVConstraint

getset

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

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

Measured

override eVision.EShape eVision.EPointGauge.Measured

get

Copy of the measured shape.

MeasuredPeaks

eVision.EPeak [] eVision.EPointGauge.MeasuredPeaks

get

Returns information pertaining to the derivative peaks associated with all the edge-crossing point, such as their area, amplitude, start, length and center.

If you want to query less than 10 peaks, using EPointGauge.GetMeasuredPeak should be faster.

MeasuredPoints

eVision.EPoint [] eVision.EPointGauge.MeasuredPoints

get

Coordinates of all edge-crossing points measured along the path of the point gauge.

These coordinates pertain to the World space.

If you want to query less than 10 points, using EPointGauge.GetMeasuredPoint should be faster.

MeasuredPointSet

eVision.EPointSet eVision.EPointGauge.MeasuredPointSet

get

Coordinates of a sample point measured along the path of the point gauge.

MinAmplitude

override uint eVision.EPointGauge.MinAmplitude

getset

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

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

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

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

MinArea

override uint eVision.EPointGauge.MinArea

getset

Minimum area value.

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

Nominal

override eVision.EShape eVision.EPointGauge.Nominal

getset

Nominal shape of the gauge.

Note that the gauge stores a copy of the shape and returns a copy of the shape. The gauge applies its EBaseGauge.EditionMode to the shape.

NominalLine

eVision.ELine eVision.EPointGauge.NominalLine

getset

The line upon which we try to measure edge crossing points.

NominalLineAngle

float eVision.EPointGauge.NominalLineAngle

getset

Angle of the EPointGauge.NominalLine.

NominalLineLength

float eVision.EPointGauge.NominalLineLength

getset

Length of the EPointGauge.NominalLine.

NumMeasuredPoints

uint eVision.EPointGauge.NumMeasuredPoints

get

Number of edge-crossing points measured along the path of the point gauge.

NumSamples

override uint eVision.EPointGauge.NumSamples

get

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

RectangularSamplingArea

override bool eVision.EPointGauge.RectangularSamplingArea

getset

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.

Smoothing

override uint eVision.EPointGauge.Smoothing

getset

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

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

Thickness

override uint eVision.EPointGauge.Thickness

getset

Number of parallel segments used to extract the data profile.

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

Threshold

override uint eVision.EPointGauge.Threshold

getset

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

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

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

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

Tolerance

override float eVision.EPointGauge.Tolerance

getset

Half thickness of the model fitting gauge.

By default, the tolerance 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.

The tolerance isn't taken into consideration for the point gauge.

TransitionChoice

override eVision.ETransitionChoice eVision.EPointGauge.TransitionChoice

getset

Transition choice.

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

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

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

TransitionIndex

override uint eVision.EPointGauge.TransitionIndex

getset

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

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

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

TransitionType

override eVision.ETransitionType eVision.EPointGauge.TransitionType

getset

Transition type.

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

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

Type

override eVision.EShapeType eVision.EPointGauge.Type

get

Shape type.