QSurface3DSeries — PyQt Documentation v6.9.0 (original) (raw)
PyQt6.QtDataVisualization.QSurface3DSeries
Inherits from QAbstract3DSeries.
Description¶
The QSurface3DSeries class represents a data series in a 3D surface graph.
This class manages the series specific visual elements, as well as the series data (via a data proxy).
If no data proxy is set explicitly for the series, the series creates a default proxy. Setting another proxy will destroy the existing proxy and all data added to it.
The object mesh set via the mesh() property defines the selection pointer shape in a surface series.
QSurface3DSeries supports the following format tags for setItemLabelFormat():
| @xTitle | Title from x-axis |
|---|---|
| @yTitle | Title from y-axis |
| @zTitle | Title from z-axis |
| @xLabel | Item value formatted using the format of the x-axis. For more information, see setLabelFormat(). |
| @yLabel | Item value formatted using the format of the y-axis. For more information, see setLabelFormat(). |
| @zLabel | Item value formatted using the format of the z-axis. For more information, see setLabelFormat(). |
| @seriesName | Name of the series |
For example:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Enums¶
DrawFlag
The drawing mode of the surface. Values of this enumeration can be combined with the OR operator.
| Member | Value | Description |
|---|---|---|
| DrawSurface | 2 | Only the surface is drawn. |
| DrawSurfaceAndWireframe | DrawWireframe | DrawSurface | Both the surface and grid are drawn. |
| DrawWireframe | 1 | Only the grid is drawn. |
Methods¶
__init__(parent: QObject = None)
Constructs a surface 3D series with the parent parent.
__init__(QSurfaceDataProxy, parent: QObject = None)
Constructs a surface 3D series with the data proxy dataProxy and the parent parent.
dataProxy() → QSurfaceDataProxy
drawMode() → DrawFlag
@staticmethod
invalidSelectionPosition() → QPoint
Returns the QPoint signifying an invalid selection position. This is set to the selectedPoint() property to clear the selection from this series.
isFlatShadingEnabled() → bool
TODO
isFlatShadingSupported() → bool
TODO
selectedPoint() → QPoint
See also
setDataProxy(QSurfaceDataProxy)
setDrawMode(DrawFlag)
setFlatShadingEnabled(bool)
setSelectedPoint(QPoint)
Selects a surface grid point at the position position in the data array of the series specified by a row and a column.
Only one point can be selected at a time.
To clear selection from this series, invalidSelectionPosition() is set as position. If this series is added to a graph, the graph can adjust the selection according to user interaction or if it becomes invalid.
Removing rows from or inserting rows to the series before the row of the selected point will adjust the selection so that the same point will stay selected.
setTexture(QImage)
setTextureFile(Optional[str])
setWireframeColor(Union[QColor, GlobalColor, int])
See also
texture() → QImage
textureFile() → str
See also
wireframeColor() → QColor
See also
Signals¶
dataProxyChanged(QSurfaceDataProxy)
TODO
drawModeChanged(DrawFlag)
TODO
flatShadingEnabledChanged(bool)
TODO
flatShadingSupportedChanged(bool)
TODO
selectedPointChanged(QPoint)
TODO
textureChanged(QImage)
TODO
textureFileChanged(Optional[str])
TODO
wireframeColorChanged(Union[QColor, GlobalColor, int])
TODO