Represents a model of a circle (or arc) in EasyGauge. More...

Inheritance diagram for eVision.ECircle:

Collaboration diagram for eVision.ECircle:

Public Member Functions
None	__init__ (self)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.EPoint center, float diameter, float originAngle, bool direct)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.EPoint center, float diameter, float originAngle)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.EPoint center, float diameter)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.EPoint center, eVision.EPoint origin, bool direct)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.EPoint center, eVision.EPoint origin)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.EPoint center, float diameter, float originAngle, float amplitude)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end, bool fullCircle)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.ECircle other)
	Constructs a eVision.ECircle object.
None	__init__ (self, eVision.Legacy.ECircle other)
	Constructs a eVision.ECircle object.
None	SetFromCenterAndOrigin (self, eVision.EPoint center, eVision.EPoint origin, bool direct)
	Sets the geometric parameters (nominal position and diameter, angular position and amplitude) of an eVision.ECircle object.
None	SetFromCenterAndOrigin (self, eVision.EPoint center, eVision.EPoint origin)
	Sets the geometric parameters (nominal position and diameter, angular position and amplitude) of an eVision.ECircle object.
None	SetFromOriginMiddleEnd (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end, bool fullCircle)
	Sets the geometric parameters (nominal position and diameter, angular position and amplitude) of an eVision.ECircle object.
None	SetFromOriginMiddleEnd (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end)
	Sets the geometric parameters (nominal position and diameter, angular position and amplitude) of an eVision.ECircle object.
eVision.EPoint	GetPoint (self, float fraction)
	Returns the coordinates of a particular point specified by its location along the circle arc.
bool	IsDirect (self)
	Flag indicating whether positive angles correspond to a clockwise or an anticlockwise rotation.
float	Distance (self, eVision.ECircle circle)
	Returns the smallest distance between this eVision.ECircle object an another eVision.ECircle.
eVision.EPoint	Center (self)
	Center of the eVision.ECircle.
	Center (self, eVision.EPoint value)
	Center of the eVision.ECircle.
float	CenterX (self)
	Abscissa of the center of the eVision.ECircle.
	CenterX (self, float value)
	Abscissa of the center of the eVision.ECircle.
float	CenterY (self)
	Ordinate of the the center of the eVision.ECircle.
	CenterY (self, float value)
	Ordinate of the the center of the eVision.ECircle.
float	Angle (self)
	Starting orientation of the eVision.ECircle.
	Angle (self, float value)
	Starting orientation of the eVision.ECircle.
float	Radius (self)
	Radius of a eVision.ECircle object.
	Radius (self, float value)
	Radius of a eVision.ECircle object.
float	Diameter (self)
	Diameter of a eVision.ECircle object.
	Diameter (self, float value)
	Diameter of a eVision.ECircle object.
float	ArcLength (self)
	Circle arc length of a eVision.ECircle object.
float	OrgAngle (self)
	Angular position from where the eVision.ECircle object extents.
float	ApexAngle (self)
	Angular position at the apex of a eVision.ECircle object.
float	EndAngle (self)
	Angular position of the end of a eVision.ECircle object.
eVision.EPoint	Org (self)
	Origin point coordinates of a eVision.ECircle object.
eVision.EPoint	Apex (self)
	Apex point coordinates of a eVision.ECircle object.
eVision.EPoint	End (self)
	End point coordinates of a eVision.ECircle object.
bool	Full (self)
	Flag indicating whether the eVision.ECircle object is a full circle or not.
float	Amplitude (self)
	Angular amplitude of the eVision.ECircle object.
	Amplitude (self, float value)
	Angular amplitude of the eVision.ECircle object.
eVision.EEditionMode	AvailableEditionModes (self)
	Available edition modes for the shape.
str	Description (self)
	Textual description of the shape and its parameters.
Public Member Functions inherited from eVision.EShape
None	Load (self, str path)
	Load the eVision.EShape configuration.
