matrix4x4 QML Value Type
Una matriz de tipo 4x4 es una matriz de 4 filas y 4 columnas. Más información...
| Import Statement: | import QtQuick |
Descripción detallada
Un tipo « matrix4x4 » tiene dieciséis valores, a los que se puede acceder a través de las propiedades « m11 » hasta « m44 » en QML (en orden de fila/columna). Los valores de este tipo se pueden crear con la función Qt.matrix4x4(). Cada atributo de una matriz 4x4 se almacena como un número real (precisión simple en ARM, precisión doble en x86).
Una propiedad de tipo matrix4x4 toma por defecto la matriz identidad, cuyos elementos diagonales m11, m22, m33 y m44 son todos 1, mientras que el resto de componentes son 0.
El tipo «matrix4x4» cuenta con las siguientes funciones idempotentes que pueden invocarse en QML:
| Firma de la función | Descripción | Ejemplo |
|---|---|---|
| translate(vector3d vector) | Multiplica una matriz this de tipo matrix4x4 por otra que traslada las coordenadas según los componentes de vector | |
| rotate(real angle, vector3d axis) | Multiplica una matriz 4x4 de this por otra que gira las coordenadas un ángulo de angle grados alrededor de axis | |
| rotate(cuaternión cuaternión) | Multiplica una matriz 4x4 de tipo « this » por otra que gira las coordenadas según un ángulo especificado de « quaternion ». Se supone que el « quaternion » ha sido normalizado. | |
| scale(factor real) | Multiplica una matriz 4x4 this por otra que escala las coordenadas según el valor dado factor | |
| scale(real x, real y, real z) | Multiplica una matriz this de 4x4 por otra que escala las coordenadas según los componentes x, y y z | |
| scale(vector3d vector) | Multiplica una matriz 4x4 de tipo « this » por otra que escala las coordenadas según los componentes de vector | |
| lookAt(vector3d eye, vector3d center, vector3d up) | Multiplica la matriz 4x4 « this » por una matriz de visión derivada de un punto « eye ». El vector « center » indica el centro de la vista hacia el que mira el « eye ». El vector « up » indica qué dirección debe considerarse «arriba» con respecto a « eye ». | |
| matrix4x4 times(matrix4x4 other) | Devuelve la matriz 4x4 resultante de multiplicar la matriz 4x4 this por la matriz 4x4 other | |
| vector4d times(vector4d vector) | Devuelve el vector4d resultante de transformar el vector según la matriz this de 4x4, con la matriz aplicada al vector | |
| vector3d times(vector3d vector) | Devuelve el vector3d resultante de transformar el vector e según la matriz this e de 4x4, aplicándose la matriz antes del vector | |
| matriz4x4 por (factor real) | Devuelve la matriz 4x4 resultante de multiplicar una matriz 4x4 this por el escalar factor | |
| matriz4x4 más(matriz4x4 otra) | Devuelve el resultado de la suma de una matriz 4x4 ( this ) con otra matriz 4x4 ( other ) | |
| matrix4x4 minus(matrix4x4 other) | Devuelve la matriz 4x4 resultante de la resta de una matriz 4x4 « other » de una matriz 4x4 « this » | |
| vector4d fila(int cual) | Devuelve la fila del vector4d de this especificada por which. Nota: el which es un acceso a la matriz basado en 0. | |
| vector4d column(int which) | Devuelve la columna vector4d de la matriz this especificada por which. Nota: el which es un acceso a la matriz con índice 0 como punto de partida. | |
| real determinant() | Devuelve el determinante de this matrix4x4 | |
| matrix4x4 inverted() | Devuelve la inversa de this matrix4x4 si existe; en caso contrario, devuelve la matriz identidad. | |
| matriz4x4 transpuesta() | Devuelve la transpuesta de this matriz4x4 | |
| rect mapRect(rect) | Asigna el rectángulo proporcionado al sistema de coordenadas definido por esta matriz. Si se ha especificado una rotación o un sesgo, esta función devuelve el rectángulo delimitador. Esta función se introdujo en Qt 6.5. | |
| point map(point) | Mapea el punto proporcionado al sistema de coordenadas definido por esta matriz. Esta función se introdujo en Qt 6.5. | |
| bool fuzzyEquals(matrix4x4 other, real epsilon) | Devuelve «true» si la matriz 4x4 « this » es aproximadamente igual a la matriz 4x4 « other ». La aproximación será verdadera si cada atributo de « this » se encuentra dentro de « epsilon » del atributo respectivo de « other ». Ten en cuenta que « epsilon » es un argumento opcional; el valor predeterminado de « epsilon » es 0,00001. | |
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.