WasdController QML Type
Steuerung der Position und Ausrichtung von Knoten mit Tasten und Maus. Mehr...
Import Statement: | import QtQuick3D.Helpers |
Inherits: |
Eigenschaften
- 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
Detaillierte Beschreibung
Diese Hilfsfunktion ermöglicht es dem Benutzer, einen Knoten mit W, A, S, D, den Pfeiltasten und der Maus zu steuern. Normalerweise ist der kontrollierte Knoten eine Kamera, die in der Eigenschaft controlledObject angegeben ist.
Das Hinzufügen eines WasdControllers kann sehr nützlich sein, sowohl in Anwendungen, die einen Standardweg zur Navigation in der Szene bieten wollen, als auch als vorübergehende Maßnahme während der Entwicklung und Fehlersuche, da es die Inspektion der Szene zur Laufzeit über die vertraute Tastatur- und Mausnavigation ermöglicht.
Die Tastenkombinationen lauten wie folgt:
W
oderup
- vorwärts gehenS
oderdown
- rückwärts gehenA
oderleft
- nach links strebenD
oderright
- nach rechts strebenR
oderpage up
- nach oben bewegenF
oderpage down
- nach unten bewegenshift
zusammen mit anderen Tasten - schneller bewegen, abhängig von shiftSpeed
Das folgende Snippet zeigt, wie ein WasdController-Objekt hinzugefügt werden kann. Standardmäßig ist sowohl die tasten- als auch die mausbasierte Navigation aktiv, so dass in den meisten Fällen keine weitere Konfiguration erforderlich ist:
View3D { anchors.fill: parent camera: camera PerspectiveCamera { id: camera position: Qt.vector3d(0, 0, 600) } ... } WasdController { controlledObject: camera }
Eigenschaft Dokumentation
acceptedButtons : enumeration |
Gibt die vom Controller akzeptierten Schaltflächen an.
Siehe auch DragHandler und MultiPointHandler.
backSpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die Zurück-Taste gedrückt wird.
controlledObject : QtQuick3D::Node |
Legt den zu steuernden Knoten fest. Dies ist normalerweise ein Kameraobjekt.
downSpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die Abwärts-Taste gedrückt wird.
forwardSpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die Vorwärts-Taste gedrückt wird.
inputsNeedProcessing : bool |
Diese Eigenschaft ist wahr, wenn es Eingaben gibt, die verarbeitet werden müssen.
keysEnabled : bool |
Aktiviert die Tastensteuerung. Der Standardwert ist true.
leftSpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die linke Taste gedrückt wird.
mouseEnabled : bool |
Aktiviert die Maussteuerung. Der Standardwert ist true.
rightSpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die rechte Taste gedrückt wird.
shiftSpeed : real |
Legt den Geschwindigkeitsmultiplikator fest, der aktiv ist, wenn die Umschalttaste gedrückt wird.
speed : real |
Legt die Geschwindigkeit der Navigation fest.
upSpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die Aufwärtstaste gedrückt wird.
xInvert : bool |
Invertiert die Steuerelemente der x-Achse. Der Standardwert ist false.
xSpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die Maus entlang der X-Achse bewegt wird.
yInvert : bool |
Invertiert die Steuerelemente der y-Achse. Der Standardwert ist true.
ySpeed : real |
Legt die Geschwindigkeit der Navigation fest, wenn die Maus entlang der Y-Achse bewegt wird.
© 2025 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.