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

Inheritance diagram for eVision.ECircle:

[legend]

Collaboration diagram for eVision.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.ECircle other)
	Constructs a ECircle object.
	ECircle (eVision.Legacy.ECircle other)
	Constructs a ECircle object.
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.
bool	IsDirect ()
	Flag indicating whether positive angles correspond to a clockwise or an anticlockwise rotation.
float	Distance (eVision.ECircle circle)
	Returns the smallest distance between this ECircle object an another ECircle.
Public Member Functions inherited from eVision.EShape
void	Load (string path)
	Load the EShape configuration. The given ESerializer must have been created for reading.
void	Load (eVision.ESerializer serializer)
	Load the EShape configuration. The given ESerializer must have been created for reading.
void	Save (string path)
	Save the EShape configuration. The given ESerializer must have been created for writing.
void	Save (eVision.ESerializer serializer)
	Save the EShape configuration. The given ESerializer must have been created for writing.
void	Draw (eVision.EDrawAdapter drawAdapter, float zoomX, float zoomY, float panX, float panY, bool drawDiagonals)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, float zoomX, float zoomY, float panX, float panY)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, float zoomX, float zoomY, float panX)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, float zoomX, float zoomY)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, float zoomX)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY, bool drawDiagonals)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, eVision.EFrame frame, float zoomX, float zoomY)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, eVision.EFrame frame, float zoomX)
	Draws the EShape shape.
void	Draw (eVision.EDrawAdapter drawAdapter, eVision.EFrame frame)
	Draws the EShape shape.
