QSurface3DSeries#

The QSurface3DSeries class represents a data series in a 3D surface graph. More…

Synopsis#

Properties#

dataProxy - Active data proxy
drawMode
flatShadingEnabled - Whether surface flat shading is enabled
flatShadingSupported - Whether surface flat shading is supported by the current system
selectedPoint - Surface grid point that is selected in the series
texture - For the surface as a QImage
textureFile - Texture for the surface as a file
wireframeColor - Color for the surface wireframe

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

Warning

This section contains snippets that were automatically translated from C++ to Python and may contain errors.

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("@valueTitle for (@rowLabel, @colLabel): %.1f")
See also

Qt Data Visualization Data Handling

class PySide6.QtDataVisualization.QSurface3DSeries([parent=None])#

PySide6.QtDataVisualization.QSurface3DSeries(dataProxy[, parent=None])

Parameters:

dataProxy – PySide6.QtDataVisualization.QSurfaceDataProxy
parent – PySide6.QtCore.QObject

Constructs a surface 3D series with the parent parent.

Constructs a surface 3D series with the data proxy dataProxy and the parent parent.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.QtDataVisualization.QSurface3DSeries.dataProxy: PySide6.QtDataVisualization.QSurfaceDataProxy#

This property holds The active data proxy..

The series assumes ownership of any proxy set to it and deletes any previously set proxy when a new one is added. The proxy cannot be null or set to another series.

Access functions:

dataProxy ()
setDataProxy (proxy)
Signal dataProxyChanged (proxy)

property PᅟySide6.QtDataVisualization.QSurface3DSeries.drawMode: DrawFlags#

The drawing mode.

Possible values are the values of DrawFlag . Clearing all flags is not allowed.

Access functions:

drawMode ()
setDrawMode (mode)
Signal drawModeChanged (mode)

property PᅟySide6.QtDataVisualization.QSurface3DSeries.flatShadingEnabled: bool#

This property holds Whether surface flat shading is enabled..

Preset to true by default.

When disabled, the normals on the surface are interpolated making the edges look round. When enabled, the normals are kept the same on a triangle making the color of the triangle solid. This makes the data more readable from the model.

Note

Flat shaded surfaces require at least GLSL version 1.2 with GL_EXT_gpu_shader4 extension. The value of the flatShadingSupported property indicates whether flat shading is supported at runtime.

Access functions:

isFlatShadingEnabled ()
setFlatShadingEnabled (enabled)
Signal flatShadingEnabledChanged (enable)

property PᅟySide6.QtDataVisualization.QSurface3DSeries.flatShadingSupported: bool#

This property holds Whether surface flat shading is supported by the current system..

Flat shading for surfaces requires at least GLSL version 1.2 with GL_EXT_gpu_shader4 extension. If true, flat shading for surfaces is supported.

Note

This read-only property is set to its correct value after the first render pass. Until then it is always true.

Access functions:

isFlatShadingSupported ()
Signal flatShadingSupportedChanged (enable)

property PᅟySide6.QtDataVisualization.QSurface3DSeries.selectedPoint: PySide6.QtCore.QPoint#

This property holds The surface grid point that is selected in the series..

Access functions:

selectedPoint ()
setSelectedPoint (position)
Signal selectedPointChanged (position)

property PᅟySide6.QtDataVisualization.QSurface3DSeries.texture: PySide6.QtGui.QImage#

This property holds The texture for the surface as a QImage ..

Setting an empty QImage clears the texture.

Access functions:

texture ()
setTexture (texture)
Signal textureChanged (image)

property PᅟySide6.QtDataVisualization.QSurface3DSeries.textureFile: str#

This property holds The texture for the surface as a file..

Setting an empty file name clears the texture.

Access functions:

textureFile ()
setTextureFile (filename)
Signal textureFileChanged (filename)

property PᅟySide6.QtDataVisualization.QSurface3DSeries.wireframeColor: PySide6.QtGui.QColor#

This property holds The color for the surface wireframe..

Access functions:

wireframeColor ()
setWireframeColor (color)
Signal wireframeColorChanged (color)

PySide6.QtDataVisualization.QSurface3DSeries.DrawFlag#

(inherits enum.Flag) The drawing mode of the surface. Values of this enumeration can be combined with the OR operator.

Constant

Description

QSurface3DSeries.DrawWireframe

Only the grid is drawn.

QSurface3DSeries.DrawSurface

Only the surface is drawn.

QSurface3DSeries.DrawSurfaceAndWireframe

Both the surface and grid are drawn.

Constant	Description
QSurface3DSeries.DrawWireframe	Only the grid is drawn.
QSurface3DSeries.DrawSurface	Only the surface is drawn.
QSurface3DSeries.DrawSurfaceAndWireframe	Both the surface and grid are drawn.

