GraphsNode QML Type

3Dグラフの基本タイプ。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧
• GraphsNodeは、Qt Graphs の3D用QMLタイプの一部です。

プロパティ

• 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 の 3D 用 C++ クラスも参照してください 。

プロパティのドキュメント

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

プロット可能なグラフ領域の端とグラフ背景の端の間に残すスペースに使用する絶対値です。

マージンの値が負の場合、マージンは自動的に決定され、系列内の項目のサイズやグラフの種類に応じて変動する可能性があります。グラフのアスペクト比がデフォルト値から変更されていない場合、この値は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 」信号が発信されるまで有効です。

このシグナルは、例えば「Axis Handling」の例で示されているように、カスタマイズされた入力処理を実装するために使用できます。

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 をグラフに追加します。追加された項目の所有権はグラフが引き継ぎます。

追加に成功した場合は追加された項目のインデックスを返し、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」も参照してください 。