このページでは

Surface3D QML Type

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

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

AbstractGraph3D

Status: Deprecated

この型は非推奨です。新しいコードでの使用は強くお勧めしません。

プロパティ

方法

詳細な説明

この型を使用すると、開発者は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()も参照してください 。

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