class QLine

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

Synopsis

Methods

• def __init__()

• def __reduce__()

• def __repr__()

• def center()

• def dx()

• def dy()

• def isNull()

• def __ne__()

• def __mul__()

• def __eq__()

• def p1()

• def p2()

• def setLine()

• def setP1()

• def setP2()

• def setPoints()

• def toLineF()

• def toTuple()

• def translate()

• def translated()

• def x1()

• def x2()

• def y1()

• def y2()

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.

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:

• pt1 – QPoint

• pt2 – QPoint

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:

object

__repr__()

Return type:

object

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__(d)

Parameters:

d – QLine

Return type:

bool

Returns true if the given line is not the same as this line.

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.

__mul__(m)

Parameters:

m – QTransform

Return type:

QLine

__eq__(d)

Parameters:

d – QLine

Return type:

bool

Returns true if the given line is the same as this line.

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.

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.

See also

setP1() setP2() p1() p2()

setP1(p1)

Parameters:

p1 – QPoint

Sets the starting point of this line to p1.

See also

setP2() p1()

setP2(p2)

Parameters:

p2 – QPoint

Sets the end point of this line to p2.

See also

setP1() p2()

setPoints(p1, p2)

Parameters:

• p1 – QPoint

• p2 – QPoint

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

See also

setP1() setP2() p1() 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:

p – QPoint

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:

p – QPoint

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()