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]
在某些使用场景中,横轴网格大部分被曲面覆盖,因此将横轴网格显示在图表上方而非下方会更实用。一个典型的应用场景是使用正交投影并采用自上而下的视点来显示二维频谱图。
若设置为false ,则横轴网格和标签将绘制在图表的水平背景上。若设置为true ,则横轴网格和标签将绘制在与水平背景相对的一侧。默认值为false 。
该属性在 QtDataVisualization 1.2 中引入。
selectedSeries : Surface3DSeries
所选系列或空值。如果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.