Q3DScene Class
Q3DSceneクラスはビジュアライズされている3Dシーンの説明を提供します。もっと詳しく...
| ヘッダー | #include <Q3DScene> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake | QT += graphs |
| QML で | Scene3D |
| 継承： | QObject |
- 継承メンバを含む全メンバのリスト
- Q3DScene はQt Graphs C++ Classes for 3D に含まれます。
プロパティ
|
|
パブリック機能
| Q3DScene(QObject *parent = nullptr) | |
| virtual | ~Q3DScene() override |
| qreal | devicePixelRatio() const |
| QPoint | graphPositionQuery() const |
| QPoint | invalidSelectionPoint() const |
| bool | isPointInPrimarySubView(QPoint point) |
| bool | isPointInSecondarySubView(QPoint point) |
| bool | isSecondarySubviewOnTop() const |
| bool | isSlicingActive() const |
| QRect | primarySubViewport() const |
| QRect | secondarySubViewport() const |
| QPoint | selectionQueryPosition() const |
| void | setDevicePixelRatio(qreal pixelRatio) |
| void | setGraphPositionQuery(QPoint point) |
| void | setPrimarySubViewport(QRect primarySubViewport) |
| void | setSecondarySubViewport(QRect secondarySubViewport) |
| void | setSecondarySubviewOnTop(bool isSecondaryOnTop) |
| void | setSelectionQueryPosition(QPoint point) |
| void | setSlicingActive(bool isSlicing) |
| QRect | viewport() const |
シグナル
| void | devicePixelRatioChanged(qreal pixelRatio) |
| void | graphPositionQueryChanged(QPoint position) |
| void | primarySubViewportChanged(QRect subViewport) |
| void | secondarySubViewportChanged(QRect subViewport) |
| void | secondarySubviewOnTopChanged(bool isSecondaryOnTop) |
| void | selectionQueryPositionChanged(QPoint position) |
| void | slicingActiveChanged(bool isSlicingActive) |
| void | viewportChanged(QRect viewport) |
詳細説明
3Dシーンには、1つのアクティブなカメラと1つのアクティブな光源があります。ビジュアライズされたデータは固定された場所にあると仮定されます。
3Dシーンは、グラフレンダリングが行われるビューポート、メインの3Dグラフビューが存在するビューポート内のプライマリサブビューポート、データの2Dスライスビューが存在するセカンダリサブビューポートも追跡します。サブビューポートはデフォルトでQ3DScene によってリサイズされます。リサイズ動作をオーバーライドするには、viewportChanged() とslicingActiveChanged() の両方のシグナルをリッスンし、それに応じてサブビューポートを再計算する必要があります。
また、シーンには、セカンダリ2Dスライスビューが現在アクティブかどうかをトラッキングするフラグがあります。
注意： すべてのグラフがセカンダリ2Dスライシングビューをサポートしているわけではありません。
プロパティ・ドキュメント
devicePixelRatio : qreal
本プロパティは、入力座標をピクセル座標にマッピングする際に使用するデバイスピクセル比を保持する。
アクセス関数
| qreal | devicePixelRatio() const |
| void | setDevicePixelRatio(qreal pixelRatio) |
通知シグナル
| void | devicePixelRatioChanged(qreal pixelRatio) |
graphPositionQuery : QPoint
このプロパティは、グラフ位置クエリとしてシーンによって処理されるべきユーザー入力の座標を保持する。
このプロパティがinvalidSelectionPoint() 以外の値に設定されている場合、グラフは、プライマリビューポート内の指定された座標にグラフ位置を一致させようとします。レンダリング パスの後、このプロパティはデフォルト状態のinvalidSelectionPoint() に戻されます。照会されたグラフ位置は、次のレンダリングパスの後にQ3DGraphsWidgetItem::queriedGraphPosition プロパティから読み取ることができます。
特定の画面位置に一致する単一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む不可視ボックスの内側に対して行われます。
注： 棒グラフでは、グラフフロアレベルでのみグラフ位置のクエリーが可能です。
アクセス機能：
| QPoint | graphPositionQuery() const |
| void | setGraphPositionQuery(QPoint point) |
ノーティファイア・シグナル：
| void | graphPositionQueryChanged(QPoint position) |
Q3DGraphsWidgetItem::queriedGraphPositionも参照のこと 。
primarySubViewport : QRect
このプロパティは、グラフのプライマリビューが対象とするビューポート内の現在のサブビューポート矩形を保持する。
プライマリサブビューポートが明示的に設定されていない場合、viewport （）の5分の1になります。
注意： primarySubViewportをビューポートより大きく、またはビューポートの外側に設定すると、それに応じてビューポートのサイズが変更されます。
アクセス関数：
| QRect | primarySubViewport() const |
| void | setPrimarySubViewport(QRect primarySubViewport) |
通知シグナル：
| void | primarySubViewportChanged(QRect subViewport) |
secondarySubViewport : QRect
このプロパティは、ビューポート内のセカンダリビューポート矩形を保持する。
セカンダリビューポートは、いくつかのグラフで2Dスライスビューを描画するために使用されます。明示的に設定されていない場合は、ビューポートのサイズに等しくなります。
メモ： セカンダリサブビューポートがビューポートより大きい、またはビューポートの外側にある場合、ビューポートはそれに応じてサイズ変更されます。
アクセス関数：
| QRect | secondarySubViewport() const |
| void | setSecondarySubViewport(QRect secondarySubViewport) |
通知シグナル：
| void | secondarySubViewportChanged(QRect subViewport) |
secondarySubviewOnTop : bool
このプロパティは、2Dスライスビューと3Dビューのどちらが上に描画されるかを保持します。
アクセス関数
| bool | isSecondarySubviewOnTop() const |
| void | setSecondarySubviewOnTop(bool isSecondaryOnTop) |
通知シグナル
| void | secondarySubviewOnTopChanged(bool isSecondaryOnTop) |
selectionQueryPosition : QPoint
このプロパティは、選択としてシーンによって処理されるべきユーザー入力の座標を保持する。
このプロパティがinvalidSelectionPoint() 以外の値に設定されている場合、グラフは、プライマリビューポート内の指定された座標で、データアイテム、軸ラベル、またはカスタムアイテムの選択を試みます。レンダリングパスの後、このプロパティはデフォルト状態のinvalidSelectionPoint() に戻されます。
アクセス関数：
| QPoint | selectionQueryPosition() const |
| void | setSelectionQueryPosition(QPoint point) |
通知シグナル：
| void | selectionQueryPositionChanged(QPoint position) |
Q3DGraphsWidgetItem::selectedElementも参照してください 。
slicingActive : bool
このプロパティは、2Dスライスビューが現在アクティブであるかどうかを保持する。
true,Q3DGraphsWidgetItem::selectionMode の場合、QtGraphs3D::SelectionFlag::Row またはQtGraphs3D::SelectionFlag::Column のいずれかが有効な選択に設定されている必要があります。
注： すべてのグラフが 2D スライスビューをサポートしているわけではありません。
アクセス関数
| bool | isSlicingActive() const |
| void | setSlicingActive(bool isSlicing) |
通知シグナル：
| void | slicingActiveChanged(bool isSlicingActive) |
[read-only] viewport : const QRect
このプロパティは、すべての3Dレンダリングがターゲットとする現在のビューポート矩形を含む読み取り専用プロパティを保持します。
アクセス関数
| QRect | viewport() const |
通知シグナル
| void | viewportChanged(QRect viewport) |
メンバー関数ドキュメント
[explicit] Q3DScene::Q3DScene(QObject *parent = nullptr)
1つのライトと1つのカメラを含む基本的なシーンを構築します。オプションでparent パラメータを指定でき、QObject コンストラクタに渡されます。
[override virtual noexcept] Q3DScene::~Q3DScene()
3Dシーンとその中に含まれるすべてのオブジェクトを破壊する。
QPoint Q3DScene::invalidSelectionPoint() const
無効な選択位置を示すQPoint を返す。
注： プロパティ invalidSelectionPoint のゲッター関数。
bool Q3DScene::isPointInPrimarySubView(QPoint point)
与えられたpoint がプライマリサブビュー内にあるかどうかを返します。その点がプライマリサブビューの内側にある場合、true を返します。
注意: サブビューが重ね合わされていて、与えられたpoint が両方の内側にある場合、結果はプライマリサブビューが上にあるときのみtrue になります。
bool Q3DScene::isPointInSecondarySubView(QPoint point)
指定されたpoint がセカンダリサブビュー内にあるかどうかを返します。その点がセカンダリサブビューの内側にある場合、true を返します。
注意: サブビューが重なっていて、指定されたpoint が両方の内側にある場合、セカンダリサブビューが上にあるときのみ、結果はtrue になります。
© 2025 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.
