QGIS API Documentation  3.21.0-Master (5b68dc587e)
Public Member Functions | List of all members
QgsLineSegment2D Class Reference

Represents a single 2D line segment, consisting of a 2D start and end vertex only. More...

#include <qgslinesegment.h>

Public Member Functions

 QgsLineSegment2D (const QgsPointXY &start, const QgsPointXY &end) SIP_HOLDGIL
 Constructor for a QgsLineSegment2D from the specified start point to the end point. More...
 
 QgsLineSegment2D (double x1, double y1, double x2, double y2) SIP_HOLDGIL
 Constructor for a QgsLineSegment2D from the point (x1, y2) to (x2, y2). More...
 
QgsPointXY end () const SIP_HOLDGIL
 Returns the segment's end point. More...
 
double endX () const SIP_HOLDGIL
 Returns the segment's end x-coordinate. More...
 
double endY () const SIP_HOLDGIL
 Returns the segment's end y-coordinate. More...
 
double length () const SIP_HOLDGIL
 Returns the length of the segment. More...
 
double lengthSquared () const SIP_HOLDGIL
 Returns the squared length of the segment. More...
 
bool operator!= (const QgsLineSegment2D &other) const SIP_HOLDGIL
 Inequality operator. More...
 
bool operator== (const QgsLineSegment2D &other) const SIP_HOLDGIL
 Equality operator. More...
 
int pointLeftOfLine (const QgsPointXY &point) const SIP_HOLDGIL
 Tests if a point is to the left of the line segment. More...
 
void reverse () SIP_HOLDGIL
 Reverses the line segment, so that the start and end points are flipped. More...
 
void setEnd (const QgsPointXY &end) SIP_HOLDGIL
 Sets the segment's end point. More...
 
void setEndX (double x) SIP_HOLDGIL
 Sets the segment's end x coordinate. More...
 
void setEndY (double y) SIP_HOLDGIL
 Sets the segment's end y coordinate. More...
 
void setStart (const QgsPointXY &start) SIP_HOLDGIL
 Sets the segment's start point. More...
 
void setStartX (double x) SIP_HOLDGIL
 Sets the segment's start x coordinate. More...
 
void setStartY (double y) SIP_HOLDGIL
 Sets the segment's start y coordinate. More...
 
QgsPointXY start () const SIP_HOLDGIL
 Returns the segment's start point. More...
 
double startX () const SIP_HOLDGIL
 Returns the segment's start x-coordinate. More...
 
double startY () const SIP_HOLDGIL
 Returns the segment's start y-coordinate. More...
 

Detailed Description

Represents a single 2D line segment, consisting of a 2D start and end vertex only.

Since
QGIS 3.2

Definition at line 31 of file qgslinesegment.h.

Constructor & Destructor Documentation

◆ QgsLineSegment2D() [1/2]

QgsLineSegment2D::QgsLineSegment2D ( const QgsPointXY start,
const QgsPointXY end 
)
inline

Constructor for a QgsLineSegment2D from the specified start point to the end point.

Definition at line 40 of file qgslinesegment.h.

◆ QgsLineSegment2D() [2/2]

QgsLineSegment2D::QgsLineSegment2D ( double  x1,
double  y1,
double  x2,
double  y2 
)
inline

Constructor for a QgsLineSegment2D from the point (x1, y2) to (x2, y2).

Definition at line 49 of file qgslinesegment.h.

Member Function Documentation

◆ end()

QgsPointXY QgsLineSegment2D::end ( ) const
inline

Returns the segment's end point.

See also
start()
endX()
endY()

Definition at line 129 of file qgslinesegment.h.

◆ endX()

double QgsLineSegment2D::endX ( ) const
inline

Returns the segment's end x-coordinate.

See also
end()
endY()

Definition at line 97 of file qgslinesegment.h.

◆ endY()

double QgsLineSegment2D::endY ( ) const
inline

Returns the segment's end y-coordinate.

See also
end()
endX()

Definition at line 107 of file qgslinesegment.h.

◆ length()

double QgsLineSegment2D::length ( ) const
inline

Returns the length of the segment.

See also
lengthSquared()

Definition at line 58 of file qgslinesegment.h.

◆ lengthSquared()

double QgsLineSegment2D::lengthSquared ( ) const
inline

Returns the squared length of the segment.

See also
length()

Definition at line 67 of file qgslinesegment.h.

◆ operator!=()

bool QgsLineSegment2D::operator!= ( const QgsLineSegment2D other) const
inline

Inequality operator.

Definition at line 230 of file qgslinesegment.h.

◆ operator==()

bool QgsLineSegment2D::operator== ( const QgsLineSegment2D other) const
inline

Equality operator.

Definition at line 224 of file qgslinesegment.h.

◆ pointLeftOfLine()

int QgsLineSegment2D::pointLeftOfLine ( const QgsPointXY point) const

Tests if a point is to the left of the line segment.

Returns -1 if the point falls to the left of the line, or +1 if the point is to the right.

If the return value is 0, then the test was unsuccessful (e.g. due to testing a point exactly on the line, or exactly in line with the segment) and the result is undefined.

See also
QgsGeometryUtils::leftOfLine()

Definition at line 21 of file qgslinesegment.cpp.

◆ reverse()

void QgsLineSegment2D::reverse ( )
inline

Reverses the line segment, so that the start and end points are flipped.

Definition at line 216 of file qgslinesegment.h.

◆ setEnd()

void QgsLineSegment2D::setEnd ( const QgsPointXY end)
inline

Sets the segment's end point.

See also
setEndX()
setEndY()
setStart()

Definition at line 195 of file qgslinesegment.h.

◆ setEndX()

void QgsLineSegment2D::setEndX ( double  x)
inline

Sets the segment's end x coordinate.

See also
setStartX()
setEnd()
setEndY()

Definition at line 162 of file qgslinesegment.h.

◆ setEndY()

void QgsLineSegment2D::setEndY ( double  y)
inline

Sets the segment's end y coordinate.

See also
setStartY()
setEnd()
setEndX()

Definition at line 173 of file qgslinesegment.h.

◆ setStart()

void QgsLineSegment2D::setStart ( const QgsPointXY start)
inline

Sets the segment's start point.

See also
setStartX()
setStartY()
setEnd()

Definition at line 184 of file qgslinesegment.h.

◆ setStartX()

void QgsLineSegment2D::setStartX ( double  x)
inline

Sets the segment's start x coordinate.

See also
setEndX()
setStart()
setStartY()

Definition at line 140 of file qgslinesegment.h.

◆ setStartY()

void QgsLineSegment2D::setStartY ( double  y)
inline

Sets the segment's start y coordinate.

See also
setEndY()
setStart()
setStartX()

Definition at line 151 of file qgslinesegment.h.

◆ start()

QgsPointXY QgsLineSegment2D::start ( ) const
inline

Returns the segment's start point.

See also
end()
startX()
startY()

Definition at line 118 of file qgslinesegment.h.

◆ startX()

double QgsLineSegment2D::startX ( ) const
inline

Returns the segment's start x-coordinate.

See also
start()
startY()

Definition at line 77 of file qgslinesegment.h.

◆ startY()

double QgsLineSegment2D::startY ( ) const
inline

Returns the segment's start y-coordinate.

See also
start()
startX()

Definition at line 87 of file qgslinesegment.h.


The documentation for this class was generated from the following files: