Scene3D QML Type
Scene3D 型は、視覚化されている3Dシーンの説明を提供する。詳細...
| Import Statement: | import QtGraphs |
| In C++: | Q3DScene |
- 継承メンバを含む、全メンバ一覧
- Scene3D はQt Graphs QML Types for 3D に含まれます。
プロパティ
- 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をviewportより大きく、またはviewportの外に設定すると、それに応じてviewportのサイズが変更されます。
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.
