Class: QgsLineSegment2D

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

Added in version 3.2.

class qgis.core.QgsLineSegment2D[source]

Bases: object

__init__(start: QgsPointXY, end: QgsPointXY)

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

Parameters:
__init__(x1: float, y1: float, x2: float, y2: float)

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

Parameters:
  • x1 (float)

  • y1 (float)

  • x2 (float)

  • y2 (float)

__init__(a0: QgsLineSegment2D)
Parameters:

a0 (QgsLineSegment2D)

end(self) QgsPointXY[source]

Returns the segment’s end point.

See also

start()

See also

endX()

See also

endY()

Return type:

QgsPointXY

endX(self) float[source]

Returns the segment’s end x-coordinate.

See also

end()

See also

endY()

Return type:

float

endY(self) float[source]

Returns the segment’s end y-coordinate.

See also

end()

See also

endX()

Return type:

float

length(self) float[source]

Returns the length of the segment.

See also

lengthSquared()

Return type:

float

lengthSquared(self) float[source]

Returns the squared length of the segment.

See also

length()

Return type:

float

pointLeftOfLine(self, point: QgsPointXY) int[source]

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.

Parameters:

point (QgsPointXY)

Return type:

int

reverse(self)[source]

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

setEnd(self, end: QgsPointXY)[source]

Sets the segment’s end point.

See also

setEndX()

See also

setEndY()

See also

setStart()

Parameters:

end (QgsPointXY)

setEndX(self, x: float)[source]

Sets the segment’s end x coordinate.

See also

setStartX()

See also

setEnd()

See also

setEndY()

Parameters:

x (float)

setEndY(self, y: float)[source]

Sets the segment’s end y coordinate.

See also

setStartY()

See also

setEnd()

See also

setEndX()

Parameters:

y (float)

setStart(self, start: QgsPointXY)[source]

Sets the segment’s start point.

See also

setStartX()

See also

setStartY()

See also

setEnd()

Parameters:

start (QgsPointXY)

setStartX(self, x: float)[source]

Sets the segment’s start x coordinate.

See also

setEndX()

See also

setStart()

See also

setStartY()

Parameters:

x (float)

setStartY(self, y: float)[source]

Sets the segment’s start y coordinate.

See also

setEndY()

See also

setStart()

See also

setStartX()

Parameters:

y (float)

start(self) QgsPointXY[source]

Returns the segment’s start point.

See also

end()

See also

startX()

See also

startY()

Return type:

QgsPointXY

startX(self) float[source]

Returns the segment’s start x-coordinate.

See also

start()

See also

startY()

Return type:

float

startY(self) float[source]

Returns the segment’s start y-coordinate.

See also

start()

See also

startX()

Return type:

float