QVector2D#

The QVector2D class represents a vector or vertex in 2D space. More…

New in version 4.6.

Synopsis#

Functions#

def __reduce__ ()
def __repr__ ()
def distanceToLine (point, direction)
def distanceToPoint (point)
def isNull ()
def length ()
def lengthSquared ()
def normalize ()
def normalized ()
def __ne__ (v2)
def __mul__ (v2)
def __mul__ (factor)
def __mul__ (factor)
def __imul__ (vector)
def __imul__ (factor)
def __add__ (v2)
def __iadd__ (vector)
def __sub__ ()
def __sub__ (v2)
def __isub__ (vector)
def __div__ (divisor)
def __div__ (divisor)
def __idiv__ (vector)
def __idiv__ (divisor)
def __eq__ (v2)
def operator[] (i)
def setX (x)
def setY (y)
def toPoint ()
def toPointF ()
def toTuple ()
def toVector3D ()
def toVector4D ()
def x ()
def y ()

Static functions#

def dotProduct (v1, v2)

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#

Vectors are one of the main building blocks of 2D representation and drawing. They consist of two finite floating-point coordinates, traditionally called x and y.

The QVector2D class can also be used to represent vertices in 2D space. We therefore do not need to provide a separate vertex class.

See also

QVector3D QVector4D QQuaternion

class PySide6.QtGui.QVector2D#

PySide6.QtGui.QVector2D(point)

PySide6.QtGui.QVector2D(point)

PySide6.QtGui.QVector2D(vector)

PySide6.QtGui.QVector2D(vector)

PySide6.QtGui.QVector2D(xpos, ypos)

Parameters:

ypos – float
xpos – float
vector – PySide6.QtGui.QVector3D
point – PySide6.QtCore.QPoint

Constructs a null vector, i.e. with coordinates (0, 0).

Constructs a vector with x and y coordinates from a 2D point.

Constructs a vector with x and y coordinates from a 3D vector. The z coordinate of vector is dropped.

See also

toVector3D()

Constructs a vector with x and y coordinates from a 3D vector. The z and w coordinates of vector are dropped.

See also

toVector4D()

Constructs a vector with coordinates (xpos, ypos). Both coordinates must be finite.

PySide6.QtGui.QVector2D.__reduce__()#

Return type:: object

PySide6.QtGui.QVector2D.__repr__()#

Return type:: object

PySide6.QtGui.QVector2D.distanceToLine(point, direction)#

Parameters:

point – PySide6.QtGui.QVector2D
direction – PySide6.QtGui.QVector2D

Return type:

float

Returns the distance that this vertex is from a line defined by point and the unit vector direction.

If direction is a null vector, then it does not define a line. In that case, the distance from point to this vertex is returned.

See also

distanceToPoint()

PySide6.QtGui.QVector2D.distanceToPoint(point)#

Parameters:: point – PySide6.QtGui.QVector2D
Return type:: float

Returns the distance from this vertex to a point defined by the vertex point.

See also

distanceToLine()

static PySide6.QtGui.QVector2D.dotProduct(v1, v2)#

Parameters:

v1 – PySide6.QtGui.QVector2D
v2 – PySide6.QtGui.QVector2D

Return type:

float

Returns the dot product of v1 and v2.

PySide6.QtGui.QVector2D.isNull()#

Return type:: bool

Returns true if the x and y coordinates are set to 0.0, otherwise returns false.

PySide6.QtGui.QVector2D.length()#

Return type:: float

Returns the length of the vector from the origin.

See also

lengthSquared() normalized()

PySide6.QtGui.QVector2D.lengthSquared()#

Return type:: float

Returns the squared length of the vector from the origin. This is equivalent to the dot product of the vector with itself.

See also

length() dotProduct()

PySide6.QtGui.QVector2D.normalize()#

Normalizes the current vector in place. Nothing happens if this vector is a null vector or the length of the vector is very close to 1.

See also

length() normalized()

PySide6.QtGui.QVector2D.normalized()#

Return type:: PySide6.QtGui.QVector2D

Returns the normalized unit vector form of this vector.

If this vector is null, then a null vector is returned. If the length of the vector is very close to 1, then the vector will be returned as-is. Otherwise the normalized form of the vector of length 1 will be returned.

See also

length() normalize()

PySide6.QtGui.QVector2D.__ne__(v2)#

Parameters:: v2 – PySide6.QtGui.QVector2D
Return type:: bool

Returns true if v1 is not equal to v2; otherwise returns false. This operator uses an exact floating-point comparison.

PySide6.QtGui.QVector2D.__mul__(v2)#

Parameters:: v2 – PySide6.QtGui.QVector2D
Return type:: PySide6.QtGui.QVector2D

Returns the QVector2D object formed by multiplying each component of v1 by the corresponding component of v2.

Note

This is not a cross product of v1 and v2 in any sense. (Its components add up to the dot product of v1 and v2.)