QAbstract3DSeries#

The QAbstract3DSeries class is a base class for all data series. More…

Inherited by: QSurface3DSeries, QScatter3DSeries, QBar3DSeries

Synopsis#

Properties#

baseColor - Base color of the series
baseGradient - Base gradient of the series
colorStyle - Color style for the series
itemLabel - Formatted item label
itemLabelFormat - Label format for data items in this series
itemLabelVisible - Visibility of item labels in the graph
mesh - Of the items in the series
meshRotation - Mesh rotation that is applied to all items of the series
meshSmooth - Whether smooth versions of predefined meshes are used
multiHighlightColor - Multiple item highlight color of the series
multiHighlightGradient - Multiple item highlight gradient of the series
name - Series name
singleHighlightColor - Single item highlight color of the series
singleHighlightGradient - Single item highlight gradient of the series
type - Of the series
userDefinedMesh - Filename for a user defined custom mesh for objects
visible - Visibility of the series

Functions#

def baseColor ()
def baseGradient ()
def colorStyle ()
def isItemLabelVisible ()
def isMeshSmooth ()
def isVisible ()
def itemLabel ()
def itemLabelFormat ()
def mesh ()
def meshRotation ()
def multiHighlightColor ()
def multiHighlightGradient ()
def name ()
def setBaseColor (color)
def setBaseGradient (gradient)
def setColorStyle (style)
def setItemLabelFormat (format)
def setItemLabelVisible (visible)
def setMesh (mesh)
def setMeshAxisAndAngle (axis, angle)
def setMeshRotation (rotation)
def setMeshSmooth (enable)
def setMultiHighlightColor (color)
def setMultiHighlightGradient (gradient)
def setName (name)
def setSingleHighlightColor (color)
def setSingleHighlightGradient (gradient)
def setUserDefinedMesh (fileName)
def setVisible (visible)
def singleHighlightColor ()
def singleHighlightGradient ()
def type ()
def userDefinedMesh ()

Signals#

def baseColorChanged (color)
def baseGradientChanged (gradient)
def colorStyleChanged (style)
def itemLabelChanged (label)
def itemLabelFormatChanged (format)
def itemLabelVisibilityChanged (visible)
def meshChanged (mesh)
def meshRotationChanged (rotation)
def meshSmoothChanged (enabled)
def multiHighlightColorChanged (color)
def multiHighlightGradientChanged (gradient)
def nameChanged (name)
def singleHighlightColorChanged (color)
def singleHighlightGradientChanged (gradient)
def userDefinedMeshChanged (fileName)
def visibilityChanged (visible)

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#

There are inherited classes for each supported series type: QBar3DSeries , QScatter3DSeries , and QSurface3DSeries .

For more information, see Qt Data Visualization Data Handling .

class PySide6.QtDataVisualization.QAbstract3DSeries#

Note

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

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.baseColor: PySide6.QtGui.QColor#

This property holds The base color of the series..

See also

colorStyle baseColors

Access functions:

baseColor ()
setBaseColor (color)
Signal baseColorChanged (color)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.baseGradient: PySide6.QtGui.QLinearGradient#

This property holds The base gradient of the series..

See also

colorStyle baseGradients

Access functions:

baseGradient ()
setBaseGradient (gradient)
Signal baseGradientChanged (gradient)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.colorStyle: ColorStyle#

This property holds The color style for the series..

See also

ColorStyle

Access functions:

colorStyle ()
setColorStyle (style)
Signal colorStyleChanged (style)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.itemLabel: str#

This property holds The formatted item label..

If there is no selected item or the selected item is not visible, returns an empty string.

See also

itemLabelFormat

Access functions:

itemLabel ()
Signal itemLabelChanged (label)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.itemLabelFormat: str#

This property holds The label format for data items in this series..

This format is used for single item labels, for example, when an item is selected. How the format is interpreted depends on series type: QBar3DSeries , QScatter3DSeries , QSurface3DSeries .

Access functions:

itemLabelFormat ()
setItemLabelFormat (format)
Signal itemLabelFormatChanged (format)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.itemLabelVisible: bool#

