TiPlotChannelCustom.DataStyle

TiPlotChannelCustom

Specifies the storage type for the data in the channel.

type TiPlotDataStyle = (ipdsStandard, ipdsCompact, ipdsCompactInterval);

property DataStyle : TiPlotDataStyle;

Description

Use DataStyle to set the storage type for the data in the channel. The original Plot Components used a Data Style of ipdsStandard. The Compact data styles allow for a larger maximum number of data points to be added to the chart with the benefit of additional speed at the expense of supported features.

These are the possible values:

Value
Meaning
Bytes Per Data Point
Maximum # of Data Points (32-Bit Windows)
ipdsStandard
The original data style for the component. This data set supports all of the extended features of the component.
24 bytes
89,478,485
ipdsCompact
A compact data storage type that uses 8 bytes per data point. This data set does not support the following features...
  • · Empty Data Points
  • · Null Data Points
  • · Individual Marker Hiding
  • · Individual Marker Styles
  1. bytes
268,435,455
ipdsCompactInterval
A compact data storage type for fixed-interval data sets that uses 4 bytes per data point.

The first and second data point x-values added to the channel determine the fixed-interval used for the entire data set.

For example, if the first data point's X-Value is 1, and the second data point's X-Value is 6, then the X-Value interval between all data points in this channel will be fixed at 5 (Interval = 6 - 1 = 5). All future X-Values will be ignored. This was done to keep backward compatibility with previous log files and data sets.

This data set does not support the following features...
  • · Empty Data Points
  • · Null Data Points
  • · Individual Marker Hiding
  • · Individual Marker Styles
  • · Non-Fixed X-Interval Data Points
  1. bytes
536,870,911
ipdsFullFeature
A large data storage type for data sets that intend to utilize the following extended features….

Individual Trace Line Styles, Color, and Width
Individual Data Marker BrushColor, BrushStyle, PenColor, PenStyle, PenWidth, and Size properties.

This Data Type will always support all extended features of the channel object as we add them to future versions

Note: this Data Style should not be used with extremely large data sets due to the larger amount of memory storage needed for each data point. If you must keep your memory usage low and you don't plan on using extended features of the channel, then we recommend not using this Data Style unless necessary.
100 bytes
21,474,836

Note: the Maximun # of Data Points quoted is a theoretical maximum assumes that your application uses 0KB of memory. Since this is not the case, your actual maximum storage of data points will depend on the following equations...

Maximum Memory available for Data Point Storage

32-Bit Windows
(Windows 95/98/ME/NT4/2000/XP)

Max = 2GB - ApplicationMemoryUsed

Memory Note: if you will be using large numbers of data points, you will need to investigate the total memory usage needed by your application and adjust your virtual memory settings in your operating system accordingly. Using the Compact data styles instead of the Standard data style will greatly reduce the memory requirements of your channel data set.

Example

Delphi

iComponent.Channel[0].DataStyle := ipdsCompact;

C++ Builder

iComponent->Channel[0]->DataStyle = ipdsCompact;

Contents | Index | Previous | Next