vector3d QML Value Type

a value with x, y, and z attributes. More...

Detailed Description

The vector3d type refers to a value with x, y, and z attributes.

Properties of type vector3d have a zero vector by default. This has x, y and z set to 0.

To create a vector3d value, specify it as a "x,y,z" string:

 Rotation { angle: 60; axis: "0,1,0" }

or with the Qt.vector3d() function:

 Rotation { angle: 60; axis: Qt.vector3d(0, 1, 0) }

or as separate x, y, and z components:

 Rotation { angle: 60; axis.x: 0; axis.y: 1; axis.z: 0 }

Each attribute of a vector3d value is stored internally as a single-precision floating point number (float).

When integrating with C++, note that any QVector3D value passed into QML from C++ is automatically converted into a vector3d value, and vice-versa.

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

 var a = Qt.vector3d(1,2,3);
 var b = Qt.vector3d(4,5,6);
 var c = a.crossProduct(b);
 console.log(c.toString()); // QVector3D(-3, 6, -3)

 var a = Qt.vector3d(1,2,3);
 var b = Qt.vector3d(4,5,6);
 var c = a.dotProduct(b);
 console.log(c); // 32

 var a = Qt.vector3d(1,2,3);
 var b = Qt.matrix4x4(4,5,6,7,8,9,10,11,
                      12,13,14,15,16,17,18,19);
 var c = a.times(b);
 console.log(c.toString());
 // QVector3D(0.774194, 0.849462, 0.924731)

 var a = Qt.vector3d(1,2,3);
 var b = Qt.vector3d(4,5,6);
 var c = a.times(b);
 console.log(c.toString()); // QVector3D(4, 10, 18)

 var a = Qt.vector3d(1,2,3);
 var b = 4.48;
 var c = a.times(b);
 console.log(c.toString()); // QVector3D(4.48, 8.96, 13.44)

 var a = Qt.vector3d(1,2,3);
 var b = Qt.vector3d(4,5,6);
 var c = a.plus(b);
 console.log(c.toString()); // QVector3D(5, 7, 9)

 var a = Qt.vector3d(1,2,3);
 var b = Qt.vector3d(4,5,6);
 var c = a.minus(b);
 console.log(c.toString()); // QVector3D(-3, -3, -3)

 var a = Qt.vector3d(1,2,3);
 var b = a.normalized();
 console.log(b.toString());
 // QVector3D(0.267261, 0.534522, 0.801784)

 var a = Qt.vector3d(1,2,3);
 var b = a.length();
 console.log(b.toString()); // 3.7416573867739413

 var a = Qt.vector3d(1,2,3);
 var b = a.toVector2d();
 console.log(b.toString()); // QVector2D(1, 2)

 var a = Qt.vector3d(1,2,3);
 var b = a.toVector4d();
 console.log(b.toString()); // QVector4D(1, 2, 3, 0)

 var a = Qt.vector3d(1,2,3);
 var b = Qt.vector3d(1.0001, 1.9998, 2.0001);
 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.