Qt3DExtras::QOrbitCameraController Class

class Qt3DExtras::QOrbitCameraController

Die Klasse QOrbitCameraController ermöglicht die Steuerung der Szenenkamera entlang der Umlaufbahn. Mehr...

Kopfzeile:	`#include <QOrbitCameraController>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS 3dextras)` `target_link_libraries(mytarget PRIVATE Qt6::3dextras)`
qmake:	`QT += 3dextras`
Vererbt:	Qt3DExtras::QAbstractCameraController
Status:	Veraltet

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

inversePan : bool
inverseTilt : bool
inverseXTranslate : bool
inverseYTranslate : bool

upVector : QVector3D
zoomInLimit : float
zoomTranslateViewCenter : bool

Ö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, wird die Kamera durch eine Mausbewegung entlang der x-Achse nach links und rechts und durch eine Bewegung entlang der y-Achse nach oben und unten bewegt.
Rechte Maustaste	Bei gedrückter rechter Maustaste wird die Kamera durch eine Mausbewegung entlang der x-Achse um das Zentrum der Kameraansicht geschwenkt und durch eine Bewegung entlang der y-Achse um das Zentrum der Kameraansicht gekippt.
Sowohl linke als auch rechte Maustaste	Wenn sowohl die linke als auch die rechte Maustaste gedrückt sind, wird die Kamera durch Mausbewegungen entlang der y-Achse vergrößert oder verkleinert, ohne dass sich das Zentrum der Ansicht ändert.
Maus-Scrollrad	Vergrößert und verkleinert die Kamera, ohne den Mittelpunkt der Ansicht zu verändern.
Pfeiltasten	Bewegen Sie die Kamera vertikal und horizontal relativ zum Ansichtsfenster der Kamera.
Tasten zum Hoch- und Runterblättern	Bewegen Sie die Kamera vorwärts und rückwärts.
Umschalttaste	Ändert das Verhalten der Pfeiltasten nach oben und nach unten, um die Kamera zu vergrößern oder zu verkleinern, ohne das Zentrum der Ansicht zu verändern. Die anderen Bewegungstasten sind deaktiviert.
Alt-Taste	Ändert das Verhalten der Pfeiltasten zum Schwenken und Neigen der Kamera um das Ansichtszentrum. Deaktiviert die Tasten zum Hoch- und Runterblättern.
Escape-Taste	Bewegt die Kamera so, dass die gesamte Szene im Kamerafenster sichtbar ist.

Eigenschaft Dokumentation

inversePan : bool

Legt fest, ob das Schwenken invertiert wird.

Wenn diese Option aktiviert ist, wird die Kamera bei horizontalen Schwenkbewegungen in die entgegengesetzte Richtung um den Bildmittelpunkt gedreht.

Zugriff auf Funktionen:

bool	inversePan() const
void	setInversePan(bool isInverse)

Benachrichtigungssignal:

void	inversePanChanged(bool isInverse)

inverseTilt : bool

Legt fest, ob die Neigung invertiert ist.

Wenn diese Funktion aktiviert ist, wird die Kamera bei vertikalen Kippbewegungen in die entgegengesetzte Richtung um den Bildmittelpunkt gedreht.

Zugriff auf Funktionen:

bool	inverseTilt() const
void	setInverseTilt(bool isInverse)

Benachrichtigungssignal:

void	inverseTiltChanged(bool isInverse)

inverseXTranslate : bool

Legt fest, ob die horizontale Verschiebung invertiert wird.

Wenn diese Option aktiviert ist, wird die Kamera bei horizontalen Mausbewegungen und Eingaben in die entgegengesetzte Richtung verschoben.

Zugriffsfunktionen:

bool	inverseXTranslate() const
void	setInverseXTranslate(bool isInverse)

Benachrichtigungssignal:

void	inverseXTranslateChanged(bool isInverse)

inverseYTranslate : bool

Legt fest, ob die vertikale Verschiebung invertiert wird.

Wenn aktiviert, wird die Kamera bei vertikalen Mausbewegungen und Eingaben in die entgegengesetzte Richtung verschoben.

Zugriffsfunktionen:

bool	inverseYTranslate() const
void	setInverseYTranslate(bool isInverse)

Benachrichtigungssignal:

void	inverseYTranslateChanged(bool isInverse)

upVector : QVector3D

Enthält den Aufwärtsvektor für die kreisförmige Drehung der Kamera.

Der Aufwärtsvektor definiert die vertikale Achse, um die die Kamera kreist. 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 nahe die Kamera an die Bildmitte herangezoomt werden kann.

Zugriff auf Funktionen:

float	zoomInLimit() const
void	setZoomInLimit(float zoomInLimit)

Benachrichtigungssignal:

void	zoomInLimitChanged()

zoomTranslateViewCenter : bool

Legt fest, ob der Mittelpunkt der Ansicht während des Zoomvorgangs verschoben wird.

Wenn aktiviert, wird beim Zoomen der Mittelpunkt der Ansicht 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)

Benachrichtigungssignal:

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.