QPoint¶
The QPoint
class defines a point in the plane using integer precision. More…
Synopsis¶
Functions¶
def
__add__
()def
__add__
(, p2)def
__div__
(, c)def
__eq__
(, p2)def
__iadd__
(p)def
__idiv__
(divisor)def
__imul__
(factor)def
__imul__
(factor)def
__imul__
(factor)def
__isub__
(p)def
__mul__
(, factor)def
__mul__
(, factor)def
__mul__
(, factor)def
__mul__
(, m)def
__mul__
(, matrix)def
__mul__
(factor)def
__mul__
(factor)def
__mul__
(factor)def
__mul__
(matrix)def
__ne__
(, p2)def
__reduce__
()def
__repr__
()def
__sub__
()def
__sub__
(, p2)def
isNull
()def
manhattanLength
()def
setX
(x)def
setY
(y)def
toTuple
()def
transposed
()def
x
()def
y
()
Static functions¶
def
dotProduct
(p1, p2)
Detailed Description¶
A point is specified by a x coordinate and an y coordinate which can be accessed using the x()
and y()
functions. The isNull()
function returns true
if both x and y are set to 0. The coordinates can be set (or altered) using the setX()
and setY()
functions, or alternatively the rx()
and ry()
functions which return references to the coordinates (allowing direct manipulation).
Given a point p, the following statements are all equivalent:
p = QPoint() p.setX(p.x() + 1) p += QPoint(1, 0)
A QPoint
object can also be used as a vector: Addition and subtraction are defined as for vectors (each component is added separately). A QPoint
object can also be divided or multiplied by an int
or a qreal
.
In addition, the QPoint
class provides the manhattanLength()
function which gives an inexpensive approximation of the length of the QPoint
object interpreted as a vector. Finally, QPoint
objects can be streamed as well as compared.
See also
QPointF
QPolygon

class
PySide6.QtCore.
QPoint
¶ PySide6.QtCore.QPoint(QPoint)
PySide6.QtCore.QPoint(xpos, ypos)
 Parameters
QPoint –
PySide6.QtCore.QPoint
xpos – int
ypos – int
Constructs a null point, i.e. with coordinates (0, 0)
See also
Constructs a point with the given coordinates (xpos
, ypos
).

PySide6.QtCore.QPoint.
__reduce__
()¶  Return type
object

PySide6.QtCore.QPoint.
__repr__
()¶  Return type
object

static
PySide6.QtCore.QPoint.
dotProduct
(p1, p2)¶  Parameters
 Return type
int
QPoint p( 3, 7); QPoint q(1, 4); int lengthSquared = QPoint::dotProduct(p, q); // lengthSquared becomes 25
Returns the dot product of p1
and p2
.

PySide6.QtCore.QPoint.
isNull
()¶  Return type
bool
Returns true
if both the x and y coordinates are set to 0, otherwise returns false
.

PySide6.QtCore.QPoint.
manhattanLength
()¶  Return type
int
Returns the sum of the absolute values of x()
and y()
, traditionally known as the “Manhattan length” of the vector from the origin to the point. For example:
class MyWidget(QWidget): self.oldPosition = QPointer() # event : QMouseEvent def mouseMoveEvent(QMouseEvent event): point = event.pos()  self.oldPosition if (point.manhattanLength() > 3): # the mouse has moved more than 3 pixels since the oldPosition pass
This is a useful, and quick to calculate, approximation to the true length:
trueLength = sqrt(pow(x(), 2) + pow(y(), 2))
The tradition of “Manhattan length” arises because such distances apply to travelers who can only travel on a rectangular grid, like the streets of Manhattan.

PySide6.QtCore.QPoint.
__ne__
(p2)¶  Parameters
 Return type
bool

PySide6.QtCore.QPoint.
__mul__
(m)¶  Parameters
 Return type

PySide6.QtCore.QPoint.
__mul__
(factor)  Parameters
factor – int
 Return type

PySide6.QtCore.QPoint.
__mul__
(factor)  Parameters
factor – int
 Return type

