Rotation QML Type

Permite rotar un elemento. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• angle : real
• axis
  • axis.x : real
  • axis.y : real
  • axis.z : real
• distanceToPlane : real (since 6.11)
• origin
  • origin.x : real
  • origin.y : real

Descripción detallada

El tipo Rotación permite rotar un Item mediante una transformación de tipo rotación.

Permite que la rotación (eje z) sea relativa a un punto arbitrario, y también proporciona una forma de especificar rotaciones de tipo 3D para los elementos. Esto da más control sobre la rotación de elementos que la propiedad rotation.

El siguiente ejemplo rota un Rectángulo alrededor de su punto interior (25, 25):

Rectangle {
    width: 100; height: 100
    color: "blue"
    transform: Rotation { origin.x: 25; origin.y: 25; angle: 45}
}

Para rotaciones de elementos 3D, debe especificar el eje de rotación además del punto de origen. El siguiente ejemplo muestra varias rotaciones de tipo 3D aplicadas a un Image.

import QtQuick

Row {
    x: 10; y: 10
    spacing: 10

    Image { source: "images/qt-logo.png" }
    Image {
        source: "images/qt-logo.png"
        transform: Rotation { origin.x: 30; origin.y: 30; axis { x: 0; y: 1; z: 0 } angle: 18 }
    }
    Image {
        source: "images/qt-logo.png"
        transform: Rotation { origin.x: 30; origin.y: 30; axis { x: 0; y: 1; z: 0 } angle: 36 }
    }
    Image {
        source: "images/qt-logo.png"
        transform: Rotation { origin.x: 30; origin.y: 30; axis { x: 0; y: 1; z: 0 } angle: 54 }
    }
    Image {
        source: "images/qt-logo.png"
        transform: Rotation { origin.x: 30; origin.y: 30; axis { x: 0; y: 1; z: 0 } angle: 72 }
    }
}

Véase también el ejemplo de Control de Esfera y Qt Quick Demo - Relojes.

Documentación de propiedades

angle : real

El ángulo a rotar, en grados en el sentido de las agujas del reloj.

axis group

El eje alrededor del cual se girará. Para una rotación simple (2D) alrededor de un punto, no es necesario especificar un eje, ya que el eje por defecto es el eje z (axis { x: 0; y: 0; z: 1 }).

Para una rotación típica en 3D, normalmente especificará tanto el origen como el eje.

distanceToPlane : real [since 6.11]

Esta propiedad define la distancia entre el plano de visión (la pantalla virtual) y el observador en el modelo de proyección en perspectiva.

Una distancia menor produce un efecto de perspectiva más fuerte, haciendo que el objeto parezca retroceder o avanzar más drásticamente durante la rotación. Un valor mayor produce un aspecto más plano y ortográfico, con una distorsión de la perspectiva menos visible.

El valor predeterminado es 1024.0, que proporciona una perspectiva moderada adecuada para la mayoría de los casos de uso.

Cuando esta propiedad se establece en 0, no se aplica ninguna proyección de perspectiva. En este caso, la rotación se realiza directamente en el espacio 3D utilizando la transformación definida por QMatrix4x4::rotate().

Esta propiedad sólo afecta a las rotaciones alrededor de los ejes x e y. Las rotaciones alrededor del eje z (rotaciones 2D) no se ven afectadas por esta propiedad.

Esta propiedad se introdujo en Qt 6.11.

origin group

El punto de origen de la rotación (es decir, el punto que permanece fijo respecto al padre mientras el resto del elemento gira). Por defecto, el origen es (0, 0).