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

Inheritance diagram for eVision.Legacy.ECircle:

Collaboration diagram for eVision.Legacy.ECircle:

Public Member Functions
None	__init__ (self)
	Constructs a eVision.Legacy.ECircle object.
None	__init__ (self, eVision.EPoint center, float diameter, float originAngle, bool direct)
	Constructs a eVision.Legacy.ECircle object.
None	__init__ (self, eVision.EPoint center, float diameter, float originAngle)
	Constructs a eVision.Legacy.ECircle object.
None	__init__ (self, eVision.EPoint center, float diameter)
	Constructs a eVision.Legacy.ECircle object.
None	__init__ (self, eVision.EPoint center, eVision.EPoint origin, bool direct)
	Constructs a eVision.Legacy.ECircle object.
None	__init__ (self, eVision.EPoint center, eVision.EPoint origin)
	Constructs a eVision.Legacy.ECircle object.
None	__init__ (self, eVision.EPoint center, float diameter, float originAngle, float amplitude)
	Constructs a eVision.Legacy.ECircle object.
None	__init__ (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end, bool fullCircle)
	Constructs a eVision.Legacy.ECircle object.
None	__init__ (self, eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end)
	Constructs a eVision.Legacy.ECircle object.
None	__init__ (self, eVision.Legacy.ECircle other)
	Constructs a eVision.Legacy.ECircle object.
None	CopyTo (self, eVision.Legacy.ECircle other)
	Copies all the data of the current eVision.Legacy.ECircle object into another eVision.Legacy.ECircle object and returns it.
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.Legacy.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.Legacy.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.Legacy.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.Legacy.ECircle object.
eVision.EPoint	GetPoint (self, float fraction)
	Returns the coordinates of a particular point specified by its location along the circle arc.
float	Distance (self, eVision.Legacy.ECircle circle)
	Returns the smallest distance between this eVision.Legacy.ECircle object an another eVision.Legacy.ECircle.
float	Radius (self)
	Radius of a eVision.Legacy.ECircle object.
	Radius (self, float value)
	Radius of a eVision.Legacy.ECircle object.
float	Diameter (self)
	Diameter of a eVision.Legacy.ECircle object.
	Diameter (self, float value)
	Diameter of a eVision.Legacy.ECircle object.
float	ArcLength (self)
	Circle arc length of a eVision.Legacy.ECircle object.
float	OrgAngle (self)
	Angular position from where the eVision.Legacy.ECircle object extents.
float	ApexAngle (self)
	Angular position at the apex of a eVision.Legacy.ECircle object.
float	EndAngle (self)
	Angular position of the end of a eVision.Legacy.ECircle object.
eVision.EPoint	Org (self)
	Origin point coordinates of a eVision.Legacy.ECircle object.
eVision.EPoint	Apex (self)
	Apex point coordinates of a eVision.Legacy.ECircle object.
eVision.EPoint	End (self)
	End point coordinates of a eVision.Legacy.ECircle object.
bool	Full (self)
	Flag indicating whether the eVision.Legacy.ECircle object is a full circle or not.
bool	Direct (self)
	Flag indicating whether positive angles correspond to a clockwise or an anticlockwise rotation.
float	Amplitude (self)
	Angular amplitude of the eVision.Legacy.ECircle object.
	Amplitude (self, float value)
	Angular amplitude of the eVision.Legacy.ECircle object.
Public Member Functions inherited from eVision.Legacy.EFrame
None	__init__ (self)
	Constructs a eVision.Legacy.EFrame object.
None	__init__ (self, float centerX, float centerY, float angle, float scale)
	Constructs a eVision.Legacy.EFrame object.
None	__init__ (self, float centerX, float centerY, float angle)
	Constructs a eVision.Legacy.EFrame object.
None	__init__ (self, float centerX, float centerY)
	Constructs a eVision.Legacy.EFrame object.
None	__init__ (self, eVision.EPoint center, float angle, float scale)
	Constructs a eVision.Legacy.EFrame object.
None	__init__ (self, eVision.Legacy.EFrame frame)
	Constructs a eVision.Legacy.EFrame object.
