GraphsItem3D QML Type

3Dグラフのベースタイプ。詳細...

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

プロパティ

• ambientLightStrength : real
• aspectRatio : real
• cameraPreset : Graphs3D.CameraPreset
• cameraTargetPosition : vector3d
• cameraXRotation : real
• cameraYRotation : real
• cameraZoomLevel : real
• currentFps : int
• customItemList : list<Custom3DItem>
• cutoffMargin : real (since 6.11)
• dragMode : Graphs3D.DragMode (since 6.12)
• gridLineType : Graphs3D.GridLineType
• horizontalAspectRatio : real
• labelMargin : real
• lightColor : color
• lightStrength : real
• locale : locale
• margin : real
• maxCameraXRotation : real (since 6.9)
• maxCameraYRotation : real (since 6.9)
• maxCameraZoomLevel : real
• measureFps : bool
• minCameraXRotation : real (since 6.9)
• minCameraYRotation : real (since 6.9)
• minCameraZoomLevel : real
• msaaSamples : int
• optimizationHint : Graphs3D.OptimizationHint
• orthoProjection : bool
• panEnabled : bool (since 6.12)
• polar : bool
• queriedGraphPosition : vector3d
• radialLabelOffset : real
• renderingMode : Graphs3D.RenderingMode
• rootNode : Node (since 6.9)
• rotationEnabled : bool
• scene : Scene3D
• selectedElement : Graphs3D.ElementType
• selectionEnabled : bool
• selectionMode : Graphs3D.SelectionMode
• shadowQuality : Graphs3D.ShadowQuality
• shadowStrength : real
• theme : GraphsTheme
• transparencyTechnique : Graphs3D.TransparencyTechnique (since 6.9)
• wrapCameraXRotation : bool
• wrapCameraYRotation : bool
• zoomAtTargetEnabled : bool
• zoomEnabled : bool

信号

• doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)
• dragged(QVector2D delta)
• longPressed()
• mouseMove(QPoint mousePos)
• pinch(qreal delta)
• tapped(QEventPoint eventPoint, Qt::MouseButton button)
• wheel(QQuickWheelEvent *event)

方法

• 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()
• void setDefaultInputHandler()
• void setDragButton(Qt::MouseButtons button)
• void setPanButton(Qt::MouseButtons button) (since 6.12)
• void unsetDefaultDragHandler()
• void unsetDefaultInputHandler()
• void unsetDefaultPinchHandler()
• void unsetDefaultTapHandler()
• void unsetDefaultWheelHandler()

詳細な説明

QtGraphs におけるすべての 3D グラフの、生成不可能な基本型。

Bars3D 、Scatter3D 、Surface3D 、およびQt Graphs にある 3D 用 C++ クラスも参照してください 。

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

ambientLightStrength : real

グラフ全体の周囲の光量です。この値によって、光の位置に関係なく、グラフ全体で色がどれほど均一かつ明るく表示されるかが決まります。値は、0.0 から1.0 の範囲内である必要があります。

aspectRatio : real

水平面上の最長軸とy軸との間のグラフの拡大・縮小比率です。デフォルトは2.0 です。

「horizontalAspectRatio」も参照してください 。

cameraPreset : Graphs3D.CameraPreset

現在有効なカメラプリセット。これはGraphs3D.CameraPreset のいずれかです。有効なプリセットがない場合、値はGraphs3D.CameraPreset.NoPreset となります。

cameraTargetPosition : vector3d

カメラのターゲットは Vector3d として指定されます。デフォルトはvector3d(0.0, 0.0, 0.0) です。

有効な座標値は-1.0...1.0 の範囲内であり、端の値は各軸の範囲の端を示します。この範囲外の値は、範囲の端にクリップされます。

cameraXRotation : real

現在の基準位置を起点として、ターゲット点を中心とするカメラのX軸周りの回転角度（度単位）。

cameraYRotation : real

現在の基準位置を起点として、ターゲット点を中心とするカメラのY軸周りの回転角度（度単位）。

cameraZoomLevel : real

カメラのズームレベル（パーセント単位）。デフォルト値の「100.0 」は、カメラにズームインやズームアウトの設定がないことを意味します。この値は、minCameraZoomLevel およびmaxCameraZoomLevel プロパティによって制限されます。

「 minCameraZoomLevel 」および「maxCameraZoomLevel 」も参照してください 。

currentFps : int

FPS測定が有効になっている場合、過去1秒間の測定結果がこの読み取り専用プロパティに保存されます。測定が有効になってから、この値が更新されるまでには少なくとも1秒かかります。

measureFpsも参照してください 。

customItemList : list<Custom3DItem>

グラフに追加されたCustom3DItem 項目のリスト。グラフは、追加された項目の所有権を取得します。

