Back to Qt.io
Contact Us Blog Download Qt

Surface3D QML Type

3Dサーフェスグラフの使い方を説明します。詳細...

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
Inherits:

AbstractGraph3D

プロパティ

方法

詳細説明

この型を使用すると、Qt Quick を使用してサーフェスプロットを 3D でレンダリングできるようになります。

この型を使用するには、データ可視化モジュールをインポートする必要があります：

import QtDataVisualization 1.2

その後、qmlファイルでSurface3Dを使用することができます：

import QtQuick 2.0
import QtDataVisualization 1.2

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"
            }
        }
    }
    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 Data Visualization C++ Classes.

プロパティの説明

axisX : ValueAxis3D

アクティブなX軸。

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


axisY : ValueAxis3D

アクティブなY軸。

軸が与えられない場合、ラベルと自動調整範囲を持たない一時的なデフォルト軸が作成されます。この一時的な軸は、他の軸が同じ方向に明示的に設定されると破棄されます。


axisZ : ValueAxis3D

アクティブなZ軸。

軸が与え ら れない と 、 ラ ベルな し と 自動調整範囲を持つ一時的なデフ ォル ト 軸が作成 さ れます。この一時的な軸は、別の軸が明示的に同じ方向に設定されると破棄されます。


flipHorizontalGrid : bool [since QtDataVisualization 1.2]

いくつかの使用例では、水平軸グリッドはほとんどサーフェスで覆われているので、水平軸グリッドをグラフの下部ではなく上部に表示した方が便利な場合がある。典型的な使用例としては、トップダウン視点のオルソグラフィック投影を使用して2Dスペクトログラムを表示する場合である。

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

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


selectedSeries : Surface3DSeries

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


seriesList : list<Surface3DSeries> [default]

このプロパティは、グラフの系列を保持します。デフォルトでは、このプロパティには空のリストが含まれます。系列を設定するには、addSeries() 関数を使用するか、グラフの子として定義します。


メソッド・ドキュメント

void addSeries(Surface3DSeries series)

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

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


void removeSeries(Surface3DSeries series)

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

AbstractGraph3D::hasSeries()も参照 。


© 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.