Platforms to show: All Mac Windows Linux Cross-Platform
Back to CDDataAcceleratorMBS class.
CDDataAcceleratorMBS.addDataSeries(id as string, yData as CDArrayMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | ChartDirector | MBS ChartDirector Plugin | 21.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
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 CDDataAcceleratorMBS.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.
Argument | Default | Description |
id | (Mandatory) | Name of the data series. Each data series in a CDDataAcceleratorMBS object must have a unique name. |
yData | (Mandatory) | The array to store the data values. |
See also:
CDDataAcceleratorMBS.addDataSeries(id as string, yData() as double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | ChartDirector | MBS ChartDirector Plugin | 21.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
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 CDDataAcceleratorMBS.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.
Argument | Default | Description |
id | (Mandatory) | Name of the data series. Each data series in a CDDataAcceleratorMBS object must have a unique name. |
yData | (Mandatory) | The array to store the data values. |
See also:
CDDataAcceleratorMBS.Constructor
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | ChartDirector | MBS ChartDirector Plugin | 21.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
The xData is an array for storing the x data values, and xDataLen is 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.
Argument | Default | Description |
xData | (Mandatory) | The array to store the x values. |
xDataLen | (Mandatory) | The number of valid values. |
See also:
CDDataAcceleratorMBS.Constructor(xData as CDArrayMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | ChartDirector | MBS ChartDirector Plugin | 21.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
The xData is an array for storing the x data values, and xDataLen is 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.
Argument | Default | Description |
xData | (Mandatory) | The array to store the x values. |
xDataLen | (Mandatory) | The number of valid values. |
See also:
CDDataAcceleratorMBS.Constructor(xData() as double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | ChartDirector | MBS ChartDirector Plugin | 21.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
The xData is an array for storing the x data values, and xDataLen is 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.
Argument | Default | Description |
xData | (Mandatory) | The array to store the x values. |
xDataLen | (Mandatory) | The number of valid values. |
See also:
CDDataAcceleratorMBS.extendLength(len as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | ChartDirector | MBS ChartDirector Plugin | 21.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
This method is usually used by real time charts. After storing the real time data into the data arrays, the extendLength method should be used to notify the DataAccelerator of the new data. You must ensure all data arrays in the DataAccelerator are updated to contain valid data before calling this method.
You can only increase the number of valid values, but not decrease it.
Argument | Default | Description |
length | (Mandatory) | The number of valid values in the arrays. |
CDDataAcceleratorMBS.setSubsetRange(xStart as double, xEnd as double, resolution as Integer = 0)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | ChartDirector | MBS ChartDirector Plugin | 21.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
For zoomable and scrollable chart, depending on the zoom level, only part of the data may be visible. The setSubsetRange method should be used to set the visible x range so that the DataAccelerator can supply the chart with the necessary data only.
The resolution argument is a hint of the number of pixels available in the x direction for plotting the data. This argument avoids the DataAccelerator from providing too much data to the chart. For example, if only 600 pixels are available in the x direction, it is not necessary to provide 10 million points to the chart, as they will overlap and block each others and the vast majority would not be visible. The DataAccelerator employs a special algorithm that can reduce the data to match the resolution without noticeably affecting the shape of the plotted chart.
Argument | Default | Description |
xStart | (Mandatory) | The x value at the start of the visible range. |
xEnd | (Mandatory) | The x value at the end of the visible range. |
resolution | 0 | The approximate number of pixels available in the x direction for plotting the chart. In the most common case that the x-axis is horizontal, this is the plot area width. If this argument is not provided, ChartDirector will automatically choose the resolution to use. |
The items on this page are in the following plugins: MBS ChartDirector Plugin.