Surface3D QML Type

3Dサーフェスグラフの使用方法について説明します。詳細...

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

プロパティ

• ambientLightStrength : real
• aspectRatio : real
• axisX : Value3DAxis
• axisY : Value3DAxis
• axisZ : Value3DAxis
• 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)
• flipHorizontalGrid : bool
• 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
• selectedSeries : Surface3DSeries
• selectionEnabled : bool
• selectionMode : Graphs3D.SelectionMode
• seriesList : list<Surface3DSeries>
• shadowQuality : Graphs3D.ShadowQuality
• shadowStrength : real
• theme : GraphsTheme
• transparencyTechnique : Graphs3D.TransparencyTechnique (since 6.9)
• wrapCameraXRotation : bool
• wrapCameraYRotation : bool
• zoomAtTargetEnabled : bool
• zoomEnabled : bool

シグナル

• axisXChanged(ValueAxis3D axis)
• axisYChanged(ValueAxis3D axis)
• axisZChanged(ValueAxis3D axis)
• doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)
• dragged(QVector2D delta)
• flipHorizontalGridChanged(bool flip)
• longPressed()
• mouseMove(QPoint mousePos)
• pinch(qreal delta)
• selectedSeriesChanged(Surface3DSeries series)
• tapped(QEventPoint eventPoint, Qt::MouseButton button)
• wheel(QQuickWheelEvent *event)

方法

• qsizetype addCustomItem(Custom3DItem item)
• void addSeries(Surface3DSeries series)
• 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()
• void removeSeries(Surface3DSeries series)
• void removeSeries(Surface3DSeries series)
• void renderSliceToImage(int index, int requestedIndex, QtGraphs3D::SliceCaptureType sliceType, QUrl filePath) (since 6.10)
• 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()

詳細な説明

この型を使用すると、開発者はQt Quick を使用して3Dの表面プロットを描画できます。

このタイプを使用するには、Qt Graphs モジュールをインポートする必要があります：

import QtGraphs

その後、qmlファイル内でSurface3Dを使用できるようになります：

import QtQuick
import QtGraphs

Item {
    width: 640
    height: 480

    Surface3D {
        width: parent.width
        height: parent.height
        Surface3DSeries {
            itemLabelFormat: "Pop density at (@xLabel N, @zLabel E): @yLabel"
            ItemModelSurfaceDataProxy {
                itemModel: dataModel
                // Mapping model roles to surface series rows, columns, and values.
                rowRole: "longitude"
                columnRole: "latitude"
                yPosRole: "pop_density"
            }
        }

        onTapped: {
            // Disable the default input handler
            unsetDefaultTapHandler()
            // Implement own custom event handler
            console.log("Custom tap event handler")
        }
    }
    ListModel {
        id: dataModel
        ListElement{ longitude: "20"; latitude: "10"; pop_density: "4.75"; }
        ListElement{ longitude: "21"; latitude: "10"; pop_density: "3.00"; }
        ListElement{ longitude: "22"; latitude: "10"; pop_density: "1.24"; }
        ListElement{ longitude: "23"; latitude: "10"; pop_density: "2.53"; }
        ListElement{ longitude: "20"; latitude: "11"; pop_density: "2.55"; }
        ListElement{ longitude: "21"; latitude: "11"; pop_density: "2.03"; }
        ListElement{ longitude: "22"; latitude: "11"; pop_density: "3.46"; }
        ListElement{ longitude: "23"; latitude: "11"; pop_density: "5.12"; }
        ListElement{ longitude: "20"; latitude: "12"; pop_density: "1.37"; }
        ListElement{ longitude: "21"; latitude: "12"; pop_density: "2.98"; }
        ListElement{ longitude: "22"; latitude: "12"; pop_density: "3.33"; }
        ListElement{ longitude: "23"; latitude: "12"; pop_density: "3.23"; }
        ListElement{ longitude: "20"; latitude: "13"; pop_density: "4.34"; }
        ListElement{ longitude: "21"; latitude: "13"; pop_density: "3.54"; }
        ListElement{ longitude: "22"; latitude: "13"; pop_density: "1.65"; }
        ListElement{ longitude: "23"; latitude: "13"; pop_density: "2.67"; }
    }
}

