AbstractGraph3D QML Type
3Dビジュアライゼーションの基本型。詳細...
| Import Statement: | import QtDataVisualization 1.11 |
| Since: | QtDataVisualization 1.0 |
| Inherited By: |
プロパティ
- 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 。
注： barThickness およびbarSpacing プロパティによって水平面のスケーリングを扱うBars3D には影響しません。極座標グラフもこのプロパティを無視します。
このプロパティは 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]
プロット可能なグラフ領域の端とグラフの背景の端の間に残されたスペースに使用される絶対値。
marginの値が負の場合、marginは自動的に決定され、系列のアイテムのサイズやグラフのタイプによって変化する。グラフのアスペクト比がデフォルト値から変更されていない場合、値は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回の描画呼び出しで描画されるためで、グラフィックドライバによって、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 。
注： Bars3D にのみ影響します。ただし、正と負の両方の値を保持する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 enum 値のいずれか。
QAbstract3DGraph::SelectionFlagも参照 。
shadowQuality : AbstractGraph3D.ShadowQuality
影の質。QAbstract3DGraph::ShadowQuality enum 値の1つ。
QAbstract3DGraph::ShadowQualityも参照 。
shadowsSupported : bool
この読み取り専用プロパティは、現在のコンフィギュレーションでシャドウがサポートされているかどうかを示します。OpenGL ES2 コンフィギュレーションはシャドウをサポートしません。
theme : Theme3D
グラフのアクティブテーマ。
Theme3Dも参照 。
メソッドのドキュメント
[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)
Custom3DItem item をグラフに追加する。グラフは追加されたアイテムの所有権を持つ。
add が成功した場合は追加されたアイテムのインデックスを、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.
