Data Properties

DataScrollerPresenceGroups

This property controls the presence of data scroll bars on the group axis. It can be used for all 2D charts except pies. It is not applicable for 3D or pie charts. When the number of viewable groups is set to a value less than the number of groups in the data set, the scroll bar can be used to change the first group in the chart that is displayed (i.e., effectively changes the value assigned to ScrollOffsetGroup). The scroll bar consists of two segments: 1) a segment that can be used to click and drag to the first group to be displayed and 2) a status bar that shows the number of the first group (i.e., the ScrollOffsetGroup value), the total number of viewable groups, and the remaining number of groups in the data set. In the first segment, the darker, movable thumb can be dragged to change the group offset. In the second segment, the three numbers indicate the total number of groups defined in the data set. For example, the status area of the scroll bar displays "2 3 1". These numbers indicate that ScrollOffsetGroup is "2", ViewableGroups is "3", there is "1" group in the data set that is not displayed, and there are a total of six groups defined in the data set. The user can click on these numbers and edit them with the arrow keys.

DATA TYPE:

integer

RANGE:

0...2; 0 = Never display data scroller bar, 1 = Only display data scroller bar when ViewableGroups is greater than zero, 2 = Always display data scroller bar

DEFAULT:

0 (Never)

SYNTAX:

void setDataScrollerPresenceGroups(int newValue);
int getDataScrollerPresenceGroups();

EXAMPLE:

setDepthRadius(0);
setDataScrollerPresenceGroups(2);
setViewableGroups(4);

ALSO SEE:

DataScrollerPresenceSeries, ScrollOffsetGroup, ViewableGroups

DataScrollerPresenceSeries

This property controls the presence of data scroll bars on the series in a chart. It can be used for all 2D charts. It is not applicable for 3D charts. When the number of viewable series is set to a value less than the number of series in the data set, the scroll bar can be used to change the first series in the chart that is displayed (i.e., effectively changes the value assigned to ScrollOffsetSeries). The data scroll bar consists of two segments: 1) a segment that can be used to click and drag to the first series to be displayed and 2) a status bar that shows the number of the first series (i.e., ScrollOffsetSeries value), the total number of viewable series, and the remaining number of series in the data set. In the first segment, the darker, movable thumb can be dragged to change the series offset. In the second segment, the three numbers indicate the total number of series defined in the data set. For example, the status area of the scroll bar displays "2 3 1". These numbers indicate that ScrollOffsetSeries is "2", ViewableSeries is "3", there is "1" series in the data set that is not displayed, and there are a total of six series defined in the data set. The user can click on these numbers and edit them with the arrow keys.

DATA TYPE:

integer

RANGE:

0...2; 0 = Never display data scroller bar, 1 = Only display data scroller bar when ViewableSeries is greater than zero, 2 = Always display data scroller bar

DEFAULT:

0 (Never)

SYNTAX:

void setDataScrollerPresenceSeries(int newValue);
int getDataScrollerPresenceSeries();

ALSO SEE:

DataScrollerPresenceGroups, ScrollOffsetSeries, ViewableSeries

FillMissingData

When data points are missing from a data set, this property defines the how Perspective should handle the missing data.

DATA TYPE:

integer

RANGE:

0...2; 0 = Skip Missing Data, 1 = Set Missing Data to Zero, 2 = Interpolate

DEFAULT:

0 (Skip)

SYNTAX:

void setFillMissingData(int newValue);
int getFillMissingData();

ALSO SEE:

NumMissingDataSegments

NumMissingDataSegments

This property in used in conjunction with FillMissingData to define the number of missing data segments for filling in missing data in a line chart.

DATA TYPE:

integer

RANGE:

1...25

DEFAULT:

3

SYNTAX:

void setNumMissingDataSegments(int newValue);
int getNumMissingDataSegments();

EXAMPLE:

setGraphType(41);
setLegendDisplay(false);
setFootnoteDisplay(false);
setSubtitleDisplay(false);
setTitleDisplay(false);
setData(7,0,20.0);
setData(7,2,10.0);
setData(7,6,50.0);
setDataRangeToExtent();
setDepthRadius(0);
setFillMissingData(1);
setNumMissingDataSegments(20);

