AbstractGraph3D QML Type
3D 視覚化のための基本型。詳細...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| Inherited By: | |
| Status: | Deprecated |
この型は非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
- aspectRatio : real
(since QtDataVisualization 1.1) - currentFps : int
(since QtDataVisualization 1.1) - customItemList : list<Custom3DItem>
(since QtDataVisualization 1.1) - horizontalAspectRatio : real
(since QtDataVisualization 1.2) - inputHandler : AbstractInputHandler3D
- locale : locale
(since QtDataVisualization 1.2) - margin : real
(since QtDataVisualization 1.2) - measureFps : bool
(since QtDataVisualization 1.1) - msaaSamples : int
- optimizationHints : AbstractGraph3D.OptimizationHints
(since QtDataVisualization 1.1) - orthoProjection : bool
(since QtDataVisualization 1.1) - polar : bool
(since QtDataVisualization 1.2) - queriedGraphPosition : vector3d
(since QtDataVisualization 1.2) - radialLabelOffset : real
(since QtDataVisualization 1.2) - reflection : bool
(since QtDataVisualization 1.2) - reflectivity : real
(since QtDataVisualization 1.2) - scene : Scene3D
- selectedElement : AbstractGraph3D.ElementType
(since QtDataVisualization 1.1) - selectionMode : AbstractGraph3D.SelectionMode
- shadowQuality : AbstractGraph3D.ShadowQuality
- shadowsSupported : bool
- theme : Theme3D
方法
- int addCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void clearSelection()
- bool hasSeries(Abstract3DSeries series)
(since 6.3) - void releaseCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItemAt(vector3d position)
(since QtDataVisualization 1.1) - void removeCustomItems()
(since QtDataVisualization 1.1) - Abstract3DAxis selectedAxis()
(since QtDataVisualization 1.1) - Custom3DItem selectedCustomItem()
(since QtDataVisualization 1.1) - int selectedCustomItemIndex()
(since QtDataVisualization 1.1) - int selectedLabelIndex()
(since QtDataVisualization 1.1)
詳細説明
QtDataVisualization におけるすべての3D視覚化の基底型です。
このタイプは作成できませんが、3D 視覚化間で共有されるプロパティが含まれています。
関連項目： Bars3D 、Scatter3D 、Surface3D 、および Qt Data Visualization C++ Classesを参照してください。
プロパティのドキュメント
aspectRatio : real [since QtDataVisualization 1.1]
水平面上の最長軸とy軸との間のグラフのスケーリング比率です。デフォルトは2.0 です。
注： Bars3Dには影響しません 。
このプロパティは、QtDataVisualization 1.1で導入されました。
horizontalAspectRatioも参照してください 。
currentFps : int [since QtDataVisualization 1.1]
FPS測定が有効になっている場合、過去1秒間の測定結果がこの読み取り専用プロパティに格納されます。測定が有効になってから、この値が更新されるまでには少なくとも1秒かかります。
このプロパティは QtDataVisualization 1.1 で導入されました。
measureFpsも参照してください 。
customItemList : list<Custom3DItem> [since QtDataVisualization 1.1]
グラフに追加されたCustom3DItem 項目のリスト。グラフは、追加された項目の所有権を取得します。
このプロパティは、QtDataVisualization 1.1 で導入されました。
horizontalAspectRatio : real [since QtDataVisualization 1.2]
x軸とz軸のグラフのスケーリング比率です。0.0 の値は、軸の範囲に応じて自動的にスケーリングされることを示します。デフォルトは0.0 です。
注： Bars3D には影響しません 。Bars3D では、水平面でのスケーリングはbarThickness およびbarSpacing プロパティによって処理されます。極座標グラフもこのプロパティを無視します。
このプロパティは、QtDataVisualization 1.2で導入されました。
関連項目： aspectRatio 、polar 、Bars3D::barThickness 、およびBars3D::barSpacing 。
inputHandler : AbstractInputHandler3D
グラフで使用されるアクティブな入力ハンドラです。このプロパティをnullに設定することで、デフォルトの入力ハンドラを無効にすることができます。
locale : locale [since QtDataVisualization 1.2]
さまざまな数値ラベルの書式設定に使用するロケールを設定します。デフォルトは"C" ロケールです。
このプロパティは、QtDataVisualization 1.2で導入されました。
「ValueAxis3D::labelFormat」も参照してください 。
margin : real [since QtDataVisualization 1.2]
プロット可能なグラフ領域の端とグラフの背景の端との間に残すスペースに用いられる絶対値。
マージンの値が負の場合、マージンは自動的に決定され、系列内の項目のサイズやグラフの種類に応じて変動する可能性があります。グラフのアスペクト比がデフォルト値から変更されていない場合、この値はY軸範囲に対する割合として解釈されます。デフォルト値は-1.0 です。
注： 散布図の余白を、自動的に決定された余白よりも小さく設定すると 、グラフの端にある散布図のデータ点がグラフの背景と重なってしまうことがあります。
注： 散布図 およびサーフェスグラフにおいて 、マージンが軸ラベルのサイズに比べて小さい場合、隣接する軸の端のラベルとの重なりを避けるために、軸の端のラベルの位置が調整されます。
このプロパティは、QtDataVisualization 1.2 で導入されました。
measureFps : bool [since QtDataVisualization 1.1]
true の場合、レンダリングはオンデマンドではなく継続的に行われ、currentFps プロパティの値が更新されます。デフォルトはfalse です。
このプロパティは、QtDataVisualization 1.1 で導入されました。
currentFpsも参照してください 。
msaaSamples : int
renderingModeがRenderIndirect の場合、マルチサンプルアンチエイリアシングで使用されるサンプル数です。renderingModeがRenderDirectToBackground またはRenderDirectToBackground_NoClear の場合、このプロパティの値は読み取り専用となり、ウィンドウのサーフェスフォーマットで指定されたサンプル数を返します。デフォルトは4 です。
renderingModeも参照してください 。
optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]
レンダリングの最適化に、デフォルトモードとスタティックモードのどちらを使用するか。
デフォルトモードでは、妥当なパフォーマンスレベルで全機能を利用できます。スタティックモードはグラフのレンダリングを最適化するため、変更のない大規模なデータセットに最適です。ただし、動的なデータ変更や項目の回転が行われる場合は処理速度が低下します。選択操作は最適化されていないため、大規模なデータセットでスタティックモードを使用することは推奨されません。 静的最適化は散布図でのみ機能します。デフォルトはOptimizationDefault です。
注：一部の環境では 、静的最適化を使用した大規模なグラフがレンダリングされない場合があります。これは、すべてのアイテムが単一のドローコールでレンダリングされるためであり、グラフィックドライバによって1回のドローコールあたりの最大頂点数が異なるためです。この問題は主に32ビットおよびOpenGL ES2プラットフォームで発生します。 この問題を回避するには、頂点数の少ないアイテムメッシュを選択するか、ポイントメッシュを使用してください。
このプロパティは、QtDataVisualization 1.1 で導入されました。
Abstract3DSeries::mesh およびQAbstract3DGraph::OptimizationHintも参照してください 。
orthoProjection : bool [since QtDataVisualization 1.1]
true に設定すると、グラフの表示には正投影が使用されます。デフォルトはfalse です。
注： true に設定すると、影 は無効になります。
このプロパティは、QtDataVisualization 1.1 で導入されました。
polar : bool [since QtDataVisualization 1.2]
true の場合、横軸は極座標軸に変更されます。x軸は角度軸となり、z軸は半径軸となります。棒グラフでは極座標モードは使用できません。
デフォルトはfalse です。
このプロパティは QtDataVisualization 1.2 で導入されました。
orthoProjection およびradialLabelOffsetも参照してください 。
queriedGraphPosition : vector3d [since QtDataVisualization 1.2]
この読み取り専用プロパティには、Scene3D::graphPositionQuery を使用してクエリされた、各軸に沿った最新のグラフ位置値が含まれます。これらの値は、[-1, 1] の範囲に正規化されています。クエリされた位置がグラフの境界外にある場合、値は実際の位置を反映せず、代わりに[-1, 1] の範囲外の未定義の位置となります。クエリが行われるまでは、この値は未定義となります。
特定の画面位置に対応する唯一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む見えないボックスの内側を基準に行われます。
注：棒 グラフでは 、グラフの底面レベルでのみグラフ位置のクエリが可能であるため、棒グラフの y 値は常に 0 であり、有効なクエリはグラフの底面を含む画面位置でのみ実行できます。
このプロパティは QtDataVisualization 1.2 で導入されました。
Scene3D::graphPositionQueryも参照してください 。
radialLabelOffset : real [since QtDataVisualization 1.2]
このプロパティは、放射状極座標軸の軸ラベルの正規化された水平オフセットを指定します。値「0.0 」は、ラベルを0度の角度軸グリッド線の隣に描画することを示します。値「1.0 」は、ラベルをグラフ背景の端という通常の位置に描画することを示します。このプロパティは、polarプロパティの値が「false 」の場合、無視されます。デフォルトは「1.0 」です。
このプロパティは QtDataVisualization 1.2 で導入されました。
polarも参照してください 。
reflection : bool [since QtDataVisualization 1.2]
床面への反射をオンまたはオフに設定します。デフォルトはfalse です。
注： Bars3 Dに のみ影響します 。ただし、正の値と負の値の両方を含むBars3Dグラフでは、床面と交差するカスタムアイテムに対して反射はサポートされません。その場合は、不正なレンダリングを防ぐために、反射を無効にする必要があります。
このプロパティは QtDataVisualization 1.2 で導入されました。
reflectivityも参照してください 。
reflectivity : real [since QtDataVisualization 1.2]
床の反射率を設定します。数値が大きいほど、床の反射率が高くなります。有効な範囲は[0...1] です。デフォルトは0.5 です。
注： Bars3Dにのみ影響します 。
このプロパティは QtDataVisualization 1.2 で導入されました。
reflectionも参照してください 。
scene : Scene3D
シーンの操作や、アクティブなカメラなどのシーン要素へのアクセスに使用できる Scene3D ポインタです。
このプロパティは読み取り専用です。
selectedElement : AbstractGraph3D.ElementType [since QtDataVisualization 1.1]
グラフで選択されている要素。
このプロパティを使用すると、選択された要素のタイプを照会できます。このタイプは、グラフ内で新たな選択が行われ、「selectedElementChanged 」シグナルが発行されるまで有効です。
このシグナルは、たとえば「Axis Handling」の例で示されているように、カスタマイズされた入力処理を実装するために使用できます。
このプロパティは、QtDataVisualization 1.1 で導入されました。
selectedLabelIndex()、selectedAxis()、selectedCustomItemIndex()、selectedCustomItem()、Bars3D::selectedSeries 、Scatter3D::selectedSeries 、Scene3D::selectionQueryPosition 、およびQAbstract3DGraph::ElementTypeも参照してください 。
selectionMode : AbstractGraph3D.SelectionMode
可視化におけるアクティブな選択モード。QAbstract3DGraph::SelectionFlag 列挙型の値の1つです。
「QAbstract3DGraph::SelectionFlag」も参照してください 。
shadowQuality : AbstractGraph3D.ShadowQuality
影の品質。QAbstract3DGraph::ShadowQuality の列挙値の1つ。
「QAbstract3DGraph::ShadowQuality」も参照してください 。
shadowsSupported : bool
この読み取り専用プロパティは、現在の設定で影がサポートされているかどうかを示します。OpenGL ES2の設定では、影はサポートされていません。
theme : Theme3D
グラフのアクティブなテーマ。
Theme3Dも参照してください 。
メソッドのドキュメント
[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)
item 型の Custom3DItem をグラフに追加します。追加されたアイテムの所有権はグラフが引き継ぎます。
追加に成功した場合は追加された項目のインデックスを返し、null 項目の追加を試みた場合は -1 を返し、すでに追加済みの項目の追加を試みた場合はその項目のインデックスを返します。
このメソッドは QtDataVisualization 1.1 で導入されました。
removeCustomItems()、removeCustomItem()、およびremoveCustomItemAt()も参照してください 。
void clearSelection()
すべての関連シリーズから選択内容を解除します。
[since 6.3] bool hasSeries(Abstract3DSeries series)
series がすでにグラフに追加されているかどうかを返します。
このメソッドは Qt 6.3 で導入されました。
[since QtDataVisualization 1.1] void releaseCustomItem(Custom3DItem item)
item の所有権を取り戻し、グラフからitem を削除します。
注： 同じアイテムをグラフに再度追加する場合 、テクスチャファイルを再設定する必要があります。
このメソッドは QtDataVisualization 1.1 で導入されました。
Custom3DItem::textureFileも参照してください 。
[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)
カスタムitem を削除します。それに割り当てられたリソースを解放します。
このメソッドは、QtDataVisualization 1.1 で導入されました。
[since QtDataVisualization 1.1] void removeCustomItemAt(vector3d position)
position にあるすべてのカスタムアイテムを削除します。それらに割り当てられていたリソースも削除します。
このメソッドは、QtDataVisualization 1.1 で導入されました。
[since QtDataVisualization 1.1] void removeCustomItems()
すべてのカスタム項目を削除します。それらに割り当てられたリソースも削除します。
このメソッドは、QtDataVisualization 1.1 で導入されました。
[since QtDataVisualization 1.1] Abstract3DAxis selectedAxis()
任意のラベルタイプでselectedElementChanged 信号を受信した後、選択された軸を取得するために使用できます。選択は、次のselectedElementChanged 信号が送信されるまで有効です。
選択された軸、またはnullを返します。
このメソッドは、QtDataVisualization 1.1で導入されました。
selectedElementも参照してください 。
[since QtDataVisualization 1.1] Custom3DItem selectedCustomItem()
ElementCustomItem 型のselectedElementChanged シグナルを受信した後、選択されたカスタムアイテムを取得するために使用できます。アイテムの所有権はグラフに残ります。選択は、次のselectedElementChanged シグナルが送信されるまで有効です。
選択されたカスタムアイテム、またはnullを返します。
このメソッドは、QtDataVisualization 1.1で導入されました。
selectedElementも参照してください 。
[since QtDataVisualization 1.1] int selectedCustomItemIndex()
ElementCustomItem 型を持つselectedElementChanged シグナルを受信した後、選択されたカスタム項目のインデックスを照会するために使用できます。選択は、次のselectedElementChanged シグナルが送信されるまで有効です。
選択されたカスタム項目のインデックス、または -1 を返します。
このメソッドは、QtDataVisualization 1.1で導入されました。
selectedElementも参照してください 。
[since QtDataVisualization 1.1] int selectedLabelIndex()
任意のラベルタイプでselectedElementChanged シグナルを受信した後、選択されたラベルのインデックスを照会するために使用できます。選択は、次のselectedElementChanged シグナルが送信されるまで有効です。
選択されたラベルのインデックス、または -1 を返します。
このメソッドは QtDataVisualization 1.1 で導入されました。
selectedElementも参照してください 。
© 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.
