Scene3D QML Type
Scene3D 型は、可視化されている 3D シーンに関する記述を提供します。詳細...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| In C++: | Q3DScene |
| Status: | Deprecated |
この型は非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
- activeCamera : Camera3D
- activeLight : Light3D
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
- viewport : rect
詳細な説明
3Dシーンには、1つのアクティブなカメラと1つのアクティブな光源が含まれています。可視化されるデータは、固定された位置にあるものと想定されます。
また、この3Dシーンでは、可視化レンダリングが行われるビューポート、メインの3Dデータ可視化ビューが存在するビューポート内のプライマリサブビューポート、およびデータの2Dスライスビューが存在するセカンダリサブビューポートも追跡されます。
また、このシーンには、セカンダリの 2D スライスビューが現在アクティブであるかどうかを追跡するためのフラグがあります。
注: すべての可視化がセカンダリ2Dスライスビューに対応しているわけではありません 。
プロパティのドキュメント
activeCamera : Camera3D
3Dシーン内で現在アクティブなカメラです。プロパティにCamera3Dが設定されると、自動的にシーンの子として追加されます。
activeLight : Light3D
3Dシーン内で現在アクティブなライトです。このプロパティにLight3Dが設定されると、そのライトは自動的にシーンの子として追加されます。
devicePixelRatio : real
入力座標をピクセル座標に変換する際に使用される、現在のデバイス・ピクセル比。
graphPositionQuery : point
シーンがグラフ位置のクエリとして処理すべき、ユーザー入力の座標。このプロパティが `invalidSelectionPoint` 以外の値に設定されている場合、グラフはプライマリビューポート内の指定された点にグラフ位置を照合しようとします。 レンダリングパス終了後、このプロパティはデフォルト状態の `invalidSelectionPoint` に戻ります。クエリされたグラフ位置は、次のレンダリングパス終了後に `AbstractGraph3D::queriedGraphPosition ` プロパティから読み取ることができます。
特定の画面位置に対応する唯一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む不可視のボックスの内側を基準に行われます。
注:棒 グラフでは、グラフの位置のクエリはグラフの床レベルでのみ可能です。
AbstractGraph3D::queriedGraphPositionも参照してください 。
invalidSelectionPoint : point
選択に無効なポイントを提供する定数プロパティ。
primarySubViewport : rect
データ可視化のプライマリビューが対象となる、ビューポート内の現在のサブビューポートの矩形。
slicingActive がfalse の場合、プライマリ・サブビューポートはビューポートと同じサイズになります。slicingActive がtrue であり、かつプライマリ・サブビューポートが明示的に設定されていない場合、プライマリ・サブビューポートはビューポートの5分の1のサイズになります。
注: primarySubViewport をビューポートより大きく、またはビューポートの外側に設定すると 、ビューポートのサイズがそれに応じて変更されます。
secondarySubViewport : rect
* * * ビューポート内のセカンダリ・ビューポートの矩形。セカンダリ・ビューポート * は、一部の可視化において 2D スライスビューを描画するために使用されます。明示的に * 設定されていない場合、null となります。slicingActive がtrue の場合、 * ビューポートと同じサイズになります。 *
注: セカンダリサブビューポートがビューポートより大きい場合 、またはビューポートの* 外側にある場合、ビューポートはそれに応じてサイズが調整されます。
secondarySubviewOnTop : bool
2Dスライスビューと3Dビューのどちらを上に表示するかを指定します。
selectionQueryPosition : point
シーンによって選択として処理されるべき、ユーザー入力の座標。このプロパティが `invalidSelectionPoint` 以外の値に設定されている場合、グラフはプライマリビューポート内の指定された地点にあるデータ項目を選択しようとします。レンダリングパスが終了すると、このプロパティはデフォルト状態の `invalidSelectionPoint` に戻ります。
slicingActive : bool
2Dスライシングビューが現在アクティブであるかどうかを指定します。true の場合、AbstractGraph3D::selectionMode では、AbstractGraph3D.SelectionRow またはAbstractGraph3D.SelectionColumn のいずれかに有効な選択が設定されている必要があります。
注: すべての可視化機能が2Dスライシングビューに対応しているわけではありません 。
viewport : rect [read-only]
すべての3Dレンダリングの対象となる、現在のビューポート矩形。
© 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.