Contents

Abstract3DSeries QML Type

A base type for all 3D data series. More...

Import Statement: import QtGraphs
In C++: QAbstract3DSeries
Inherited By:

Bar3DSeries, Scatter3DSeries, and Surface3DSeries

Properties

Signals

Methods

Detailed Description

This abstract class serves as a base class for the following subtypes: Bar3DSeries, Scatter3DSeries, and Surface3DSeries.

For more information, see Qt Graphs Data Handling with 3D.

Property Documentation

baseColor : color

Sets the base color of the series.

See also colorStyle and GraphsTheme.seriesColors.


baseGradient : Gradient

Sets the base gradient of the series.

See also colorStyle and GraphsTheme.seriesGradients.


colorStyle : GraphsTheme.ColorStyle

Sets the color style for the series.

See also GraphsTheme.ColorStyle.


itemLabel : string [read-only]

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

See also itemLabelFormat.


itemLabelFormat : string

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: Bar3DSeries, Scatter3DSeries, Surface3DSeries.


itemLabelVisible : bool

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 and itemLabel.


mesh : Abstract3DSeries.Mesh

Sets the mesh of the items in the series, or the selection pointer in case of Surface3DSeries. If the mesh is Abstract3DSeries.Mesh.UserDefined, then the userDefinedMesh property must also be set for items to render properly. The default value depends on the graph type.

See also QAbstract3DSeries::Mesh.


meshRotation : quaternion

Sets the mesh rotation that is applied to all items of the series. The rotation should be a normalized quaternion. For those series types that support item specific rotation, the rotations are multiplied together. Bar3DSeries ignores any rotation that is not around the y-axis. Surface3DSeries applies the rotation only to the selection pointer. Defaults to no rotation.


meshSmooth : bool

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


multiHighlightColor : color

Sets the multiple item highlight color of the series.

See also colorStyle and GraphsTheme.multiHighlightColor.


multiHighlightGradient : Gradient

Sets the multiple item highlight gradient of the series.

See also colorStyle and GraphsTheme.multiHighlightGradient.


name : string

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

See also itemLabelFormat.


singleHighlightColor : color

Sets the single item highlight color of the series.

See also colorStyle and GraphsTheme.singleHighlightColor.


singleHighlightGradient : Gradient

Sets the single item highlight gradient of the series.

See also colorStyle and GraphsTheme.singleHighlightGradient.


type : Abstract3DSeries.SeriesType [read-only]

The type of the series. One of the QAbstract3DSeries::SeriesType values.


userDefinedMesh : string

Sets the filename for a user defined custom mesh for objects that is used when mesh is Abstract3DSeries.Mesh.UserDefined.

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


visible : bool

Sets the visibility of the series. If false, the series is not rendered.


Signal Documentation

baseColorChanged(color color)

This signal is emitted when baseColor changes to color.

Note: The corresponding handler is onBaseColorChanged.


baseGradientChanged(Gradient gradient)

This signal is emitted when baseGradient changes to gradient.

Note: The corresponding handler is onBaseGradientChanged.


colorStyleChanged(GraphsTheme.ColorStyle style)

This signal is emitted when colorStyle changes to style.

Note: The corresponding handler is onColorStyleChanged.


itemLabelChanged(string label)

This signal is emitted when itemLabel changes to label.

Note: The corresponding handler is onItemLabelChanged.


itemLabelFormatChanged(string format)

This signal is emitted when itemLabelFormat changes to format.

Note: The corresponding handler is onItemLabelFormatChanged.


itemLabelVisibilityChanged(bool visible)

This signal is emitted when itemLabelVisibility changes to visible.

Note: The corresponding handler is onItemLabelVisibilityChanged.


meshChanged(Abstract3DSeries.Mesh mesh)

This signal is emitted when mesh changes to mesh.

Note: The corresponding handler is onMeshChanged.


meshRotationChanged(quaternion rotation)

This signal is emitted when meshRotation changes to rotation.

Note: The corresponding handler is onMeshRotationChanged.


meshSmoothChanged(bool enabled)

This signal is emitted when meshSmooth changes to enabled.

Note: The corresponding handler is onMeshSmoothChanged.


multiHighlightColorChanged(color color)

This signal is emitted when multiHighlightColor changes to color.

Note: The corresponding handler is onMultiHighlightColorChanged.


multiHighlightGradientChanged(Gradient gradient)

This signal is emitted when multiHighlightGradient changes to gradient.

Note: The corresponding handler is onMultiHighlightGradientChanged.


nameChanged(string name)

This signal is emitted when name changes to name.

Note: The corresponding handler is onNameChanged.


singleHighlightColorChanged(color color)

This signal is emitted when singleHighlightColor changes to color.

Note: The corresponding handler is onSingleHighlightColorChanged.


singleHighlightGradientChanged(Gradient gradient)

This signal is emitted when singleHighlightGradient changes to gradient.

Note: The corresponding handler is onSingleHighlightGradientChanged.


userDefinedMeshChanged(string fileName)

This signal is emitted when userDefinedMesh changes to fileName.

Note: The corresponding handler is onUserDefinedMeshChanged.


visibilityChanged(bool visible)

This signal is emitted when the series visibility changes to visible.

Note: The corresponding handler is onVisibilityChanged.


Method Documentation

void setMeshAxisAndAngle(vector3d axis, real angle)

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

See also meshRotation.


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