eVision .NET API
Loading...
Searching...
No Matches
eVision.Legacy.ELine Class Reference

Represents a model of a line segment. More...

Inheritance diagram for eVision.Legacy.ELine:
Collaboration diagram for eVision.Legacy.ELine:

Public Member Functions

 ELine ()
 Constructs a ELine object.
 ELine (eVision.EPoint center, float length, float angle)
 Constructs a ELine object.
 ELine (eVision.EPoint center, float length)
 Constructs a ELine object.
 ELine (eVision.EPoint origin, eVision.EPoint end)
 Constructs a ELine object.
 ELine (eVision.Legacy.ELine other)
 Constructs a ELine object.
void CopyTo (eVision.Legacy.ELine other)
 Copies all the data of the current ELine object into another ELine object and returns it.
void SetFromOriginAndEnd (eVision.EPoint origin, eVision.EPoint end)
 Sets the geometric parameters (center coordinates, length, and rotation angle) of a ELine object.
void SetFromTwoPoints (eVision.EPoint origin, eVision.EPoint end)
 Sets the geometric parameters (center coordinates, length, and rotation angle) of a ELine object.
eVision.EPoint GetPoint (float fraction)
 Returns the coordinates of a point along the line.
new void Load (string path)
 Load the ELine configuration. The given ESerializer must have been created for reading.
new void Load (eVision.ESerializer serializer)
 Load the ELine configuration. The given ESerializer must have been created for reading.
new void Save (string path)
 Save the ELine configuration. The given ESerializer must have been created for writing.
new void Save (eVision.ESerializer serializer)
 Save the ELine configuration. The given ESerializer must have been created for writing.
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.
virtual float Distance (eVision.Legacy.ECircle circle)
 Returns the distance between the addressed point and the center of EFrame object.

Static Public Member Functions

static float GetAngleBetweenLines (eVision.Legacy.ELine line1, eVision.Legacy.ELine line2)
 Computes the angle between two lines.
static float GetDistanceBetweenPointAndLine (eVision.EPoint pt, eVision.Legacy.ELine line, bool limited)
 Computes the distance between a point and a line.
static float GetDistanceBetweenPointAndLine (eVision.EPoint pt, eVision.Legacy.ELine line)
 Computes the distance between a point and a line.
static eVision.EPoint GetProjectionOfPointOnLine (eVision.EPoint pt, eVision.Legacy.ELine line, bool limited)
 Computes the projection of a point on a line.
static eVision.EPoint GetProjectionOfPointOnLine (eVision.EPoint pt, eVision.Legacy.ELine line)
 Computes the projection of a point on a line.
static int GetIntersectionOfLines (eVision.Legacy.ELine line1, eVision.Legacy.ELine line2, ref eVision.EPoint intersection, bool limited)
 Computes the intersection between two lines.
static int GetIntersectionOfLines (eVision.Legacy.ELine line1, eVision.Legacy.ELine line2, ref eVision.EPoint intersection)
 Computes the intersection between two lines.
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 Length [get, set]
 Length of the ELine object.
eVision.EPoint Org [get]
 Origin point coordinates of the ELine object.
eVision.EPoint End [get]
 End point coordinates of the ELine 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 line segment.

License(s): BasicTypes

Constructor & Destructor Documentation

◆ ELine() [1/5]

eVision.Legacy.ELine.ELine ( )

Constructs a ELine object.

◆ ELine() [2/5]

eVision.Legacy.ELine.ELine ( eVision.EPoint center,
float length,
float angle )

Constructs a ELine object.

Parameters
centerCenter coordinates of the line at its nominal position. The default value is (0,0).
lengthNominal length of the line. The default value is 100.
angleNominal rotation angle of the line. The default value is 0.

◆ ELine() [3/5]

eVision.Legacy.ELine.ELine ( eVision.EPoint center,
float length )

Constructs a ELine object.

Parameters
centerCenter coordinates of the line at its nominal position. The default value is (0,0).
lengthNominal length of the line. The default value is 100.

◆ ELine() [4/5]

eVision.Legacy.ELine.ELine ( eVision.EPoint origin,
eVision.EPoint end )

Constructs a ELine object.

Parameters
originOrigin point coordinates of the line.
endEnd point coordinates of the line.

◆ ELine() [5/5]

eVision.Legacy.ELine.ELine ( eVision.Legacy.ELine other)

Constructs a ELine object.

Parameters
otherAnother ELine object to be copied in the new ELine object.

Member Function Documentation

◆ CopyTo()

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

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

Parameters
otherELine object in which the current ELine object data have to be copied.

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

◆ GetAngleBetweenLines()

float eVision.Legacy.ELine.GetAngleBetweenLines ( eVision.Legacy.ELine line1,
eVision.Legacy.ELine line2 )
static

Computes the angle between two lines.

Parameters
line1First line
line2Second line

The angle returned by this function is signed in the trigonometric sense, meaning that angle(1,2) = -angle(2,1).

