Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

matrix4x4 QML Value Type

4x4 행렬이란 4행 4열로 이루어진 행렬을 말합니다. 더 보기...

Import Statement: import QtQuick

상세 설명

matrix4x4 유형은 16개의 값을 가지며, 각 값은 QML에서 m11 부터 m44 까지의 속성을 통해(행/열 순서대로) 접근할 수 있습니다. 이 유형의 값은 Qt.matrix4x4() 함수를 사용하여 생성할 수 있습니다. matrix4x4의 각 속성은 실수(ARM에서는 단정밀도, x86에서는 이중정밀도)로 저장됩니다.

matrix4x4 유형의 속성은 기본값으로 단위 행렬을 갖습니다. 이 단위 행렬의 대각선 요소 m11, m22, m33 및 m44 은 모두 1 이며, 나머지 모든 성분은 0 입니다.

matrix4x4 유형에는 QML에서 호출할 수 있는 다음과 같은 항등 함수가 있습니다:

함수 시그니처설명예시
translate(vector3d vector)this 의 4x4 행렬에, 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 행렬에, 좌표를 angle 도만큼 회전시키는 다른 행렬을 곱합니다. 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)this 의 4x4 행렬에, 지정된 quaternion 에 따라 좌표를 회전시키는 또 다른 행렬을 곱합니다. quaternion 는 정규화된 것으로 가정합니다.
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(실수 인자)this 행렬 4x4에, 주어진 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(실수 x, 실수 y, 실수 z)this 행렬 4x4에, 좌표를 성분 x, y 및 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)this 의 4x4 행렬을, 좌표를 다음 성분들로 확대/축소하는 다른 행렬과 곱합니다. , , 그리고scale(vector3d vector) 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)this 행렬 4x4를 eye 점에서 파생된 시야 행렬과 곱합니다. center 벡터 3D는 eye 가 바라보고 있는 시야의 중심을 나타냅니다. up 벡터 3D는 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)this 의 matrix4x4와 other 의 matrix4x4를 곱한 결과인 matrix4x4를 반환합니다.
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)vector 를 this 행렬에 따라 변환한 결과인 4차원 벡터를 반환합니다. 이 행렬은 벡터 적용 전 단계에서 적용됩니다.
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)vector 을 this matrix4x4에 따라 변환한 결과인 vector3d를 반환하며, 행렬은 벡터 앞에 적용됩니다.vector3d 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)this 행렬에 스칼라를 곱한 결과인 matrix4x4를 반환합니다. 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 other)this 행렬과 other 행렬을 더한 결과인 4x4 행렬을 반환합니다.
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)other 행렬4x4에서 this 행렬4x4를 뺀 결과인 행렬4x4를 반환합니다.
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)which 로 지정된 this 의 행 벡터4d를 반환합니다. 참고: 행 벡터( which )는 행렬 내에서 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 column(int which)which 로 지정된 this 의 vector4d 열을 반환합니다. 참고: which 는 행렬에 대한 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()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()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.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 transposed()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)제공된 직사각형을 이 행렬로 정의된 좌표계로 매핑합니다. 회전이나 변형이 지정된 경우, 이 함수는 경계 직사각형을 반환합니다. 이 함수는 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)제공된 점을 이 행렬로 정의된 좌표계로 매핑합니다. 이 함수는 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)this 의 matrix4x4가 other 의 matrix4x4와 근사적으로 같을 경우 true를 반환합니다. this 의 각 속성이 other 의 해당 속성으로부터 epsilon 이내일 때 근사값이 참으로 간주됩니다. epsilon 는 선택적 인자이며, 기본값 epsilon 은 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

이 값 유형은 QtQuick 임포트를 통해 제공됩니다.

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.