cutoffMargin : real [since 6.11]

軸の限界値と、グラフ要素が削除される位置との差に用いられる値。

このプロパティは Qt 6.11 で導入されました。

dragMode : Graphs3D.DragMode [since 6.12]

グラフ上のドラッグイベントの解釈方法を指定します。Graphs3D.DragMode 列挙型の値のいずれかです。

デフォルトはGraphs3D.DragMode.Rotate です。

このプロパティは Qt 6.12 で導入されました。

「panEnabled」も参照してください 。

gridLineType : Graphs3D.GridLineType

グリッド線の種類を「Graphs3D.GridLineType.Shader 」とするか、「Graphs3D.GridLineType.Geometry 」とするかを指定します。

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

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

horizontalAspectRatio : real

x軸とz軸のグラフのスケーリング比率です。0.0 を指定すると、軸の範囲に応じて自動的にスケーリングが行われます。デフォルトは0.0 です。

関連項目： aspectRatio 、polar 、Bars3D::barThickness 、およびBars3D::barSpacing 。

labelMargin : real

このプロパティは、軸ラベルの配置に関する余白を指定します。

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

「QAbstract3DAxis::labelAutoAngle」も参照してください 。

lightColor : color

Scene3D で定義された環境光および鏡面反射光の色。

lightStrength : real

グラフ全体の鏡面反射光の強度です。この値は、0.0 から10.0 の範囲内である必要があります。

この値は、Scene3D で指定された光に影響を与えます。

locale : locale

さまざまな数値ラベルの書式設定に使用されるロケールを設定します。デフォルトは「"C" 」ロケールです。

「Value3DAxis::labelFormat」も参照してください 。

margin : real

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

マージンの値が負の場合、マージンは自動的に決定され、系列内の項目のサイズやグラフの種類に応じて変動する可能性があります。グラフのアスペクト比がデフォルト値から変更されていない場合、この値はY軸範囲の割合として解釈されます。デフォルト値は-1.0 です。

maxCameraXRotation : real [since 6.9]

ターゲット点を中心としたカメラのX軸周りの最大回転角度（度単位）。デフォルト値は180.0

このプロパティは Qt 6.9 で導入されました。

maxCameraYRotation : real [since 6.9]

ターゲット点を中心としたカメラのY軸周りの最大回転角度（度）。デフォルト値は90.0

このプロパティは Qt 6.9 で導入されました。

maxCameraZoomLevel : real

カメラのズームレベルの最大許容値を設定します。新しい最大値が既存の最小値よりも低い場合、最小値も新しい最大値に合わせて調整されます。現在のcameraZoomLevel が新しい範囲外にある場合も、同様に調整されます。デフォルトは500.0f です。

「 cameraZoomLevel 」および「minCameraZoomLevel 」も参照してください 。

measureFps : bool

true の場合、レンダリングはオンデマンドではなく継続的に行われ、currentFps プロパティの値が更新されます。デフォルトはfalse です。

「currentFps」も参照してください 。

minCameraXRotation : real [since 6.9]

ターゲット点を中心としたカメラのX軸回転の最小角度（度単位）。デフォルト値は-180.0

このプロパティは Qt 6.9 で導入されました。

minCameraYRotation : real [since 6.9]

ターゲット点を中心としたカメラのY軸周りの最小回転角度（度）。デフォルト値は0.0

このプロパティは Qt 6.9 で導入されました。

minCameraZoomLevel : real

カメラのズームレベルの下限値を設定します。新しい下限値が既存の最大値よりも大きい場合、最大値も新しい下限値に合わせて調整されます。現在のcameraZoomLevel が新しい範囲外にある場合も、同様に調整されます。minCameraZoomLevelは1.0 未満に設定することはできません。デフォルト値は10.0 です。

cameraZoomLevel およびmaxCameraZoomLevelも参照してください 。

msaaSamples : int

renderingMode がIndirect の場合、マルチサンプルアンチエイリアシングで使用されるサンプル数は となります。renderingMode がDirectToBackground の場合、このプロパティの値は読み取り専用となり、ウィンドウのサーフェスフォーマットで指定されたサンプル数を返します。デフォルト値は4 です。

renderingModeも参照してください 。

optimizationHint : Graphs3D.OptimizationHint

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

デフォルトモードではインスタンス化レンダリングが使用され、ほとんどのシステムにおいて最高のパフォーマンスで全機能を利用できます。スタティックモードはグラフのレンダリングを最適化しており、変更のない大規模なデータセットに最適です。ただし、動的なデータ変更やアイテムの回転を行う場合は処理速度が低下します。 選択操作は最適化されていないため、大規模なデータセットで静的モードを使用することは推奨されません。レガシーモードでは、インスタンス化を行わずにグラフ内のすべてのアイテムを個別にレンダリングします。これは、デフォルトモードが機能しない場合、つまりターゲットシステムがインスタンス化をサポートしていない場合にのみ使用してください。デフォルトはDefault です。

