OrbitCameraController QML Type

Kamerasteuerung, die sich um einen Ursprung dreht. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

• acceptedButtons : Qt::MouseButtons (since 6.9)
• automaticClipping : bool (since 6.9)
• camera : QtQuick3D::Camera
• mouseEnabled : bool
• origin : QtQuick3D::Node
• panEnabled : bool
• xInvert : bool
• xSpeed : real
• yInvert : bool
• ySpeed : real

Ausführliche Beschreibung

Dieser Helper ermöglicht es, eine Kamera um einen Ursprung zu drehen. Für seine Funktion benötigt der OrbitCameraController einen Knoten als Ursprung sowie ein Kameraobjekt, das ein untergeordnetes Element des zu steuernden Ursprungsknotens sein sollte. Durch die Anpassung der z-Position der untergeordneten Kamera relativ zum übergeordneten Ursprung wird die Kamera näher an den Zielursprung herangeführt oder weiter von ihm entfernt. Durch Anwenden einer Drehung auf den Ursprungsknoten umkreist die untergeordnete Kamera den Ursprungsknoten.

Das „OrbitCameraController“-Element selbst ist ein 2D-Element, das Eingabeereignisse akzeptiert; unabhängig von seiner Größe und Position werden Eingabeereignisse an der Stelle akzeptiert, an der sich das Element befindet. Zum Zoomen verwenden Sie entweder das Scrollrad der Maus oder führen Sie eine Pinch-Geste aus. Zum Drehen klicken oder tippen Sie auf den Bereich und ziehen Sie ihn. Zum Schwenken halten Sie die Strg-Taste gedrückt und ziehen Sie den Bereich. Durch das Schwenken ändert sich die Position des Ursprungsknotens. Es ist auch möglich, eine Schwenkgeste durch Ziehen mit zwei Fingern auszuführen.

View3D {
    camera: cameraNode
    Node {
        id: originNode
        PerspectiveCamera {
            id: cameraNode
            z: 100
        }
    }
    OrbitCameraController {
        anchors.fill: parent
        origin: originNode
        camera: cameraNode
    }
    ...
}

Dokumentation der Eigenschaften

acceptedButtons : Qt::MouseButtons [default: Qt.LeftButton, since 6.9]

Legt fest, welche Maustaste die Kamera steuert.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

automaticClipping : bool [default: true, since 6.9]

Ermöglicht die automatische Aktualisierung der Eigenschaften „ clipNear “, „ “ und „l{PerspectiveCamera::}{clipFar}“ der „ camera “ basierend auf der z-Position der Kamera.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

camera : QtQuick3D::Camera

Gibt den zu steuernden Kameraknoten an. Dies ist eine erforderliche Eigenschaft, und der Knoten sollte ein untergeordneter Knoten des Knotens „ origin “ sein.

mouseEnabled : bool [default: true]

Aktiviert die Maussteuerung.

origin : QtQuick3D::Node

Gibt den zu steuernden Ursprungsknoten an. Dies ist eine erforderliche Eigenschaft und sollte der übergeordnete Knoten des camera

panEnabled : bool [default: true]

Aktiviert die Steuerelemente zum Schwenken.

xInvert : bool [default: false]

Kehrt die Steuerung der x-Achse um.

xSpeed : real [default: 0.1]

Legt die Navigationsgeschwindigkeit fest, wenn die Maus entlang der X-Achse bewegt wird.

yInvert : bool [default: true]

Kehrt die Steuerung der y-Achse um.

ySpeed : real [default: 0.1]

Legt die Navigationsgeschwindigkeit fest, wenn die Maus entlang der Y-Achse bewegt wird.