Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

quaternion QML Value Type

Ein Quaternion-Typ verfügt über die Attribute „scalar“, „x“, „y“ und „z“. Mehr...

Import Statement: import QtQuick

Ausführliche Beschreibung

Ein Typ vom Typ „ quaternion “ verfügt über die Attribute „ scalar “, „ x “, „ y “ und „ z “.

Um einen „ quaternion “-Wert zu erstellen, geben Sie ihn als Zeichenkette „scalar,x,y,z“ an, definieren Sie die Komponenten einzeln oder setzen Sie ihn mit der Funktion Qt.quaternion() zusammen.

Der Typ „Quaternion“ verfügt über die folgenden idempotenten Funktionen, die in QML aufgerufen werden können:

FunktionssignaturBeschreibungBeispiel
real dotProduct(quaternion other)Gibt das skalare reelle Ergebnis des Skalarprodukts des Quaternions ` this ` mit dem Quaternion ` other ` zurück
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
Quaternion times(Quaternion other)Gibt das Quaternion-Ergebnis der Multiplikation des Quaternions „ this “ mit dem Quaternion „ other “ zurück, was der Anwendung beider Rotationen entspricht
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)Gibt das vector3d-Ergebnis der Rotation des vector mit dem this Quaternion zurück
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)
Quaternion times(real factor)Gibt das Quaternion-Ergebnis der Multiplikation des Quaternions ` this ` mit dem Skalar zurück 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)
Quaternion plus(Quaternion other)Gibt das Quaternion-Ergebnis der Addition des Quaternions „ this “ mit dem Quaternion „ other “ zurück
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)
Quaternion minus(Quaternion other)Gibt das Quaternion-Ergebnis der Subtraktion des Quaternions „ other “ vom Quaternion „ this “ zurück
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)
Quaternion normalized()Gibt die normalisierte Einheitsform des Quaternions „ this “ zurück
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)
Quaternion invertiert()Gibt die Umkehrung des Quaternions „ this “ zurück
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)
quaternion konjugiert()Gibt das Konjugierte des Quaternions ` this ` zurück
var a = Qt.quaternion(1,2,3,4);
var b = a.conjugated()
console.log(b.toString()); // QQuaternion(1, -2, -3, -4)
real length()Gibt den skalaren reellen Wert der Länge des Quaternions „ this “ zurück
var a = Qt.quaternion(1,2,3,4);
var b = a.length();
console.log(b.toString()); // 5.477225575051661
vector3d toEulerAngles()Gibt die Eulerwinkel als vector3d (in Grad) zurück, die dem Quaternion „ this “ entsprechen
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()Gibt das vector4d-Ergebnis der Konvertierung eines Quaternions vom Typ „ this “ in einen vector4d zurück
var a = Qt.quaternion(1,2,3,4);
var b = a.toVector4d();
console.log(b.toString()); // QVector4D(2, 3, 4, 1)
bool fuzzyEquals(Quaternion other, real epsilon)Gibt „true“ zurück, wenn das Quaternion „ this “ annähernd gleich dem Quaternion „ other “ ist. Die Annäherung gilt als erfüllt, wenn jedes Attribut von „ this “ innerhalb von „ epsilon “ von „ other “ liegt. Beachten Sie, dass „ epsilon “ ein optionales Argument ist; der Standardwert für „ epsilon “ ist 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

Eigenschaften vom Typ „ quaternion “ haben „ Qt.quaternion(1, 0, 0, 0) “ als Standardwert.

Dieser Werttyp wird durch den Import „ QtQuick “ bereitgestellt.

Siehe auch QML-Werttypen.

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