This property holds The visibility of item labels in the graph..

If true, item labels are drawn as floating labels in the graph. Otherwise, item labels are not drawn. To show the item label in an external control, this property is set to false. Defaults to true.

See also

itemLabelFormat itemLabel

Access functions:

isItemLabelVisible ()
setItemLabelVisible (visible)
Signal itemLabelVisibilityChanged (visible)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.mesh: Mesh#

This property holds The mesh of the items in the series..

For QSurface3DSeries , this property holds the selection pointer.

If the mesh is MeshUserDefined , then the userDefinedMesh property must also be set for items to render properly. The default value depends on the graph type.

Access functions:

mesh ()
setMesh (mesh)
Signal meshChanged (mesh)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.meshRotation: PySide6.QtGui.QQuaternion#

This property holds The mesh rotation that is applied to all items of the series..

The rotation should be a normalized QQuaternion . For those series types that support item specific rotation, the rotations are multiplied together. QBar3DSeries ignores any rotation that is not around the y-axis. QSurface3DSeries applies the rotation only to the selection pointer. Defaults to no rotation.

Access functions:

meshRotation ()
setMeshRotation (rotation)
Signal meshRotationChanged (rotation)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.meshSmooth: bool#

This property holds Whether smooth versions of predefined meshes are used..

If true, smooth versions set via the mesh property are used. This property does not affect custom meshes used when the mesh is set to MeshUserDefined . Defaults to false.

Access functions:

isMeshSmooth ()
setMeshSmooth (enable)
Signal meshSmoothChanged (enabled)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.multiHighlightColor: PySide6.QtGui.QColor#

This property holds The multiple item highlight color of the series..

See also

colorStyle multiHighlightColor

Access functions:

multiHighlightColor ()
setMultiHighlightColor (color)
Signal multiHighlightColorChanged (color)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.multiHighlightGradient: PySide6.QtGui.QLinearGradient#

This property holds The multiple item highlight gradient of the series..

See also

colorStyle multiHighlightGradient

Access functions:

multiHighlightGradient ()
setMultiHighlightGradient (gradient)
Signal multiHighlightGradientChanged (gradient)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.name: str#

This property holds The series name..

The series name can be used in item label format with the tag @seriesName.

See also

itemLabelFormat

Access functions:

name ()
setName (name)
Signal nameChanged (name)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.singleHighlightColor: PySide6.QtGui.QColor#

This property holds The single item highlight color of the series..

See also

colorStyle singleHighlightColor

Access functions:

singleHighlightColor ()
setSingleHighlightColor (color)
Signal singleHighlightColorChanged (color)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.singleHighlightGradient: PySide6.QtGui.QLinearGradient#

This property holds The single item highlight gradient of the series..

See also

colorStyle singleHighlightGradient

Access functions:

singleHighlightGradient ()
setSingleHighlightGradient (gradient)
Signal singleHighlightGradientChanged (gradient)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.type: SeriesType#

This property holds The type of the series..

Access functions:

type ()

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.userDefinedMesh: str#

This property holds The filename for a user defined custom mesh for objects..

The custom mesh is used when mesh is MeshUserDefined .

Note

The file needs to be in the Wavefront OBJ format and include vertices, normals, and UVs. It also needs to be in triangles.

Access functions:

userDefinedMesh ()
setUserDefinedMesh (fileName)
Signal userDefinedMeshChanged (fileName)

property PᅟySide6.QtDataVisualization.QAbstract3DSeries.visible: bool#

This property holds The visibility of the series..

If this property is false, the series is not rendered. Defaults to true.

Access functions:

isVisible ()
setVisible (visible)
Signal visibilityChanged (visible)

PySide6.QtDataVisualization.QAbstract3DSeries.SeriesType#

Type of the series.

Constant

Description

QAbstract3DSeries.SeriesTypeNone

No series type.

QAbstract3DSeries.SeriesTypeBar

Series type for Q3DBars .

QAbstract3DSeries.SeriesTypeScatter

