En esta página

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.