eVision.EPoint	LocalToGlobal (self, eVision.EPoint local)
	Transforms a geometrical element from local to global coordinates (local to world).
eVision.Legacy.ELine	LocalToGlobal (self, eVision.Legacy.ELine local)
	Transforms a geometrical element from local to global coordinates (local to world).
eVision.Legacy.ECircle	LocalToGlobal (self, eVision.Legacy.ECircle local)
	Transforms a geometrical element from local to global coordinates (local to world).
eVision.Legacy.EFrame	LocalToGlobal (self, eVision.Legacy.EFrame local)
	Transforms a geometrical element from local to global coordinates (local to world).
eVision.EPoint	GlobalToLocal (self, eVision.EPoint global_)
	Transforms a geometrical element from global to local coordinates (world to local).
eVision.Legacy.EFrame	GlobalToLocal (self, eVision.Legacy.EFrame global_)
	Transforms a geometrical element from global to local coordinates (world to local).
None	Load (self, str path)
	Load the eVision.Legacy.EFrame configuration.
None	Load (self, eVision.ESerializer\|None serializer)
	Load the eVision.Legacy.EFrame configuration.
None	Save (self, str path)
	Save the eVision.Legacy.EFrame configuration.
None	Save (self, eVision.ESerializer\|None serializer)
	Save the eVision.Legacy.EFrame configuration.
None	SetCenterXY (self, float centerX, float centerY)
	Sets the center coordinates of a eVision.Legacy.EFrame object.
eVision.EPoint	MidPoint (self, eVision.EPoint Point)
	Returns the middle coordinate between this eVision.Legacy.EFrame object's center and another eVision.Legacy.EFrame object's center.
eVision.EPoint	Rotate (self, float angle)
	Returns another eVision.EPoint object containing the coordinates of the rotated center point.
float	Square (self)
	Compute the sum of the squared coordinates of the center of a eVision.Legacy.EFrame.
float	Modulus (self)
	Compute the euclidean modulus of the center of a eVision.Legacy.EFrame.
float	Argument (self)
	Compute the polar argument of the center of eVision.Legacy.EFrame object.
float	Dot (self, eVision.EPoint Point)
	Compute the dot product of the centers of two eVision.Legacy.EFrame objects.
float	Cross (self, eVision.EPoint Point)
	Compute the cross product of the centers of two eVision.Legacy.EFrame objects.
float	Area (self, eVision.EPoint Point)
	Compute the oriented area of the parallelogram built on the centers of two eVision.Legacy.EFrame.
eVision.EPoint	Project (self, eVision.Legacy.ELine shape)
	Compute the orthogonal projection of the center of a eVision.Legacy.EFrame on another shape.
eVision.EPoint	Project (self, eVision.Legacy.ECircle shape)
	Compute the orthogonal projection of the center of a eVision.Legacy.EFrame on another shape.
float	SquaredDistance (self, eVision.EPoint Point)
	Compute the squared distance between the centers of two eVision.Legacy.EFrame.
eVision.EPoint	Move (self, float angle, float distance)
	Return the position by moving the center along angle by distance.
float	Angle (self)
	Orientation of the frame.
	Angle (self, float value)
	Orientation of the frame.
float	Scale (self)
	Horizontal sensor resolution, in pixels per unit.
	Scale (self, float value)
	Horizontal sensor resolution, in pixels per unit.
float	CenterX (self)
	Abscissa of the origin point of the frame.
float	CenterY (self)
	Ordinate of the origin point of the frame.
eVision.EPoint	Center (self)
	Center.
	Center (self, eVision.EPoint value)
	Center.
float	X (self)
	Abscissa (X coordinate) of the eVision.Legacy.EFrame object.
	X (self, float value)
	Abscissa (X coordinate) of the eVision.Legacy.EFrame object.
float	Y (self)
	Ordinate (Y coordinate) of the eVision.Legacy.EFrame object.
	Y (self, float value)
	Ordinate (Y coordinate) of the eVision.Legacy.EFrame object.

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

Protected Member Functions
	_DirectInternal__setter (self, bool value)