Series type for Q3DScatter .

QAbstract3DSeries.SeriesTypeSurface

Series type for Q3DSurface .

Constant	Description
QAbstract3DSeries.SeriesTypeNone	No series type.
QAbstract3DSeries.SeriesTypeBar	Series type for `Q3DBars` .
QAbstract3DSeries.SeriesTypeScatter	Series type for `Q3DScatter` .
QAbstract3DSeries.SeriesTypeSurface	Series type for `Q3DSurface` .

PySide6.QtDataVisualization.QAbstract3DSeries.Mesh#

Predefined mesh types. All styles are not usable with all visualization types.

Constant

Description

QAbstract3DSeries.MeshUserDefined

User defined mesh, set via userDefinedMesh property.

QAbstract3DSeries.MeshBar

Basic rectangular bar.

QAbstract3DSeries.MeshCube

Basic cube.

QAbstract3DSeries.MeshPyramid

Four-sided pyramid.

QAbstract3DSeries.MeshCone

Basic cone.

QAbstract3DSeries.MeshCylinder

Basic cylinder.

QAbstract3DSeries.MeshBevelBar

Slightly beveled (rounded) rectangular bar.

QAbstract3DSeries.MeshBevelCube

Slightly beveled (rounded) cube.

QAbstract3DSeries.MeshSphere

Sphere.

QAbstract3DSeries.MeshMinimal

The minimal 3D mesh: a triangular pyramid. Usable only with Q3DScatter .

QAbstract3DSeries.MeshArrow

Arrow pointing upwards.

QAbstract3DSeries.MeshPoint

2D point. Usable only with Q3DScatter . Shadows do not affect this style. Color style ColorStyleObjectGradient is not supported by this style.

Constant	Description
QAbstract3DSeries.MeshUserDefined	User defined mesh, set via `userDefinedMesh` property.
QAbstract3DSeries.MeshBar	Basic rectangular bar.
QAbstract3DSeries.MeshCube	Basic cube.
QAbstract3DSeries.MeshPyramid	Four-sided pyramid.
QAbstract3DSeries.MeshCone	Basic cone.
QAbstract3DSeries.MeshCylinder	Basic cylinder.
QAbstract3DSeries.MeshBevelBar	Slightly beveled (rounded) rectangular bar.
QAbstract3DSeries.MeshBevelCube	Slightly beveled (rounded) cube.
QAbstract3DSeries.MeshSphere	Sphere.
QAbstract3DSeries.MeshMinimal	The minimal 3D mesh: a triangular pyramid. Usable only with `Q3DScatter` .
QAbstract3DSeries.MeshArrow	Arrow pointing upwards.
QAbstract3DSeries.MeshPoint	2D point. Usable only with `Q3DScatter` . Shadows do not affect this style. Color style `ColorStyleObjectGradient` is not supported by this style.

PySide6.QtDataVisualization.QAbstract3DSeries.baseColor()#

Return type:: PySide6.QtGui.QColor

See also

setBaseColor()

Getter of property baseColor .

PySide6.QtDataVisualization.QAbstract3DSeries.baseColorChanged(color)#

Parameters:: color – PySide6.QtGui.QColor

Notification signal of property baseColor .

PySide6.QtDataVisualization.QAbstract3DSeries.baseGradient()#

Return type:: PySide6.QtGui.QLinearGradient

See also

setBaseGradient()

Getter of property baseGradient .

PySide6.QtDataVisualization.QAbstract3DSeries.baseGradientChanged(gradient)#

Parameters:: gradient – PySide6.QtGui.QLinearGradient

Notification signal of property baseGradient .

PySide6.QtDataVisualization.QAbstract3DSeries.colorStyle()#

Return type:: ColorStyle

See also

setColorStyle()

Getter of property colorStyle .

PySide6.QtDataVisualization.QAbstract3DSeries.colorStyleChanged(style)#

Parameters:: style – ColorStyle

Notification signal of property colorStyle .

PySide6.QtDataVisualization.QAbstract3DSeries.isItemLabelVisible()#

