Qt Documentation

Contents

AbstractSeries QML Type

Base type for all Qt Chart series types. More...

Import Statement: import QtCharts 2.2
Instantiates: QAbstractSeries
Inherited By:

AbstractBarSeries, AreaSeries, BoxPlotSeries, CandlestickSeries, PieSeries, and XYSeries

Properties

Signals

Detailed Description

This type cannot be instantiated directly. Instead, one of the following derived types should be used to create a series: LineSeries, AreaSeries, BarSeries, StackedBarSeries, PercentBarSeries, HorizontalBarSeries, HorizontalStackedBarSeries, HorizontalPercentBarSeries, PieSeries, ScatterSeries, SplineSeries, BoxPlotSeries, or CandlestickSeries.

Property Documentation

name : string

The name of the series. It is displayed in the legend for the series and it 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 : enumeration

The type of the series.

ConstantDescription
AbstractSeries.SeriesTypeLineA line chart.
AbstractSeries.SeriesTypeAreaAn area chart.
AbstractSeries.SeriesTypeBarA vertical bar chart.
AbstractSeries.SeriesTypeStackedBarA vertical stacked bar chart.
AbstractSeries.SeriesTypePercentBarA vertical percent bar chart.
AbstractSeries.SeriesTypePieA pie chart.
AbstractSeries.SeriesTypeScatterA scatter chart.
AbstractSeries.SeriesTypeSplineA spline chart.
AbstractSeries.SeriesTypeHorizontalBarA horizontal bar chart.
AbstractSeries.SeriesTypeHorizontalStackedBarA horizontal stacked bar chart.
AbstractSeries.SeriesTypeHorizontalPercentBarA horizontal percent bar chart.
AbstractSeries.SeriesTypeBoxPlotA box plot chart.
AbstractSeries.SeriesTypeCandlestickA candlestick chart.

useOpenGL : bool

Specifies whether or not the series is drawn with OpenGL.

Acceleration using OpenGL is supported only for LineSeries and ScatterSeries. A line series used as an 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.
  • 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 for series are reported asynchronously.
  • 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. By default, true.


Signal Documentation

onNameChanged()

This signal is emitted when the series name changes.


onOpacityChanged()

This signal is emitted when the opacity of the series changes.


onUseOpenGLChanged()

This signal is emitted when accelerating the drawing of the series by using OpenGL is enabled or disabled.


onVisibleChanged()

This signal is emitted when the series visibility changes.


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