OrbitCameraController QML Type
Kamera-Controller, der um einen Ursprung rotiert. Mehr...
Import Statement: | import QtQuick3D.Helpers |
Inherits: |
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
Detaillierte Beschreibung
Dieser Helfer bietet eine Möglichkeit, eine Kamera um einen Ursprung zu drehen. OrbitCameraController akzeptiert einen Knoten als Ursprung und ein Kamera-Objekt, das ein Kind des Ursprungsknotens sein sollte, um es zu steuern. Indem man nur die z-Position der untergeordneten Kamera relativ zum übergeordneten Ursprung anpasst, hat man den Effekt, die Kamera näher oder weiter vom Zielursprung zu bewegen. Durch die Anwendung einer Rotation auf den originNode wird die untergeordnete Kamera um den originNode kreisen.
Das OrbitCameraController-Element selbst ist ein 2D-Element, das Eingabeereignisse akzeptiert, so dass seine Größe und Position dort liegen, wo Eingabeereignisse akzeptiert werden. Zum Zoomen entweder das Scrollrad der Maus verwenden oder eine Pinch-Geste ausführen. Zum Drehen klicken oder berühren und ziehen Sie den Bereich. Zum Schwenken halten Sie die Steuerung gedrückt und ziehen Sie den Bereich. Beim Schwenken wird die Position des Ursprungsknotens geändert. Es ist auch möglich, eine Schwenkgeste auszuführen, indem Sie mit zwei Fingern ziehen.
View3D { camera: cameraNode Node { id: originNode PerspectiveCamera { id: cameraNode z: 100 } } OrbitCameraController { anchors.fill: parent origin: originNode camera: cameraNode } ... }
Eigenschaft Dokumentation
acceptedButtons : Qt::MouseButtons |
Gibt die Maustaste an, mit der die Kamera gesteuert wird.
Diese Eigenschaft wurde in Qt 6.9 eingeführt.
automaticClipping : bool |
camera : QtQuick3D::Camera |
Gibt den zu steuernden Kameraknoten an. Dies ist eine erforderliche Eigenschaft und sollte ein Kind des origin Knotens sein.
mouseEnabled : bool |
Aktiviert die Maussteuerung.
origin : QtQuick3D::Node |
Legt den zu steuernden Ursprungsknoten fest. Dies ist eine erforderliche Eigenschaft und sollte das übergeordnete Element des Knotens camera
panEnabled : bool |
Aktiviert die Schwenksteuerung.
xInvert : bool |
Invertiert die x-Achsen-Steuerung.
xSpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die Maus entlang der X-Achse bewegt wird.
yInvert : bool |
Invertiert die Steuerelemente der y-Achse.
ySpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die Maus entlang der Y-Achse bewegt wird.
© 2025 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.