Rotation QML Type

Bietet eine Möglichkeit, ein Element zu drehen. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

Der Rotationstyp bietet die Möglichkeit, ein Element ( Item ) mithilfe einer Rotationstransformation zu drehen.

Er ermöglicht eine Drehung um die z-Achse relativ zu einem beliebigen Punkt und bietet zudem die Möglichkeit, 3D-ähnliche Drehungen für Elemente festzulegen. Dadurch lässt sich die Drehung von Elementen besser steuern als mit der Eigenschaft „ rotation “.

Das folgende Beispiel dreht ein Rechteck um seinen Mittelpunkt (25, 25):

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

Für 3D-ähnliche Elementrotationen müssen Sie zusätzlich zum Ursprungspunkt die Rotationsachse angeben. Das folgende Beispiel zeigt verschiedene 3D-ähnliche Rotationen, die auf ein „ Image “-Element angewendet werden.

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 }
    }
}

Siehe auch das Beispiel „Drehregler“ und die „Qt Quick “-Demo – Uhren.

Dokumentation zu den Eigenschaften

angle : real

Der Drehwinkel in Grad im Uhrzeigersinn.

axis group

Die Achse, um die gedreht werden soll. Bei einer einfachen (2D-)Drehung um einen Punkt müssen Sie keine Achse angeben, da die Standardachse die z-Achse ist (axis { x: 0; y: 0; z: 1 }).

Für eine typische 3D-ähnliche Drehung geben Sie in der Regel sowohl den Ursprung als auch die Achse an.

distanceToPlane : real [since 6.11]

Diese Eigenschaft definiert den Abstand zwischen der Bildebene (dem virtuellen Bildschirm) und dem Betrachter im perspektivischen Projektionsmodell.

Ein kleinerer Abstand erzeugt einen stärkeren Perspektiveffekt, wodurch das Objekt bei der Drehung dramatischer in den Hintergrund zu rücken oder in den Vordergrund zu treten scheint. Ein größerer Wert führt zu einer flacheren, eher orthografischen Darstellung mit weniger sichtbarer perspektivischer Verzerrung.

Der Standardwert ist „ 1024.0 “, was eine moderate Perspektive bietet, die für die meisten Anwendungsfälle geeignet ist.

Wenn diese Eigenschaft auf ` 0` gesetzt ist, wird keine perspektivische Projektion angewendet. In diesem Fall erfolgt die Drehung direkt im 3D-Raum unter Verwendung der durch ` QMatrix4x4::rotate()` definierten Transformation.

Diese Eigenschaft wirkt sich nur auf Drehungen um die x- und y-Achse aus. Drehungen um die z-Achse (2D-Drehungen) werden von dieser Eigenschaft nicht beeinflusst.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

origin group

Der Drehpunkt der Drehung (d. h. der Punkt, der relativ zum übergeordneten Element fest bleibt, während sich der Rest des Elements dreht). Standardmäßig liegt der Drehpunkt bei (0, 0).