Return type:: bool

Getter of property itemLabelVisible .

PySide6.QtDataVisualization.QAbstract3DSeries.isMeshSmooth()#

Return type:: bool

Getter of property meshSmooth .

PySide6.QtDataVisualization.QAbstract3DSeries.isVisible()#

Return type:: bool

Getter of property visible .

PySide6.QtDataVisualization.QAbstract3DSeries.itemLabel()#

Return type:: str

Getter of property itemLabel .

PySide6.QtDataVisualization.QAbstract3DSeries.itemLabelChanged(label)#

Parameters:: label – str

Notification signal of property itemLabel .

PySide6.QtDataVisualization.QAbstract3DSeries.itemLabelFormat()#

Return type:: str

See also

setItemLabelFormat()

Getter of property itemLabelFormat .

PySide6.QtDataVisualization.QAbstract3DSeries.itemLabelFormatChanged(format)#

Parameters:: format – str

Notification signal of property itemLabelFormat .

PySide6.QtDataVisualization.QAbstract3DSeries.itemLabelVisibilityChanged(visible)#

Parameters:: visible – bool

Notification signal of property itemLabelVisible .

PySide6.QtDataVisualization.QAbstract3DSeries.mesh()#

Return type:: Mesh

See also

setMesh()

Getter of property mesh .

PySide6.QtDataVisualization.QAbstract3DSeries.meshChanged(mesh)#

Parameters:: mesh – Mesh

Notification signal of property mesh .

PySide6.QtDataVisualization.QAbstract3DSeries.meshRotation()#

Return type:: PySide6.QtGui.QQuaternion

See also

setMeshRotation()

Getter of property meshRotation .

PySide6.QtDataVisualization.QAbstract3DSeries.meshRotationChanged(rotation)#

Parameters:: rotation – PySide6.QtGui.QQuaternion

Notification signal of property meshRotation .

PySide6.QtDataVisualization.QAbstract3DSeries.meshSmoothChanged(enabled)#

Parameters:: enabled – bool

Notification signal of property meshSmooth .

PySide6.QtDataVisualization.QAbstract3DSeries.multiHighlightColor()#

Return type:: PySide6.QtGui.QColor

See also

setMultiHighlightColor()

Getter of property multiHighlightColor .

PySide6.QtDataVisualization.QAbstract3DSeries.multiHighlightColorChanged(color)#

Parameters:: color – PySide6.QtGui.QColor

Notification signal of property multiHighlightColor .

PySide6.QtDataVisualization.QAbstract3DSeries.multiHighlightGradient()#

Return type:: PySide6.QtGui.QLinearGradient

See also

setMultiHighlightGradient()

Getter of property multiHighlightGradient .

PySide6.QtDataVisualization.QAbstract3DSeries.multiHighlightGradientChanged(gradient)#

Parameters:: gradient – PySide6.QtGui.QLinearGradient

Notification signal of property multiHighlightGradient .

PySide6.QtDataVisualization.QAbstract3DSeries.name()#

Return type:: str

See also

setName()

Getter of property name .

PySide6.QtDataVisualization.QAbstract3DSeries.nameChanged(name)#

Parameters:: name – str

Notification signal of property name .

PySide6.QtDataVisualization.QAbstract3DSeries.setBaseColor(color)#

Parameters:: color – PySide6.QtGui.QColor

See also

baseColor()

Setter of property baseColor .

PySide6.QtDataVisualization.QAbstract3DSeries.setBaseGradient(gradient)#

Parameters:: gradient – PySide6.QtGui.QLinearGradient

See also

baseGradient()

Setter of property baseGradient .

PySide6.QtDataVisualization.QAbstract3DSeries.setColorStyle(style)#

Parameters:: style – ColorStyle

See also

colorStyle()

Setter of property colorStyle .

PySide6.QtDataVisualization.QAbstract3DSeries.setItemLabelFormat(format)#

Parameters:: format – str

See also

itemLabelFormat()

Setter of property itemLabelFormat .

