Surface3D QML Type
3Dサーフェスグラフの使用方法について説明します。詳細...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| Inherits: | |
| Status: | Deprecated |
この型は非推奨です。新しいコードでの使用は強くお勧めしません。
プロパティ
- axisX : ValueAxis3D
- axisY : ValueAxis3D
- axisZ : ValueAxis3D
- flipHorizontalGrid : bool
(since QtDataVisualization 1.2) - selectedSeries : Surface3DSeries
- seriesList : list<Surface3DSeries>
方法
- void addSeries(Surface3DSeries series)
- void removeSeries(Surface3DSeries series)
詳細な説明
この型を使用すると、開発者は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.