OverdrawSkip

This property can be used to accelerate the drawing of 2D and 2.5D bar charts that represent very large data sets. When this property is enabled (true) and there are so many bar risers so that several would be drawn on each pixel of the screen (overdraw), the charting engine selects and draws only the largest and smallest values. This property has no effect on most data sets.

DATA TYPE:

boolean

RANGE:

true / false; true = Skip overdraw, false = Do not skip overdraw

DEFAULT:

true

SYNTAX:

void setOverdrawSkip(boolean newValue);
boolean getOverdrawSkip();

ScaleFromZero

In applications where the data range can include negative numbers, this property determines whether the risers will be drawn pointing up and down from a zero line or whether all risers will draw straight up from the "bottom" of the graph. It affects risers on 3D graphs and all 2D graphs except pie charts.

DATA TYPE:

boolean

RANGE:

true / false; true = Draw from the zero line, false = Draw from the base of the frame

DEFAULT:

true

SYNTAX:

void setScaleFromZero(boolean newValue);
boolean getScaleFromZero();

EXAMPLE:

setY1MajorGridStep(20.0);
setScaleFromZero(true);
setY1ScaleMax(80.0);
setY1ScaleMaxAuto(false);
setY1ScaleMin(-40.0);
setY1ScaleMinAuto(false);
setDepthRadius(0);

setScaleFromZero(false);

ScrollOffsetGroup

When ViewableGroups is set to a value greater than zero, this property selects the first group to be displayed in the graph.

DATA TYPE:

integer

RANGE:

Zero to the number of viewable groups in chart

DEFAULT:

Zero

SYNTAX:

void setScrollOffsetGroup(int newValue);
int getScrollOffsetGroup();

EXAMPLE:

setDataScrollerPresenceGroups(0);
setDepthRadius(0);
setViewableGroups(2);
setScrollOffsetGroup(4);

NOTE:

ALSO SEE:

DataScrollerPresenceGroups, ViewableGroups, ScrollOffsetSeries

ScrollOffsetSeries

When ViewableSeries is set to a value greater than zero, this property selects the first series to be displayed in the graph.

DATA TYPE:

integer

RANGE:

Zero to the number of viewable series in chart

DEFAULT:

Zero

SYNTAX:

void setScrollOffsetSeries(int newValue);
int getScrollOffsetSeries();

EXAMPLE:

setViewableSeries(4);
setViewableGroups(2);
setDepthRadius(0);
setDataScrollerPresenceGroups(0);
setScrollOffsetSeries(1);

setViewableSeries(2);
setScrollOffsetSeries(2);

Since there are only five series in the data that defines this graph, setViewableSeries(3) and setScrollOffsetSeries(3) results in only two series remaining in the chart.

NOTE:

ALSO SEE:

DataScrollerPresenceSeries, ViewableSeries, ScrollOffsetGroup

SeriesAreRows

When this property is enabled (true), series values are stored as rows. When it is disabled (false), series values are stored as columns.

DATA TYPE:

boolean

RANGE:

true / false; true = Series are stored as rows, false = Series are stored as columns

DEFAULT:

true

SYNTAX:

void setSeriesAreRows(boolean newValue);
boolean setSeriesAreRows();

EXAMPLE:

setDepthAngle(0);
setSeriesAreRows(true);
setDepthRadius(0);

setSeriesAreRows(false);

ALSO SEE:

ReverseSeries, ReverseGroups

UseSampleData

This property enables (true) / disables (false) the use of sample data in a chart.

DATA TYPE:

boolean

RANGE:

true / false; true = Use sample data, false = Do not use sample data. Use the data provided by the setData() methods or other data interface

DEFAULT:

true

SYNTAX:

void setUseSampleData(boolean newValue);
boolean getUseSampleData();

EXAMPLE:

setUseSampleData(false);
setData(0,0,10);
setData(0,1,20);
setData(0,2,30);
setData(1,0,11);
setData(1,1,22);
setData(1,2,33);
setDataRangeToExtent();
setDepthAngle(0);
setDepthRadius(0);

NOTE:

If this property is false, your application must provide all property settings (including the GraphType) and all data values that define the chart.

ValidGroupsMin