関連項目： Abstract3DSeries::mesh およびGraphs3D.OptimizationHint 。

orthoProjection : bool

true に設定すると、グラフの表示には正投影が使用されます。デフォルトはfalse です。

panEnabled : bool [since 6.12]

この入力ハンドラがグラフのパン操作を許可するかどうか。

デフォルト値はtrue です。

このプロパティはQt 6.12で導入されました。

polar : bool

true の場合、横軸が極座標軸に変更されます。x軸は角度軸となり、z軸は半径軸となります。棒グラフでは極座標モードは使用できません。

デフォルトはfalse です。

「 orthoProjection 」および「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も参照してください 。

renderingMode : Graphs3D.RenderingMode

グラフの描画方法。デフォルトはIndirect です。

「 msaaSamples 」および「Graphs3D.RenderingMode 」も参照してください 。

rootNode : Node [read-only, since 6.9]

3Dグラフのルートノードへのポインタを返します。importScene を使用して、3Dグラフを別のView3D に組み込む際には、このプロパティを使用します：

Bars3D {
  id: bars
}
View3D {
  importScene: bars.rootNode
}

このプロパティはQt 6.9で導入されました。

View3Dも参照してください 。

rotationEnabled : bool

この入力ハンドラがグラフの回転を許可するかどうか。

デフォルトはtrue です。

scene : Scene3D [read-only]

シーンの操作やシーン要素へのアクセスに使用できるScene3D ポインタです。

このプロパティは読み取り専用です。

selectedElement : Graphs3D.ElementType [read-only]

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

このプロパティを使用すると、選択されている要素のタイプを照会できます。このタイプは、グラフ内で新たな選択が行われ、「selectedElementChanged 」シグナルが発信されるまで有効です。

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

selectedLabelIndex()、selectedAxis()、selectedCustomItemIndex()、selectedCustomItem()、Bars3D::selectedSeries 、Scatter3D::selectedSeries 、Scene3D::selectionQueryPosition 、およびGraphs3D.ElementTypeも参照してください 。

selectionEnabled : bool

この入力ハンドラがグラフからの選択を許可するかどうか。

デフォルトはtrue です。

selectionMode : Graphs3D.SelectionMode

グラフのアクティブな選択モード。Graphs3D.SelectionFlag 列挙型の値のいずれか。

shadowQuality : Graphs3D.ShadowQuality

影の品質。Graphs3D.ShadowQuality 列挙型の値の一つです。

shadowStrength : real

グラフ全体の影の強さです。数値が大きいほど、影は濃くなります。値は0.0 から100.0 の範囲で指定する必要があります。

この値は、Scene3D で指定された光に影響を与えます。

theme : GraphsTheme

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

GraphsThemeも参照してください 。

transparencyTechnique : Graphs3D.TransparencyTechnique [since 6.9]

使用する透過表現の手法を指定します。デフォルト値は `Default` です。透過サーフェスグラフをレンダリングする場合は、`Approximate ` または `Accurate` を使用してください。その他のグラフタイプには、`Default ` を使用してください。

このプロパティは Qt 6.9 で導入されました。

wrapCameraXRotation : bool

X回転における最小値と最大値の挙動。デフォルトでは、X回転は最小値から最大値へ、そして最大値から最小値へとループします。

true に設定すると、カメラのX回転は最小値から最大値へ、そして最大値から最小値へとループします。false に設定すると、カメラのX回転は最小値と最大値によって決定されるセクター内に制限されます。

wrapCameraYRotation : bool

Y回転における最小値と最大値の挙動。デフォルトでは、Y回転はループすることなく、最小値と最大値の間で制限されます。

true の場合、カメラのY回転は最小値から最大値へ、そして最大値から最小値へとループします。false の場合、カメラのY回転は最小値と最大値によって決定されるセクター内に制限されます。

zoomAtTargetEnabled : bool

ズーム操作を行った際、グラフのズーム対象点がズーム後も元の位置に留まるように、カメラのターゲットを変更するかどうか。

デフォルトはtrue です。

zoomEnabled : bool

この入力ハンドラがグラフのズームを許可するかどうか。

デフォルトはtrue です。

Signal ドキュメント

doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)

このシグナルは、グラフアイテムが短時間のうちに2回タップされたときに発火します。eventPoint シグナルパラメータには、タップされたポイントに関するリリースイベントからの情報が含まれており、button はクリックされたmouse button 、またはタッチスクリーン上ではNoButton を指します。

