Q3DScatter Class

Q3DScatter 类提供了渲染 3D 散点图的方法。更多

Header: #include <Q3DScatter>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
QtDataVisualization 1.0
继承: QAbstract3DGraph

属性

公共功能

Q3DScatter(const QSurfaceFormat *format = nullptr, QWindow *parent = nullptr)
virtual ~Q3DScatter()
void addAxis(QValue3DAxis *axis)
void addSeries(QScatter3DSeries *series)
QList<QValue3DAxis *> axes() const
QValue3DAxis *axisX() const
QValue3DAxis *axisY() const
QValue3DAxis *axisZ() const
void releaseAxis(QValue3DAxis *axis)
void removeSeries(QScatter3DSeries *series)
QScatter3DSeries *selectedSeries() const
QList<QScatter3DSeries *> seriesList() const
void setAxisX(QValue3DAxis *axis)
void setAxisY(QValue3DAxis *axis)
void setAxisZ(QValue3DAxis *axis)

信号

void axisXChanged(QValue3DAxis *axis)
void axisYChanged(QValue3DAxis *axis)
void axisZChanged(QValue3DAxis *axis)
void selectedSeriesChanged(QScatter3DSeries *series)

详细说明

通过该类,开发人员可以渲染 3D 散点图,并通过自由旋转场景查看散点图。旋转可通过按住鼠标右键并移动鼠标来完成。缩放通过鼠标滚轮完成。选择(如果启用)通过鼠标左键完成。单击鼠标滚轮可将场景重置为默认摄像机视图。在触摸设备中,旋转通过点击移动来完成,选择通过点击和按住来完成,缩放通过捏来完成。

如果没有为 Q3DScatter 明确设置坐标轴,则会创建没有标签的临时默认坐标轴。这些默认坐标轴可以通过坐标轴访问器进行修改,但只要为方向明确设置了坐标轴,该方向的默认坐标轴就会被销毁。

Q3DScatter 支持多个系列同时可见。

如何构建最小 Q3DScatter 图形

首先,构建 Q3DScatter。在本例中,我们将图形作为顶级窗口运行,因此需要清除默认设置的Qt::FramelessWindowHint 标志:

Q3DScatter scatter;
scatter.setFlags(scatter.flags() ^ Qt::FramelessWindowHint);

现在 Q3DScatter 已准备好接收要渲染的数据。添加一个包含 3 个QVector3D 项目的系列:

QScatter3DSeries *series = new QScatter3DSeries;
QScatterDataArray data;
data << QVector3D(0.5f, 0.5f, 0.5f) << QVector3D(-0.3f, -0.5f, -0.4f) << QVector3D(0.0f, -0.3f, 0.2f);
series->dataProxy()->addItems(data);
scatter.addSeries(series);

最后,您需要将其设置为可见:

scatter.show();

创建和显示此图表所需的完整代码如下:

#include <QtDataVisualization>

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

    Q3DScatter scatter;
    scatter.setFlags(scatter.flags() ^ Qt::FramelessWindowHint);
    QScatter3DSeries *series = new QScatter3DSeries;
    QScatterDataArray data;
    data << QVector3D(0.5f, 0.5f, 0.5f) << QVector3D(-0.3f, -0.5f, -0.4f) << QVector3D(0.0f, -0.3f, 0.2f);
    series->dataProxy()->addItems(data);
    scatter.addSeries(series);
    scatter.show();

    return app.exec();
}

这就是这几行代码产生的结果:

场景可以旋转、缩放,还可以选择一个项目查看其位置,但在这个最小代码示例中不包括其他交互。您可以通过熟悉所提供的示例(如散点图)了解更多信息。

另请参见 Q3DBars,Q3DSurface, 以及 Qt Data Visualization C++ Classes.

属性文档

axisX : QValue3DAxis*

该属性用于保存活动 X 轴。

访问功能:

QValue3DAxis *axisX() const
void setAxisX(QValue3DAxis *axis)

通知信号:

void axisXChanged(QValue3DAxis *axis)

axisY : QValue3DAxis*

该属性用于保存活动 Y 轴。

访问功能:

QValue3DAxis *axisY() const
void setAxisY(QValue3DAxis *axis)

通知信号:

void axisYChanged(QValue3DAxis *axis)

axisZ : QValue3DAxis*

该属性用于保存活动 Z 轴。

访问功能:

QValue3DAxis *axisZ() const
void setAxisZ(QValue3DAxis *axis)

通知信号:

void axisZChanged(QValue3DAxis *axis)

[read-only] selectedSeries : QScatter3DSeries* const

该属性包含所选系列或空。

访问功能:

QScatter3DSeries *selectedSeries() const

Notifier 信号:

void selectedSeriesChanged(QScatter3DSeries *series)

成员函数 文档

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

构建新的三维散点图,可选parent 窗口和表面format

[virtual noexcept] Q3DScatter::~Q3DScatter()

销毁 3D 散点图。

void Q3DScatter::addAxis(QValue3DAxis *axis)

axis 添加到图表中。通过 addAxis 添加的坐标轴尚未投入使用,addAxis 只是用来将axis 的所有权赋予图形。axis 不得为空或添加到其他图形中。

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

void Q3DScatter::addSeries(QScatter3DSeries *series)

series 添加到图表中。图形可以包含多个序列,但只有一组坐标轴。如果新添加的序列已指定了一个选中项,则该选中项将突出显示,并且任何现有选中项都将被清除。只有一个添加的序列可以有一个活动选区。

另请参见 QAbstract3DGraph::hasSeries()。

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

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

另请参见 addAxis()。

QValue3DAxis *Q3DScatter::axisZ() const

返回使用的 Z 轴。

注: 属性 axisZ 的获取函数。

另请参见 setAxisZ().

void Q3DScatter::releaseAxis(QValue3DAxis *axis)

如果axis 已添加到此图形中,则将其所有权释放给调用者。如果被释放的axis 正在使用中,将创建一个新的默认坐标轴并将其设置为活动状态。

如果默认轴被释放并在稍后添加回来,它的行为与其他轴一样。

另请参见 addAxis()、setAxisX()、setAxisY() 和setAxisZ()。

void Q3DScatter::removeSeries(QScatter3DSeries *series)

从图表中删除series

另请参见 QAbstract3DGraph::hasSeries().

QList<QScatter3DSeries *> Q3DScatter::seriesList() const

返回添加到此图表的系列列表。

另请参阅 QAbstract3DGraph::hasSeries()。

void Q3DScatter::setAxisX(QValue3DAxis *axis)

axis 设置为活动 x 轴。隐式调用addAxis() 将坐标轴的所有权转移到此图形。

如果axis 为空,则会创建一个没有标签和自动调整范围的临时默认坐标轴。如果将另一个轴明确设置为相同方向,则会销毁该临时轴。

注: 属性axisX 的设置函数。

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

void Q3DScatter::setAxisY(QValue3DAxis *axis)

axis 设置为活动 Y 轴。隐式调用addAxis() 将坐标轴的所有权转移到此图形。

如果axis 为空,则会创建一个没有标签和自动调整范围的临时默认坐标轴。如果将另一个轴明确设置为相同方向,则会销毁该临时轴。

注: 属性axisY 的设置函数。

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

void Q3DScatter::setAxisZ(QValue3DAxis *axis)

axis 设置为活动 Z 轴。隐式调用addAxis() 将坐标轴的所有权转移到此图形。

如果axis 为空,则会创建一个没有标签和自动调整范围的临时默认坐标轴。如果将另一个轴明确设置为相同方向,则会销毁该临时轴。

注: 属性axisZ 的设置函数。

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

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