AbstractGraph3D QML Type
3Dビジュアライゼーションの基本型。詳細...
| Import Statement: | import QtDataVisualization 1.8 |
| 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 |
水平面の最長軸と Y 軸の間のグラフのスケーリングの比率。デフォルトは2.0 。
注意： Bars3D には影響しません。
このプロパティは QtDataVisualization 1.1 で導入されました。
horizontalAspectRatioも参照してください 。
currentFps : int |
FPS 測定が有効な場合、最後の 1 秒間の結果がこの読み取り専用プロパティに格納されます。測定が有効化された後、この値が更新されるまでに少なくとも 1 秒かかります。
このプロパティは QtDataVisualization 1.1 で導入されました。
measureFpsも参照してください 。
customItemList : list<Custom3DItem> |
グラフに追加されたCustom3DItem アイテムのリスト。グラフは、追加された項目の所有権を持つ。
このプロパティは QtDataVisualization 1.1 で導入されました。
horizontalAspectRatio : real |
x 軸と z 軸間のグラフのスケーリングの比率。0.0 の値は、軸の範囲に従って自動的にスケーリングすることを示します。デフォルトは0.0 。
注： Bars3D には影響しません。barThickness およびbarSpacing プロパティによって水平面上のスケーリングが処理されます。極座標グラフもこのプロパティを無視します。
このプロパティは QtDataVisualization 1.2 で導入されました。
aspectRatio,polar,Bars3D::barThickness,Bars3D::barSpacingも参照してください 。
inputHandler : AbstractInputHandler3D |
グラフで使用されるアクティブな入力ハンドラ。このプロパティを NULL に設定することで、デフォルトの入力ハンドラを無効にすることができます。
locale : locale |
各種数値ラベルの書式設定に使用するロケールを設定します。デフォルトは"C" ロケールです。
このプロパティは QtDataVisualization 1.2 で導入されました。
ValueAxis3D::labelFormatも参照してください 。
margin : real |
このプロパティは、QtDataVisualization 1.2 で導入されました。
マージン値が負の場合、マージンは自動的に決定され、シリーズ内のアイテムのサイズとグラフの種類に応じて変化します。グラフのアスペクト比がデフォルト値から変更されていない場合、値はY軸範囲の分数として解釈される。デフォルトは-1.0 。
注： 散布図グラフの余白を自動的に決定される余白よりも小さく設定すると、グラフの端の散布図項目がグラフの背景と重なることがあります。
注 ： 散布図やサーフェス グラフでは、マージンが軸ラベルのサイズに比べて小さい場合、軸のエッジ ラベルの位置は、隣接する軸のエッジ ラベルと重ならないように調整されます。
このプロパティは QtDataVisualization 1.2 で導入されました。
measureFps : bool |
true の場合、レンダリングはオンデマンドではなく連続的に行われ、currentFps プロパティの値が更新されます。デフォルトはfalse 。
このプロパティは QtDataVisualization 1.1 で導入されました。
currentFpsも参照してください 。
msaaSamples : int |
renderingMode がRenderIndirect のとき、マルチサンプル・アンチエイリアシングで使用されるサンプル数。renderingMode がRenderDirectToBackground またはRenderDirectToBackground_NoClear の場合、このプロパティ値は読み取り専用で、ウィンドウ サーフェス形式で指定されたサンプル数を返します。デフォルトは4 です。
renderingModeも参照してください 。
optimizationHints : AbstractGraph3D.OptimizationHints |
レンダリングの最適化にデフォルトモードと静的モードのどちらを使用するか。
デフ ォ ル ト モー ド は、 パフ ォーマ ン ス を妥当な水準で全機能を提供 し ます。静的モードはグラフ描画を最適化し、変化のない大きなデータセットに最適です。動的なデータの変更やアイテムの回転があると遅くなります。選択は最適化されないので、大量のデータセットで静的モードを使用することはお勧めできません。静的最適化は散布図でのみ機能します。デフォルトはOptimizationDefault 。
注意： 環境によっては、静的最適化を使用した大きなグラフが描画されないことがあります。これは、すべての項目が1回の描画呼び出しで描画されるためで、グラフィックドライバによって、呼び出しごとにサポートされる最大頂点数が異なるからです。これは主に32ビットおよびOpenGL ES2プラットフォームでの問題です。この問題を回避するには、頂点数の少ないアイテムメッシュを選択するか、ポイントメッシュを使用します。
このプロパティは QtDataVisualization 1.1 で導入されました。
Abstract3DSeries::mesh とQAbstract3DGraph::OptimizationHintも参照して ください。
orthoProjection : bool |
true の場合、グラフの表示に正射投影が使用されます。デフォルトはfalse です。
注： true に設定すると、影は無効になります。
このプロパティは QtDataVisualization 1.1 で導入されました。
polar : bool |
true を指定すると、水平軸が極軸に変更されます。x 軸は角度軸になり、z 軸は半径軸になります。棒グラフでは極軸モードは利用できない。
デフォルトはfalse です。
このプロパティは QtDataVisualization 1.2 で導入されました。
orthoProjection およびradialLabelOffsetも参照してください 。
queriedGraphPosition : vector3d |
この読み取り専用プロパティには、Scene3D::graphPositionQuery を使用してクエリされた、各軸に沿った最新のグラフ位置値が含まれます。値は、[-1, 1] の範囲に正規化されます。クエリされた位置がグラフ境界の外側であった場合、値は実際の位置を反映せず、代わりに範囲外の未定義の位置[-1, 1] になります。この値は、問い合わせが行われるまで未定義となる。
特定の画面位置に一致する唯一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む不可視のボックスの内側に対して行われます。
注： 棒グラフでは、グラフのフロアレベルでしかグラフの位置を問い合わせることができないため、棒グラフでは y 値は常に 0 となり、有効な問い合わせはグラフのフロアを含む画面位置でのみ行うことができます。
このプロパティは QtDataVisualization 1.2 で導入されました。
Scene3D::graphPositionQueryも参照してください 。
radialLabelOffset : real |
このプロパティは、半径極軸の軸ラベルの正規化された水平オフセットを指定します。値0.0 は、ラベルが0角度の角度軸グリッド線の隣に描画されることを示します。値1.0 は、ラベルがグラフ背景の端の通常の場所に描画されることを示す。このプロパティは、polar プロパティ値がfalse の場合は無視されます。デフォルトは1.0 。
このプロパティは QtDataVisualization 1.2 で導入されました。
polarも参照してください 。
reflection : bool |
床反射のオン/オフを設定します。デフォルトはfalse です。
注: Bars3D にのみ影響します。 ただし、正と負の両方の値を保持するBars3D グラフでは、床平面と交差するカスタム項目の反射はサポートされません。その場合、間違ったレンダリングを避けるために、反射をオフにする必要があります。
このプロパティは QtDataVisualization 1.2 で導入されました。
reflectivityも参照して ください。
reflectivity : real |
床の反射率を設定します。数値が大きいほど、床の反射率が高くなります。有効範囲は[0...1] です。デフォルトは0.5 。
注意: Bars3D にのみ影響します。
このプロパティは QtDataVisualization 1.2 で導入されました。
reflectionも参照してください。
selectedElement : AbstractGraph3D.ElementType |
グラフ内で選択されているエレメント。
このプロパティは、選択された要素のタイプを問い合わせるために使用することができる。このタイプは、グラフ内で新しい選択が行われ、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 値のいずれか。
QAbstract3DGraph::ShadowQualityも参照して ください。
shadowsSupported : bool |
この読み取り専用プロパティは、現在のコンフィギュレーションでシャドウがサポートされているかどうかを示します。OpenGL ES2 構成ではシャドウはサポートされません。
メソッドのドキュメント
|
Custom3DItem item をグラフに追加する。グラフは追加されたアイテムの所有権を持つ。
add が成功した場合は追加されたアイテムのインデックスを、null アイテムを追加しようとした場合は -1、既に追加されたアイテムを追加しようとした場合はアイテムのインデックスを返します。
このメソッドは QtDataVisualization 1.1 で導入されました。
removeCustomItems(),removeCustomItem(),removeCustomItemAt()も参照してください 。
void clearSelection() |
すべての添付シリーズから選択をクリアします。
|
series がすでにグラフに追加されているかどうかを返します。
このメソッドは Qt 6.3 で導入されました。
|
item の所有権を取り戻し、グラフからitem を削除する。
注意： 同じアイテムがグラフに追加された場合、テクスチャファイルを再設定する必要があります。
このメソッドは QtDataVisualization 1.1 で導入されました。
Custom3DItem::textureFileも参照して ください。
|
カスタムitem を削除します。割り当てられたリソースを削除します。
このメソッドは QtDataVisualization 1.1 で導入されました。
|
position にあるすべてのカスタムアイテムを削除する。それらに割り当てられたリソースを削除します。
このメソッドは QtDataVisualization 1.1 で導入されました。
|
すべてのカスタム項目を削除します。それらに割り当てられたリソースを削除します。
このメソッドは QtDataVisualization 1.1 で導入されました。
|
任意のラベルタイプでselectedElementChanged 信号を受信した後に、選択された軸を取得するために使用できる。選択は、次のselectedElementChanged 信号まで有効である。
選択された軸、またはNULLを返します。
このメソッドは、QtDataVisualization 1.1 で導入されました。
selectedElementも参照してください 。
|
ElementCustomItem タイプでselectedElementChanged シグナルを受信した後、選択されたカスタム項目を取得するために使用できます。アイテムの所有権はグラフに残ります。選択は、次のselectedElementChanged シグナルまで有効です。
選択されたカスタムアイテム、または null を返します。
このメソッドは QtDataVisualization 1.1 で導入されました。
selectedElementも参照してください 。
|
ElementCustomItem タイプでselectedElementChanged シグナルを受信した後、選択されたカスタム項目のインデックスを照会するために使用できる。選択は次のselectedElementChanged シグナルまで有効である。
選択されたカスタム項目のインデックス、または -1 を返します。
このメソッドは QtDataVisualization 1.1 で導入されました。
selectedElementも参照してください 。
|
任意のラベルタイプでselectedElementChanged シグナルを受信した後、選択されたラベルのインデックスを問い合わせるために使用できる。選択は次のselectedElementChanged シグナルまで有効である。
選択されたラベルのインデックス、または -1 を返します。
このメソッドは QtDataVisualization 1.1 で導入されました。
selectedElementも参照してください 。
© 2025 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.
