QSurface3DSeries 类
QSurface3DSeries 类表示 3D 表面图中的数据序列。 更多...
| 头文件 | #include <QSurface3DSeries> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake | QT += graphs |
| 实例化 | Surface3DSeries |
| 继承 | QAbstract3DSeries |
| 状态 | 技术预览 |
- 包含所有成员的列表，包括继承的成员
- QSurface3DSeries 是 Qt Graphs C++ 3D 类 的一部分。
公共类型
属性
|
|
公共函数
| QSurface3DSeries(QObject *parent = nullptr) | |
| QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QSurface3DSeries() override |
| QSurfaceDataProxy * | dataProxy() const |
| QSurface3DSeries::DrawFlags | drawMode() const |
| bool | isFlatShadingEnabled() const |
| bool | isFlatShadingSupported() const |
| QPoint | selectedPoint() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
| void | setFlatShadingEnabled(bool enabled) |
| void | setSelectedPoint(const QPoint &position) |
| void | setTexture(const QImage &texture) |
| void | setTextureFile(const QString &filename) |
| void | setWireframeColor(const QColor &color) |
| QImage | texture() const |
| QString | textureFile() const |
| QColor | wireframeColor() const |
信号
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
| void | flatShadingEnabledChanged(bool enable) |
| void | flatShadingSupportedChanged(bool enable) |
| void | selectedPointChanged(const QPoint &position) |
| void | textureChanged(const QImage &image) |
| void | textureFileChanged(const QString &filename) |
| void | wireframeColorChanged(const QColor &color) |
静态公共成员
| QPoint | invalidSelectionPosition() |
详细描述
此类管理系列特定的可视化元素以及系列数据（通过数据代理）。
如果没有为系列明确设置数据代理，则系列将创建一个默认代理。设置另一个代理将销毁现有的代理以及添加到其中的所有数据。
通过QAbstract3DSeries::mesh属性设置的物体网格定义了物体系列中的选择指针形状。
QSurface3DSeries支持下面这些格式标签用于QAbstract3DSeries::setItemLabelFormat（）：
| @xTitle | 来自x轴的标题 |
| @yTitle | 来自y轴的标题 |
| @zTitle | 来自z轴的标题 |
| @xLabel | 使用x轴格式格式化的项目值。有关更多信息，请参阅QValue3DAxis::setLabelFormat。 |
| @yLabel | 使用y轴格式格式化的项目值。有关更多信息，请参阅QValue3DAxis::setLabelFormat。 |
| @zLabel | 使用z轴格式格式化的项目值。有关更多信息，请参阅QValue3DAxis::setLabelFormat。 |
| @seriesName | 系列的名称 |
例如
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
另请参阅Qt 图表使用 3D 进行数据处理。
成员类型文档
enum QSurface3DSeries::DrawFlag
flags QSurface3DSeries::DrawFlags
表面的绘制模式。枚举的值可以通过OR运算符组合。
| 常量 | 值 | 描述 |
|---|---|---|
QSurface3DSeries::DrawWireframe | 1 | 只绘制网格。 |
QSurface3DSeries::DrawSurface | 2 | 只绘制表面。 |
QSurface3DSeries::DrawSurfaceAndWireframe | DrawWireframe | DrawSurface | 同时绘制表面和网格。 |
DrawFlags类型是QFlags<DrawFlag>的重定义。它存储了DrawFlag值的OR组合。
属性文档
dataProxy : QSurfaceDataProxy*
此属性持有活动数据代理。
系列假定拥有设置给它的任何代理，并在添加新的代理时删除先前设置的代理。代理不能为空或设置给另一个系列。
访问函数
| QSurfaceDataProxy * | dataProxy() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
通知信号
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
drawMode : QSurface3DSeries::DrawFlags
绘制模式。
可能值是 DrawFlag 的值。不允许清除所有标志。
访问函数
| QSurface3DSeries::DrawFlags | drawMode() const |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
通知信号
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
flatShadingEnabled : bool
此属性表示是否启用了表面平面着色。
默认设置为 true。
当禁用时，表面的法线将进行插值，使边缘看起来圆润。当启用时，三角形上的法线保持不变，使三角形的颜色更加均匀。这使数据在模型上更容易阅读。
注意： 平面着色表面需要至少 GLSL 版本 1.2 以及 GL_EXT_gpu_shader4 扩展。 flatShadingSupported 属性的值表示在运行时是否支持平面着色。
访问函数
| bool | isFlatShadingEnabled() const |
| void | setFlatShadingEnabled(bool enabled) |
通知信号
| void | flatShadingEnabledChanged(bool enable) |
[只读] flatShadingSupported : const bool
此属性表示当前系统是否支持表面平面着色。
表面平面着色需要至少 GLSL 版本 1.2 以及 GL_EXT_gpu_shader4 扩展。如果 true，则表示支持表面的平面着色。
注意： 此只读属性在第一次渲染通过后设置为正确值。在此之前，它始终是 true。
访问函数
| bool | isFlatShadingSupported() const |
通知信号
| void | flatShadingSupportedChanged(bool enable) |
selectedPoint : QPoint
此属性表示系列中选定的表面网格点。
访问函数
| QPoint | selectedPoint() const |
| void | setSelectedPoint(const QPoint &position) |
通知信号
| void | selectedPointChanged(const QPoint &position) |
texture : QImage
此属性表示表面纹理作为 QImage。
设置空 QImage 会清除纹理。
访问函数
| QImage | texture() const |
| void | setTexture(const QImage &texture) |
通知信号
| void | textureChanged(const QImage &image) |
textureFile : QString
此属性表示表面纹理作为一个文件。
设置空文件名会清除纹理。
访问函数
| QString | textureFile() const |
| void | setTextureFile(const QString &filename) |
通知信号
| void | textureFileChanged(const QString &filename) |
wireframeColor : QColor
此属性表示表面线框的颜色。
访问函数
| QColor | wireframeColor() const |
| void | setWireframeColor(const QColor &color) |
通知信号
| void | wireframeColorChanged(const QColor &color) |
成员函数文档
[显式] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
使用父对象parent构建表面3D系列。
[显式] QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
使用数据代理dataProxy和父对象parent构建表面3D系列。
[覆盖虚函数 noexcept] QSurface3DSeries::~QSurface3DSeries()
删除表面3D系列。
[静态] QPoint QSurface3DSeries::invalidSelectionPosition()
返回表示无效选择位置的QPoint。此位置设置为selectedPoint属性，以从该系列清除选择。
另请参阅QAbstract3DGraph::clearSelection。
void QSurface3DSeries::setSelectedPoint(const QPoint &position)
选择系列数据数组中指定行为和列的位置position的表面网格点。
每次只能选择一个点。
要从该系列中清除选择，请将invalidSelectionPosition()设置为position。如果将此系列添加到图表中，则图表可以根据用户交互或选择无效时进行调整。
在选择点所在的行之前从系列中删除行或插入行将调整选择，以保持相同的点被选中。
注意：属性selectedPoint的设置函数。
© 2024 Qt公司有限公司。此处包含的文档贡献是各自所有者的版权。此处提供的文档是根据自由软件基金会发布的GNU自由文档许可版1.3许可的。Qt和相应的标志是Qt公司在芬兰和/或世界各国/地区的商标。所有其他商标均为各自所有者的财产。