None	Load (self, eVision.ESerializer\|None serializer)
	Load the eVision.EShape configuration.
None	Save (self, str path)
	Save the eVision.EShape configuration.
None	Save (self, eVision.ESerializer\|None serializer)
	Save the eVision.EShape configuration.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, float zoomX, float zoomY, float panX, float panY, bool drawDiagonals)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, float zoomX, float zoomY, float panX, float panY)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, float zoomX, float zoomY, float panX)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, float zoomX, float zoomY)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, float zoomX)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY, bool drawDiagonals)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, eVision.EFrame frame, float zoomX, float zoomY)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, eVision.EFrame frame, float zoomX)
	Draws the eVision.EShape shape.
None	Draw (self, eVision.EDrawAdapter\|None drawAdapter, eVision.EFrame frame)
	Draws the eVision.EShape shape.
eVision.EEditionMode	HitTest (self, int x, int y, float zoomX, float zoomY, float panX, float panY)
	Detects if the cursor is placed over one of the dragging handles.
eVision.EEditionMode	HitTest (self, int x, int y, float zoomX, float zoomY, float panX)
	Detects if the cursor is placed over one of the dragging handles.
eVision.EEditionMode	HitTest (self, int x, int y, float zoomX, float zoomY)
	Detects if the cursor is placed over one of the dragging handles.
eVision.EEditionMode	HitTest (self, int x, int y, float zoomX)
	Detects if the cursor is placed over one of the dragging handles.