PySide6.QtDataVisualization.QSurface3DSeries.dataProxy()#

Return type:: PySide6.QtDataVisualization.QSurfaceDataProxy

See also

setDataProxy()

Getter of property dataProxy .

PySide6.QtDataVisualization.QSurface3DSeries.dataProxyChanged(proxy)#

Parameters:: proxy – PySide6.QtDataVisualization.QSurfaceDataProxy

Notification signal of property dataProxy .

PySide6.QtDataVisualization.QSurface3DSeries.drawMode()#

Return type:: DrawFlags

See also

setDrawMode()

Getter of property drawMode .

PySide6.QtDataVisualization.QSurface3DSeries.drawModeChanged(mode)#

Parameters:: mode – DrawFlags

Notification signal of property drawMode .

PySide6.QtDataVisualization.QSurface3DSeries.flatShadingEnabledChanged(enable)#

Parameters:: enable – bool

Notification signal of property flatShadingEnabled .

PySide6.QtDataVisualization.QSurface3DSeries.flatShadingSupportedChanged(enable)#

Parameters:: enable – bool

Notification signal of property flatShadingSupported .

static PySide6.QtDataVisualization.QSurface3DSeries.invalidSelectionPosition()#

Return type:: PySide6.QtCore.QPoint

Returns the QPoint signifying an invalid selection position. This is set to the selectedPoint property to clear the selection from this series.

See also

clearSelection()

PySide6.QtDataVisualization.QSurface3DSeries.isFlatShadingEnabled()#

Return type:: bool

Getter of property flatShadingEnabled .

PySide6.QtDataVisualization.QSurface3DSeries.isFlatShadingSupported()#

Return type:: bool

Getter of property flatShadingSupported .

PySide6.QtDataVisualization.QSurface3DSeries.selectedPoint()#

Return type:: PySide6.QtCore.QPoint

See also

setSelectedPoint()

Getter of property selectedPoint .

PySide6.QtDataVisualization.QSurface3DSeries.selectedPointChanged(position)#

Parameters:: position – PySide6.QtCore.QPoint

Notification signal of property selectedPoint .

PySide6.QtDataVisualization.QSurface3DSeries.setDataProxy(proxy)#

Parameters:: proxy – PySide6.QtDataVisualization.QSurfaceDataProxy

See also

dataProxy()

Setter of property dataProxy .

PySide6.QtDataVisualization.QSurface3DSeries.setDrawMode(mode)#

Parameters:: mode – DrawFlags

See also

drawMode()

Setter of property drawMode .

PySide6.QtDataVisualization.QSurface3DSeries.setFlatShadingEnabled(enabled)#

Parameters:: enabled – bool

See also

isFlatShadingEnabled()

Setter of property flatShadingEnabled .

PySide6.QtDataVisualization.QSurface3DSeries.setSelectedPoint(position)#

Parameters:: position – PySide6.QtCore.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.

See also

selectedPoint() clearSelection()

Setter of property selectedPoint .

PySide6.QtDataVisualization.QSurface3DSeries.setTexture(texture)#

Parameters:: texture – PySide6.QtGui.QImage

See also

texture()

Setter of property texture .

PySide6.QtDataVisualization.QSurface3DSeries.setTextureFile(filename)#

Parameters:: filename – str

See also

textureFile()

Setter of property textureFile .

PySide6.QtDataVisualization.QSurface3DSeries.setWireframeColor(color)#

Parameters:: color – PySide6.QtGui.QColor

See also

wireframeColor()

Setter of property wireframeColor .

PySide6.QtDataVisualization.QSurface3DSeries.texture()#

Return type:: PySide6.QtGui.QImage

See also

setTexture()

Getter of property texture .

PySide6.QtDataVisualization.QSurface3DSeries.textureChanged(image)#

Parameters:: image – PySide6.QtGui.QImage

Notification signal of property texture .

PySide6.QtDataVisualization.QSurface3DSeries.textureFile()#

Return type:: str

See also

setTextureFile()

Getter of property textureFile .

PySide6.QtDataVisualization.QSurface3DSeries.textureFileChanged(filename)#

Parameters:: filename – str

Notification signal of property textureFile .

PySide6.QtDataVisualization.QSurface3DSeries.wireframeColor()#

Return type:: PySide6.QtGui.QColor

See also

setWireframeColor()

Getter of property wireframeColor .

PySide6.QtDataVisualization.QSurface3DSeries.wireframeColorChanged(color)#

Parameters:: color – PySide6.QtGui.QColor

Notification signal of property wireframeColor .

@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

QSurface3DSeries#

Synopsis#

Properties#

Functions#

Signals#

Static functions#

Detailed Description#