WasdController QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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 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 gehen
• 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 an, welche Tasten der Controller akzeptiert.

Siehe auch DragHandler und MultiPointHandler.

backSpeed : real [default: 5]

Gibt die Geschwindigkeit der Navigation an, wenn die Zurück-Taste gedrückt wird.

controlledObject : QtQuick3D::Node

Gibt den zu steuernden Knoten an. 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]

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

inputsNeedProcessing : bool [read-only]

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

keysEnabled : bool [default: true]

Aktiviert die Tastensteuerung.

leftSpeed : real [default: 5]

Bestimmt die Geschwindigkeit der Navigation beim Drücken der linken Taste.

mouseEnabled : bool [default: true]

Aktiviert die Maussteuerung.

rightSpeed : real [default: 5]

Gibt die Geschwindigkeit der Navigation beim Drücken der rechten Taste an.

shiftSpeed : real [default: 3]

Gibt den Geschwindigkeitsmultiplikator an, der aktiv ist, wenn die Umschalttaste gedrückt wird.

speed : real [default: 1]

Gibt die Geschwindigkeit der Navigation an.

upSpeed : real [default: 5]

Gibt die Geschwindigkeit der Navigation an, wenn die Aufwärts-Taste gedrückt wird.

xInvert : bool [default: false]

Invertiert die Steuerelemente der x-Achse.

xSpeed : real [default: 0.1]

Gibt die Geschwindigkeit der Navigation an, wenn die Maus entlang der X-Achse bewegt wird.

yInvert : bool [default: true]

Invertiert die Steuerelemente der y-Achse.

ySpeed : real [default: 0.1]

Gibt die Geschwindigkeit der Navigation an, wenn die Maus entlang der Y-Achse bewegt wird.