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

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 [read-only]

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.