WasdController QML Type

Steuerung der Position und Ausrichtung von Knoten mit Tasten und Maus. Mehr...

Import Statement: import QtQuick3D.Helpers
Inherits:

Item

Eigenschaften

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 oder up - vorwärts gehen
  • S oder down - rückwärts gehen
  • A oder left - nach links streben
  • D oder right - nach rechts streben
  • R oder page up - nach oben bewegen
  • F oder page down - nach unten bewegen
  • shift 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 [default: Qt.LeftButton]

Gibt die vom Controller akzeptierten Schaltflächen an.

Siehe auch DragHandler und MultiPointHandler.


backSpeed : real [default: 5]

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 [default: 5]

Legt die Geschwindigkeit der Navigation fest, wenn die Abwärts-Taste gedrückt wird.


forwardSpeed : real [default: 5]

Legt die Geschwindigkeit der Navigation fest, wenn die Vorwärts-Taste gedrückt wird.


inputsNeedProcessing : bool [read-only]

Diese Eigenschaft ist wahr, wenn es Eingaben gibt, die verarbeitet werden müssen.


keysEnabled : bool [default: true]

Aktiviert die Tastensteuerung.


leftSpeed : real [default: 5]

Legt die Geschwindigkeit der Navigation fest, wenn die linke Taste gedrückt wird.


mouseEnabled : bool [default: true]

Aktiviert die Maussteuerung.


rightSpeed : real [default: 5]

Legt die Geschwindigkeit der Navigation fest, wenn die rechte Taste gedrückt wird.


shiftSpeed : real [default: 3]

Legt den Geschwindigkeitsmultiplikator fest, der aktiv ist, wenn die Umschalttaste gedrückt wird.


speed : real [default: 1]

Legt die Geschwindigkeit der Navigation fest.


upSpeed : real [default: 5]

Legt die Geschwindigkeit der Navigation fest, wenn die Aufwärtstaste gedrückt wird.


xInvert : bool [default: false]

Invertiert die Steuerelemente der x-Achse.


xSpeed : real [default: 0.1]

Legt die Geschwindigkeit der Navigation fest, wenn die Maus entlang der X-Achse bewegt wird.


yInvert : bool [default: true]

Invertiert die Steuerelemente der y-Achse.


ySpeed : real [default: 0.1]

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.