This property controls the minimum number of groups that can be used to draw a chart. If ViewableGroups is set to a value lower than the value assigned to ValidGroupsMin, the "Not Enough Data To Draw Chart" message will be generated.

DATA TYPE:

integer

RANGE:

Any positive integer

DEFAULT:

1

SYNTAX:

void setViewableGroupsMin(int newValue);
int getViewableGroupsMin();

EXAMPLE:

setDepthAngle(0);
setViewableSeries(3);
setValidSeriesMin(3);
setCurveFitNumSegments(100);
setValidGroupsMin(3);
setViewableGroups(3);
setDepthRadius(0);

ALSO SEE:

ViewableGroups

ValidSeriesMin

This property controls the minimum number of series that can be used to draw a chart. If ViewableSeries is set to a value lower than the value assigned to ValidSeriesMin, the "Not Enough Data To Draw Chart" message will be generated.

DATA TYPE:

integer

RANGE:

Any positive integer

DEFAULT:

1

SYNTAX:

void setValidSeriesMin(int newValue);
int getValidSeriesMin();

EXAMPLE:

setDepthAngle(0);
setViewableSeries(3);
setValidSeriesMin(4);
setCurveFitNumSegments(100);
setValidGroupsMin(3);
setViewableGroups(3);
setDepthRadius(0);

ALSO SEE:

ViewableSeries

ViewableGroups

This property selects the number of groups to be made visible in a graph. When this property is set to a value greater than zero, you may use the ScrollOffsetGroups property to define the first group to be made visible.

DATA TYPE:

integer

RANGE:

Zero to the number of groups in the data that defines the graph.

DEFAULT:

0 (Show all Groups)

SYNTAX:

void setViewableGroups(int newValue);
int getViewableGroups();

EXAMPLE:

setViewableGroups(1);
setDataScrollerPresenceGroups(0);
setDepthAngle(0);
setDepthRadius(0);

setViewableGroups(3);

NOTE:

The setDataRange() method can also be used to set the number of groups to be made visible in a graph. It establishes the range of data that will be used in a graph.

ALSO SEE:

ScrollOffsetGroup, ViewableGroupsStock, ViewableSeries, ViewableSeriesStock, setDataRange()

ViewableSeries

This property selects the number of series to be made visible in a graph. When this property is set to a value greater than zero, you may use the ScrollOffsetSeries property to define the first series to be made visible.

DATA TYPE:

integer

RANGE:

Zero to the number of series in the data that defines the graph.

DEFAULT:

0 (Show all Series)

SYNTAX:

void setViewableSeries(int newValue);
int getViewableSeries();

EXAMPLE:

setViewableSeries(3);
setDepthRadius(0);

setViewableSeries(4);

NOTE:

The setDataRange() method can also be used to set the number of series to be made visible in a graph. It establishes the range of data that will be used in a graph.

ALSO SEE:

ScrollOffsetSeries, ViewableGroups, ViewableSeriesStock, setDataRange()

ZoomDirection

This property sets the direction (X-, Y-axis, or both) in which data zooming operations are performed by doZoomIn() and doZoomOut(). If the chart is dual Y-axes and ZoomDirection is zero or two, zooming is done on both the Y1 and Y2 axes.

DATA TYPE:

integer

RANGE:

0...2; 0 = zoom in on both directions (the default), 1 = zoom in on just the X-axis (or ordinal axis if applicable), 2 = zoom in on just the Y-axis

DEFAULT:

Zero

SYNTAX:

void setZoomDirection(int newVaue);
int getZoomDirection();

NOTE:

This property is not currently supported in 3D graph types.

ALSO SEE:

ZoomPercentage, doZoomIn(), doZoomOut()

ZoomPercentage

This property specifies the percentage of data zooming that will done with doZoomIn() and/or doZoomOut(). The ZoomDirection property specifies the direction (X-axis, Y-axis, or both) in which data zooming is performed.

DATA TYPE:

Real (double )

RANGE:

Any real number

DEFAULT:

50.0

SYNTAX:

void setZoomPercentage(double newValue);
double getZoomPercentage();

NOTE:

This property is not currently supported in 3D graph types.

ALSO SEE:

ZoomDirection, doZoomIn(), doZoomOut()