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

Inheritance diagram for eVision.Legacy.ECircle:

[legend]

Collaboration diagram for eVision.Legacy.ECircle:

[legend]

Public Member Functions
	ECircle ()
	Constructs a ECircle object.
	ECircle (eVision.EPoint center, float diameter, float originAngle, bool direct)
	Constructs a ECircle object.
	ECircle (eVision.EPoint center, float diameter, float originAngle)
	Constructs a ECircle object.
	ECircle (eVision.EPoint center, float diameter)
	Constructs a ECircle object.
	ECircle (eVision.EPoint center, eVision.EPoint origin, bool direct)
	Constructs a ECircle object.
	ECircle (eVision.EPoint center, eVision.EPoint origin)
	Constructs a ECircle object.
	ECircle (eVision.EPoint center, float diameter, float originAngle, float amplitude)
	Constructs a ECircle object.
	ECircle (eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end, bool fullCircle)
	Constructs a ECircle object.
	ECircle (eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end)
	Constructs a ECircle object.
	ECircle (eVision.Legacy.ECircle other)
	Constructs a ECircle object.
void	CopyTo (eVision.Legacy.ECircle other)
	Copies all the data of the current ECircle object into another ECircle object and returns it.
void	SetFromCenterAndOrigin (eVision.EPoint center, eVision.EPoint origin, bool direct)
	Sets the geometric parameters (nominal position and diameter, angular position and amplitude) of an ECircle object.
void	SetFromCenterAndOrigin (eVision.EPoint center, eVision.EPoint origin)
	Sets the geometric parameters (nominal position and diameter, angular position and amplitude) of an ECircle object.
