vector2d QML Value Type | Qt Quick | Qt 6.12.0
Description: A vector2d type has x and y attributes.
Keywords: qmlvaluetype

- Qt 6.12
- Qt Quick
- QML Types
- vector2d
- Qt 6.12.0 Reference Documentation

# vector2d QML Value Type

A vector2d type has x and y attributes. More...

## Detailed Description

A `vector2d` type has `x` and `y` attributes, otherwise it is similar to the `vector3d` type.

Properties of type `vector2d` have a zero vector as their default value. This has both `x` and `y` set to `0`.

See the documentation about the `vector3d` type for more information.

To create a `vector2d` value, specify it as a "x,y" string, or define the components individually, or compose it with the Qt.vector2d() function.

The vector2d type has the following idempotent functions which can be invoked in QML:

Function Signature | Description | Example
--- | --- | ---
real dotProduct(vector2d other) | Returns the scalar real result of the dot product of `this` vector2d with the `other` vector2d |
     var a = Qt.vector2d(1,2);
     var b = Qt.vector2d(3,4);
     var c = a.dotProduct(b);
     console.log(c); // 11
vector2d times(vector2d other) | Returns the vector2d result of multiplying `this` vector2d with the `other` vector2d |
     var a = Qt.vector2d(1,2);
     var b = Qt.vector2d(3,4);
     var c = a.times(b);
     console.log(c.toString()); // QVector2D(3, 8)
vector2d times(real factor) | Returns the vector2d result of multiplying `this` vector2d with the scalar `factor` |
     var a = Qt.vector2d(1,2);
     var b = 4.48;
     var c = a.times(b);
     console.log(c.toString()); // QVector2D(4.48, 8.96)
vector2d plus(vector2d other) | Returns the vector2d result of the addition of `this` vector2d with the `other` vector2d |
     var a = Qt.vector2d(1,2);
     var b = Qt.vector2d(3,4);
     var c = a.plus(b);
     console.log(c.toString()); // QVector2D(4, 6)
vector2d minus(vector2d other) | Returns the vector2d result of the subtraction of `other` vector2d from `this` vector2d |
     var a = Qt.vector2d(1,2);
     var b = Qt.vector2d(3,4);
     var c = a.minus(b);
     console.log(c.toString()); // QVector2D(-2, -2)
vector2d normalized() | Returns the normalized form of `this` vector |
     var a = Qt.vector2d(1,2);
     var b = a.normalized();
     console.log(b.toString()); // QVector2D(0.447214, 0.894427)
real length() | Returns the scalar real value of the length of `this` vector2d |
     var a = Qt.vector2d(1,2);
     var b = a.length();
     console.log(b.toString()); // 2.23606797749979
vector3d toVector3d() | Returns the vector3d result of converting `this` vector2d to a vector3d |
     var a = Qt.vector2d(1,2);
     var b = a.toVector3d();
     console.log(b.toString()); // QVector3D(1, 2, 0)
vector4d toVector4d() | Returns the vector4d result of converting `this` vector2d to a vector4d |
     var a = Qt.vector2d(1,2);
     var b = a.toVector4d();
     console.log(b.toString()); // QVector4D(1, 2, 0, 0)
bool fuzzyEquals(vector2d other, real epsilon) | Returns true if `this` vector2d is approximately equal to the `other` vector2d. The approximation will be true if each attribute of `this` is within `epsilon` of `other`. Note that `epsilon` is an optional argument, the default `epsilon` is 0.00001. |
     var a = Qt.vector2d(1,2);
     var b = Qt.vector2d(1.0001, 1.9998);
     var c = a.fuzzyEquals(b);        // default epsilon
     var d = a.fuzzyEquals(b, 0.005); // supplied epsilon
     console.log(c + " " + d); // false true

This value type is provided by the QtQuick import.

See also QML Value Types.