GraphsNode QML Type

3Dグラフの基本型。詳細...

Import Statement: import QtGraphs
Inherits:

Node

Inherited By:

Bars3DNode, Scatter3DNode, and Surface3DNode

プロパティ

方法

詳細な説明

Qt Graphs のすべての 3D グラフ・ノードのための作成不可能な基本型。

Bars3DNode,Scatter3DNode,Surface3DNode,Qt Graphs C++ Classes for 3Dも参照してください

プロパティの説明

aspectRatio : real

水平面上の最長軸と y 軸間のグラフのスケーリングの比率。デフォルトは2.0 です。

注意: Bars3D には影響しません。

horizontalAspectRatioも参照してください


customItemList : list<Custom3DItem>

グラフに追加されたCustom3DItem アイテムのリスト。グラフは、追加された項目の所有権を持ちます。


gridLineType : Graphs3D.GridLineType

グリッド線のタイプがGraphs3D.GridLineType.ShaderGraphs3D.GridLineType.Geometry かを定義します。

この値はすべてのグリッド線に影響します。

Graphs3D.GridLineTypeも参照してください


horizontalAspectRatio : real

グラフの X 軸と Z 軸のスケーリングの比率。値0.0 は、 軸範囲に従っ た自動ス ケー リ ン グ を示す。デフォルトは0.0

注 : barThicknessbarSpacing プ ロパテ ィ を通 じ て水平面上の拡縮を扱 うBars3DNode には影響 し ません。極座標グラフもこのプロパティを無視します。

aspectRatio,polar,Bars3DNode::barThickness, およびBars3DNode::barSpacingも参照してください


labelMargin : real

このプロパティは、軸ラベルの配置のマージンを指定します。

負の値はラベルをプロット領域内に配置し、正の値はラベルをプロット領域外に配置する。値が負の場合、ラベルの自動回転は無効になる。デフォルトは0.1

QAbstract3DAxis::labelAutoAngleも参照


locale : locale

各種数値ラベルの書式設定に用いるロケールを設定する。デ フ ォ ル ト は"C" ロ ケール。

Value3DAxis::labelFormatも参照


margin : real

margin(余白) グラフ描画可能領域の端とグラフ背景の端の間に残された余白の絶対値。

marginの値が負の場合、余白は自動的に決定され、シリーズ内のアイテムのサイズやグラフの種類によって変化する。グラフのアスペクト比がデフォルト値から変更されていない場合、値はY軸範囲の分数として解釈される。デフォルトは-1.0

注: 散布図グラフの余白を自動的に決定される余白よりも小さく設定すると、グラフの端の散布図項目がグラフの背景と重なることがあります。

:散布図およびサーフェス グラフでは、軸ラベルのサイズに比べてマージンが小さい場合、軸のエッジ ラベルの位置は、隣接する軸のエッジ ラベルと重ならないように調整されます。


optimizationHint : Graphs3D.OptimizationHint

レンダリングの最適化にデフォルトモードとレガシーモードのどちらを使用するかを指定します。

デフォルトモードはインスタンス化されたレンダリングを使用し、ほとんどのシステムで最高レベルのパフォーマンスで全機能セットを提供します。静的モードはグラフ描画を最適化し、変化のない大規模なデータセットに最適です。動的なデータの変化やアイテムの回転があると遅くなります。選択は最適化されないため、大規模なデータセットで静的モードを使用することはお勧めできません。レガシーモードは、インスタンス化せずに、グラフ内のすべての項目を個別にレンダリングします。これは、デフォルト・モードが機能しない場合にのみ使用されるべきで、ターゲット・システムがインスタンス化をサポートしていない場合と同じです。デフォルトはDefault

注意: 環境によっては、静的最適化を使用した大きなグラフが描画されないことがあります。これは、すべてのアイテムが1回の描画呼び出しで描画されるためで、グラフィックドライバによって、呼び出しごとにサポートされる最大頂点数が異なるからです。これは主に32ビットおよびOpenGL ES2プラットフォームでの問題です。この問題を回避するには、頂点数の少ないアイテムメッシュを選択するか、ポイントメッシュを使用します。

Abstract3DSeries::mesh およびGraphs3D.OptimizationHintも参照して ください。


polar : bool

true の場合、水平軸は極軸に変更されます。x軸が角軸になり、z軸が半径軸になる。棒グラフでは極軸モードは利用できない。

デフォルトはfalse

radialLabelOffsetも参照


queriedGraphPosition : vector3d [read-only]

こ の読み出 し 専用のプ ロパテ ィ には、Scene3D::graphPositionQuery を用いて取得 さ れた各軸に沿 う 最新のグ ラ フ位置値が格納 さ れてい ます。値は[-1, 1] の範囲に正規化されます。クエリされた位置がグラフ境界の外側であった場合、値は実際の位置を反映せず、代わりに範囲[-1, 1] の外側の未定義の位置となります。この値は、問い合わせが行われるまで未定義となる。