Properties
	DirectInternal

Detailed Description

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

Remarks:

License(s): BasicTypes

Constructor & Destructor Documentation

◆ init() [1/10]

None eVision.Legacy.ECircle.__init__ ( self )

Constructs a eVision.Legacy.ECircle object.

◆ init() [2/10]

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

Constructs a eVision.Legacy.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/10]

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

Constructs a eVision.Legacy.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/10]

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

Constructs a eVision.Legacy.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/10]

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

Constructs a eVision.Legacy.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/10]

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

Constructs a eVision.Legacy.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/10]

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

Constructs a eVision.Legacy.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/10]

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

Constructs a eVision.Legacy.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/10]

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

Constructs a eVision.Legacy.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/10]

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

Constructs a eVision.Legacy.ECircle object.

Parameters

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

Member Function Documentation

◆ _DirectInternal__setter()

eVision.Legacy.ECircle._DirectInternal__setter	(		self,
		bool	value )

protected

◆ Amplitude() [1/2]

float eVision.Legacy.ECircle.Amplitude ( self )

Angular amplitude of the eVision.Legacy.ECircle object.

Remarks:

The default value is 360. A eVision.Legacy.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.Legacy.ECircle.Amplitude	(		self,
		float	value )

Angular amplitude of the eVision.Legacy.ECircle object.

Remarks:

The default value is 360. A eVision.Legacy.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.

◆ Apex()

eVision.EPoint eVision.Legacy.ECircle.Apex ( self )

Apex point coordinates of a eVision.Legacy.ECircle object.

◆ ApexAngle()

float eVision.Legacy.ECircle.ApexAngle ( self )

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

Remarks:

A eVision.Legacy.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.Legacy.ECircle.ArcLength ( self )

Circle arc length of a eVision.Legacy.ECircle object.

Remarks:

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

◆ CopyTo()

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

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

Remarks:

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

Parameters

other eVision.Legacy.ECircle object in which the current eVision.Legacy.ECircle object data have to be copied.

Reimplemented from eVision.Legacy.EFrame.

◆ Diameter() [1/2]

float eVision.Legacy.ECircle.Diameter ( self )

Diameter of a eVision.Legacy.ECircle object.

Remarks:

A eVision.Legacy.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.Legacy.ECircle.Diameter	(		self,
		float	value )

Diameter of a eVision.Legacy.ECircle object.

Remarks:

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

◆ Direct()