関連項目： QEventPoint 、Qt::MouseButtons 、およびTapHandler::doubleTapped 。

dragged(QVector2D delta)

この信号は、ピンチジェスチャーが行われている最中に、グラフ上の点群の並進位置が変更されたときに発信されます。delta ベクトルは、その並進位置の変化量を表します。

「PinchHandler::translationChanged」も参照してください 。

longPressed()

このシグナルは、parent アイテムがTapHandler::longPressThreshold よりも長い時間押し続けられたときに発せられます。

「TapHandler::longPressed」も参照してください 。

mouseMove(QPoint mousePos)

このシグナルは、グラフがmouseMoveイベントを受信したときに発火します。mousePos の値は、マウスが移動している間の位置を示します。

「QQuickItem::mouseMoveEvent」も参照してください 。

pinch(qreal delta)

このシグナルは、ピンチジェスチャーが実行されている最中にグラフのスケール係数が変更されたときに発せられます。delta の値は、スケールの乗算的な変化量を示します。

「PinchHandler::scaleChanged」も参照してください 。

tapped(QEventPoint eventPoint, Qt::MouseButton button)

このシグナルは、グラフアイテムが1回タップされたときに発火します。eventPoint シグナルパラメータには、タップされたポイントに関するリリースイベントからの情報が含まれており、button はクリックされたmouse button 、あるいはタッチスクリーン上ではNoButton を指します。

関連項目： QEventPoint 、Qt::MouseButtons 、およびTapHandler::singleTapped 。

wheel(QQuickWheelEvent *event)

このシグナルは、グラフが `QWheelEvent` 型の `event ` を受け取るたびに発火します。つまり、ホイールが操作されたり、スクロールジェスチャーが更新されたりするたびに発火します。

「 WheelEvent 」および「WheelHandler::wheel 」も参照してください 。

メソッドのドキュメント

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」も参照してください 。

void setDefaultInputHandler()

* * @brief デフォルトの入力処理メカニズムを復元します。 * * このメソッドは、内部で事前定義された入力ハンドラを再有効化します。 * これを使用して、以前に *unsetDefaultInputHandler を呼び出した後に、デフォルトの動作に戻すことができます。 *

unsetDefaultInputHandler()も参照してください 。

void setDragButton(Qt::MouseButtons button)

* * @brief ドラッグイベントをトリガーするために使用するマウスボタンを設定します。 * * このメソッドを使用すると、ドラッグ操作を開始するために必要なマウスボタンを * `button` に変更できます。 * デフォルトは `Qt::RightButton` です。

[since 6.12] void setPanButton(Qt::MouseButtons button)

* * * @brief パンイベントをトリガーするために使用するマウスボタンを設定します。 * * このメソッドを使用すると、ドラッグ操作を開始するために必要なマウスボタンを * `button` に変更できます。 * デフォルトは `Qt::MiddleButton` です。

このメソッドは Qt 6.12 で導入されました。

void unsetDefaultDragHandler()

* * @brief デフォルトのドラッグイベントハンドラを無効にします。 * * これは、ドラッグジェスチャーに対する組み込みの応答を明示的に解除します。 * ドラッグ用のカスタムハンドラを実装する必要がある場合にこれを使用してください。 *

関連項目： unsetDefaultInputHandler()。

void unsetDefaultInputHandler()

* * @brief デフォルトの入力処理メカニズムを無効にします。 * * このメソッドは、あらかじめ定義されているすべてのデフォルトの入力ハンドラを無効にします。 * デフォルトの動作を上書きしたい場合は、このメソッドを呼び出してください。 *

関連項目： unsetDefaultTapHandler()、unsetDefaultDragHandler()、unsetDefaultWheelHandler()、およびunsetDefaultPinchHandler()。

void unsetDefaultPinchHandler()

* * @brief デフォルトのピンチジェスチャーハンドラを無効にします。 * * これは、ピンチジェスチャーに対する組み込みの反応を明示的に解除します。 * カスタムピンチジェスチャーハンドラを実装する際に使用してください。 *

unsetDefaultInputHandler()も参照してください 。

void unsetDefaultTapHandler()

* * @brief デフォルトのタップイベントハンドラを無効にします。 * * これは、タップやクリックイベントに対する組み込みの応答を明示的に解除し、 * カスタムタップ処理ロジックを実装できるようにします。 *

unsetDefaultInputHandler()も参照してください 。

void unsetDefaultWheelHandler()

* * @brief デフォルトのマウスホイールイベントハンドラを無効にします。 * * これは、マウスホイールのスクロールに対する組み込みの反応を特に解除します。 * カスタムホイール動作を実装する際にこれを使用してください。 *

unsetDefaultInputHandler()も参照してください 。