特定の画面位置に一致する唯一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む不可視のボックスの内側に対して行われます。

注: 棒グラフでは、グラフのフロアレベルでしかグラフの位置を問い合わせることができないため、棒グラフではy値は常に0であり、有効な問い合わせはグラフのフロアを含む画面位置でのみ行うことができます。

Scene3D::graphPositionQueryも参照のこと


radialLabelOffset : real

このプロパティは、半径極軸の軸ラベルの正規化された水平オフセットを指定します。値0.0 は、ラベルが0角度の角度軸グリッド線の隣に描画されるべきであることを示します。値1.0 は、ラベルがグラフ背景の端の通常の場所に描画されることを示す。このプロパティは、polar プロパティ値がfalse の場合は無視されます。デフォルトは1.0

polarも参照してください


selectedElement : Graphs3D.ElementType [read-only]

グラフ内で選択されている要素。

こ のプ ロパテ ィ を用いて、 選択 さ れてい る 要素の種類を取得す る こ と がで き ます。このタイプは、グラフ内で新しい選択が行われ、selectedElementChanged シグナルが発せられるまで有効です。

このシグナルは、例えば、カスタマイズされた入力処理を実装するために使用することができます。

selectedLabelIndex(),selectedAxis(),selectedCustomItemIndex(),selectedCustomItem(),Bars3DNode::selectedSeries,Scatter3DNode::selectedSeries,Scene3D::selectionQueryPosition,Graphs3D.ElementTypeも参照のこと


selectionMode : Graphs3D.SelectionMode

グラフのアクティブな選択モード。graphs3d.selectionflag enum 値のいずれか。


theme : GraphsTheme

グラフのアクティブテーマ。

GraphsThemeも参照


メソッド・ドキュメント

qsizetype addCustomItem(Custom3DItem item)

Custom3DItem item をグラフに追加します。グラフは追加されたアイテムの所有権を持ちます。

add が成功した場合は追加されたアイテムのインデックスを、null アイテムを追加しようとした場合は -1、既に追加されたアイテムを追加しようとした場合はアイテムのインデックスを返します。

removeCustomItems(),removeCustomItem(),removeCustomItemAt()も参照


void clearSelection()

付属するすべてのシリーズから選択をクリアします。


void doPicking(QPoint point)

point 、グラフの要素のビュー座標を使用してピッキングを行い、最初にヒットした項目を選択します。デフォルトの入力処理では、onTapped イベントを受信するとこの処理が実行されます。

selectedElementも参照してください


void doRayPicking(QVector3D origin, QVector3D direction)

origindirection からグラフの要素に対してピッキングを実行し、最初にヒットしたアイテムを選択します。

selectedElement参照して ください。


bool hasSeries(Abstract3DSeries series)

series がすでにグラフに追加されているかどうかを返します。


void releaseCustomItem(Custom3DItem item)

item の所有権を取り戻し、item をグラフから削除します。

注意: 同じアイテムが再びグラフに追加された場合、テクスチャファイルを再設定する必要があります。

Custom3DItem::textureFileも参照して ください。


void removeCustomItem(Custom3DItem item)

カスタムitem を削除します。それに割り当てられているリソースを削除します。


void removeCustomItemAt(vector3d position)

position のカスタム アイテムをすべて削除します。それらに割り当てられているリソースを削除します。


void removeCustomItems()

すべてのカスタム項目を削除します。それらに割り当てられているリソースを削除する。


Abstract3DAxis selectedAxis()

任意のラベルタイプでselectedElementChanged シグナルを受信した後に、選択された軸を取得するために使用できる。選択は、次のselectedElementChanged シグナルまで有効である。

選択された軸、またはNULLを返す。

selectedElementも参照してください


Custom3DItem selectedCustomItem()

ElementType.CustomItem タイプでselectedElementChanged シグナルを受信した後、選択されたカスタム項目を取得するために使用できます。項目の所有権はグラフに残ります。選択は、次のselectedElementChanged シグナルまで有効です。

選択されたカスタム項目、または null を返します。

selectedElementも参照してください


qsizetype selectedCustomItemIndex()

ElementType.CustomItem 型のselectedElementChanged シグナルを受信した後、選択されたカスタム項目のインデックスを照会するために使用できます。選択は次のselectedElementChanged シグナルまで有効である。

選択されたカスタム項目のインデックス、または -1 を返します。

selectedElementも参照


int selectedLabelIndex()

任意のラベル・タイプでselectedElementChanged シグナルを受信した後、選択されたラベルのインデックスを問い合わせるために使用できる。選択は次のselectedElementChanged シグナルが来るまで有効である。

選択されたラベルのインデックスか -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.