Scene3D QML Type (Uncreatable)
Scene3D 型は、可視化される 3D シーンに関する記述を提供します。詳細...
| Import Statement: | import QtGraphs |
| In C++: | Q3DScene |
注：これは作成不可能な型です。QML ではインスタンス化できません。
- 継承されたメンバーを含む、すべてのメンバーの一覧
- Scene3Dは、Qt Graphs の3D用QMLタイプの一部です。
プロパティ
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
信号
- devicePixelRatioChanged(qreal pixelRatio)
- graphPositionQueryChanged(point position)
- primarySubViewportChanged(rect subViewport)
- secondarySubViewportChanged(rect subViewport)
- secondarySubviewOnTopChanged(bool isSecondaryOnTop)
- selectionQueryPositionChanged(point position)
- slicingActiveChanged(bool isSlicingActive)
- viewportChanged(rect viewport)
詳細な説明
3Dシーンには、1つのアクティブなカメラと1つのアクティブな光源が含まれます。可視化されるデータは、固定された位置にあるものと仮定します。
また、この3Dシーンでは、グラフのレンダリングが行われるビューポート、メインの3Dグラフビューが存在するビューポート内のプライマリサブビューポート、およびデータの2Dスライスビューが存在するセカンダリサブビューポートを追跡します。
また、このシーンには、セカンダリ 2D スライスビューが現在アクティブであるかどうかを追跡するためのフラグがあります。
注： すべてのグラフがセカンダリ2Dスライスビューに対応しているわけではありません 。
プロパティのドキュメント
devicePixelRatio : real
入力座標をピクセル座標に変換する際に使用される、現在のデバイス・ピクセル比。
graphPositionQuery : point
シーンがグラフ位置クエリとして処理すべき、ユーザー入力の座標。このプロパティが `invalidSelectionPoint` 以外の値に設定されている場合、グラフはプライマリビューポート内の指定された点にグラフ位置を照合しようとします。 レンダリングパス終了後、このプロパティはデフォルト状態の `invalidSelectionPoint` に戻ります。クエリ対象となったグラフ位置は、次のレンダリングパス終了後に `GraphsItem3D::queriedGraphPosition ` プロパティから読み取ることができます。
特定の画面位置に対応する唯一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む不可視のボックスの内側を基準に行われます。
注：棒 グラフでは、グラフの位置のクエリはグラフの床レベルでのみ可能です。
GraphsItem3D::queriedGraphPositionも参照してください 。
invalidSelectionPoint : point [read-only]
選択に無効なポイントを提供する定数プロパティ。
primarySubViewport : rect
グラフのメインビューが対象となる、ビューポート内の現在のサブビューポートの矩形。
プライマリサブビューポートが明示的に設定されていない場合、ビューポートの5分の1のサイズになります。
注： primarySubViewport をビューポートより大きく設定したり 、ビューポートの外側に設定したりすると 、ビューポートのサイズがそれに応じて変更されます。
secondarySubViewport : rect
セカンダリ・ビューポートは、一部のグラフにおいて2Dスライスビューを描画するために使用されます。明示的に設定されていない場合、ビューポートのサイズと同じになります。
注： セカンダリサブビューポートがビューポートより大きい場合 、またはビューポートの外側にある場合 、ビューポートのサイズがそれに応じて変更されます。
secondarySubviewOnTop : bool
2Dスライスビューと3Dビューのどちらを上に表示するかを指定します。
selectionQueryPosition : point
シーンによって選択として処理されるべき、ユーザー入力の座標。このプロパティがinvalidSelectionPoint 以外の値に設定されている場合、グラフはプライマリビューポート内の指定された位置にあるデータ項目を選択しようとします。レンダリングパスが終了すると、このプロパティはデフォルト状態のinvalidSelectionPoint に戻ります。
slicingActive : bool
2Dスライシングビューが現在アクティブであるかどうかを指定します。true の場合、Graphs3D::selectionModeのGraphs3D.SelectionRow またはGraphs3D.SelectionColumn のいずれかが、有効な選択に設定されている必要があります。
注： すべてのグラフが2Dスライシングビューに対応しているわけではありません 。
シグナルのドキュメント
devicePixelRatioChanged(qreal pixelRatio)
このシグナルは、devicePixelRatio がpixelRatio に変更されたときに発生します。
注： 対応するハンドラは onDevicePixelRatioChanged です。
graphPositionQueryChanged(point position)
このシグナルは、graphPositionQuery がposition に変更されたときに発生します。
注： 対応するハンドラは onGraphPositionQueryChanged です。
primarySubViewportChanged(rect subViewport)
このシグナルは、primarySubViewport がsubViewport に変更されたときに発生します。
注： 対応するハンドラは onPrimarySubViewportChanged です。
secondarySubViewportChanged(rect subViewport)
このシグナルは、secondarySubViewport がsubViewport に変わったときに発せられます。
注： 対応するハンドラは onSecondarySubViewportChanged です。
secondarySubviewOnTopChanged(bool isSecondaryOnTop)
このシグナルは、secondarySubviewOnTop がisSecondaryOnTop に変更されたときに発生します。
注： 対応するハンドラは onSecondarySubviewOnTopChanged です。
selectionQueryPositionChanged(point position)
このシグナルは、selectionQueryPosition がposition に変化したときに発生します。
注： 対応するハンドラは onSelectionQueryPositionChanged です。
slicingActiveChanged(bool isSlicingActive)
このシグナルは、slicingActive がisSlicingActive に変更されたときに発生します。
注： 対応するハンドラは onSlicingActiveChanged です。
viewportChanged(rect viewport)
このシグナルは、ビューポートが `viewport` に変更されたときに発火します。
注： 対応するハンドラは `onViewportChanged` です。
© 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.
