ChartDirector 7.1 (C++ Edition)

DataAccelerator.addDataSeries


Usage

void addDataSeries(const char *id, const double *yData, int yDataLen);

Description

Adds a data series.

The yData is an array for storing the y data values, and yDataLen is the number of valid values in the array.

To conserve memory, DataAccelerator will only keep a reference to the array and not copy it. The caller must ensure the array remains valid for as long as the DataAccelerator is in use.

For real time chart usage, the array acts as a buffer to store real time data. Initially the number of valid values can be 0. As new data come in, the values can be stored in the array and DataAccelerator.extendLength can be called to update the number of valid values.

This method is specially designed to allow multiple data series to be updated concurrently with multiple threads.

Arguments

ArgumentDefaultDescription
id(Mandatory)Name of the data series. Each data series in a DataAccelerator object must have a unique name.
yData(Mandatory)The array to store the data values.
yDataLen(Mandatory)The number of valid values.

Return Value

None