class QLine

The QLine class provides a two-dimensional vector using integer precision. More

Synopsis

Methods

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

A QLine describes a finite length line (or a line segment) on a two-dimensional surface. The start and end points of the line are specified using integer point accuracy for coordinates. Use the QLineF constructor to retrieve a floating point copy.

qline-point1

qline-coordinates2

The positions of the line’s start and end points can be retrieved using the p1() , x1() , y1() , p2() , x2() , and y2() functions. The dx() and dy() functions return the horizontal and vertical components of the line. Use isNull() to determine whether the QLine represents a valid line or a null line.

Finally, the line can be translated a given offset using the translate() function.

See also

QLineF QRect

__init__()

Constructs a null line.

__init__(pt1, pt2)
Parameters:

Constructs a line object that represents the line between p1 and p2.

__init__(x1, y1, x2, y2)
Parameters:
  • x1 – int

  • y1 – int

  • x2 – int

  • y2 – int

Constructs a line object that represents the line between (x1, y1) and (x2, y2).

__reduce__()
Return type:

str

__repr__()
Return type:

str

center()
Return type:

QPoint

Returns the center point of this line. This is equivalent to ( p1() + p2() ) / 2, except it will never overflow.

dx()
Return type:

int

Returns the horizontal component of the line’s vector.

See also

dy()

dy()
Return type:

int

Returns the vertical component of the line’s vector.

See also

dx()

isNull()
Return type:

bool

Returns true if the line does not have distinct start and end points; otherwise returns false.

__ne__(rhs)
Parameters:

rhsQLine

Return type:

bool

Returns true if the line lhs is not the same as line rhs.

A line is different from another line if any of their start or end points differ, or the internal order of the points is different.

__ne__(rhs)
Parameters:

rhsQLineF

Return type:

bool

__mul__(m)
Parameters:

mQTransform

Return type:

QLine

__eq__(rhs)
Parameters:

rhsQLine

Return type:

bool

Returns true if the line lhs is the same as line rhs.

A line is identical to another line if the start and end points are identical, and the internal order of the points is the same.

__eq__(rhs)
Parameters:

rhsQLineF

Return type:

bool

p1()
Return type:

QPoint

Returns the line’s start point.

See also

setP1() x1() y1() p2()

p2()
Return type:

QPoint

Returns the line’s end point.

See also

setP2() x2() y2() p1()

setLine(x1, y1, x2, y2)
Parameters:
  • x1 – int

  • y1 – int

  • x2 – int

  • y2 – int

Sets this line to the start in x1, y1 and end in x2, y2.

setP1(p1)
Parameters:

p1QPoint

Sets the starting point of this line to p1.

See also

setP2() p1()

setP2(p2)
Parameters:

p2QPoint

Sets the end point of this line to p2.

See also

setP1() p2()

setPoints(p1, p2)
Parameters:

Sets the start point of this line to p1 and the end point of this line to p2.

toLineF()
Return type:

QLineF

Returns this line as a line with floating point accuracy.

See also

toLine()

toTuple()
Return type:

object

translate(p)
Parameters:

pQPoint

Translates this line by the given offset.

translate(dx, dy)
Parameters:
  • dx – int

  • dy – int

This is an overloaded function.

Translates this line the distance specified by dx and dy.

translated(p)
Parameters:

pQPoint

Return type:

QLine

Returns this line translated by the given offset.

translated(dx, dy)
Parameters:
  • dx – int

  • dy – int

Return type:

QLine

This is an overloaded function.

Returns this line translated the distance specified by dx and dy.

x1()
Return type:

int

Returns the x-coordinate of the line’s start point.

See also

p1()

x2()
Return type:

int

Returns the x-coordinate of the line’s end point.

See also

p2()

y1()
Return type:

int

Returns the y-coordinate of the line’s start point.

See also

p1()

y2()
Return type:

int

Returns the y-coordinate of the line’s end point.

See also

p2()