QGraphicsRotation Class
La clase QGraphicsRotation permite realizar una transformación de rotación alrededor de un eje determinado. Más información...
| Encabezado: | #include <QGraphicsRotation> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QGraphicsTransform |
Propiedades
Funciones públicas
| QGraphicsRotation(QObject *parent = nullptr) | |
| virtual | ~QGraphicsRotation() |
| qreal | angle() const |
| QVector3D | axis() const |
| QVector3D | origin() const |
| void | setAngle(qreal) |
| void | setAxis(const QVector3D &axis) |
| void | setAxis(Qt::Axis axis) |
| void | setOrigin(const QVector3D &point) |
Funciones públicas reimplementadas
| virtual void | applyTo(QMatrix4x4 *matrix) const override |
Señales
| void | angleChanged() |
| void | axisChanged() |
| void | originChanged() |
Descripción detallada
Se puede especificar el eje deseado asignando un objeto ` QVector3D ` a la propiedad `axis` o pasando un miembro ` Qt::Axis ` a la función de conveniencia ` setAxis `. Por defecto, el eje es (0, 0, 1), es decir, la rotación alrededor del eje Z.
La propiedad «angle», proporcionada por QGraphicsRotation, describe ahora el número de grados en que se debe girar alrededor de este eje.
QGraphicsRotation proporciona ciertos parámetros que ayudan a controlar cómo debe aplicarse la rotación.
El origen es el punto alrededor del cual gira el elemento (es decir, permanece fijo con respecto al elemento padre mientras el resto del elemento gira). Por defecto, el origen es QPointF(0, 0).
La propiedad «angle» proporciona el número de grados en que se debe girar el elemento en el sentido de las agujas del reloj alrededor del origen. Este valor también puede ser negativo, lo que indica una rotación en sentido contrario a las agujas del reloj. A efectos de animación, también puede resultar útil especificar ángulos de rotación que superen los (-360, 360) grados, por ejemplo, para animar cómo un elemento gira varias veces.
Nota: la rotación final es el efecto combinado de una rotación en el espacio 3D seguida de una proyección de vuelta a 2D. Si se realizan varias rotaciones sucesivas, no se comportarán como se espera a menos que todas ellas sean alrededor del eje Z.
Véase también QGraphicsTransform, QGraphicsItem::setRotation() y QTransform::rotate().
Documentación de propiedades
angle : qreal
Esta propiedad indica el ángulo de rotación en el sentido de las agujas del reloj, en grados.
El ángulo puede ser cualquier número real; el valor por defecto es 0,0. Un valor de 180 girará 180 grados en el sentido de las agujas del reloj. Si se introduce un número negativo, el elemento girará en sentido contrario a las agujas del reloj. Normalmente, el ángulo de rotación estará comprendido entre -360 y 360, pero también se pueden introducir números fuera de este rango (por ejemplo, un ángulo de 370 grados da el mismo resultado que uno de 10 grados). Si se establece el ángulo en NaN, no se producirá ninguna rotación.
Funciones de acceso:
| qreal | angle() const |
| void | setAngle(qreal) |
Señal de notificación:
| void | angleChanged() |
Véase también «origin».
axis : QVector3D
Esta propiedad contiene un eje de rotación, especificado por un vector en el espacio 3D.
Puede ser cualquier eje del espacio 3D. Por defecto, el eje es (0, 0, 1), que está alineado con el eje Z. Si se especifica otro eje, QGraphicsRotation proporcionará una transformación que gira alrededor de dicho eje. Por ejemplo, si se desea girar un elemento alrededor de su eje X, se podría pasar (1, 0, 0) como eje.
Funciones de acceso:
| QVector3D | axis() const |
| void | setAxis(const QVector3D &axis) |
| void | setAxis(Qt::Axis axis) |
Señal de notificación:
| void | axisChanged() |
Véase también QTransform y QGraphicsRotation::angle.
origin : QVector3D
Esta propiedad contiene el origen de la rotación en el espacio 3D.
Todas las rotaciones se realizarán con respecto a este punto (es decir, este punto permanecerá fijo, con respecto al elemento padre, cuando se gire el elemento).
Funciones de acceso:
| QVector3D | origin() const |
| void | setOrigin(const QVector3D &point) |
Señal de notificación:
| void | originChanged() |
Véase también angle.
Documentación de las funciones miembro
QGraphicsRotation::QGraphicsRotation(QObject *parent = nullptr)
Crea un nuevo objeto `QGraphicsRotation` con el ` parent` indicado.
[virtual noexcept] QGraphicsRotation::~QGraphicsRotation()
Anula la rotación de los gráficos.
[signal] void QGraphicsRotation::angleChanged()
Esta señal se emite cada vez que cambia el ángulo.
Nota: Señalde notificación para la propiedad angle.
Véase también QGraphicsRotation::angle.
[override virtual] void QGraphicsRotation::applyTo(QMatrix4x4 *matrix) const
Reimplementa: ` QGraphicsTransform::applyTo(QMatrix4x4 *matrix) const`.
[signal] void QGraphicsRotation::axisChanged()
Esta señal se emite cada vez que cambia el eje del objeto.
Nota: Señalde notificador para la propiedad axis.
Véase también « QGraphicsRotation::axis ».
[signal] void QGraphicsRotation::originChanged()
Esta señal se emite cada vez que cambia el origen.
Nota: Señalde notificación para la propiedad «origin».
Véase también QGraphicsRotation::origin.
void QGraphicsRotation::setAxis(Qt::Axis axis)
Función práctica para establecer el eje en axis.
Nota: la rotación « Qt::YAxis » para « QTransform » está invertida con respecto a la rotación matemática correcta en el espacio 3D. La clase « QGraphicsRotation » implementa una rotación matemática correcta. Las dos secuencias de código siguientes realizarán la misma transformación:
QTransform t;
t.rotate(45, Qt::YAxis);
QGraphicsRotation r;
r.setAxis(Qt::YAxis);
r.setAngle(-45);Nota: Funciónsetter para la propiedad axis.
Véase también axis().
© 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.