AbstractSeries QML Type | Qt Charts 5.7

Qt 5.7 | Qt Charts | QML Types | AbstractSeries QML Type

Qt 5.7.1 Reference Documentation

# AbstractSeries QML Type

Base class for all Qt Chart series. More...

Import Statement: | import QtCharts 2.1
Instantiates: | QAbstractSeries
Inherited By: | AbstractBarSeries, AreaSeries, BoxPlotSeries, PieSeries, and XYSeries

- List of all members, including inherited members

## Properties

- name : string
- opacity : real
- type : ChartView.SeriesType
- useOpenGL : bool
- visible : bool

## Signals

- onNameChanged()
- onOpacityChanged()
- onUseOpenGLChanged()
- onVisibleChanged()

## Detailed Description

AbstractSeries is the base class for all series. The class cannot be instantiated by the user.

## Property Documentation

name : string

Name of the series. The name is shown in legend for series and supports html formatting.

opacity : real

The opacity of the series. By default the opacity is 1.0. The valid values range from 0.0 (transparent) to 1.0 (opaque).

type : ChartView.SeriesType

The type of the series.

useOpenGL : bool

Specifies whether or not the series is drawn with OpenGL.

Drawing series with OpenGL is supported only for LineSeries and ScatterSeries. Line series used as edge series for a AreaSeries cannot use OpenGL acceleration. When a chart contains any series that are drawn with OpenGL, an additional transparent child node is created for the ChartView node. The accelerated series are not drawn on the ChartView node, but are instead drawn on the child node.

Performance gained from using OpenGL to accelerate series drawing depends on the underlying hardware, but in most cases it is significant. For example, on a standard desktop computer, enabling OpenGL acceleration for a series typically allows rendering at least hundred times more points without reduction on the frame rate. Chart size also has less effect on the frame rate. The biggest performance sink when rendering ChartView is rendering and uploading the underlying chart texture. If the underlying chart itself is not changing rapidly, significant extra performance is gained from not needing to regenerate the chart texture for each frame.

The OpenGL acceleration of series drawing is meant for use cases that need fast drawing of large numbers of points. It is optimized for efficiency, and therefore the series using it lack support for many features available to non-accelerated series:

- Series animations are not supported for accelerated series.
- Antialiasing is not supported for accelerated series.
- Point labels are not supported for accelerated series.
- Marker shapes are ignored for accelerated series. Only plain scatter dots are supported. The scatter dots may be circular or rectangular, depending on the underlying graphics hardware and drivers.
- Polar charts do not support accelerated series.
- Mouse events are not supported for accelerated series.
- Enabling chart drop shadow or using transparent chart background color is not recommended when using accelerated series, as that can slow the frame rate down significantly.

The default value is `false`.

visible : bool

Visibility of the series. True by default.

## Signal Documentation

onNameChanged()

This signal is emitted when the series name changes.

onOpacityChanged()

Emitted when the opacity of the series changes.

onUseOpenGLChanged()

Emitted when the useOpenGL property value changes.

onVisibleChanged()

Emitted when the series visibility changes.