Qt3DExtras::QOrbitCameraController Class
class Qt3DExtras::QOrbitCameraControllerDie Klasse „QOrbitCameraController“ ermöglicht die Steuerung der Szenenkamera entlang einer Umlaufbahn. Mehr...
| Header: | #include <qorbitcameracontroller.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dextras) target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake: | QT += 3dextras |
| Erbt von: | Qt3DExtras::QAbstractCameraController |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
|
|
Öffentliche Funktionen
| bool | inversePan() const |
| bool | inverseTilt() const |
| bool | inverseXTranslate() const |
| bool | inverseYTranslate() const |
| QVector3D | upVector() const |
| float | zoomInLimit() const |
| bool | zoomTranslateViewCenter() const |
Öffentliche Slots
| void | setInversePan(bool isInverse) |
| void | setInverseTilt(bool isInverse) |
| void | setInverseXTranslate(bool isInverse) |
| void | setInverseYTranslate(bool isInverse) |
| void | setUpVector(const QVector3D &upVector) |
| void | setZoomInLimit(float zoomInLimit) |
| void | setZoomTranslateViewCenter(bool isTranslate) |
Signale
| void | inversePanChanged(bool isInverse) |
| void | inverseTiltChanged(bool isInverse) |
| void | inverseXTranslateChanged(bool isInverse) |
| void | inverseYTranslateChanged(bool isInverse) |
| void | upVectorChanged(const QVector3D &upVector) |
| void | zoomInLimitChanged() |
| void | zoomTranslateViewCenterChanged(bool isTranslate) |
Detaillierte Beschreibung
Die Steuerelemente sind:
| Eingabe | Aktion |
|---|---|
| Linke Maustaste | Solange die linke Maustaste gedrückt ist, bewegt sich die Kamera bei einer Mausbewegung entlang der x-Achse nach links und rechts und bei einer Bewegung entlang der y-Achse nach oben und unten. |
| Rechte Maustaste | Solange die rechte Maustaste gedrückt ist, bewirkt eine Bewegung der Maus entlang der x-Achse eine Schwenkbewegung der Kamera um den Blickpunkt, und eine Bewegung entlang der y-Achse bewirkt eine Neigung der Kamera um den Blickpunkt. |
| Linke und rechte Maustaste | Wenn sowohl die linke als auch die rechte Maustaste gedrückt sind, bewirkt die Bewegung der Maus entlang der y-Achse ein Vergrößern und Verkleinern der Kamera, ohne den Blickpunkt zu verändern. |
| Mausrad | Vergrößert und verkleinert die Kamera, ohne den Blickpunkt zu verändern. |
| Pfeiltasten | Bewegen die Kamera vertikal und horizontal relativ zum Kamera-Ansichtsfenster. |
| Bild-auf- und Bild-ab-Tasten | Bewegt die Kamera vorwärts und rückwärts. |
| Umschalttaste | Ändert das Verhalten der Aufwärts- und Abwärts-Pfeiltasten, sodass die Kamera vergrößert und verkleinert wird, ohne den Blickpunkt zu verändern. Die anderen Bewegungstasten sind deaktiviert. |
| Alt-Taste | Ändert das Verhalten der Pfeiltasten, sodass die Kamera um den Bildmittelpunkt geschwenkt und geneigt wird. Deaktiviert die Tasten „Bild auf“ und „Bild ab“. |
| Esc | Bewegt die Kamera so, dass die gesamte Szene im Kamera-Ansichtsfenster sichtbar ist. |
Eigenschaftsdokumentation
inversePan : bool
Gibt an, ob das Schwenken umgekehrt erfolgt.
Wenn diese Option aktiviert ist, drehen horizontale Schwenkbewegungen die Kamera in entgegengesetzter Richtung um den Bildmittelpunkt.
Zugriffsfunktionen:
| bool | inversePan() const |
| void | setInversePan(bool isInverse) |
Benachrichtigungssignal:
| void | inversePanChanged(bool isInverse) |
inverseTilt : bool
Gibt an, ob die Neigung umgekehrt ist.
Wenn diese Option aktiviert ist, drehen vertikale Neigungsbewegungen die Kamera in entgegengesetzter Richtung um den Bildmittelpunkt.
Zugriffsfunktionen:
| bool | inverseTilt() const |
| void | setInverseTilt(bool isInverse) |
Benachrichtigungssignal:
| void | inverseTiltChanged(bool isInverse) |
inverseXTranslate : bool
Gibt an, ob die horizontale Verschiebung umgekehrt ist.
Wenn diese Option aktiviert ist, bewirken horizontale Mausbewegungen und Eingaben eine Verschiebung der Kamera in die entgegengesetzte Richtung.
Zugriffsfunktionen:
| bool | inverseXTranslate() const |
| void | setInverseXTranslate(bool isInverse) |
Benachrichtigungssignal:
| void | inverseXTranslateChanged(bool isInverse) |
inverseYTranslate : bool
Gibt an, ob die vertikale Verschiebung umgekehrt ist.
Wenn diese Option aktiviert ist, bewirken vertikale Mausbewegungen und Eingaben eine Verschiebung der Kamera in die entgegengesetzte Richtung.
Zugriffsfunktionen:
| bool | inverseYTranslate() const |
| void | setInverseYTranslate(bool isInverse) |
Benachrichtigungssignal:
| void | inverseYTranslateChanged(bool isInverse) |
upVector : QVector3D
Enthält den Aufwärtsvektor für die Umlaufrotation der Kamera.
Der „up“-Vektor definiert die vertikale Achse, um die sich die Kamera dreht. Der Standardwert ist (0,0; 1,0; 0,0).
Zugriffsfunktionen:
| QVector3D | upVector() const |
| void | setUpVector(const QVector3D &upVector) |
Benachrichtigungssignal:
| void | upVectorChanged(const QVector3D &upVector) |
zoomInLimit : float
Enthält die aktuelle Vergrößerungsgrenze. Die Vergrößerungsgrenze legt fest, wie nah an die Bildmitte die Kamera herangezoomt werden kann.
Zugriffsfunktionen:
| float | zoomInLimit() const |
| void | setZoomInLimit(float zoomInLimit) |
Benachrichtigungssignal:
| void | zoomInLimitChanged() |
zoomTranslateViewCenter : bool
Gibt an, ob der Blickpunkt bei Zoomvorgängen verschoben wird.
Wenn diese Option aktiviert ist, wird der Ansichtsmittelpunkt beim Zoomen verschoben. Wenn sie deaktiviert ist, ändert sich bei Zoomvorgängen nur die Kameraposition. Der Standardwert ist „true“.
Zugriffsfunktionen:
| bool | zoomTranslateViewCenter() const |
| void | setZoomTranslateViewCenter(bool isTranslate) |
Notifier-Signal:
| void | zoomTranslateViewCenterChanged(bool isTranslate) |
© 2026 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.
