En esta página

quaternion QML Value Type

Un tipo «cuaternión» tiene los atributos escalar, x, y y z. Más información...

Import Statement: import QtQuick

Descripción detallada

Un tipo « quaternion » tiene los atributos « scalar », « x », « y » y « z ».

Para crear un valor de tipo « quaternion », especifícalo como una cadena «scalar,x,y,z», define los componentes individualmente o compónlo con la función Qt.quaternion().

El tipo «quaternion» cuenta con las siguientes funciones idempotentes que pueden invocarse en QML:

Firma de la funciónDescripciónEjemplo
real dotProduct(quaternion other)Devuelve el resultado escalar real del producto escalar del cuaternión ` this ` con el cuaternión ` other `
var a = Qt.quaternion(1,2,3,4);
var b = Qt.quaternion(5,6,7,8);
var c = a.dotProduct(b);
console.log(c); // 70
cuaternión times(cuaternión other)Devuelve el cuaternión resultante de multiplicar el cuaternión this por el cuaternión other, lo que equivale a aplicar ambas rotaciones
var a = Qt.quaternion(1 / Math.sqrt(2), 1 / Math.sqrt(2), 0, 0);
var b = Qt.quaternion(1 / Math.sqrt(2), 0, 1 / Math.sqrt(2), 0);
var c = b.times(a);
console.log(c.toString()); // QQuaternion(0.5, 0.5, 0.5, -0.5)
vector3d times(vector3d vector)Devuelve el vector3d resultante de rotar el cuaternión « vector » con el cuaternión « this »
var a = Qt.quaternion(0.5,0.5,0.5,-0.5);
var b = Qt.vector3d(4,5,6);
var c = a.times(b);
console.log(c.toString()); // QVector3D(5, -6, -4)
cuaternión times(factor real)Devuelve el cuaternión resultante de multiplicar el cuaternión this por el escalar factor
var a = Qt.quaternion(1,2,3,4);
var b = 4.48;
var c = a.times(b);
console.log(c.toString()); // QQuaternion(4.48, 8.96, 13.44, 17.92)
cuaternión más(cuaternión otro)Devuelve el resultado, un cuaternión, de la suma del cuaternión « this » con el cuaternión « other »
var a = Qt.quaternion(1,2,3,4);
var b = Qt.quaternion(5,6,7,8);
var c = a.plus(b);
console.log(c.toString()); // QQuaternion(6, 8, 10, 12)
cuaternión menos(cuaternión otro)Devuelve el cuaternión resultante de la resta de un cuaternión « other » de un cuaternión « this »
var a = Qt.quaternion(1,2,3,4);
var b = Qt.quaternion(5,6,7,8);
var c = a.minus(b);
console.log(c.toString()); // QQuaternion(-4, -4, -4, -4)
cuaternión normalizado()Devuelve la forma unitaria normalizada de un cuaternion d this
var a = Qt.quaternion(1,2,3,4);
var b = a.normalized();
console.log(b.toString()); // QQuaternion(0.182574, 0.365148, 0.547723, 0.730297)
cuaternión invertido()Devuelve la inversa de un cuaternion d this
var a = Qt.quaternion(0.5,0.5,0.5,-0.5);
var b = a.inverted();
console.log(b.toString()); // QQuaternion(0.5, -0.5, -0.5, 0.5)
cuaternión conjugado()Devuelve el conjugado de un cuaternión d this
var a = Qt.quaternion(1,2,3,4);
var b = a.conjugated()
console.log(b.toString()); // QQuaternion(1, -2, -3, -4)
longitud real()Devuelve el valor real escalar de la longitud de un cuaternión d this
var a = Qt.quaternion(1,2,3,4);
var b = a.length();
console.log(b.toString()); // 5.477225575051661
vector3d toEulerAngles()Devuelve los ángulos de Euler en vector3d (en grados) que corresponden a un cuaternion d this
var a = Qt.quaternion(0.933012,0.25,-0.25,0.066987);
var b = a.toEulerAngles();
console.log(b.toString()); // QVector3D(30, -30, -4.28846e-05)
vector4d toVector4d()Devuelve el vector4d resultante de convertir un cuaternión de this en un vector4d
var a = Qt.quaternion(1,2,3,4);
var b = a.toVector4d();
console.log(b.toString()); // QVector4D(2, 3, 4, 1)
bool fuzzyEquals(cuaternión otro, real épsilon)Devuelve «true» si un cuaternión de tipo « this » es aproximadamente igual al cuaternión de tipo « other ». La aproximación será verdadera si cada atributo de « this » está dentro de « epsilon » de « other ». Ten en cuenta que « epsilon » es un argumento opcional; el valor predeterminado de « epsilon » es 0,00001.
var a = Qt.quaternion(1,2,3,4);
var b = Qt.quaternion(1.0001, 1.9998, 2.0001, 3.9999);
var c = a.fuzzyEquals(b);        // default epsilon
var d = a.fuzzyEquals(b, 0.005); // supplied epsilon
console.log(c + " " + d); // false true

Las propiedades de tipo quaternion tienen Qt.quaternion(1, 0, 0, 0) como valor por defecto.

Este tipo de valor se proporciona mediante la importación QtQuick.

Véase también Tipos de valor de QML.

© 2026 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.