eVision.EEditionMode	HitTest (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Detects if the cursor is placed over one of the dragging handles.
eVision.EEditionMode	HitTest (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Detects if the cursor is placed over one of the dragging handles.
eVision.EEditionMode	HitTest (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY)
	Detects if the cursor is placed over one of the dragging handles.
eVision.EEditionMode	HitTest (self, int x, int y, eVision.EFrame frame, float zoomX)
	Detects if the cursor is placed over one of the dragging handles.
None	Drag (self, int x, int y, float zoomX, float zoomY, float panX, float panY)
	Moves the specified handle to a new position and updates all placement parameters of the region.
None	Drag (self, int x, int y, float zoomX, float zoomY, float panX)
	Moves the specified handle to a new position and updates all placement parameters of the region.
None	Drag (self, int x, int y, float zoomX, float zoomY)
	Moves the specified handle to a new position and updates all placement parameters of the region.
None	Drag (self, int x, int y, float zoomX)
	Moves the specified handle to a new position and updates all placement parameters of the region.
None	Drag (self, int x, int y)
	Moves the specified handle to a new position and updates all placement parameters of the region.
None	Drag (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Moves the specified handle to a new position and updates all placement parameters of the region.
None	Drag (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Moves the specified handle to a new position and updates all placement parameters of the region.
None	Drag (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY)
	Moves the specified handle to a new position and updates all placement parameters of the region.
None	Drag (self, int x, int y, eVision.EFrame frame, float zoomX)
	Moves the specified handle to a new position and updates all placement parameters of the region.
None	Drag (self, int x, int y, eVision.EFrame frame)
	Moves the specified handle to a new position and updates all placement parameters of the region.
eVision.EFrame	ToFrame (self, bool useAngle, eVision.EFrameScaling frameScaling)
	Converts the shape to a frame.
eVision.EFrame	ToFrame (self, bool useAngle, eVision.EFrameScaling frameScaling, eVision.EFrame shapeFrame)
	Converts the shape to a frame.
eVision.EEditionMode	EditionMode (self)
	Current edition mode for the shape.
	EditionMode (self, eVision.EEditionMode value)
	Current edition mode for the shape.

Static Public Member Functions
eVision.EPoint	GetProjectionOfPointOnCircle (eVision.EPoint pt, eVision.ECircle circle, bool limited)
	Computes the projection of a point on a circle.
eVision.EPoint	GetProjectionOfPointOnCircle (eVision.EPoint pt, eVision.ECircle circle)
	Computes the projection of a point on a circle.
float	GetDistanceBetweenPointAndCircle (eVision.EPoint pt, eVision.ECircle circle, bool limited)
	Computes the distance between a point and a circle.
float	GetDistanceBetweenPointAndCircle (eVision.EPoint pt, eVision.ECircle circle)
	Computes the distance between a point and a circle.
float	GetDistanceBetweenLineAndCircle (eVision.ELine line, eVision.ECircle circle, bool limited)
	Computes the distance between a line and a circle.
float	GetDistanceBetweenLineAndCircle (eVision.ELine line, eVision.ECircle circle)
	Computes the distance between a line and a circle.
int	GetIntersectionOfLineAndCircle (eVision.ELine line, eVision.ECircle circle, eVision.EPoint intersection1, eVision.EPoint intersection2, bool limited)
	Computes the intersections between a line and circle.
int	GetIntersectionOfLineAndCircle (eVision.ELine line, eVision.ECircle circle, eVision.EPoint intersection1, eVision.EPoint intersection2)
	Computes the intersections between a line and circle.
int	GetIntersectionOfCircles (eVision.ECircle circle1, eVision.ECircle circle2, eVision.EPoint intersection1, eVision.EPoint intersection2, bool limited)
	Computes the intersections between two circles.
int	GetIntersectionOfCircles (eVision.ECircle circle1, eVision.ECircle circle2, eVision.EPoint intersection1, eVision.EPoint intersection2)
	Computes the intersections between two circles.
eVision.ECircle	Fit (list[eVision._eVision.EPoint] points, bool fitArc, int numFilteringPasses, float filteringThreshold)
	Fits an eVision.ECircle to a set of points.
eVision.ECircle	Fit (list[eVision._eVision.EPoint] points, bool fitArc, int numFilteringPasses)
	Fits an eVision.ECircle to a set of points.
eVision.ECircle	Fit (list[eVision._eVision.EPoint] points, bool fitArc)
	Fits an eVision.ECircle to a set of points.
eVision.ECircle	Fit (list[eVision._eVision.EPoint] points)
	Fits an eVision.ECircle to a set of points.

Detailed Description

Represents a model of a circle (or arc) in EasyGauge.

Remarks:

License(s): BasicTypes

Constructor & Destructor Documentation

◆ init() [1/11]

None eVision.ECircle.__init__ ( self )

Constructs a eVision.ECircle object.

◆ init() [2/11]

None eVision.ECircle.__init__	(		self,
		eVision.EPoint	center,
		float	diameter,
		float	originAngle,
		bool	direct )

Constructs a eVision.ECircle object.

Parameters

center	Center coordinates of the circle at its nominal position. The default value is (0,0).
diameter	Nominal diameter of the circle. The default value is 100.
originAngle	Nominal angular origin of the circle. The default value is 0.
direct	true (default) means that angles increase anticlockwisely in a direct coordinate system.

◆ init() [3/11]

None eVision.ECircle.__init__	(		self,
		eVision.EPoint	center,
		float	diameter,
		float	originAngle )

Constructs a eVision.ECircle object.

Parameters

center	Center coordinates of the circle at its nominal position. The default value is (0,0).
diameter	Nominal diameter of the circle. The default value is 100.
originAngle	Nominal angular origin of the circle. The default value is 0.

◆ init() [4/11]

None eVision.ECircle.__init__	(		self,
		eVision.EPoint	center,
		float	diameter )

Constructs a eVision.ECircle object.

Parameters

center	Center coordinates of the circle at its nominal position. The default value is (0,0).
diameter	Nominal diameter of the circle. The default value is 100.

◆ init() [5/11]

None eVision.ECircle.__init__	(		self,
		eVision.EPoint	center,
		eVision.EPoint	origin,
		bool	direct )

Constructs a eVision.ECircle object.

Parameters

center	Center coordinates of the circle at its nominal position. The default value is (0,0).
origin	Origin point coordinates of the circle.
direct	true (default) means that angles increase anticlockwisely in a direct coordinate system.

◆ init() [6/11]

None eVision.ECircle.__init__	(		self,
		eVision.EPoint	center,
		eVision.EPoint	origin )

Constructs a eVision.ECircle object.

Parameters

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

◆ init() [7/11]

None eVision.ECircle.__init__	(		self,
		eVision.EPoint	center,
		float	diameter,
		float	originAngle,
		float	amplitude )

Constructs a eVision.ECircle object.

Parameters

center	Center coordinates of the circle at its nominal position. The default value is (0,0).
diameter	Nominal diameter of the circle. The default value is 100.
originAngle	Nominal angular origin of the circle. The default value is 0.
amplitude	Nominal angular amplitude of the circle. The default value is 360.

◆ init() [8/11]

None eVision.ECircle.__init__	(		self,
		eVision.EPoint	origin,
		eVision.EPoint	middle,
		eVision.EPoint	end,
		bool	fullCircle )

Constructs a eVision.ECircle object.

Parameters

origin	Origin point coordinates of the circle.
middle	Middle point coordinates of the circle.
end	End point coordinates of the circle.
fullCircle	true (default) in case of a full turn circle. If fullCircle is false, origin and end give the circle's amplitude.

◆ init() [9/11]

None eVision.ECircle.__init__	(		self,
		eVision.EPoint	origin,
		eVision.EPoint	middle,
		eVision.EPoint	end )

Constructs a eVision.ECircle object.

Parameters

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

◆ init() [10/11]

None eVision.ECircle.__init__	(		self,
		eVision.ECircle	other )

Constructs a eVision.ECircle object.

Parameters

other Another eVision.ECircle object to be copied in the new eVision.ECircle object.

◆ init() [11/11]

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

Constructs a eVision.ECircle object.

Parameters

other Another eVision.ECircle object to be copied in the new eVision.ECircle object.

Member Function Documentation

◆ Amplitude() [1/2]

float eVision.ECircle.Amplitude ( self )

Angular amplitude of the eVision.ECircle object.

Remarks:

The default value is 360. A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance. The sign of the rotation angle depends whether the field of view is calibrated or not.

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

◆ Amplitude() [2/2]

eVision.ECircle.Amplitude	(		self,
		float	value )

Angular amplitude of the eVision.ECircle object.

Remarks:

The default value is 360. A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance. The sign of the rotation angle depends whether the field of view is calibrated or not.

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

◆ Angle() [1/2]

float eVision.ECircle.Angle ( self )

Starting orientation of the eVision.ECircle.

◆ Angle() [2/2]

eVision.ECircle.Angle	(		self,
		float	value )

Starting orientation of the eVision.ECircle.

◆ Apex()

eVision.EPoint eVision.ECircle.Apex ( self )

Apex point coordinates of a eVision.ECircle object.

◆ ApexAngle()

float eVision.ECircle.ApexAngle ( self )

Angular position at the apex of a eVision.ECircle object.

Remarks:

A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance. The sign of the rotation angle depends whether the field of view is calibrated or not.

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

◆ ArcLength()

float eVision.ECircle.ArcLength ( self )

Circle arc length of a eVision.ECircle object.

Remarks:

A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance.

◆ AvailableEditionModes()

eVision.EEditionMode eVision.ECircle.AvailableEditionModes ( self )

Available edition modes for the shape.

Reimplemented from eVision.EShape.

◆ Center() [1/2]

eVision.EPoint eVision.ECircle.Center ( self )

Center of the eVision.ECircle.

◆ Center() [2/2]

eVision.ECircle.Center	(		self,
		eVision.EPoint	value )

Center of the eVision.ECircle.

◆ CenterX() [1/2]

float eVision.ECircle.CenterX ( self )

Abscissa of the center of the eVision.ECircle.

◆ CenterX() [2/2]

eVision.ECircle.CenterX	(		self,
		float	value )

Abscissa of the center of the eVision.ECircle.

◆ CenterY() [1/2]

float eVision.ECircle.CenterY ( self )

Ordinate of the the center of the eVision.ECircle.

◆ CenterY() [2/2]

eVision.ECircle.CenterY	(		self,
		float	value )

Ordinate of the the center of the eVision.ECircle.

◆ Description()

str eVision.ECircle.Description ( self )

Textual description of the shape and its parameters.

Reimplemented from eVision.EShape.

◆ Diameter() [1/2]

float eVision.ECircle.Diameter ( self )

Diameter of a eVision.ECircle object.

Remarks:

A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance. By default, the diameter is 100, which means 100 pixels when the field of view is not calibrated, and 100 physical units in case of a calibrated field of view.

◆ Diameter() [2/2]

eVision.ECircle.Diameter	(		self,
		float	value )

Diameter of a eVision.ECircle object.

Remarks:

A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance. By default, the diameter is 100, which means 100 pixels when the field of view is not calibrated, and 100 physical units in case of a calibrated field of view.

◆ Distance()

float eVision.ECircle.Distance	(		self,
		eVision.ECircle	circle )

Returns the smallest distance between this eVision.ECircle object an another eVision.ECircle.

Parameters

circle The other circle

◆ End()

eVision.EPoint eVision.ECircle.End ( self )

End point coordinates of a eVision.ECircle object.

◆ EndAngle()

float eVision.ECircle.EndAngle ( self )

Angular position of the end of a eVision.ECircle object.

Remarks:

A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance. The sign of the rotation angle depends whether the field of view is calibrated or not.

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

◆ Fit() [1/4]

eVision.ECircle eVision.ECircle.Fit ( list[eVision._eVision.EPoint] points )

static

Fits an eVision.ECircle to a set of points.

Remarks:

The algorithm used here is the same as the one used in eVision.Legacy.ECircleGauge.Measure.

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

This method returns a "direct" eVision.ECircle, see eVision.ECircle.IsDirect.

Parameters

points Vector of points to fit.

◆ Fit() [2/4]

eVision.ECircle eVision.ECircle.Fit	(	list[eVision._eVision.EPoint]	points,
		bool	fitArc )

static

Fits an eVision.ECircle to a set of points.

Remarks:

The algorithm used here is the same as the one used in eVision.Legacy.ECircleGauge.Measure.

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

This method returns a "direct" eVision.ECircle, see eVision.ECircle.IsDirect.

Parameters

points	Vector of points to fit.
fitArc	If true, a circle arc big enough to be close to all points will be returned instead of a full circle. Defaults to false.

◆ Fit() [3/4]

eVision.ECircle eVision.ECircle.Fit	(	list[eVision._eVision.EPoint]	points,
		bool	fitArc,
		int	numFilteringPasses )

static

Fits an eVision.ECircle to a set of points.

Remarks:

The algorithm used here is the same as the one used in eVision.Legacy.ECircleGauge.Measure.

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

This method returns a "direct" eVision.ECircle, see eVision.ECircle.IsDirect.

Parameters

points	Vector of points to fit.
fitArc	If true, a circle arc big enough to be close to all points will be returned instead of a full circle. Defaults to false.
numFilteringPasses	Number of filtering passes for a circle fitting operation. Defaults to 0 (no filtering performed).

◆ Fit() [4/4]

eVision.ECircle eVision.ECircle.Fit	(	list[eVision._eVision.EPoint]	points,
		bool	fitArc,
		int	numFilteringPasses,
		float	filteringThreshold )

static

Fits an eVision.ECircle to a set of points.

Remarks:

The algorithm used here is the same as the one used in eVision.Legacy.ECircleGauge.Measure.

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

This method returns a "direct" eVision.ECircle, see eVision.ECircle.IsDirect.

Parameters

points	Vector of points to fit.
fitArc	If true, a circle arc big enough to be close to all points will be returned instead of a full circle. Defaults to false.
numFilteringPasses	Number of filtering passes for a circle fitting operation. Defaults to 0 (no filtering performed).
filteringThreshold	Relative filtering threshold, that is the fraction of the average distance between the points and the fitted model above which a point is filtered out. Defaults to 3.

◆ Full()

bool eVision.ECircle.Full ( self )

Flag indicating whether the eVision.ECircle object is a full circle or not.

Remarks:

By default (true), the eVision.ECircle object is a full circle.

◆ GetDistanceBetweenLineAndCircle() [1/2]

float eVision.ECircle.GetDistanceBetweenLineAndCircle	(	eVision.ELine	line,
		eVision.ECircle	circle )

static

Computes the distance between a line and a circle.

Parameters

line	The line.
circle	The circle.

◆ GetDistanceBetweenLineAndCircle() [2/2]

float eVision.ECircle.GetDistanceBetweenLineAndCircle	(	eVision.ELine	line,
		eVision.ECircle	circle,
		bool	limited )

static

Computes the distance between a line and a circle.

Parameters

line	The line.
circle	The circle.
limited	Indicates if the line and circle parameters should be considered as infinite lines and full circles or as a segments and arcs.

◆ GetDistanceBetweenPointAndCircle() [1/2]

float eVision.ECircle.GetDistanceBetweenPointAndCircle	(	eVision.EPoint	pt,
		eVision.ECircle	circle )

static

Computes the distance between a point and a circle.

Remarks:

When the circle is restricted to an arc and the orthogonal projection of the point onto the circle falls outside this arc, the distance to the closest endpoint of the arc is returned instead.

Parameters

pt	The point.
circle	The circle.

◆ GetDistanceBetweenPointAndCircle() [2/2]

float eVision.ECircle.GetDistanceBetweenPointAndCircle	(	eVision.EPoint	pt,
		eVision.ECircle	circle,
		bool	limited )

static

Computes the distance between a point and a circle.

Remarks:

When the circle is restricted to an arc and the orthogonal projection of the point onto the circle falls outside this arc, the distance to the closest endpoint of the arc is returned instead.

Parameters

pt	The point.
circle	The circle.
limited	Indicates if the circle parameter should be considered as a full circle or as an arc.

◆ GetIntersectionOfCircles() [1/2]

int eVision.ECircle.GetIntersectionOfCircles	(	eVision.ECircle	circle1,
		eVision.ECircle	circle2,
		eVision.EPoint	intersection1,
		eVision.EPoint	intersection2 )

static

Computes the intersections between two circles.

Returns the number of intersections and stores the found intersections in the provided point parameters.

Remarks:

The function returns the number of intersections found. It will return -1 if the two circles are overlapping.

Parameters

circle1	The first circle
circle2	The second circle
intersection1	The first intersection
intersection2	The second intersection

◆ GetIntersectionOfCircles() [2/2]

int eVision.ECircle.GetIntersectionOfCircles	(	eVision.ECircle	circle1,
		eVision.ECircle	circle2,
		eVision.EPoint	intersection1,
		eVision.EPoint	intersection2,
		bool	limited )

static

Computes the intersections between two circles.

Returns the number of intersections and stores the found intersections in the provided point parameters.

Remarks:

The function returns the number of intersections found. It will return -1 if the two circles are overlapping.

Parameters

circle1	The first circle
circle2	The second circle
intersection1	The first intersection
intersection2	The second intersection
limited	Indicates if the circle parameters should be considered as full circles or as arcs.

◆ GetIntersectionOfLineAndCircle() [1/2]

int eVision.ECircle.GetIntersectionOfLineAndCircle	(	eVision.ELine	line,
		eVision.ECircle	circle,
		eVision.EPoint	intersection1,
		eVision.EPoint	intersection2 )

static

Computes the intersections between a line and circle.

Returns the number of intersections and stores the found intersections in the provided point parameters.

Remarks:

The function returns the number of intersections found.

Parameters

line	The line
circle	The circle
intersection1	The first intersection
intersection2	The second intersection

◆ GetIntersectionOfLineAndCircle() [2/2]

int eVision.ECircle.GetIntersectionOfLineAndCircle	(	eVision.ELine	line,
		eVision.ECircle	circle,
		eVision.EPoint	intersection1,
		eVision.EPoint	intersection2,
		bool	limited )

static

Computes the intersections between a line and circle.

Returns the number of intersections and stores the found intersections in the provided point parameters.

Remarks:

The function returns the number of intersections found.

Parameters

line	The line
circle	The circle
intersection1	The first intersection
intersection2	The second intersection
limited	Indicates if the line and circle parameters should be considered as infinite lines and full circles or as a segments and arcs.

◆ GetPoint()

eVision.EPoint eVision.ECircle.GetPoint	(		self,
		float	fraction )

Returns the coordinates of a particular point specified by its location along the circle arc.

Parameters

fraction Point location expressed as a fraction of the circle arc (range [-1, +1]).

◆ GetProjectionOfPointOnCircle() [1/2]

eVision.EPoint eVision.ECircle.GetProjectionOfPointOnCircle	(	eVision.EPoint	pt,
		eVision.ECircle	circle )

static

Computes the projection of a point on a circle.

Remarks:

When the circle is restricted to an arc and the orthogonal projection of the point onto the circle falls outside this arc, the closest endpoint of the arc is returned instead.

Parameters

pt	The point.
circle	The circle.

◆ GetProjectionOfPointOnCircle() [2/2]

eVision.EPoint eVision.ECircle.GetProjectionOfPointOnCircle	(	eVision.EPoint	pt,
		eVision.ECircle	circle,
		bool	limited )

static

Computes the projection of a point on a circle.

Remarks:

When the circle is restricted to an arc and the orthogonal projection of the point onto the circle falls outside this arc, the closest endpoint of the arc is returned instead.

Parameters

pt	The point.
circle	The circle.
limited	Indicates if the circle parameter should be considered as a full circle or as an arc.

◆ IsDirect()

bool eVision.ECircle.IsDirect ( self )

Flag indicating whether positive angles correspond to a clockwise or an anticlockwise rotation.

Remarks:

true (default) means that angles increase anticlockwisely in a direct coordinate system, and clockwisely in an inverse coordinate system.

When the field of view is calibrated, the coordinate system is said to be direct, the abscissa extends rightwards and the ordinate extends upwards.
When the field of view is not calibrated, the coordinate system is said to be inverse, the abscissa extends rightwards and the ordinate extends downwards.

◆ Org()

eVision.EPoint eVision.ECircle.Org ( self )

Origin point coordinates of a eVision.ECircle object.

◆ OrgAngle()

float eVision.ECircle.OrgAngle ( self )

Angular position from where the eVision.ECircle object extents.

Remarks:

A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance. The sign of the rotation angle depends whether the field of view is calibrated or not.

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

◆ Radius() [1/2]

float eVision.ECircle.Radius ( self )

Radius of a eVision.ECircle object.

Remarks:

A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance. By default, the radius is 50, which means 50 pixels when the field of view is not calibrated, and 50 physical units in case of a calibrated field of view.

◆ Radius() [2/2]

eVision.ECircle.Radius	(		self,
		float	value )

Radius of a eVision.ECircle object.

Remarks:

A eVision.ECircle object is fully defined knowing its nominal position (its center coordinates), its nominal radius (diameter), the angular position from where it extents, its angular amplitude, and its outline tolerance. By default, the radius is 50, which means 50 pixels when the field of view is not calibrated, and 50 physical units in case of a calibrated field of view.

◆ SetFromCenterAndOrigin() [1/2]

None eVision.ECircle.SetFromCenterAndOrigin	(		self,
		eVision.EPoint	center,
		eVision.EPoint	origin )

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

Parameters

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

◆ SetFromCenterAndOrigin() [2/2]

None eVision.ECircle.SetFromCenterAndOrigin	(		self,
		eVision.EPoint	center,
		eVision.EPoint	origin,
		bool	direct )

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

Parameters

center	Center coordinates of the circle at its nominal position. The default value is (0,0).
origin	Origin point coordinates of the circle.
direct	true (default) means that angles increase anticlockwisely in a direct coordinate system.

◆ SetFromOriginMiddleEnd() [1/2]

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

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

Remarks:

For example, for a calibrated circle centered on the origin with a radius of 1, whose arc length is 180° and origin angle 0°: Its origin is (1, 0), its middle (0, 1) and its end (-1, 0).

Parameters

origin	Origin of the circle Arc.
middle	Middle of the circle Arc.
end	End of the circle Arc.

◆ SetFromOriginMiddleEnd() [2/2]

None eVision.ECircle.SetFromOriginMiddleEnd	(		self,
		eVision.EPoint	origin,
		eVision.EPoint	middle,
		eVision.EPoint	end,
		bool	fullCircle )

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

Remarks:

For example, for a calibrated circle centered on the origin with a radius of 1, whose arc length is 180° and origin angle 0°: Its origin is (1, 0), its middle (0, 1) and its end (-1, 0).

Parameters

origin	Origin of the circle Arc.
middle	Middle of the circle Arc.
end	End of the circle Arc.
fullCircle	true (default) in case of a full turn circle. If fullCircle is false, origin and end give the circle's amplitude.

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __init__() [1/11]

◆ __init__() [2/11]

◆ __init__() [3/11]

◆ __init__() [4/11]

◆ __init__() [5/11]

◆ __init__() [6/11]

◆ __init__() [7/11]

◆ __init__() [8/11]

◆ __init__() [9/11]

◆ __init__() [10/11]

◆ __init__() [11/11]

Member Function Documentation

◆ Amplitude() [1/2]

◆ Amplitude() [2/2]

◆ Angle() [1/2]

◆ Angle() [2/2]

◆ Apex()

◆ ApexAngle()

◆ ArcLength()

◆ AvailableEditionModes()

◆ Center() [1/2]

◆ Center() [2/2]

◆ CenterX() [1/2]

◆ CenterX() [2/2]

◆ CenterY() [1/2]

◆ CenterY() [2/2]

◆ Description()

◆ Diameter() [1/2]

◆ Diameter() [2/2]

◆ Distance()

◆ End()

◆ EndAngle()

◆ Fit() [1/4]

◆ Fit() [2/4]

◆ Fit() [3/4]

◆ Fit() [4/4]

◆ Full()

◆ GetDistanceBetweenLineAndCircle() [1/2]

◆ GetDistanceBetweenLineAndCircle() [2/2]

◆ GetDistanceBetweenPointAndCircle() [1/2]

◆ GetDistanceBetweenPointAndCircle() [2/2]

◆ GetIntersectionOfCircles() [1/2]

◆ GetIntersectionOfCircles() [2/2]

◆ GetIntersectionOfLineAndCircle() [1/2]

◆ GetIntersectionOfLineAndCircle() [2/2]

◆ GetPoint()

◆ GetProjectionOfPointOnCircle() [1/2]

◆ GetProjectionOfPointOnCircle() [2/2]

◆ IsDirect()

◆ Org()

◆ OrgAngle()

◆ Radius() [1/2]

◆ Radius() [2/2]

◆ SetFromCenterAndOrigin() [1/2]

◆ SetFromCenterAndOrigin() [2/2]

◆ SetFromOriginMiddleEnd() [1/2]

◆ SetFromOriginMiddleEnd() [2/2]

◆ init() [1/11]

◆ init() [2/11]

◆ init() [3/11]

◆ init() [4/11]

◆ init() [5/11]

◆ init() [6/11]

◆ init() [7/11]

◆ init() [8/11]

◆ init() [9/11]

◆ init() [10/11]

◆ init() [11/11]