このページでは

Qt3DExtras::QOrbitCameraController Class

class Qt3DExtras::QOrbitCameraController

QOrbitCameraControllerクラスは、軌道に沿ってシーンカメラを制御することができます。詳細...

ヘッダー #include <QOrbitCameraController>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
を継承する: Qt3DExtras::QAbstractCameraController
ステータス非推奨

プロパティ

パブリック機能

bool inversePan() const
bool inverseTilt() const
bool inverseXTranslate() const
bool inverseYTranslate() const
QVector3D upVector() const
float zoomInLimit() const
bool zoomTranslateViewCenter() const

パブリックスロット

void setInversePan(bool isInverse)
void setInverseTilt(bool isInverse)
void setInverseXTranslate(bool isInverse)
void setInverseYTranslate(bool isInverse)
void setUpVector(const QVector3D &upVector)
void setZoomInLimit(float zoomInLimit)
void setZoomTranslateViewCenter(bool isTranslate)

シグナル

void inversePanChanged(bool isInverse)
void inverseTiltChanged(bool isInverse)
void inverseXTranslateChanged(bool isInverse)
void inverseYTranslateChanged(bool isInverse)
void upVectorChanged(const QVector3D &upVector)
void zoomInLimitChanged()
void zoomTranslateViewCenterChanged(bool isTranslate)

詳細説明

コントロール

入力アクション
マウスの左ボタンマウスの左ボタンが押されている間、X軸に沿ってマウスを動かすとカメラが左右に動き、Y軸に沿って動かすとカメラが上下に動きます。
マウスの右ボタンマウスの右ボタンが押されている間、x軸に沿ったマウスの移動はカメラビューセンターを中心にカメラをパンさせ、y軸に沿った移動はカメラビューセンターを中心にカメラをチルトさせます。
左右両方のマウスボタンマウスの左ボタンと右ボタンの両方を押している間、y 軸に沿ってマウスを動かすと、ビューの中心を変えずにカメラをズームインまたはズームアウトします。
マウススクロールホイールビューの中心を変えずにカメラをズームイン/ズームアウトします。
矢印キーカメラのビューポートに対してカメラを垂直方向および水平方向に移動します。
ページアップ・ページダウンキーカメラを前後に移動します。
シフトキー上下の矢印キーの動作を変更し、ビューセンターを変更せずにカメラをズームイン/ズームアウトします。他の移動キーは無効になります。
Alt キー矢印キーの動作を変更し、ビューセンターを中心にカメラをパンおよびチルトします。ページアップ・ページダウンキーを無効にします。
エスケープシーン全体がカメラのビューポートに表示されるようにカメラを移動します。

プロパティの説明

inversePan : bool

パンを反転させるかどうかを保持する。

有効な場合、水平パン動作はビューセンターを中心にカメラを逆方向に回転させます。

アクセス機能:

bool inversePan() const
void setInversePan(bool isInverse)

通知信号:

void inversePanChanged(bool isInverse)

inverseTilt : bool

チルトが反転するかどうかを保持します。

有効な場合、垂直方向のチルト動作は、ビューセンターを中心にカメラを逆方向に回転させます。

アクセス機能:

bool inverseTilt() const
void setInverseTilt(bool isInverse)

通知信号:

void inverseTiltChanged(bool isInverse)

inverseXTranslate : bool

水平移動を反転させるかどうかを保持する。

有効にすると、マウスの水平移動と入力によってカメラが逆方向に移動します。

アクセス機能:

bool inverseXTranslate() const
void setInverseXTranslate(bool isInverse)

通知信号:

void inverseXTranslateChanged(bool isInverse)

inverseYTranslate : bool

垂直移動を反転させるかどうかを保持する。

有効にすると、マウスの垂直方向の動きと入力によってカメラが逆方向に移動します。

アクセス機能:

bool inverseYTranslate() const
void setInverseYTranslate(bool isInverse)

通知信号:

void inverseYTranslateChanged(bool isInverse)

upVector : QVector3D

カメラの軌道回転のアップベクトルを保持します。

アップベクトルはカメラが公転する垂直軸を定義する。デフォルト値は(0.0, 1.0, 0.0)。

アクセス関数:

QVector3D upVector() const
void setUpVector(const QVector3D &upVector)

通知シグナル:

void upVectorChanged(const QVector3D &upVector)

zoomInLimit : float

現在のズームインリミットを保持します。ズームインリミットは、カメラをビューセンターにどれだけ近づけるかを決定します。

アクセス機能:

float zoomInLimit() const
void setZoomInLimit(float zoomInLimit)

通知信号:

void zoomInLimitChanged()

zoomTranslateViewCenter : bool

ズーム操作時にビューセンターを移動させるかどうかを保持する。

有効にすると、ズーム操作でビューセンターが移動します。無効にすると、ズーム操作時にカメラ位置のみが変更されます。デフォルト値はtrue。

アクセス機能:

bool zoomTranslateViewCenter() const
void setZoomTranslateViewCenter(bool isTranslate)

通知シグナル:

void zoomTranslateViewCenterChanged(bool isTranslate)

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