WasdController QML Type

Steuern Sie die Position und Ausrichtung des Knotens mit den Tasten und der Maus. Mehr...

• Liste aller Elemente, einschließlich vererbter Elemente

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

Ausführliche Beschreibung

Mit diesem Helper kann der Benutzer einen Knoten mithilfe der Tasten W, A, S, D, der Pfeiltasten und der Maus steuern. In der Regel handelt es sich bei dem gesteuerten Knoten um eine Kamera, die in der Eigenschaft „ controlledObject “ angegeben ist.

Das Hinzufügen eines „WasdController“ kann sowohl in Anwendungen, die eine standardisierte Art der Navigation durch die Szene bieten möchten, als auch als vorübergehende Maßnahme während der Entwicklung und Fehlerbehebung sehr nützlich sein, da es die Untersuchung der Szene zur Laufzeit über die vertraute Tastatur- und Mausnavigation ermöglicht.

Die Tastenbelegungen lauten wie folgt:

• W oder up – vorwärts bewegen
• S oder ` down ` – rückwärts bewegen
• A oder left – nach links ausweichen
• D oder right – nach rechts ausweichen
• R oder page up – nach oben bewegen
• F oder page down – nach unten bewegen
• shift in Kombination mit anderen Tasten – schneller bewegen, je nach shiftSpeed

Der folgende Codeausschnitt zeigt, wie ein `WasdController`-Objekt hinzugefügt werden kann. Standardmäßig ist sowohl die Tasten- als auch die Maussteuerung aktiv, sodass 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
}

Dokumentation der Eigenschaften

acceptedButtons : enumeration [default: Qt.LeftButton]

Gibt die vom Controller unterstützten Tasten 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

Gibt den zu steuernden Knoten an. In der Regel handelt es sich dabei um ein Kameraobjekt.

downSpeed : real [default: 5]

Legt die Navigationsgeschwindigkeit fest, wenn die Abwärts-Taste gedrückt wird.

forwardSpeed : real [default: 5]

Legt die Navigationsgeschwindigkeit fest, wenn die Vorwärts-Taste gedrückt wird.

inputsNeedProcessing : bool [read-only]

Diese Eigenschaft trifft zu, wenn Eingaben vorliegen, die verarbeitet werden müssen.

keysEnabled : bool [default: true]

Aktiviert die Tastenbefehle.

leftSpeed : real [default: 5]

Legt die Navigationsgeschwindigkeit fest, wenn die linke Taste gedrückt wird.

mouseEnabled : bool [default: true]

Aktiviert die Maussteuerung.

rightSpeed : real [default: 5]

Legt die Navigationsgeschwindigkeit fest, wenn die rechte Taste gedrückt wird.

shiftSpeed : real [default: 3]

Legt den Geschwindigkeitsmultiplikator fest, der beim Drücken der Umschalttaste aktiv ist.

speed : real [default: 1]

Legt die Geschwindigkeit der Navigation fest.

upSpeed : real [default: 5]

Legt die Navigationsgeschwindigkeit fest, wenn die Aufwärts-Taste gedrückt wird.

xInvert : bool [default: false]

Kehrt die Steuerung der x-Achse um.

xSpeed : real [default: 0.1]

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

yInvert : bool [default: true]

Kehrt die Steuerung der y-Achse um.

ySpeed : real [default: 0.1]

Legt die Navigationsgeschwindigkeit fest, wenn die Maus entlang der Y-Achse bewegt wird.