WasdController QML Type
Contrôlez la position et l'orientation des nœuds à l'aide des touches et de la souris. Plus d'informations...
| Import Statement: | import QtQuick3D.Helpers |
| Inherits: |
Propriétés
- acceptedButtons : enumeration
- backSpeed : real
- controlledObject : QtQuick3D::Node
- downSpeed : real
- forwardSpeed : real
- inputsNeedProcessing : bool
- keysEnabled : bool
- leftSpeed : real
- mouseEnabled : bool
- rightSpeed : real
- shiftSpeed : real
- speed : real
- upSpeed : real
- xInvert : bool
- xSpeed : real
- yInvert : bool
- ySpeed : real
Description détaillée
Cette aide permet à l'utilisateur de contrôler un nœud à l'aide de W, A, S, D, des touches fléchées et de la souris. En général, le nœud contrôlé est une caméra, spécifiée dans la propriété controlledObject.
L'ajout d'un WasdController peut être très utile à la fois dans les applications qui souhaitent fournir un moyen standard de naviguer dans la scène, et aussi comme mesure temporaire pendant le développement et le dépannage, car il permet d'inspecter la scène au moment de l'exécution par une navigation familière au clavier et à la souris.
Les raccourcis clavier sont les suivants
Wouup- aller en avantSoudown- aller en arrièreAouleft- aller à gaucheDouright- se déplacer vers la droiteRoupage up- se déplacer vers le hautFoupage down- se déplacer vers le basshiftavec d'autres touches - se déplacer plus rapidement, en fonction de la vitesse de déplacement. shiftSpeed
L'extrait suivant montre comment un objet WasdController peut être ajouté. Par défaut, la navigation par touche et par souris est active, de sorte que, dans la plupart des cas, aucune autre configuration n'est nécessaire :
View3D {
anchors.fill: parent
camera: camera
PerspectiveCamera {
id: camera
position: Qt.vector3d(0, 0, 600)
}
...
}
WasdController {
controlledObject: camera
}Documentation sur les propriétés
acceptedButtons : enumeration [default: Qt.LeftButton]
Spécifie les boutons acceptés par le contrôleur.
Voir également DragHandler et MultiPointHandler.
backSpeed : real [default: 5]
Spécifie la vitesse de navigation lorsque l'on appuie sur la touche retour.
controlledObject : QtQuick3D::Node
Spécifie le nœud à contrôler. Il s'agit généralement d'un objet Camera.
downSpeed : real [default: 5]
Spécifie la vitesse de navigation lorsque la touche bas est enfoncée.
forwardSpeed : real [default: 5]
Spécifie la vitesse de navigation lorsque l'on appuie sur la touche avant.
inputsNeedProcessing : bool [read-only]
Cette propriété est vraie lorsqu'il y a des entrées à traiter.
keysEnabled : bool [default: true]
Active les contrôles des touches.
leftSpeed : real [default: 5]
Spécifie la vitesse de navigation lorsque la touche gauche est enfoncée.
mouseEnabled : bool [default: true]
Active les commandes de la souris.
rightSpeed : real [default: 5]
Spécifie la vitesse de navigation lorsque la touche droite est enfoncée.
shiftSpeed : real [default: 3]
Spécifie le multiplicateur de vitesse actif lorsque la touche shift est enfoncée.
speed : real [default: 1]
Spécifie la vitesse de navigation.
upSpeed : real [default: 5]
Spécifie la vitesse de navigation lorsque l'on appuie sur la touche haut.
xInvert : bool [default: false]
Inverse les contrôles de l'axe des x.
xSpeed : real [default: 0.1]
Spécifie la vitesse de navigation lorsque la souris est déplacée le long de l'axe X.
yInvert : bool [default: true]
Inverse les contrôles de l'axe des y.
ySpeed : real [default: 0.1]
Spécifie la vitesse de navigation lorsque la souris est déplacée le long de l'axe Y.
© 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.