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

matrix4x4 QML Value Type

Eine Matrix vom Typ 4x4 ist eine Matrix mit 4 Zeilen und 4 Spalten. Mehr...

Import Statement: import QtQuick

Ausführliche Beschreibung

Ein Typ „ matrix4x4 “ verfügt über sechzehn Werte, auf die jeweils über die Eigenschaften „ m11 “ bis „ m44 “ in QML zugegriffen werden kann (in Reihen-/Spaltenreihenfolge). Werte dieses Typs können mit der Funktion `Qt.matrix4x4()` gebildet werden. Jedes Attribut in einer `matrix4x4` wird als reelle Zahl gespeichert (Einfachgenauigkeit auf ARM, Doppelgenauigkeit auf x86).

Eine Eigenschaft vom Typ „ matrix4x4 “ ist standardmäßig die Einheitsmatrix, deren Diagonalelemente „ m11 “, „ m22 “, „ m33 “ und „ m44 “ alle den Wert „ 1 “ haben, während alle anderen Komponenten den Wert „ 0 “ haben.

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

FunktionssignaturBeschreibungBeispiel
translate(vector3d vector)Multipliziert eine ` this `-Matrix4x4 mit einer anderen, die Koordinaten um die Komponenten von vector
var m = Qt.matrix4x4();
m.translate(Qt.vector3d(1,2,3));
console.log(m.toString());
// QMatrix4x4(1, 0, 0, 1, 0, 1, 0, 2, 0, 0, 1, 3, 0, 0, 0, 1)
rotate(real angle, vector3d axis)this -4x4-Matrix mit einer anderen multipliziert, die die Koordinaten um angle Grad um axis
var m = Qt.matrix4x4();
m.rotate(180,Qt.vector3d(1,0,0));
console.log(m.toString());
// QMatrix4x4(1, 0, 0, 0, 0, -1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1)
rotate(quaternion quaternion)Multipliziert die this -Matrix 4×4 mit einer anderen, die die Koordinaten gemäß einem angegebenen quaternion dreht. Es wird angenommen, dass der quaternion normiert ist.
var m = Qt.matrix4x4();
m.rotate(Qt.quaternion(0.5,0.5,0.5,-0.5));
console.log(m.toString());
// QMatrix4x4(0, 1, 0, 0, 0, 0, -1, 0, -1, 0, 0, 0, 0, 0, 0, 1)
scale(real factor)this -Matrix4x4 mit einer anderen Matrix multipliziert, die die Koordinaten mit dem angegebenen factor
var m = Qt.matrix4x4();
m.scale(2);
console.log(m.toString());
// QMatrix4x4(2, 0, 0, 0, 0, 2, 0, 0, 0, 0, 2, 0, 0, 0, 0, 1)
scale(real x, real y, real z)Multipliziert die this -Matrix 4x4 mit einer anderen, die die Koordinaten mit den Komponenten x, y und z
var m = Qt.matrix4x4();
m.scale(1,2,3);
console.log(m.toString());
// QMatrix4x4(1, 0, 0, 0, 0, 2, 0, 0, 0, 0, 3, 0, 0, 0, 0, 1)
scale(vector3d vector)Multipliziert die this -Matrix 4×4 mit einer anderen, die die Koordinaten mit den Komponenten von vector
var m = Qt.matrix4x4();
m.scale(Qt.vector3d(1,2,3));
console.log(m.toString());
// QMatrix4x4(1, 0, 0, 0, 0, 2, 0, 0, 0, 0, 3, 0, 0, 0, 0, 1)
lookAt(vector3d eye, vector3d center, vector3d up)Multipliziert die this 4x4-Matrix mit einer Betrachtungsmatrix, die aus einem eye Punkt abgeleitet wird. Der center vector3d gibt den Mittelpunkt der Ansicht an, auf den der eye blickt. Der up vector3d gibt an, welche Richtung in Bezug auf den eye als „oben“ betrachtet werden soll.
var m = Qt.matrix4x4();
m.lookAt(Qt.vector3d(1,2,3),Qt.vector3d(1,2,0),Qt.vector3d(0,1,0));
console.log(m.toString());
// QMatrix4x4(1, 0, 0, -1, 0, 1, 0, -2, 0, 0, 1, -3, 0, 0, 0, 1)
matrix4x4 times(matrix4x4 other)Gibt die matrix4x4 zurück, die sich aus der Multiplikation der matrix4x4 „ this “ mit der matrix4x4 „ other “ ergibt
var a = Qt.matrix4x4(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16);
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());
// QMatrix4x4(120, 130, 140, 150, 280, 306, 332, 358, 440, 482,
//524, 566, 600, 658, 716, 774)
vector4d times(vector4d vector)Liefert das vector4d-Ergebnis der Transformation des vector gemäß der this matrix4x4, wobei die Matrix vor dem Vektor angewendet wird
var a = Qt.matrix4x4(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16);
var b = Qt.vector4d(5,6,7,8);
var c = a.times(b);
console.log(c.toString()); // QVector4D(70, 174, 278, 382)
vector3d times(vector3d vector)Gibt das vector3d-Ergebnis der Transformation des Vektors „ vector “ gemäß der Matrix „ this “ (4×4) zurück, wobei die Matrix als Vorvektor angewendet wirdvector3d times(vector3d vector)
var a = Qt.matrix4x4(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16);
var b = Qt.vector3d(5,6,7);
var c = a.times(b);
console.log(c.toString()); // QVector3D(0.155556, 0.437037, 0.718518)
matrix4x4 times(real factor)Gibt das matrix4x4-Ergebnis der Multiplikation der this matrix4x4 mit dem Skalar zurück factor
var a = Qt.matrix4x4(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16);
var b = 4.48;
var c = a.times(b);
console.log(c.toString());
// QMatrix4x4(4.48, 8.96, 13.44, 17.92, 22.4, 26.88, 31.36, 35.84,
// 40.32, 44.8, 49.28, 53.76, 58.24, 62.72, 67.2, 71.68)
matrix4x4 plus(matrix4x4 andere)Gibt das Ergebnis der Addition der this en 4x4-Matrix mit der other en 4x4-Matrix als 4x4-Matrix zurück
var a = Qt.matrix4x4(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16);
var b = Qt.matrix4x4(5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20);
var c = a.plus(b);
console.log(c.toString());
// QMatrix4x4(6, 8, 10, 12, 14, 16, 18, 20, 22,
// 24, 26, 28, 30, 32, 34, 36)
matrix4x4 minus(matrix4x4 other)Gibt das Ergebnis der Subtraktion der Matrix „ other “ von der Matrix „ this “ als Matrix4x4 zurück
var a = Qt.matrix4x4(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16);
var b = Qt.matrix4x4(5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20);
var c = a.minus(b);
console.log(c.toString());
// QMatrix4x4(-4, -4, -4, -4, -4, -4, -4, -4, -4,
// -4, -4, -4, -4, -4, -4, -4)
vector4d row(int which)whichGibt die Zeile des Vektors „vector4d“ zurück, die durch „ this “ angegeben wird. Hinweis: Der „ which “ erfolgt über einen 0-basierten Zugriff auf die Matrix.
var a = Qt.matrix4x4(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16);
var b = Qt.vector4d(a.m21, a.m22, a.m23, a.m24);
var c = a.row(2); // zero based access!  so not equal to b
console.log(b.toString() + " " + c.toString());
// QVector4D(5, 6, 7, 8) QVector4D(9, 10, 11, 12)
vector4d column(int which)Gibt die „vector4d“-Spalte von „ this “ zurück, die durch „ which “ angegeben ist. Hinweis: Die „ which “ erfolgt über einen 0-basierten Zugriff auf die Matrix.
var a = Qt.matrix4x4(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16);
var b = Qt.vector4d(a.m12, a.m22, a.m32, a.m42);
var c = a.column(2); // zero based access!  so not equal to b
console.log(b.toString() + " " + c.toString());
// QVector4D(2, 6, 10, 14) QVector4D(3, 7, 11, 15)
real determinant()Gibt die Determinante von ` this matrix4x4` zurück
var a = Qt.matrix4x4(1,0,0,0,0,2,0,0,0,0,3,0,100,200,300,1);
var b = a.determinant();
console.log(b); // 6
matrix4x4 inverted()Gibt die Inverse von ` this matrix4x4` zurück, sofern diese existiert, andernfalls die Einheitsmatrix.
var a = Qt.matrix4x4(1,0,0,0,0,2,0,0,0,0,3,0,100,200,300,1);
var b = a.inverted();
console.log(b.toString());
// QMatrix4x4(1, 0, 0, 0, 0, 0.5, 0, 0, 0, 0, 0.333333, 0, -100,
// -100, -100, 1)
matrix4x4 transponiert()Gibt die Transponierte von ` this matrix4x4` zurück
var a = Qt.matrix4x4(1,0,0,0,0,2,0,0,0,0,3,0,100,200,300,1);
var b = a.transposed();
console.log(b.toString());
// QMatrix4x4(1, 0, 0, 100, 0, 2, 0, 200, 0, 0, 3, 300, 0, 0, 0, 1)
rect mapRect(rect)Ordnet das angegebene Rechteck dem durch diese Matrix definierten Koordinatensystem zu. Wenn eine Drehung oder eine Scherung angegeben wurde, gibt diese Funktion das umschließende Rechteck zurück. Diese Funktion wurde in Qt 6.5 eingeführt.
var a = Qt.matrix4x4(2,0,0,0,0,2,0,0,0,0,1,0,0,0,0,1);
var b = a.mapRect(Qt.rect(10, 20, 30, 40));
console.log(b.toString());
// Qt.rect(20, 40, 60, 80)
point map(point)Ordnet den angegebenen Punkt dem durch diese Matrix definierten Koordinatensystem zu. Diese Funktion wurde in Qt 6.5 eingeführt.
var a = Qt.matrix4x4(2,0,0,0,0,2,0,0,0,0,1,0,0,0,0,1);
var b = a.map(10, 20);
console.log(b.toString());
// Qt.point(20, 40)
bool fuzzyEquals(matrix4x4 other, real epsilon)Gibt „true“ zurück, wenn die Matrix ` this ` annähernd gleich der Matrix ` other ` ist. Die Annäherung gilt als erfüllt, wenn jedes Attribut von ` this ` innerhalb von ` epsilon ` des jeweiligen Attributs von ` other` liegt. Beachten Sie, dass ` epsilon ` ein optionales Argument ist; der Standardwert von ` epsilon ` ist 0,00001.
var a = Qt.matrix4x4(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16);
var b = Qt.matrix4x4(1.0001,2.0001,3.0002,4.0003,5.0001,6.0002,
                     7.0002,8.0004, 9.0001,10.0003,
                     11.0003,12.0004,13.0001,
                     14.0002,15.0003,16.0004);
var c = a.fuzzyEquals(b);        // default epsilon
var d = a.fuzzyEquals(b, 0.005); // supplied epsilon
console.log(c + " " + d); // false true

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.