Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

matrix4x4 QML Value Type

Une matrice de type 4x4 est une matrice composée de 4 lignes et de 4 colonnes. En savoir plus...

Import Statement: import QtQuick

Description détaillée

Un type « matrix4x4 » comporte seize valeurs, chacune accessible via les propriétés m11 à m44 en QML (dans l'ordre des lignes et des colonnes). Les valeurs de ce type peuvent être créées à l'aide de la fonction Qt.matrix4x4(). Chaque élément d'une matrice 4x4 est stocké sous forme de nombre réel (précision simple sur ARM, précision double sur x86).

Une propriété de type « matrix4x4 » prend par défaut la matrice identité, dont les éléments diagonaux m11, m22, m33 et m44 sont tous égaux à 1, les autres éléments étant tous égaux à 0.

Le type `matrix4x4` dispose des fonctions idempotentes suivantes, qui peuvent être appelées dans QML :

Signature de la fonctionDescriptionExemple
translate(vector3d vector)Multiplie une matrice this de type matrix4x4 par une autre qui translate les coordonnées selon les composantes de 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)Multiplie la matrice 4x4 d'this par une autre qui fait pivoter les coordonnées de angle degrés autour de 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)Multiplie la matrice this 4×4 par une autre qui fait pivoter les coordonnées selon une quaternion spécifiée. L’ quaternion est supposée avoir été normalisée.
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(réel facteur)Multiplie la matrice 4x4 this par une autre qui met les coordonnées à l'échelle selon le 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(réel x, réel y, réel z)Multiplie la matrice this 4×4 par une autre qui met les coordonnées à l'échelle selon les composantes x, y et 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)Multiplie la matrice 4x4 this par une autre qui met les coordonnées à l'échelle selon les composantes de 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)Multiplie la matrice 4x4 this par une matrice de vue dérivée d’un point eye. Le vecteur 3D center indique le centre de la vue vers laquelle le eye est orienté. Le vecteur 3D up indique quelle direction doit être considérée comme le haut par rapport à eye.
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)Renvoie la matrice 4x4 résultant de la multiplication de la matrice 4x4 this par la matrice 4x4 other 
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)
vecteur4d fois(vecteur4d vecteur)Renvoie le vecteur 4D résultant de la transformation du vecteur vector selon la matrice this 4x4, la matrice étant appliquée avant le vecteur
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)
vecteur3d fois(vecteur3d vecteur)Renvoie le vecteur 3D résultant de la transformation de l’ vector e selon la matrice this e 4x4, la matrice étant appliquée avant le vecteur
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)
matrice4x4 fois(facteur réel)Renvoie la matrice 4x4 résultant de la multiplication de la matrice 4x4 this par le scalaire 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)
matrice 4x4 plus (autre matrice 4x4)Renvoie la matrice 4x4 résultant de l'addition de la matrice this à la matrice other 
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)Renvoie la matrice 4x4 résultant de la soustraction de la matrice 4x4 « other » de la matrice 4x4 « this »
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)
vecteur4d ligne(int which)Renvoie la ligne du vecteur 4D de la matrice this spécifiée par which. Remarque : l'which e est un accès à la matrice à partir de 0.
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 colonne(int which)Renvoie la colonne vector4d de l'this spécifiée par which. Remarque : l'which correspond à un accès à la matrice à partir de 0.
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()Renvoie le déterminant de la matrice this matrix4x4
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()Renvoie l’inverse de la matrice this si celui-ci existe, sinon la matrice identité.
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)
matrice4x4 transposée()Renvoie la transposée de la matrice this matrix4x4
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)Converti le rectangle fourni dans le système de coordonnées défini par cette matrice. Si une rotation ou un cisaillement a été spécifié, cette fonction renvoie le rectangle englobant. Cette fonction a été introduite dans Qt 6.5.
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)Transforme le point fourni dans le système de coordonnées défini par cette matrice. Cette fonction a été introduite dans Qt 6.5.
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)Renvoie « true » si la matrice 4x4 « this » est approximativement égale à la matrice 4x4 « other ». L’approximation est considérée comme vraie si chaque attribut de « this » se situe dans une tolérance « epsilon » par rapport à l’attribut correspondant de « other ». Notez que « epsilon » est un argument facultatif ; la valeur par défaut de « epsilon » est 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

Ce type de valeur est fourni par l’importation QtQuick.

Voir également Types de valeurs 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.