QAbstract3DSeries Class▲
-
Header: QAbstract3DSeries
-
Since: QtDataVisualization 1.0
-
CMake:
find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
-
qmake: QT += datavisualization
-
Inherited By: QBar3DSeries, QScatter3DSeries, and QSurface3DSeries
-
Instantiated By: qml-qtdatavisualization-abstract3dseries.xml
-
Inherits: QObject
-
Inherited By: QBar3DSeries, QScatter3DSeries, and QSurface3DSeries
Detailed Description▲
There are inherited classes for each supported series type: QBar3DSeries, QScatter3DSeries, and QSurface3DSeries.
For more information, see Qt Data Visualization Data Handling.
Member Type Documentation▲
enum QAbstract3DSeries::Mesh▲
Predefined mesh types. All styles are not usable with all visualization types.
Constant |
Value |
Description |
---|---|---|
QAbstract3DSeries::MeshUserDefined |
0 |
User defined mesh, set via QAbstract3DSeries::userDefinedMesh property. |
QAbstract3DSeries::MeshBar |
1 |
Basic rectangular bar. |
QAbstract3DSeries::MeshCube |
2 |
Basic cube. |
QAbstract3DSeries::MeshPyramid |
3 |
Four-sided pyramid. |
QAbstract3DSeries::MeshCone |
4 |
Basic cone. |
QAbstract3DSeries::MeshCylinder |
5 |
Basic cylinder. |
QAbstract3DSeries::MeshBevelBar |
6 |
Slightly beveled (rounded) rectangular bar. |
QAbstract3DSeries::MeshBevelCube |
7 |
Slightly beveled (rounded) cube. |
QAbstract3DSeries::MeshSphere |
8 |
Sphere. |
QAbstract3DSeries::MeshMinimal |
9 |
The minimal 3D mesh: a triangular pyramid. Usable only with Q3DScatter. |
QAbstract3DSeries::MeshArrow |
10 |
Arrow pointing upwards. |
QAbstract3DSeries::MeshPoint |
11 |
2D point. Usable only with Q3DScatter. Shadows do not affect this style. Color style Q3DTheme::ColorStyleObjectGradient is not supported by this style. |
enum QAbstract3DSeries::SeriesType▲
Type of the series.
Constant |
Value |
Description |
---|---|---|
QAbstract3DSeries::SeriesTypeNone |
0 |
No series type. |
QAbstract3DSeries::SeriesTypeBar |
1 |
Series type for Q3DBars. |
QAbstract3DSeries::SeriesTypeScatter |
2 |
Series type for Q3DScatter. |
QAbstract3DSeries::SeriesTypeSurface |
4 |
Series type for Q3DSurface. |
Property Documentation▲
baseColor : QColor▲
This property holds the base color of the series.
Access functions:
-
baseColor() const
-
void setBaseColor(const &color)
Notifier signal:
-
void baseColorChanged(const &color)
See Also▲
See also colorStyle, Q3DTheme::baseColors
baseGradient : QLinearGradient▲
This property holds the base gradient of the series.
Access functions:
-
baseGradient() const
-
void setBaseGradient(const &gradient)
Notifier signal:
-
void baseGradientChanged(const &gradient)
See Also▲
See also colorStyle, Q3DTheme::baseGradients
colorStyle : Q3DTheme::ColorStyle▲
This property holds the color style for the series.
Access functions:
-
colorStyle() const
-
void setColorStyle( style)
Notifier signal:
-
void colorStyleChanged( style)
See Also▲
See also Q3DTheme::ColorStyle
[read-only, since QtDataVisualization 1.1] itemLabel : const QString▲
This property holds the formatted item label.
If there is no selected item or the selected item is not visible, returns an empty string.
This property was introduced in QtDataVisualization 1.1.
Access functions:
-
itemLabel() const
Notifier signal:
-
void itemLabelChanged(const &label)
See Also▲
See also itemLabelFormat
itemLabelFormat : QString▲
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() const
-
void setItemLabelFormat(const &format)
Notifier signal:
-
void itemLabelFormatChanged(const &format)
[since QtDataVisualization 1.1] 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.
This property was introduced in QtDataVisualization 1.1.
Access functions:
-
bool isItemLabelVisible() const
-
void setItemLabelVisible(bool visible)
Notifier signal:
-
void itemLabelVisibilityChanged(bool visible)
See Also▲
See also itemLabelFormat, itemLabel
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() const
-
void setMesh( mesh)
Notifier signal:
-
void meshChanged( mesh)
meshRotation : 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() const
-
void setMeshRotation(const &rotation)
Notifier signal:
-
void meshRotationChanged(const &rotation)
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:
-
bool isMeshSmooth() const
-
void setMeshSmooth(bool enable)
Notifier signal:
-
void meshSmoothChanged(bool enabled)
multiHighlightColor : QColor▲
This property holds the multiple item highlight color of the series.
Access functions:
-
multiHighlightColor() const
-
void setMultiHighlightColor(const &color)
Notifier signal:
-
void multiHighlightColorChanged(const &color)
See Also▲
See also colorStyle, Q3DTheme::multiHighlightColor
multiHighlightGradient : QLinearGradient▲
This property holds the multiple item highlight gradient of the series.
Access functions:
-
multiHighlightGradient() const
-
void setMultiHighlightGradient(const &gradient)
Notifier signal:
-
void multiHighlightGradientChanged(const &gradient)
See Also▲
See also colorStyle, Q3DTheme::multiHighlightGradient
name : QString▲
This property holds the series name.
The series name can be used in item label format with the tag @seriesName.
Access functions:
-
name() const
-
void setName(const &name)
Notifier signal:
-
void nameChanged(const &name)
See Also▲
See also itemLabelFormat
singleHighlightColor : QColor▲
This property holds the single item highlight color of the series.
Access functions:
-
singleHighlightColor() const
-
void setSingleHighlightColor(const &color)
Notifier signal:
-
void singleHighlightColorChanged(const &color)
See Also▲
See also colorStyle, Q3DTheme::singleHighlightColor
singleHighlightGradient : QLinearGradient▲
This property holds the single item highlight gradient of the series.
Access functions:
-
singleHighlightGradient() const
-
void setSingleHighlightGradient(const &gradient)
Notifier signal:
-
void singleHighlightGradientChanged(const &gradient)
See Also▲
See also colorStyle, Q3DTheme::singleHighlightGradient
[read-only] type : const SeriesType▲
This property holds the type of the series.
Access functions:
-
type() const
userDefinedMesh : QString▲
This property holds the filename for a user defined custom mesh for objects.
The custom mesh is used when mesh is MeshUserDefined.
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() const
-
void setUserDefinedMesh(const &fileName)
Notifier signal:
-
void userDefinedMeshChanged(const &fileName)
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:
-
bool isVisible() const
-
void setVisible(bool visible)
Notifier signal:
-
void visibilityChanged(bool visible)
Member Function Documentation▲
[virtual] QAbstract3DSeries::~QAbstract3DSeries()▲
Deletes the abstract 3D series.
void QAbstract3DSeries::setMeshAxisAndAngle(const QVector3D &axis, float angle)▲
A convenience function to construct a mesh rotation quaternion from axis and angle.
See Also▲
See also meshRotation