◆ GetDistanceBetweenPointAndLine() [1/2]

float eVision.Legacy.ELine.GetDistanceBetweenPointAndLine ( eVision.EPoint pt,
eVision.Legacy.ELine line )
static

Computes the distance between a point and a line.

Parameters
ptThe point.
lineThe line.

When the line is restricted to a segment and the orthogonal projection of the point onto the line falls outside this segment, the distance to the closest endpoint of the segment is returned instead.

◆ GetDistanceBetweenPointAndLine() [2/2]

float eVision.Legacy.ELine.GetDistanceBetweenPointAndLine ( eVision.EPoint pt,
eVision.Legacy.ELine line,
bool limited )
static

Computes the distance between a point and a line.

Parameters
ptThe point.
lineThe line.
limitedIndicates if the line parameter should be considered as an infinite line or as a segment.

When the line is restricted to a segment and the orthogonal projection of the point onto the line falls outside this segment, the distance to the closest endpoint of the segment is returned instead.

◆ GetIntersectionOfLines() [1/2]

int eVision.Legacy.ELine.GetIntersectionOfLines ( eVision.Legacy.ELine line1,
eVision.Legacy.ELine line2,
ref eVision.EPoint intersection )
static

Computes the intersection between two lines.

Parameters
line1First line.
line2Second line.
intersectionFound intersection.

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

◆ GetIntersectionOfLines() [2/2]

int eVision.Legacy.ELine.GetIntersectionOfLines ( eVision.Legacy.ELine line1,
eVision.Legacy.ELine line2,
ref eVision.EPoint intersection,
bool limited )
static

Computes the intersection between two lines.

Parameters
line1First line.
line2Second line.
intersectionFound intersection.
limitedIndicates if the line parameters should be considered as infinite lines or as a segments.

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

◆ GetPoint()

eVision.EPoint eVision.Legacy.ELine.GetPoint ( float fraction)

Returns the coordinates of a point along the line.

Parameters
fractionPoint location expressed as a fraction of the line length (range [-1, +1]).

◆ GetProjectionOfPointOnLine() [1/2]

eVision.EPoint eVision.Legacy.ELine.GetProjectionOfPointOnLine ( eVision.EPoint pt,
eVision.Legacy.ELine line )
static

Computes the projection of a point on a line.

Parameters
ptThe point.
lineThe line.

When the line is restricted to a segment and the orthogonal projection of the point onto the line falls outside this segment, the closest endpoint of the segment is returned instead.

◆ GetProjectionOfPointOnLine() [2/2]

eVision.EPoint eVision.Legacy.ELine.GetProjectionOfPointOnLine ( eVision.EPoint pt,
eVision.Legacy.ELine line,
bool limited )
static

Computes the projection of a point on a line.

Parameters
ptThe point.
lineThe line.
limitedIndicates if the line parameter should be considered as an infinite line or as a segment.

When the line is restricted to a segment and the orthogonal projection of the point onto the line falls outside this segment, the closest endpoint of the segment is returned instead.

◆ Load() [1/2]

new void eVision.Legacy.ELine.Load ( eVision.ESerializer serializer)

Load the ELine configuration. The given ESerializer must have been created for reading.

Parameters
serializerThe serializer.

◆ Load() [2/2]

new void eVision.Legacy.ELine.Load ( string path)

Load the ELine configuration. The given ESerializer must have been created for reading.

Parameters
pathThe file path.

◆ Save() [1/2]

new void eVision.Legacy.ELine.Save ( eVision.ESerializer serializer)

Save the ELine configuration. The given ESerializer must have been created for writing.

Parameters
serializerThe serializer.

◆ Save() [2/2]

new void eVision.Legacy.ELine.Save ( string path)

Save the ELine configuration. The given ESerializer must have been created for writing.

Parameters
pathThe file path.

◆ SetFromOriginAndEnd()

void eVision.Legacy.ELine.SetFromOriginAndEnd ( eVision.EPoint origin,
eVision.EPoint end )

Sets the geometric parameters (center coordinates, length, and rotation angle) of a ELine object.

Parameters
originOrigin point coordinates of the line.
endEnd point coordinates of the line.

◆ SetFromTwoPoints()

void eVision.Legacy.ELine.SetFromTwoPoints ( eVision.EPoint origin,
eVision.EPoint end )

Sets the geometric parameters (center coordinates, length, and rotation angle) of a ELine object.

Parameters
originOrigin point coordinates of the line.
endEnd point coordinates of the line.
Deprecated

Use ELine.SetFromOriginAndEnd.

Deprecated in version 25.10. Scheduled to be removed in version 27.6.

Property Documentation

◆ End

eVision.EPoint eVision.Legacy.ELine.End
get

End point coordinates of the ELine object.

◆ Length

float eVision.Legacy.ELine.Length
getset

Length of the ELine object.

By default, the length of the line 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.

◆ Org

eVision.EPoint eVision.Legacy.ELine.Org
get

Origin point coordinates of the ELine object.