Qt3DExtras::QOrbitCameraController Class

class Qt3DExtras::QOrbitCameraController

La classe QOrbitCameraController permet de contrôler la caméra de la scène le long de la trajectoire orbitale. Plus d'informations...

En-tête :	`#include <QOrbitCameraController>`
CMake :	`find_package(Qt6 REQUIRED COMPONENTS 3dextras)` `target_link_libraries(mytarget PRIVATE Qt6::3dextras)`
qmake :	`QT += 3dextras`
Hérite :	Qt3DExtras::QAbstractCameraController
Statut :	Déclassé

Liste de tous les membres, y compris les membres hérités

Propriétés

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

upVector : QVector3D
zoomInLimit : float
zoomTranslateViewCenter : bool

Fonctions publiques

bool	inversePan() const
bool	inverseTilt() const
bool	inverseXTranslate() const
bool	inverseYTranslate() const
QVector3D	upVector() const
float	zoomInLimit() const
bool	zoomTranslateViewCenter() const

Emplacements publics

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)

Signaux

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)

Description détaillée

Les contrôles sont les suivants :

Entrée	Action
Bouton gauche de la souris	Lorsque le bouton gauche de la souris est enfoncé, le mouvement de la souris le long de l'axe x déplace la caméra vers la gauche et la droite et le mouvement le long de l'axe y la déplace vers le haut et le bas.
Bouton droit de la souris	Lorsque le bouton droit de la souris est enfoncé, le mouvement de la souris le long de l'axe x fait pivoter la caméra autour du centre de la vue et le mouvement le long de l'axe y la fait basculer autour du centre de la vue.
Bouton gauche et droit de la souris	Lorsque les boutons gauche et droit de la souris sont tous deux enfoncés, le mouvement de la souris le long de l'axe y permet d'effectuer un zoom avant ou arrière sur la caméra sans modifier le centre de la vue.
Roue de défilement de la souris	Effectue un zoom avant et arrière de la caméra sans modifier le centre de la vue.
Touches fléchées	Déplacent la caméra verticalement et horizontalement par rapport à la fenêtre de visualisation de la caméra.
Touches page précédente et page suivante	Déplacent la caméra vers l'avant et vers l'arrière.
Touche Shift	Modifie le comportement des touches fléchées vers le haut et vers le bas afin d'effectuer un zoom avant ou arrière sur la caméra sans modifier le centre de la vue. Les autres touches de déplacement sont désactivées.
Touche Alt	Modifie le comportement des touches fléchées pour effectuer un panoramique et incliner la caméra autour du centre de la vue. Désactive les touches de déplacement vers le haut et vers le bas.
Échappement	Déplace la caméra de manière à ce que toute la scène soit visible dans la fenêtre de visualisation de la caméra.

Documentation sur les propriétés

inversePan : bool

Indique si le panoramique est inversé.

Lorsque cette option est activée, les mouvements panoramiques horizontaux font tourner la caméra autour du centre de la vue dans la direction opposée.

Fonctions d'accès :

bool	inversePan() const
void	setInversePan(bool isInverse)

Signal de notification :

void	inversePanChanged(bool isInverse)

inverseTilt : bool

Indique si l'inclinaison est inversée.

Lorsque cette option est activée, les mouvements d'inclinaison verticale font tourner la caméra autour du centre de la vue dans la direction opposée.

Fonctions d'accès :

bool	inverseTilt() const
void	setInverseTilt(bool isInverse)

Signal de notification :

void	inverseTiltChanged(bool isInverse)

inverseXTranslate : bool

Indique si la translation horizontale est inversée.

Lorsque cette option est activée, les mouvements horizontaux de la souris et la saisie traduisent la caméra dans la direction opposée.

Fonctions d'accès :

bool	inverseXTranslate() const
void	setInverseXTranslate(bool isInverse)

Signal de notification :

void	inverseXTranslateChanged(bool isInverse)

inverseYTranslate : bool

Indique si la translation verticale est inversée.

Lorsque cette option est activée, les mouvements verticaux de la souris et la saisie traduisent la caméra dans la direction opposée.

Fonctions d'accès :

bool	inverseYTranslate() const
void	setInverseYTranslate(bool isInverse)

Signal de notification :

void	inverseYTranslateChanged(bool isInverse)

upVector : QVector3D

Contient le vecteur ascendant pour la rotation orbitale de la caméra.

Le vecteur ascendant définit l'axe vertical autour duquel la caméra orbite. La valeur par défaut est (0,0, 1,0, 0,0).

Fonctions d'accès :

QVector3D	upVector() const
void	setUpVector(const QVector3D &upVector)

Signal de notification :

void	upVectorChanged(const QVector3D &upVector)

zoomInLimit : float

Indique la limite actuelle du zoom avant. La limite de zoom avant détermine à quelle distance du centre de la vue la caméra peut être zoomée.

Fonctions d'accès :

float	zoomInLimit() const
void	setZoomInLimit(float zoomInLimit)

Signal de notification :

void	zoomInLimitChanged()

zoomTranslateViewCenter : bool

Indique si le centre de la vue est translaté lors des opérations de zoom.

Lorsque cette option est activée, le zoom déplace le centre de la vue. Lorsqu'il est désactivé, seule la position de la caméra change lors des opérations de zoom. La valeur par défaut est true.

Fonctions d'accès :

bool	zoomTranslateViewCenter() const
void	setZoomTranslateViewCenter(bool isTranslate)

Signal de notification :

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.