GraphsNode QML Type

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

• 継承されたメンバを含む、すべてのメンバの一覧
• GraphsNode はQt Graphs QML Types for 3D に含まれます。

プロパティ

• aspectRatio : real
• customItemList : list<Custom3DItem>
• gridLineType : Graphs3D.GridLineType
• horizontalAspectRatio : real
• labelMargin : real
• locale : locale
• margin : real
• optimizationHint : Graphs3D.OptimizationHint
• polar : bool
• queriedGraphPosition : vector3d
• radialLabelOffset : real
• selectedElement : Graphs3D.ElementType
• selectionMode : Graphs3D.SelectionMode
• theme : GraphsTheme

方法

• qsizetype addCustomItem(Custom3DItem item)
• void clearSelection()
• void doPicking(QPoint point)
• void doRayPicking(QVector3D origin, QVector3D direction)
• bool hasSeries(Abstract3DSeries series)
• void releaseCustomItem(Custom3DItem item)
• void removeCustomItem(Custom3DItem item)
• void removeCustomItemAt(vector3d position)
• void removeCustomItems()
• Abstract3DAxis selectedAxis()
• Custom3DItem selectedCustomItem()
• qsizetype selectedCustomItemIndex()
• int selectedLabelIndex()

詳細な説明

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

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

プロパティの説明

aspectRatio : real

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

horizontalAspectRatioも参照してください 。

customItemList : list<Custom3DItem>

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

gridLineType : Graphs3D.GridLineType

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

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

Graphs3D.GridLineTypeも参照。

horizontalAspectRatio : real

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

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 。

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

polar : bool

true の場合、横軸は極軸に変わる。x軸は角度軸になり、z軸は半径軸になる。棒グラフでは極軸モードは利用できない。

デフォルトはfalse 。

radialLabelOffsetも参照 。

queriedGraphPosition : vector3d [read-only]

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

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

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 列挙値のいずれか。

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)

グラフの要素に対して、origin とdirection から始まるピッキングを実行し、最初にヒットした項目を選択する。

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も参照 。