Q3DSurfaceWidgetItem Class

成员函数文档

[explicit] Q3DSurfaceWidgetItem::Q3DSurfaceWidgetItem(QObject *parent = nullptr)

使用可选参数parent 构建一个新的3D曲面图。

[override virtual noexcept] Q3DSurfaceWidgetItem::~Q3DSurfaceWidgetItem()

删除该3D曲面图。

void Q3DSurfaceWidgetItem::addAxis(QValue3DAxis *axis)

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

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

void Q3DSurfaceWidgetItem::addSeries(QSurface3DSeries *series)

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

另请参阅 Q3DGraphsWidgetItem::hasSeries()。

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

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

另请参阅 addAxis()。

void Q3DSurfaceWidgetItem::releaseAxis(QValue3DAxis *axis)

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

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

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

void Q3DSurfaceWidgetItem::removeSeries(QSurface3DSeries *series)

从图中移除series 。

另请参阅 Q3DGraphsWidgetItem::hasSeries()。

[since 6.10] void Q3DSurfaceWidgetItem::renderSliceToImage(int index, int requestedIndex, QtGraphs3D::SliceCaptureType sliceType)

将请求的切片视图导出为图像。切片结果是一系列index 。要导出所有系列，请将index 设置为-1。导出的切片是一行或一列，由sliceType 定义，位于给定的requestedIndex 处。

当图像准备就绪时，会发出sliceImageChanged 信号，可按以下方式捕获：

connect(item, &Q3DSurfaceWidgetItem::sliceImageChanged, this, [](const QImage &image) {
    // ~~~
});

item->renderSliceToImage(sliceType, index);

图像将根据当前的抗锯齿设置进行渲染。

该函数在 Qt 6.10 中引入。

另请参阅 QQuickItem::grabToImage() 和sliceImageChanged()。

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

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

另请参阅 Q3DGraphsWidgetItem::hasSeries()。

[signal, since 6.10] void Q3DSurfaceWidgetItem::sliceImageChanged(const QImage &image)

当renderSliceToImage 准备好image 时触发此信号。

该函数在 Qt 6.10 中引入。