WasdController QML Type

キーとマウスを使ってノードの位置と向きを制御します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• 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

詳細説明

このヘルパーを使用すると、ユーザーはW、A、S、Dキー、矢印キー、およびマウスを使用してノードを操作できます。通常、操作対象となるノードはcontrolledObject プロパティで指定されたカメラです。

WasdControllerを追加することは、シーンを操作するための標準的な方法を提供したいアプリケーションにおいて非常に有用であるだけでなく、開発やトラブルシューティング中の一時的な対策としても役立ちます。これは、使い慣れたキーボードやマウスによる操作を通じて、実行時にシーンを詳細に確認できるためです。

キーの割り当ては以下の通りです：

• W または `up ` - 前方へ移動
• S または `down ` - 後退
• A またはleft - 左に横移動
• D またはright - 右に横移動
• R またはpage up - 上へ移動
• F またはpage down - 下に移動
• shift 他のキーと組み合わせると、状況に応じて移動速度が上がりますshiftSpeed

以下のスニペットは、WasdController オブジェクトを追加する方法を示しています。デフォルトでは、キーとマウスの両方に基づく操作が有効になっているため、ほとんどの場合、追加の設定は必要ありません：

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

WasdController {
    controlledObject: camera
}

プロパティのドキュメント

acceptedButtons : enumeration [default: Qt.LeftButton]

コントローラが対応するボタンを指定します。

「 DragHandler 」および「MultiPointHandler 」も参照してください 。

backSpeed : real [default: 5]

「戻る」キーが押された際の移動速度を指定します。

controlledObject : QtQuick3D::Node

制御対象のノードを指定します。通常は Camera オブジェクトです。

downSpeed : real [default: 5]

下矢印キーが押された際の移動速度を指定します。

forwardSpeed : real [default: 5]

「前へ」キーが押された際の移動速度を指定します。

inputsNeedProcessing : bool [read-only]

処理が必要な入力がある場合、このプロパティはtrueになります。

keysEnabled : bool [default: true]

キー操作を有効にします。

leftSpeed : real [default: 5]

左キーが押されたときの移動速度を指定します。

mouseEnabled : bool [default: true]

マウス操作を有効にします。

rightSpeed : real [default: 5]

右キーが押されたときの移動速度を指定します。

shiftSpeed : real [default: 3]

Shift キーが押されているときに有効になる速度倍率を指定します。

speed : real [default: 1]

ナビゲーションの速度を指定します。

upSpeed : real [default: 5]

上矢印キーが押された際の移動速度を指定します。

xInvert : bool [default: false]

x軸の操作を反転させます。

xSpeed : real [default: 0.1]

マウスをX軸に沿って移動させた際の移動速度を指定します。

yInvert : bool [default: true]

Y軸の操作を反転させます。

ySpeed : real [default: 0.1]

マウスをY軸に沿って移動させた際の移動速度を指定します。