PySide6.QtDataVisualization.QAbstract3DSeries.setItemLabelVisible(visible)#

Parameters:: visible – bool

See also

isItemLabelVisible()

Setter of property itemLabelVisible .

PySide6.QtDataVisualization.QAbstract3DSeries.setMesh(mesh)#

Parameters:: mesh – Mesh

See also

mesh()

Setter of property mesh .

PySide6.QtDataVisualization.QAbstract3DSeries.setMeshAxisAndAngle(axis, angle)#

Parameters:

axis – PySide6.QtGui.QVector3D
angle – float

A convenience function to construct a mesh rotation quaternion from axis and angle.

See also

meshRotation

PySide6.QtDataVisualization.QAbstract3DSeries.setMeshRotation(rotation)#

Parameters:: rotation – PySide6.QtGui.QQuaternion

See also

meshRotation()

Setter of property meshRotation .

PySide6.QtDataVisualization.QAbstract3DSeries.setMeshSmooth(enable)#

Parameters:: enable – bool

See also

isMeshSmooth()

Setter of property meshSmooth .

PySide6.QtDataVisualization.QAbstract3DSeries.setMultiHighlightColor(color)#

Parameters:: color – PySide6.QtGui.QColor

See also

multiHighlightColor()

Setter of property multiHighlightColor .

PySide6.QtDataVisualization.QAbstract3DSeries.setMultiHighlightGradient(gradient)#

Parameters:: gradient – PySide6.QtGui.QLinearGradient

See also

multiHighlightGradient()

Setter of property multiHighlightGradient .

PySide6.QtDataVisualization.QAbstract3DSeries.setName(name)#

Parameters:: name – str

See also

name()

Setter of property name .

PySide6.QtDataVisualization.QAbstract3DSeries.setSingleHighlightColor(color)#

Parameters:: color – PySide6.QtGui.QColor

See also

singleHighlightColor()

Setter of property singleHighlightColor .

PySide6.QtDataVisualization.QAbstract3DSeries.setSingleHighlightGradient(gradient)#

Parameters:: gradient – PySide6.QtGui.QLinearGradient

See also

singleHighlightGradient()

Setter of property singleHighlightGradient .

PySide6.QtDataVisualization.QAbstract3DSeries.setUserDefinedMesh(fileName)#

Parameters:: fileName – str

See also

userDefinedMesh()

Setter of property userDefinedMesh .

PySide6.QtDataVisualization.QAbstract3DSeries.setVisible(visible)#

Parameters:: visible – bool

See also

isVisible()

Setter of property visible .

PySide6.QtDataVisualization.QAbstract3DSeries.singleHighlightColor()#

Return type:: PySide6.QtGui.QColor

See also

setSingleHighlightColor()

Getter of property singleHighlightColor .

PySide6.QtDataVisualization.QAbstract3DSeries.singleHighlightColorChanged(color)#

Parameters:: color – PySide6.QtGui.QColor

Notification signal of property singleHighlightColor .

PySide6.QtDataVisualization.QAbstract3DSeries.singleHighlightGradient()#

Return type:: PySide6.QtGui.QLinearGradient

See also

setSingleHighlightGradient()

Getter of property singleHighlightGradient .

PySide6.QtDataVisualization.QAbstract3DSeries.singleHighlightGradientChanged(gradient)#

Parameters:: gradient – PySide6.QtGui.QLinearGradient

Notification signal of property singleHighlightGradient .

PySide6.QtDataVisualization.QAbstract3DSeries.type()#

Return type:: SeriesType

Getter of property type .

PySide6.QtDataVisualization.QAbstract3DSeries.userDefinedMesh()#

Return type:: str

See also

setUserDefinedMesh()

Getter of property userDefinedMesh .

PySide6.QtDataVisualization.QAbstract3DSeries.userDefinedMeshChanged(fileName)#

Parameters:: fileName – str

Notification signal of property userDefinedMesh .

PySide6.QtDataVisualization.QAbstract3DSeries.visibilityChanged(visible)#

Parameters:: visible – bool

Notification signal of property visible .