En esta página

WasdController QML Type

Controla la posición y la orientación del nodo con las teclas y el ratón. Más...

Import Statement: import QtQuick3D.Helpers
Inherits:

Item

Propiedades

Descripción detallada

Este ayudante permite al usuario controlar un nodo mediante las teclas W, A, S, D, las teclas de flecha y el ratón. Normalmente, el nodo controlado es una cámara, especificada en la propiedad « controlledObject ».

Añadir un WasdController puede resultar muy útil tanto en aplicaciones que deseen ofrecer una forma estándar de navegar por la escena, como también a modo de medida temporal durante el desarrollo y la resolución de problemas, ya que permite inspeccionar la escena en tiempo de ejecución mediante la navegación habitual con el teclado y el ratón.

Las combinaciones de teclas son las siguientes:

  • W o up: avanzar
  • S o down: ir hacia atrás
  • A o left: desplazarse hacia la izquierda
  • D o right: desplazarse hacia la derecha
  • R o page up: subir
  • F o page down - bajar
  • shift junto con otras teclas: para moverte más rápido, dependiendo de shiftSpeed

El siguiente fragmento de código muestra cómo se puede añadir un objeto WasdController. Por defecto, la navegación tanto con teclas como con el ratón está activa, por lo que en la mayoría de los casos no es necesaria ninguna configuración adicional:

View3D {
    anchors.fill: parent
    camera: camera
    PerspectiveCamera {
        id: camera
        position: Qt.vector3d(0, 0, 600)
    }
    ...
}

WasdController {
    controlledObject: camera
}

Documentación de propiedades

acceptedButtons : enumeration [default: Qt.LeftButton]

Especifica los botones que admite el controlador.

Véase también DragHandler y MultiPointHandler.

backSpeed : real [default: 5]

Especifica la velocidad de navegación al pulsar la tecla «Atrás».

controlledObject : QtQuick3D::Node

Especifica el nodo que se va a controlar. Normalmente se trata de un objeto «Cámara».

downSpeed : real [default: 5]

Especifica la velocidad de navegación al pulsar la tecla de abajo.

forwardSpeed : real [default: 5]

Especifica la velocidad de navegación al pulsar la tecla de avance.

inputsNeedProcessing : bool [read-only]

Esta propiedad es cierta cuando hay entradas que deben procesarse.

keysEnabled : bool [default: true]

Activa los controles de teclas.

leftSpeed : real [default: 5]

Especifica la velocidad de navegación al pulsar la tecla de la izquierda.

mouseEnabled : bool [default: true]

Activa los controles del ratón.

rightSpeed : real [default: 5]

Especifica la velocidad de navegación al pulsar la tecla de la derecha.

shiftSpeed : real [default: 3]

Especifica el multiplicador de velocidad que se activa al pulsar la tecla «Shift».

speed : real [default: 1]

Especifica la velocidad de navegación.

upSpeed : real [default: 5]

Especifica la velocidad de navegación al pulsar la tecla de arriba.

xInvert : bool [default: false]

Invierte los controles del eje X.

xSpeed : real [default: 0.1]

Especifica la velocidad de desplazamiento cuando se mueve el ratón a lo largo del eje X.

yInvert : bool [default: true]

Invierte los controles del eje Y.

ySpeed : real [default: 0.1]

Especifica la velocidad de desplazamiento cuando se mueve el ratón a lo largo del eje Y.

© 2026 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.