void	SetFromOriginMiddleEnd (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 ECircle object.
void	SetFromOriginMiddleEnd (eVision.EPoint origin, eVision.EPoint middle, eVision.EPoint end)
	Sets the geometric parameters (nominal position and diameter, angular position and amplitude) of an ECircle object.
eVision.EPoint	GetPoint (float fraction)
	Returns the coordinates of a particular point specified by its location along the circle arc.
override float	Distance (eVision.Legacy.ECircle circle)
	Returns the smallest distance between this ECircle object an another ECircle.
Public Member Functions inherited from eVision.Legacy.EFrame
	EFrame ()
	Constructs a EFrame object.
	EFrame (float centerX, float centerY, float angle, float scale)
	Constructs a EFrame object.
	EFrame (float centerX, float centerY, float angle)
	Constructs a EFrame object.
	EFrame (float centerX, float centerY)
	Constructs a EFrame object.
	EFrame (eVision.EPoint center, float angle, float scale)
	Constructs a EFrame object.
	EFrame (eVision.Legacy.EFrame frame)
	Constructs a EFrame object.
void	CopyTo (eVision.Legacy.EFrame other)
	Copies all the data from the current EFrame object into another EFrame object, and returns it.
eVision.EPoint	LocalToGlobal (eVision.EPoint local)
	Transforms a geometrical element from local to global coordinates (local to world).
eVision.Legacy.EFrame	LocalToGlobal (eVision.Legacy.EFrame local)
	Transforms a geometrical element from local to global coordinates (local to world).
eVision.Legacy.ELine	LocalToGlobal (eVision.Legacy.ELine local)
	Transforms a geometrical element from local to global coordinates (local to world).
eVision.Legacy.ECircle	LocalToGlobal (eVision.Legacy.ECircle local)
	Transforms a geometrical element from local to global coordinates (local to world).
eVision.EPoint	GlobalToLocal (eVision.EPoint global)
	Transforms a geometrical element from global to local coordinates (world to local).
eVision.Legacy.EFrame	GlobalToLocal (eVision.Legacy.EFrame global)
	Transforms a geometrical element from global to local coordinates (world to local).
void	Load (string path)
	Load the EFrame configuration. The given ESerializer must have been created for reading.
void	Load (eVision.ESerializer serializer)
	Load the EFrame configuration. The given ESerializer must have been created for reading.
void	Save (string path)
	Save the EFrame configuration. The given ESerializer must have been created for writing.
void	Save (eVision.ESerializer serializer)
	Save the EFrame configuration. The given ESerializer must have been created for writing.
void	SetCenterXY (float centerX, float centerY)
	Sets the center coordinates of a EFrame object.
eVision.EPoint	MidPoint (eVision.EPoint Point)
	Returns the middle coordinate between this EFrame object's center and another EFrame object's center.
eVision.EPoint	Rotate (float angle)
	Returns another EPoint object containing the coordinates of the rotated center point.
float	Square ()
	Compute the sum of the squared coordinates of the center of a EFrame.
float	Modulus ()
	Compute the euclidean modulus of the center of a EFrame.
float	Argument ()
	Compute the polar argument of the center of EFrame object.
float	Dot (eVision.EPoint Point)
	Compute the dot product of the centers of two EFrame objects.
float	Cross (eVision.EPoint Point)
	Compute the cross product of the centers of two EFrame objects.
float	Area (eVision.EPoint Point)
	Compute the oriented area of the parallelogram built on the centers of two EFrame.
eVision.EPoint	Project (eVision.Legacy.ELine shape)
	Compute the orthogonal projection of the center of a EFrame on another shape.
eVision.EPoint	Project (eVision.Legacy.ECircle shape)
	Compute the orthogonal projection of the center of a EFrame on another shape.
float	SquaredDistance (eVision.EPoint Point)
	Compute the squared distance between the centers of two EFrame.
eVision.EPoint	Move (float angle, float distance)
	Return the position by moving the center along angle by distance.
virtual float	Distance (eVision.EPoint point)
	Returns the distance between the addressed point and the center of EFrame object.
virtual float	Distance (eVision.Legacy.ELine line, bool segmentOnly)
	Returns the distance between the addressed point and the center of EFrame object.
virtual float	Distance (eVision.Legacy.ELine line)
	Returns the distance between the addressed point and the center of EFrame object.
virtual float	Distance (eVision.Legacy.ECircle circle, bool arcOnly)
	Returns the distance between the addressed point and the center of EFrame object.

Static Public Member Functions
static eVision.EPoint	GetProjectionOfPointOnCircle (eVision.EPoint pt, eVision.Legacy.ECircle circle, bool limited)
	Computes the projection of a point on a circle.
static eVision.EPoint	GetProjectionOfPointOnCircle (eVision.EPoint pt, eVision.Legacy.ECircle circle)
	Computes the projection of a point on a circle.
static float	GetDistanceBetweenPointAndCircle (eVision.EPoint pt, eVision.Legacy.ECircle circle, bool limited)
	Computes the distance between a point and a circle.
static float	GetDistanceBetweenPointAndCircle (eVision.EPoint pt, eVision.Legacy.ECircle circle)
	Computes the distance between a point and a circle.
static float	GetDistanceBetweenLineAndCircle (eVision.Legacy.ELine line, eVision.Legacy.ECircle circle, bool limited)
	Computes the distance between a line and a circle.
static float	GetDistanceBetweenLineAndCircle (eVision.Legacy.ELine line, eVision.Legacy.ECircle circle)
	Computes the distance between a line and a circle.
static int	GetIntersectionOfLineAndCircle (eVision.Legacy.ELine line, eVision.Legacy.ECircle circle, ref eVision.EPoint intersection1, ref eVision.EPoint intersection2, bool limited)
	Computes the intersections between a line and circle. Returns the number of intersections and stores the found intersections in the provided point parameters.
static int	GetIntersectionOfLineAndCircle (eVision.Legacy.ELine line, eVision.Legacy.ECircle circle, ref eVision.EPoint intersection1, ref eVision.EPoint intersection2)
	Computes the intersections between a line and circle. Returns the number of intersections and stores the found intersections in the provided point parameters.
static int	GetIntersectionOfCircles (eVision.Legacy.ECircle circle1, eVision.Legacy.ECircle circle2, ref eVision.EPoint intersection1, ref eVision.EPoint intersection2, bool limited)
	Computes the intersections between two circles. Returns the number of intersections and stores the found intersections in the provided point parameters.
static int	GetIntersectionOfCircles (eVision.Legacy.ECircle circle1, eVision.Legacy.ECircle circle2, ref eVision.EPoint intersection1, ref eVision.EPoint intersection2)
	Computes the intersections between two circles. Returns the number of intersections and stores the found intersections in the provided point parameters.
static eVision.Legacy.ECircle	Fit (eVision.EPoint[] points, bool fitArc, uint numFilteringPasses, float filteringThreshold)
	Fits an ECircle to a set of points.
static eVision.Legacy.ECircle	Fit (eVision.EPoint[] points, bool fitArc, uint numFilteringPasses)
	Fits an ECircle to a set of points.
static eVision.Legacy.ECircle	Fit (eVision.EPoint[] points, bool fitArc)
	Fits an ECircle to a set of points.
static eVision.Legacy.ECircle	Fit (eVision.EPoint[] points)
	Fits an ECircle to a set of points.
Static Public Member Functions inherited from eVision.Legacy.EFrame
static eVision.EPoint	operator+ (eVision.Legacy.EFrame extraArgument, eVision.EPoint point)
	Returns the addition of the point to the center of the EFrame.
static eVision.EPoint	operator- (eVision.Legacy.EFrame extraArgument, eVision.EPoint point)
	Returns the substraction of the center of the EFrame with the given point.
static eVision.EPoint	operator* (eVision.Legacy.EFrame extraArgument, float scalar)
	Returns the multiplication of the center of the EFrame with the given multiplier.
static eVision.EPoint	operator/ (eVision.Legacy.EFrame extraArgument, float scalar)
	Returns the division of the center of the EFrame with the given divisor.

Properties
float	Radius `[get, set]`
	Radius of a ECircle object.
float	Diameter `[get, set]`
	Diameter of a ECircle object.
float	ArcLength `[get]`
	Circle arc length of a ECircle object.
float	OrgAngle `[get]`
	Angular position from where the ECircle object extents.
float	ApexAngle `[get]`
	Angular position at the apex of a ECircle object.
float	EndAngle `[get]`
	Angular position of the end of a ECircle object.
eVision.EPoint	Org `[get]`
	Origin point coordinates of a ECircle object.
eVision.EPoint	Apex `[get]`
	Apex point coordinates of a ECircle object.
eVision.EPoint	End `[get]`
	End point coordinates of a ECircle object.
bool	Full `[get]`
	Flag indicating whether the ECircle object is a full circle or not.
bool	Direct `[get]`
	Flag indicating whether positive angles correspond to a clockwise or an anticlockwise rotation.
bool	DirectInternal `[set]`
float	Amplitude `[get, set]`
	Angular amplitude of the ECircle object.
Properties inherited from eVision.Legacy.EFrame
float	Angle `[get, set]`
	Orientation of the frame.
float	Scale `[get, set]`
	Horizontal sensor resolution, in pixels per unit.
float	CenterX `[get]`
	Abscissa of the origin point of the frame.
float	CenterY `[get]`
	Ordinate of the origin point of the frame.
virtual eVision.EPoint	Center `[get, set]`
	Center.
float	X `[get, set]`
	Abscissa (X coordinate) of the EFrame object.
float	Y `[get, set]`
	Ordinate (Y coordinate) of the EFrame object.

Detailed Description

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

License(s): BasicTypes

Constructor & Destructor Documentation

◆ ECircle() [1/10]

eVision.Legacy.ECircle.ECircle ( )

Constructs a ECircle object.

◆ ECircle() [2/10]

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

Constructs a 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.

◆ ECircle() [3/10]

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

Constructs a 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.

◆ ECircle() [4/10]

eVision.Legacy.ECircle.ECircle	(	eVision.EPoint	center,
		float	diameter )

Constructs a 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.

◆ ECircle() [5/10]

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

Constructs a 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.

◆ ECircle() [6/10]

eVision.Legacy.ECircle.ECircle	(	eVision.EPoint	center,
		eVision.EPoint	origin )

Constructs a 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.

◆ ECircle() [7/10]

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

Constructs a 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.

◆ ECircle() [8/10]

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

Constructs a 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.

◆ ECircle() [9/10]

eVision.Legacy.ECircle.ECircle	(	eVision.EPoint	origin,
		eVision.EPoint	middle,
		eVision.EPoint	end )

Constructs a ECircle object.

Parameters

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

◆ ECircle() [10/10]

eVision.Legacy.ECircle.ECircle ( eVision.Legacy.ECircle other )

Constructs a ECircle object.

Parameters

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

Member Function Documentation

◆ CopyTo()

void eVision.Legacy.ECircle.CopyTo ( eVision.Legacy.ECircle other )

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

Parameters

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

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

◆ Distance()

override float eVision.Legacy.ECircle.Distance ( eVision.Legacy.ECircle circle )

virtual

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

Parameters

circle The other circle

Reimplemented from eVision.Legacy.EFrame.

◆ Fit() [1/4]

eVision.Legacy.ECircle eVision.Legacy.ECircle.Fit ( eVision.EPoint[] points )

static

Fits an ECircle to a set of points.

Parameters

points Vector of points to fit.

The algorithm used here is the same as the one used in 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" ECircle, see ECircle.Direct.

◆ Fit() [2/4]

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

static

Fits an ECircle to a set of points.

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.

The algorithm used here is the same as the one used in 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" ECircle, see ECircle.Direct.

◆ Fit() [3/4]

eVision.Legacy.ECircle eVision.Legacy.ECircle.Fit	(	eVision.EPoint[]	points,
		bool	fitArc,
		uint	numFilteringPasses )

static

Fits an ECircle to a set of points.

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

The algorithm used here is the same as the one used in 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" ECircle, see ECircle.Direct.

◆ Fit() [4/4]

eVision.Legacy.ECircle eVision.Legacy.ECircle.Fit	(	eVision.EPoint[]	points,
		bool	fitArc,
		uint	numFilteringPasses,
		float	filteringThreshold )

static

Fits an ECircle to a set of points.

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.

The algorithm used here is the same as the one used in 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" ECircle, see ECircle.Direct.

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

Parameters

pt	The point.
circle	The circle.

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.

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

Parameters

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

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.

◆ GetIntersectionOfCircles() [1/2]

int eVision.Legacy.ECircle.GetIntersectionOfCircles	(	eVision.Legacy.ECircle	circle1,
		eVision.Legacy.ECircle	circle2,
		ref eVision.EPoint	intersection1,
		ref 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.

Parameters

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

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

◆ GetIntersectionOfCircles() [2/2]

int eVision.Legacy.ECircle.GetIntersectionOfCircles	(	eVision.Legacy.ECircle	circle1,
		eVision.Legacy.ECircle	circle2,
		ref eVision.EPoint	intersection1,
		ref 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.

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.

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

◆ GetIntersectionOfLineAndCircle() [1/2]

int eVision.Legacy.ECircle.GetIntersectionOfLineAndCircle	(	eVision.Legacy.ELine	line,
		eVision.Legacy.ECircle	circle,
		ref eVision.EPoint	intersection1,
		ref 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.

Parameters

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

The function returns the number of intersections found.

◆ GetIntersectionOfLineAndCircle() [2/2]

int eVision.Legacy.ECircle.GetIntersectionOfLineAndCircle	(	eVision.Legacy.ELine	line,
		eVision.Legacy.ECircle	circle,
		ref eVision.EPoint	intersection1,
		ref 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.

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.

The function returns the number of intersections found.

◆ GetPoint()

eVision.EPoint eVision.Legacy.ECircle.GetPoint ( 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.

Parameters

pt	The point.
circle	The circle.

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.

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

Parameters

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

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.

◆ SetFromCenterAndOrigin() [1/2]

void eVision.Legacy.ECircle.SetFromCenterAndOrigin	(	eVision.EPoint	center,
		eVision.EPoint	origin )

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

void eVision.Legacy.ECircle.SetFromCenterAndOrigin	(	eVision.EPoint	center,
		eVision.EPoint	origin,
		bool	direct )

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

void eVision.Legacy.ECircle.SetFromOriginMiddleEnd	(	eVision.EPoint	origin,
		eVision.EPoint	middle,
		eVision.EPoint	end )

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

Parameters

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

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

◆ SetFromOriginMiddleEnd() [2/2]

void eVision.Legacy.ECircle.SetFromOriginMiddleEnd	(	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 ECircle object.

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.

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

Property Documentation

◆ Amplitude

float eVision.Legacy.ECircle.Amplitude

getset

Angular amplitude of the ECircle object.

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

get

Apex point coordinates of a ECircle object.

◆ ApexAngle

float eVision.Legacy.ECircle.ApexAngle

get

Angular position at the apex of a ECircle object.

A 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

get

Circle arc length of a ECircle object.

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

◆ Diameter

float eVision.Legacy.ECircle.Diameter

getset

Diameter of a ECircle object.

A 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

get

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

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.

◆ DirectInternal

bool eVision.Legacy.ECircle.DirectInternal

set

◆ End

eVision.EPoint eVision.Legacy.ECircle.End

get

End point coordinates of a ECircle object.

◆ EndAngle

float eVision.Legacy.ECircle.EndAngle

get

Angular position of the end of a ECircle object.

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

◆ Full

bool eVision.Legacy.ECircle.Full

get

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

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

◆ Org

eVision.EPoint eVision.Legacy.ECircle.Org

get

Origin point coordinates of a ECircle object.

◆ OrgAngle

float eVision.Legacy.ECircle.OrgAngle

get

Angular position from where the ECircle object extents.

A 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

float eVision.Legacy.ECircle.Radius

getset

Radius of a ECircle object.

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

Public Member Functions

Static Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ ECircle() [1/10]

◆ ECircle() [2/10]

◆ ECircle() [3/10]

◆ ECircle() [4/10]

◆ ECircle() [5/10]

◆ ECircle() [6/10]

◆ ECircle() [7/10]

◆ ECircle() [8/10]

◆ ECircle() [9/10]

◆ ECircle() [10/10]

Member Function Documentation

◆ CopyTo()

◆ Distance()

◆ Fit() [1/4]

◆ Fit() [2/4]

◆ Fit() [3/4]

◆ Fit() [4/4]

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

◆ SetFromCenterAndOrigin() [1/2]

◆ SetFromCenterAndOrigin() [2/2]

◆ SetFromOriginMiddleEnd() [1/2]

◆ SetFromOriginMiddleEnd() [2/2]

Property Documentation

◆ Amplitude

◆ Apex

◆ ApexAngle

◆ ArcLength

◆ Diameter

◆ Direct

◆ DirectInternal

◆ End

◆ EndAngle

◆ Full

◆ Org

◆ OrgAngle

◆ Radius