Rotation QML Type

Bietet eine Möglichkeit, ein Item 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

Detaillierte Beschreibung

Der Typ Rotation ermöglicht es, eine Item durch eine Transformation vom Typ Rotation zu drehen.

Er ermöglicht die Rotation (z-Achse) relativ zu einem beliebigen Punkt und bietet außerdem eine Möglichkeit, 3D-ähnliche Rotationen für Elemente anzugeben. Dies gibt mehr Kontrolle über die Elementrotation als die rotation Eigenschaft.

Im folgenden Beispiel wird ein Rechteck um seinen inneren Punkt (25, 25) gedreht:

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

Für 3D-ähnliche Elementdrehungen müssen Sie zusätzlich zum Ursprungspunkt die Drehachse angeben. Das folgende Beispiel zeigt verschiedene 3D-ähnliche Drehungen, die auf ein Image 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 Dial Control Beispiel und Qt Quick Demo - Clocks.

Eigenschaft Dokumentation

angle : real

Der Winkel, um den gedreht werden soll, in Grad im Uhrzeigersinn.

axis group

Die Achse, um die gedreht werden soll. Für eine einfache (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 normalerweise sowohl den Ursprung als auch die Achse an.

distanceToPlane : real [since 6.11]

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

Ein kleinerer Abstand erzeugt einen stärkeren perspektivischen Effekt, so dass das Objekt während der Drehung stärker zurück- oder vorzurücken scheint. Ein größerer Wert führt zu einem flacheren, eher orthografischen Erscheinungsbild mit weniger sichtbarer perspektivischer Verzerrung.

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

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

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

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

origin group

Der Ursprungspunkt der Drehung (d. h. der Punkt, der relativ zum übergeordneten Element fixiert bleibt, während sich der Rest des Elements dreht). Standardmäßig ist der Ursprung (0, 0).