QVector2D Class

Member Function Documentation

[constexpr] QVector2D::QVector2D()

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

[constexpr] QVector2D::QVector2D(float xpos, float ypos)

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

[explicit constexpr] QVector2D::QVector2D(QPoint point)

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

[explicit constexpr] QVector2D::QVector2D(QPointF point)

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

[explicit constexpr] QVector2D::QVector2D(QVector3D vector)

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

See also toVector3D().

[explicit constexpr] QVector2D::QVector2D(QVector4D vector)

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

See also toVector4D().

float QVector2D::distanceToLine(QVector2D point, QVector2D direction) const

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

float QVector2D::distanceToPoint(QVector2D point) const

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

See also distanceToLine().

[static constexpr] float QVector2D::dotProduct(QVector2D v1, QVector2D v2)

Returns the dot product of v1 and v2.

[constexpr] bool QVector2D::isNull() const

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

float QVector2D::length() const

Returns the length of the vector from the origin.

See also lengthSquared() and normalized().

[constexpr] float QVector2D::lengthSquared() const

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() and dotProduct().

void 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() and normalized().

QVector2D QVector2D::normalized() const

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() and normalize().

[constexpr] void QVector2D::setX(float x)

Sets the x coordinate of this point to the given finite x coordinate.

See also x() and setY().

[constexpr] void QVector2D::setY(float y)

Sets the y coordinate of this point to the given finite y coordinate.

See also y() and setX().

[constexpr] QPoint QVector2D::toPoint() const

Returns the QPoint form of this 2D vector. Each coordinate is rounded to the nearest integer.

See also toPointF() and toVector3D().

[constexpr] QPointF QVector2D::toPointF() const

Returns the QPointF form of this 2D vector.

See also toPoint() and toVector3D().

[constexpr] QVector3D QVector2D::toVector3D() const

Returns the 3D form of this 2D vector, with the z coordinate set to zero.

See also toVector4D() and toPoint().

[constexpr] QVector4D QVector2D::toVector4D() const

Returns the 4D form of this 2D vector, with the z and w coordinates set to zero.

See also toVector3D() and toPoint().

[constexpr] float QVector2D::x() const

Returns the x coordinate of this point.

See also setX() and y().

[constexpr] float QVector2D::y() const

Returns the y coordinate of this point.

See also setY() and x().

QVariant QVector2D::operator QVariant() const

Returns the 2D vector as a QVariant.

[constexpr] QVector2D &QVector2D::operator*=(float factor)

Multiplies this vector's coordinates by the given finite factor and returns a reference to this vector.

See also operator/=() and operator*().

[constexpr] QVector2D &QVector2D::operator*=(QVector2D vector)

Multiplies each component of this vector by the corresponding component of vector and returns a reference to this vector.

See also operator/=() and operator*().

[constexpr] QVector2D &QVector2D::operator+=(QVector2D vector)

Adds the given vector to this vector and returns a reference to this vector.

See also operator-=().

[constexpr] QVector2D &QVector2D::operator-=(QVector2D vector)

Subtracts the given vector from this vector and returns a reference to this vector.

See also operator+=().

[constexpr] QVector2D &QVector2D::operator/=(float divisor)

Divides this vector's coordinates by the given divisor and returns a reference to this vector. The divisor must not be either zero or NaN.

See also operator*=().

[constexpr] QVector2D &QVector2D::operator/=(QVector2D vector)

Divides each component of this vector by the corresponding component of vector and returns a reference to this vector.

The vector must have no component that is either zero or NaN.

See also operator*=() and operator/().

[constexpr] float &QVector2D::operator[](int i)

Returns the component of the vector at index position i as a modifiable reference.

i must be a valid index position in the vector (i.e., 0 <= i < 2).

[constexpr] float QVector2D::operator[](int i) const

Returns the component of the vector at index position i.

i must be a valid index position in the vector (i.e., 0 <= i < 2).