bool eVision.Legacy.ECircle.Direct ( 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.

◆ Distance()

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

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

Parameters

circle The other circle

Reimplemented from eVision.Legacy.EFrame.

◆ End()

eVision.EPoint eVision.Legacy.ECircle.End ( self )

End point coordinates of a eVision.Legacy.ECircle object.

◆ EndAngle()

float eVision.Legacy.ECircle.EndAngle ( self )

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

Remarks:

A eVision.Legacy.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.Legacy.ECircle eVision.Legacy.ECircle.Fit ( list[eVision._eVision.EPoint] points )

static

Fits an eVision.Legacy.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.Legacy.ECircle, see eVision.Legacy.ECircle.Direct.

Parameters

points Vector of points to fit.

◆ Fit() [2/4]

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

static

Fits an eVision.Legacy.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.Legacy.ECircle, see eVision.Legacy.ECircle.Direct.

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.Legacy.ECircle eVision.Legacy.ECircle.Fit	(	list[eVision._eVision.EPoint]	points,
		bool	fitArc,
		int	numFilteringPasses )

static

Fits an eVision.Legacy.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.Legacy.ECircle, see eVision.Legacy.ECircle.Direct.

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.Legacy.ECircle eVision.Legacy.ECircle.Fit	(	list[eVision._eVision.EPoint]	points,
		bool	fitArc,
		int	numFilteringPasses,
		float	filteringThreshold )

static

Fits an eVision.Legacy.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.Legacy.ECircle, see eVision.Legacy.ECircle.Direct.

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.Legacy.ECircle.Full ( self )

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

Remarks:

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

◆ GetDistanceBetweenLineAndCircle() [1/2]

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

static

Computes the distance between a line and a circle.

Parameters

line	The line.
circle	The circle.

◆ GetDistanceBetweenLineAndCircle() [2/2]

float eVision.Legacy.ECircle.GetDistanceBetweenLineAndCircle	(	eVision.Legacy.ELine	line,
		eVision.Legacy.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.Legacy.ECircle.GetDistanceBetweenPointAndCircle	(	eVision.EPoint	pt,
		eVision.Legacy.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.Legacy.ECircle.GetDistanceBetweenPointAndCircle	(	eVision.EPoint	pt,
		eVision.Legacy.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.Legacy.ECircle.GetIntersectionOfCircles	(	eVision.Legacy.ECircle	circle1,
		eVision.Legacy.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.Legacy.ECircle.GetIntersectionOfCircles	(	eVision.Legacy.ECircle	circle1,
		eVision.Legacy.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.Legacy.ECircle.GetIntersectionOfLineAndCircle	(	eVision.Legacy.ELine	line,
		eVision.Legacy.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.Legacy.ECircle.GetIntersectionOfLineAndCircle	(	eVision.Legacy.ELine	line,
		eVision.Legacy.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.Legacy.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.Legacy.ECircle.GetProjectionOfPointOnCircle	(	eVision.EPoint	pt,
		eVision.Legacy.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.Legacy.ECircle.GetProjectionOfPointOnCircle	(	eVision.EPoint	pt,
		eVision.Legacy.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.

◆ Org()

eVision.EPoint eVision.Legacy.ECircle.Org ( self )

Origin point coordinates of a eVision.Legacy.ECircle object.

◆ OrgAngle()

float eVision.Legacy.ECircle.OrgAngle ( self )

Angular position from where the eVision.Legacy.ECircle object extents.

Remarks:

A eVision.Legacy.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.Legacy.ECircle.Radius ( self )

Radius of a eVision.Legacy.ECircle object.

Remarks:

A eVision.Legacy.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.Legacy.ECircle.Radius	(		self,
		float	value )

Radius of a eVision.Legacy.ECircle object.

Remarks:

A eVision.Legacy.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.Legacy.ECircle.SetFromCenterAndOrigin	(		self,
		eVision.EPoint	center,
		eVision.EPoint	origin )

Sets the geometric parameters (nominal position and diameter, angular position and amplitude) of an eVision.Legacy.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.Legacy.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.Legacy.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.Legacy.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.Legacy.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.Legacy.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.Legacy.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.

Property Documentation

◆ DirectInternal

eVision.Legacy.ECircle.DirectInternal

static

Initial value:

=  property(None, _DirectInternal__setter, None,
        
    )

Public Member Functions

Static Public Member Functions

Protected Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ __init__() [1/10]

◆ __init__() [2/10]

◆ __init__() [3/10]

◆ __init__() [4/10]

◆ __init__() [5/10]

◆ __init__() [6/10]

◆ __init__() [7/10]

◆ __init__() [8/10]

◆ __init__() [9/10]

◆ __init__() [10/10]

Member Function Documentation

◆ _DirectInternal__setter()

◆ Amplitude() [1/2]

◆ Amplitude() [2/2]

◆ Apex()

◆ ApexAngle()

◆ ArcLength()

◆ CopyTo()

◆ Diameter() [1/2]

◆ Diameter() [2/2]

◆ Direct()

◆ 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]

◆ Org()

◆ OrgAngle()

◆ Radius() [1/2]

◆ Radius() [2/2]

◆ SetFromCenterAndOrigin() [1/2]

◆ SetFromCenterAndOrigin() [2/2]

◆ SetFromOriginMiddleEnd() [1/2]

◆ SetFromOriginMiddleEnd() [2/2]

Property Documentation

◆ DirectInternal

◆ init() [1/10]

◆ init() [2/10]

◆ init() [3/10]

◆ init() [4/10]

◆ init() [5/10]

◆ init() [6/10]

◆ init() [7/10]

◆ init() [8/10]

◆ init() [9/10]

◆ init() [10/10]