Q3DSurface Class

Q3DSurface surface;
surface.setFlags(surface.flags() ^ Qt::FramelessWindowHint);

QSurfaceDataArray *data = new QSurfaceDataArray;
QSurfaceDataRow *dataRow1 = new QSurfaceDataRow;
QSurfaceDataRow *dataRow2 = new QSurfaceDataRow;

*dataRow1 << QVector3D(0.0f, 0.1f, 0.5f) << QVector3D(1.0f, 0.5f, 0.5f);
*dataRow2 << QVector3D(0.0f, 1.8f, 1.0f) << QVector3D(1.0f, 1.2f, 1.0f);
*data << dataRow1 << dataRow2;

QSurface3DSeries *series = new QSurface3DSeries;
series->dataProxy()->resetArray(data);
surface.addSeries(series);

surface.show();

#include <QtDataVisualization>

int main(int argc, char **argv)
{
    qputenv("QSG_RHI_BACKEND", "opengl");
    QGuiApplication app(argc, argv);

    Q3DSurface surface;
    surface.setFlags(surface.flags() ^ Qt::FramelessWindowHint);
    QSurfaceDataArray *data = new QSurfaceDataArray;
    QSurfaceDataRow *dataRow1 = new QSurfaceDataRow;
    QSurfaceDataRow *dataRow2 = new QSurfaceDataRow;

    *dataRow1 << QVector3D(0.0f, 0.1f, 0.5f) << QVector3D(1.0f, 0.5f, 0.5f);
    *dataRow2 << QVector3D(0.0f, 1.8f, 1.0f) << QVector3D(1.0f, 1.2f, 1.0f);
    *data << dataRow1 << dataRow2;

    QSurface3DSeries *series = new QSurface3DSeries;
    series->dataProxy()->resetArray(data);
    surface.addSeries(series);
    surface.show();

    return app.exec();
}

成员函数文档

[explicit] Q3DSurface::Q3DSurface(const QSurfaceFormat *format = nullptr, QWindow *parent = nullptr)

构建一个新的3D曲面图，可选地包含parent 窗口和曲面format 。

[virtual noexcept] Q3DSurface::~Q3DSurface()

删除该3D曲面图形。

void Q3DSurface::addAxis(QValue3DAxis *axis)

将axis 添加到图中。通过addAxis添加的坐标轴尚未投入使用，addAxis仅用于将axis 的所有权赋予该图。axis 不能为null，也不能已被添加到其他图中。

另请参阅 releaseAxis()、setAxisX()、setAxisY() 和setAxisZ()。

void Q3DSurface::addSeries(QSurface3DSeries *series)

将series 添加到图表中。一个图表可以包含多个系列，但只有一组坐标轴。如果新添加的系列指定了选定项，该选定项将被高亮显示，且任何现有的选定状态都将被清除。仅有一个新添加的系列可以处于选定状态。

另请参阅 QAbstract3DGraph::hasSeries()。

QList<QValue3DAxis *> Q3DSurface::axes() const

返回所有已添加坐标轴的列表。

另请参阅 addAxis()。

void Q3DSurface::releaseAxis(QValue3DAxis *axis)

如果该axis 已被添加到此图中，则将其所有权交还给调用方。如果被释放的axis 正在被使用，系统将创建一个新的默认轴并将其设为活动状态。

如果默认轴已被释放，随后又被重新添加，其行为将与其他轴无异。

另请参阅 addAxis()、setAxisX()、setAxisY()，以及setAxisZ()。

void Q3DSurface::removeSeries(QSurface3DSeries *series)

从图中移除series 。

另请参阅 QAbstract3DGraph::hasSeries()。

QList<QSurface3DSeries *> Q3DSurface::seriesList() const

返回已添加到该图表的系列列表。

另请参阅 QAbstract3DGraph::hasSeries()。

void Q3DSurface::setAxisX(QValue3DAxis *axis)

将axis 设置为活动x轴。会隐式调用addAxis()，将该轴的所有权转移至此图表。

如果axis 为 null，则会创建一个临时默认坐标轴，该坐标轴无标签且范围会自动调整。

如果显式将另一个坐标轴设置为相同的方位，则该临时坐标轴将被销毁。

另请参阅 axisX()、addAxis() 和releaseAxis()。

void Q3DSurface::setAxisY(QValue3DAxis *axis)

将axis 设置为活动y轴。隐式调用addAxis()，将该轴的所有权转移给此图表。

如果axis 为 null，则会创建一个临时默认坐标轴，该坐标轴无标签且范围会自动调整。

如果显式地将另一个坐标轴设置为相同的取向，则该临时坐标轴将被销毁。

另请参阅 axisY()、addAxis() 和releaseAxis()。

void Q3DSurface::setAxisZ(QValue3DAxis *axis)

将axis 设置为活动Z轴。会隐式调用addAxis()，将该轴的所有权转移至此图表。

如果axis 为 null，则会创建一个临时默认坐标轴，该坐标轴无标签且范围会自动调整。

如果显式将另一个坐标轴设置为相同的方向，则该临时坐标轴将被销毁。

另请参阅 axisZ()、addAxis() 和releaseAxis()。