eVision.EEditionMode	HitTest (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 (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 (int x, int y, float zoomX, float zoomY)
	Detects if the cursor is placed over one of the dragging handles.
eVision.EEditionMode	HitTest (int x, int y, float zoomX)
	Detects if the cursor is placed over one of the dragging handles.
eVision.EEditionMode	HitTest (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 (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 (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 (int x, int y, eVision.EFrame frame, float zoomX)
	Detects if the cursor is placed over one of the dragging handles.
void	Drag (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.
void	Drag (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.
void	Drag (int x, int y, float zoomX, float zoomY)
	Moves the specified handle to a new position and updates all placement parameters of the region.
void	Drag (int x, int y, float zoomX)
	Moves the specified handle to a new position and updates all placement parameters of the region.
void	Drag (int x, int y)
	Moves the specified handle to a new position and updates all placement parameters of the region.
void	Drag (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.
void	Drag (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.
void	Drag (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.
void	Drag (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.
void	Drag (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 (bool useAngle, eVision.EFrameScaling frameScaling)
	Converts the shape to a frame.
eVision.EFrame	ToFrame (bool useAngle, eVision.EFrameScaling frameScaling, eVision.EFrame shapeFrame)
	Converts the shape to a frame.

Static Public Member Functions
static eVision.EPoint	GetProjectionOfPointOnCircle (eVision.EPoint pt, eVision.ECircle circle, bool limited)
	Computes the projection of a point on a circle.
static eVision.EPoint	GetProjectionOfPointOnCircle (eVision.EPoint pt, eVision.ECircle circle)
	Computes the projection of a point on a circle.
static float	GetDistanceBetweenPointAndCircle (eVision.EPoint pt, eVision.ECircle circle, bool limited)
	Computes the distance between a point and a circle.
static float	GetDistanceBetweenPointAndCircle (eVision.EPoint pt, eVision.ECircle circle)
	Computes the distance between a point and a circle.
static float	GetDistanceBetweenLineAndCircle (eVision.ELine line, eVision.ECircle circle, bool limited)
	Computes the distance between a line and a circle.
static float	GetDistanceBetweenLineAndCircle (eVision.ELine line, eVision.ECircle circle)
	Computes the distance between a line and a circle.
static int	GetIntersectionOfLineAndCircle (eVision.ELine line, eVision.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.ELine line, eVision.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.ECircle circle1, eVision.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.ECircle circle1, eVision.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.ECircle	Fit (eVision.EPoint[] points, bool fitArc, uint numFilteringPasses, float filteringThreshold)
	Fits an ECircle to a set of points.
static eVision.ECircle	Fit (eVision.EPoint[] points, bool fitArc, uint numFilteringPasses)
	Fits an ECircle to a set of points.
static eVision.ECircle	Fit (eVision.EPoint[] points, bool fitArc)
	Fits an ECircle to a set of points.
static eVision.ECircle	Fit (eVision.EPoint[] points)
	Fits an ECircle to a set of points.

Properties
eVision.EPoint	Center `[get, set]`
	Center of the ECircle.
float	CenterX `[get, set]`
	Abscissa of the center of the ECircle.
float	CenterY `[get, set]`
	Ordinate of the the center of the ECircle.
float	Angle `[get, set]`
	Starting orientation of the ECircle.
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.
float	Amplitude `[get, set]`
	Angular amplitude of the ECircle object.
override eVision.EEditionMode	AvailableEditionModes `[get]`
	Available edition modes for the shape.
override string	Description `[get]`
	Textual description of the shape and its parameters.
Properties inherited from eVision.EShape
eVision.EEditionMode	EditionMode `[get, set]`
	Current edition mode for the shape. Default: EEditionMode_None.
eVision.EEditionMode	AvailableEditionModes `[get]`
	Available edition modes for the shape.
string	Description `[get]`
	Textual description of the shape and its parameters.

Detailed Description

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

License(s): BasicTypes

Constructor & Destructor Documentation

◆ ECircle() [1/11]

eVision.ECircle.ECircle ( )

Constructs a ECircle object.

◆ ECircle() [2/11]

eVision.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/11]

eVision.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/11]

eVision.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/11]

eVision.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/11]

eVision.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/11]

eVision.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/11]

eVision.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/11]

eVision.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/11]

eVision.ECircle.ECircle ( eVision.ECircle other )

Constructs a ECircle object.

Parameters

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

◆ ECircle() [11/11]

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

◆ Distance()

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

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

Parameters

circle The other circle

◆ Fit() [1/4]

eVision.ECircle eVision.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.IsDirect.

◆ Fit() [2/4]

eVision.ECircle eVision.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.IsDirect.

◆ Fit() [3/4]

eVision.ECircle eVision.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.IsDirect.

◆ Fit() [4/4]

eVision.ECircle eVision.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.IsDirect.

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

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

◆ IsDirect()

bool eVision.ECircle.IsDirect ( )

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.

◆ SetFromCenterAndOrigin() [1/2]

void eVision.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.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.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.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.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.

◆ Angle

float eVision.ECircle.Angle

getset

Starting orientation of the ECircle.

◆ Apex

eVision.EPoint eVision.ECircle.Apex

get

Apex point coordinates of a ECircle object.

◆ ApexAngle

float eVision.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.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.

◆ AvailableEditionModes

override eVision.EEditionMode eVision.ECircle.AvailableEditionModes

get

Available edition modes for the shape.

◆ Center

eVision.EPoint eVision.ECircle.Center

getset

Center of the ECircle.

◆ CenterX

float eVision.ECircle.CenterX

getset

Abscissa of the center of the ECircle.

◆ CenterY

float eVision.ECircle.CenterY

getset

Ordinate of the the center of the ECircle.

◆ Description

override string eVision.ECircle.Description

get

Textual description of the shape and its parameters.

◆ Diameter

float eVision.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.

◆ End

eVision.EPoint eVision.ECircle.End

get

End point coordinates of a ECircle object.

◆ EndAngle

float eVision.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.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.ECircle.Org

get

Origin point coordinates of a ECircle object.

◆ OrgAngle

float eVision.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.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/11]

◆ ECircle() [2/11]

◆ ECircle() [3/11]

◆ ECircle() [4/11]

◆ ECircle() [5/11]

◆ ECircle() [6/11]

◆ ECircle() [7/11]

◆ ECircle() [8/11]

◆ ECircle() [9/11]

◆ ECircle() [10/11]

◆ ECircle() [11/11]

Member Function Documentation

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

◆ IsDirect()

◆ SetFromCenterAndOrigin() [1/2]

◆ SetFromCenterAndOrigin() [2/2]

◆ SetFromOriginMiddleEnd() [1/2]

◆ SetFromOriginMiddleEnd() [2/2]

Property Documentation

◆ Amplitude

◆ Angle

◆ Apex

◆ ApexAngle

◆ ArcLength

◆ AvailableEditionModes

◆ Center

◆ CenterX

◆ CenterY

◆ Description

◆ Diameter

◆ End

◆ EndAngle

◆ Full

◆ Org

◆ OrgAngle

◆ Radius