Qt 5.8 | Qt Data Visualization | QML Types | Abstract3DSeries QML Type

Qt 5.8.0 Reference Documentation

# Abstract3DSeries QML Type

Base type for all QtDataVisualization series. More...

Import Statement: | import QtDataVisualization 1.2
Since: | QtDataVisualization 1.0
Instantiates: | QAbstract3DSeries
Inherited By: | Bar3DSeries, Scatter3DSeries, and Surface3DSeries

- List of all members, including inherited members

## Properties

- baseColor : Color
- baseGradient : ColorGradient
- colorStyle : Theme3D.ColorStyle
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- mesh : Abstract3DSeries.Mesh
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : Color
- multiHighlightGradient : ColorGradient
- name : string
- singleHighlightColor : Color
- singleHighlightGradient : ColorGradient
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool

## Methods

- void setMeshAxisAndAngle(vector3d axis, real angle)

## Detailed Description

This type is uncreatable, but contains properties that are exposed via subtypes.

For Abstract3DSeries enums, see QAbstract3DSeries::SeriesType and QAbstract3DSeries::Mesh.

See also Bar3DSeries, Scatter3DSeries, Surface3DSeries, and Qt Data Visualization Data Handling.

## Property Documentation

baseColor : Color

Sets the base color of the series. See Theme3D.baseColors documentation for more information.

See also colorStyle.

baseGradient : ColorGradient

Sets the base gradient of the series. See Theme3D.baseGradients documentation for more information.

See also colorStyle.

colorStyle : Theme3D.ColorStyle

Sets the color style for the series. See Theme3D.colorStyle documentation for more information.

itemLabel : string

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

This QML property was introduced in QtDataVisualization 1.1.

See also itemLabelFormat.

itemLabelFormat : string

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. See each series class documentation for more information.

itemLabelVisible : bool

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

This QML property was introduced in QtDataVisualization 1.1.

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.MeshUserDefined, then the userDefinedMesh property must also be set for items to render properly. The default value depends on the graph type.

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 Y-axis. Surface3DSeries applies the rotation only to the selection pointer. Defaults to no rotation.

meshSmooth : bool

If enable is `true`, smooth versions of predefined meshes set via mesh property are used. This property doesn't affect custom meshes used when mesh is Abstract3DSeries.MeshUserDefined. Defaults to `false`.

multiHighlightColor : Color

Sets the multiple item highlight color of the series. See Theme3D.multiHighlightColor documentation for more information.

See also colorStyle.

multiHighlightGradient : ColorGradient

Sets the multiple item highlight gradient of the series. See Theme3D.multiHighlightGradient documentation for more information.

See also colorStyle.

name : string

Sets the series name. Series name can be used in item label format with tag `@seriesName`.

See also itemLabelFormat.

singleHighlightColor : Color

Sets the single item highlight color of the series. See Theme3D.singleHighlightColor documentation for more information.

See also colorStyle.

singleHighlightGradient : ColorGradient

Sets the single item highlight gradient of the series. See Theme3D.singleHighlightGradient documentation for more information.

See also colorStyle.

type : Abstract3DSeries.SeriesType

The type of the series.

userDefinedMesh : string

Sets the fileName for user defined custom mesh for objects that is used when mesh is Abstract3DSeries.MeshUserDefined.

Note: The file specified by fileName needs to be in 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.

## Method Documentation

void setMeshAxisAndAngle(vector3d axis, real angle)

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

See also meshRotation.