WasdController QML Type

Contrôlez la position et l'orientation des nœuds à l'aide des touches du clavier et de la souris. En savoir plus...

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

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

Cet assistant permet à l'utilisateur de contrôler un nœud à l'aide des touches 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 s'avérer très utile aussi bien dans les applications qui souhaitent proposer un moyen standard de navigation dans la scène que comme solution temporaire pendant le développement et le dépannage, car il permet d'inspecter la scène à l'exécution à l'aide des commandes clavier et souris habituelles.

Les raccourcis clavier sont les suivants :

• W ou up: avancer
• S ou down - reculer
• A ou left - se déplacer latéralement vers la gauche
• D ou right - se déplacer latéralement vers la droite
• R ou page up - monter
• F ou page down - descendre
• shift en combinaison avec d'autres touches - se déplacer plus vite, selon shiftSpeed

L'extrait de code suivant montre comment ajouter un objet WasdController. Par défaut, la navigation au clavier et à la souris est active ; dans la plupart des cas, aucune configuration supplémentaire n'est donc nécessaire :

View3D {
    anchors.fill: parent
    camera: camera
    PerspectiveCamera {
        id: camera
        position: Qt.vector3d(0, 0, 600)
    }
    ...
}

WasdController {
    controlledObject: camera
}

Documentation des propriétés

acceptedButtons : enumeration [default: Qt.LeftButton]

Indique les boutons pris en charge par le contrôleur.

Voir également DragHandler et MultiPointHandler.

backSpeed : real [default: 5]

Définit 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]

Définit la vitesse de navigation lorsque l'on appuie sur la touche « bas ».

forwardSpeed : real [default: 5]

Définit la vitesse de navigation lorsque l'on appuie sur la touche « Avance ».

inputsNeedProcessing : bool [read-only]

Cette propriété est vraie lorsqu'il y a des entrées à traiter.

keysEnabled : bool [default: true]

Active les commandes des touches.

leftSpeed : real [default: 5]

Définit la vitesse de déplacement lorsque l'on appuie sur la touche de gauche.

mouseEnabled : bool [default: true]

Active les commandes à la souris.

rightSpeed : real [default: 5]

Définit la vitesse de navigation lorsque l'on appuie sur la touche de droite.

shiftSpeed : real [default: 3]

Définit le multiplicateur de vitesse actif lorsque la touche Maj est enfoncée.

speed : real [default: 1]

Permet de définir la vitesse de navigation.

upSpeed : real [default: 5]

Définit la vitesse de navigation lorsque l'on appuie sur la touche « haut ».

xInvert : bool [default: false]

Inverse les commandes de l'axe des x.

xSpeed : real [default: 0.1]

Définit la vitesse de déplacement lorsque la souris est déplacée le long de l'axe X.

yInvert : bool [default: true]

Inverse les commandes de l'axe des y.

ySpeed : real [default: 0.1]

Définit la vitesse de déplacement lorsque la souris est déplacée le long de l'axe Y.