PySide6.QtCore.QPoint.
__mul__
(factor)  Parameters
factor – float
 Return type

PySide6.QtCore.QPoint.
__mul__
(factor)  Parameters
factor – float
 Return type

PySide6.QtCore.QPoint.
__mul__
(factor)  Parameters
factor –
double
 Return type

PySide6.QtCore.QPoint.
__mul__
(factor)  Parameters
factor –
double
 Return type

PySide6.QtCore.QPoint.
__mul__
(matrix)  Parameters
matrix –
PySide6.QtGui.QMatrix4x4
 Return type

PySide6.QtCore.QPoint.
__mul__
(matrix)  Parameters
matrix –
PySide6.QtGui.QMatrix4x4
 Return type

PySide6.QtCore.QPoint.
__imul__
(factor)¶  Parameters
factor – int
 Return type
Multiplies this point’s coordinates by the given factor
, and returns a reference to this point.
See also
operator/=()

PySide6.QtCore.QPoint.
__imul__
(factor)  Parameters
factor – float
 Return type
Multiplies this point’s coordinates by the given factor
, and returns a reference to this point.
Note that the result is rounded to the nearest integer as points are held as integers. Use QPointF
for floating point accuracy.
See also
operator/=()

PySide6.QtCore.QPoint.
__imul__
(factor)  Parameters
factor –
double
 Return type
Multiplies this point’s coordinates by the given factor
, and returns a reference to this point. For example:
p = QPoint(1, 4) p *= 2.5 # p becomes (3, 10)
Note that the result is rounded to the nearest integer as points are held as integers. Use QPointF
for floating point accuracy.
See also
operator/=()

PySide6.QtCore.QPoint.
__add__
()¶  Return type

PySide6.QtCore.QPoint.
__add__
(p2)  Parameters
 Return type
Returns point
unmodified.

PySide6.QtCore.QPoint.
__iadd__
(p)¶  Parameters
 Return type
Adds the given point
to this point and returns a reference to this point. For example:
p = QPoint( 3, 7) q = QPoint(1, 4) p += q # p becomes (2, 11)See also
operator=()

PySide6.QtCore.QPoint.
__sub__
()¶  Return type

PySide6.QtCore.QPoint.
__sub__
(p2)  Parameters
 Return type
This is an overloaded function.
Returns a QPoint
object that is formed by changing the sign of both components of the given point
.
Equivalent to QPoint(0,0)  point
.

PySide6.QtCore.QPoint.
__isub__
(p)¶  Parameters
 Return type
Subtracts the given point
from this point and returns a reference to this point. For example:
p = QPoint( 3, 7) q = QPoint(1, 4) p = q # p becomes (4, 3)See also
operator+=()

PySide6.QtCore.QPoint.
__div__
(c)¶  Parameters
c – float
 Return type

PySide6.QtCore.QPoint.
__idiv__
(divisor)¶  Parameters
divisor – float
 Return type
This is an overloaded function.
Divides both x and y by the given divisor
, and returns a reference to this point. For example:
p = QPoint(3, 10) p /= 2.5 # p becomes (1, 4)
Note that the result is rounded to the nearest integer as points are held as integers. Use QPointF
for floating point accuracy.
See also
operator*=()

PySide6.QtCore.QPoint.
__eq__
(p2)¶  Parameters
 Return type
bool

PySide6.QtCore.QPoint.
setX
(x)¶  Parameters
x – int
Sets the x coordinate of this point to the given x
coordinate.

PySide6.QtCore.QPoint.
setY
(y)¶  Parameters
y – int
Sets the y coordinate of this point to the given y
coordinate.

PySide6.QtCore.QPoint.
toTuple
()¶  Return type
object

PySide6.QtCore.QPoint.
transposed
()¶  Return type
Returns a point with x and y coordinates exchanged:

PySide6.QtCore.QPoint.
x
()¶  Return type
int
Returns the x coordinate of this point.
See also
setX()
rx()

PySide6.QtCore.QPoint.
y
()¶  Return type
int
Returns the y coordinate of this point.
See also
setY()
ry()
© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.