WasdController QML 类型

使用按键和鼠标控制节点位置和方向。更多...

导入声明import QtQuick3D.Helpers
继承

Item

属性

详细介绍

此辅助程序允许用户通过 W、A、S、D、方向键和鼠标来控制节点。通常受控节点是相机,在 controlledObject 属性中指定。

添加 WasdController 在希望提供标准场景导航方式的应用程序中非常有用,同时也作为开发和故障排除期间的临时措施,因为它允许通过熟悉的键盘和鼠标导航在运行时检查场景。

键位绑定如下

  • W - 向前移动
  • S - 向后移动
  • A - 横向向左移动
  • D - 横向向右移动
  • R向上翻页 - 向上移动
  • F向下翻页 - 向下移动
  • shift 与其他键一起 - 加速移动,取决于 shiftSpeed 属性

下面的代码示例展示了如何添加 WasdController 对象。默认情况下,键和鼠标导航都处于活动状态,因此在大多数情况下无需进一步配置

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

WasdController {
    controlledObject: camera
}

属性文档

acceptedButtons : 枚举

指定控制器接受的按钮。

另请参阅DragHandlerMultiPointHandler


backSpeed : 实数

按后退键时指定导航速度。


controlledObject : QtQuick3D::Node

指定要控制的节点。这通常是相机对象。


downSpeed : 实数

按向下键时指定导航速度。


forwardSpeed : 实数

按向前键时指定导航速度。


inputsNeedProcessing : 布尔值 [只读]

当有需要处理的事件时,此属性为真。


keysEnabled : 布尔值

启用键盘控制。默认值为 true。


leftSpeed : 实数

按左键时指定导航速度。


mouseEnabled : 布尔值

启用鼠标控制。默认值为 true。


rightSpeed : 实数

按右键时指定导航速度。


shiftSpeed : 实数

按 shift 键时激活的速度乘数。


speed : 实数

指定导航速度。


upSpeed : 实数

按向上键时指定导航速度。


xInvert : 布尔值

反转 x 轴控制。默认值为 false。


xSpeed : 实数

指定鼠标在 X 轴上移动时的导航速度。


yInvert : 布尔值

反转 y 轴控制。默认值为 true。


ySpeed : 实数

指定鼠标在 Y 轴上移动时的导航速度。


© 2024 The Qt Company Ltd. 本文档中包含的贡献归各自所有者所有。此处提供的文档受 GNU 自由文档许可证版本 1.3 的许可,由自由软件基金会发布。Qt 以及相应的标志是 The Qt Company Ltd. 在芬兰以及/或其他国家/地区的商标。所有其他商标均为其各自所有者的财产。