より詳細な使用例については、「Surface Graph Gallery」を参照してください。

Surface3DSeries 、ItemModelSurfaceDataProxy 、Bars3D 、Scatter3D 、およびQt Graphs の 3D 用 C++ クラスも参照してください 。

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

ambientLightStrength : real

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

aspectRatio : real

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

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

axisX : Value3DAxis

アクティブなX軸。

軸が指定されていない場合、ラベルがなく、範囲が自動的に調整される一時的なデフォルトの軸が作成されます。この一時的な軸は、別の軸が明示的に同じ向きに設定された場合、破棄されます。

axisY : Value3DAxis

アクティブなY軸。

軸が指定されていない場合、ラベルがなく、範囲が自動的に調整される一時的なデフォルトの軸が作成されます。この一時的な軸は、別の軸が明示的に同じ向きに設定されると破棄されます。

axisZ : Value3DAxis

アクティブなZ軸。

軸が指定されていない場合、ラベルがなく、範囲が自動的に調整される一時的なデフォルト軸が作成されます。この一時的な軸は、別の軸が明示的に同じ向きに設定された場合、破棄されます。

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

flipHorizontalGrid : bool

用途によっては、横軸のグリッドの大部分が表面で覆われてしまうため、横軸のグリッドをグラフの下部ではなく上部に表示した方が便利な場合があります。この典型的な用途として、正投影法を用いて鳥瞰視点から2Dスペクトログラムを表示する場合が挙げられます。

false の場合、横軸のグリッドとラベルはグラフの水平な背景上に描画されます。true の場合、横軸のグリッドとラベルは、グラフの水平な背景とは反対側に描画されます。デフォルトはfalse です。

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

selectedSeries : Surface3DSeries [read-only]

選択された系列、またはNULL。selectionMode にMultiSeries フラグが設定されている場合、このプロパティには、選択された点を所有する系列が格納されます。

selectionEnabled : bool

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

デフォルトはtrue です。

selectionMode : Graphs3D.SelectionMode

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

seriesList : list<Surface3DSeries> [default]

このプロパティには、グラフのシリーズが格納されます。デフォルトでは、このプロパティには空のリストが含まれています。シリーズを設定するには、addSeries() 関数を使用するか、グラフの子要素として定義してください。

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 ドキュメント

axisXChanged(ValueAxis3D axis)

このシグナルは、axisX がaxis に変更されたときに発生します。

axisYChanged(ValueAxis3D axis)

このシグナルは、axisY がaxis に変更されたときに発生します。

axisZChanged(ValueAxis3D axis)

このシグナルは、axisZ がaxis に変更されたときに発生します。

doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)

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

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

dragged(QVector2D delta)

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

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

flipHorizontalGridChanged(bool flip)

このシグナルは、flipHorizontalGrid がflip に変わったときに発せられます。

longPressed()

この信号は、「parent 」アイテムがTapHandler::longPressThreshold よりも長い時間押し続けられたときに発信されます。

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

mouseMove(QPoint mousePos)

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

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

pinch(qreal delta)

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

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

selectedSeriesChanged(Surface3DSeries series)

このシグナルは、selectedSeries がseries に変化したときに発生します。

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 addSeries(Surface3DSeries series)

series をグラフに追加します。

GraphsItem3D::hasSeries()も参照してください 。

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()

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

void removeSeries(Surface3DSeries series)

グラフからseries を削除します。

GraphsItem3D::hasSeries()も参照してください 。

void removeSeries(Surface3DSeries series)

グラフからseries を削除します。

GraphsItem3D::hasSeries()も参照してください 。

[since 6.10] void renderSliceToImage(int index, int requestedIndex, QtGraphs3D::SliceCaptureType sliceType, QUrl filePath)

index にあるシリーズから 2D スライスをエクスポートし、結果を指定されたfilePath に画像として保存します。すべてのシリーズをエクスポートするには、index を -1 に設定してください。エクスポートされるスライスには、sliceType で定義された行または列が含まれ、これらは指定されたrequestedIndex に保存されます。

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

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