ColorMode

 

This property sets the color mode to be used in the chart (automatic, color-by-series, or color-by-group). For 3D Surface charts, automatic mode (0) will cause the chart to be colored by height. For Bar, Line, and Area charts, automatic mode (0) will color the chart by series if there is more than one series or by groups if there is only one series.

Data Type:

integer

Range:

0...2

 

0=

Automatic. Use the group as the series if there is only one series. 3D Connected Series Ribbon and Areas are colored by series. 3D Group Ribbon and Areas are colored by group.

 

1=

Color by Series

 

2=

Color by Group

Default:

0 (Automatic)

Syntax:

setColorMode ( value );

 

value = getColorMode();

Example:

perspective1.setDepthRadius(0);
perspective1.setViewableGroups(4);
perspective1.setViewableSeries(4);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setLegendDisplay(false);
perspective1.setO1LabelDisplay(false);
perspective1.setColorMode(2);

 

 

perspective1.setColorMode(1);

 

Notes:

When color by group (setColorMode(2);) is selected, the legend is always automatically turned off.

Also See:

ExactColorByHeight, getColorByHeight(), getEffectiveColorMode()

ConnectLineMarkers

 

For horizontal or vertical line charts where 2.5D depth effect is not applied (i.e., DepthRadius=0), this property enables/disables the display of lines that connect markers in the chart. Setting this to property to false will produce a "floating marker" effect with only markers and no connecting lines. Use the MarkerSizeDefault property to set the size of the markers.

Data Type:

boolean

Range:

true (draw connecting lines) / false (do not draw connecting lines)

Default:

true (draw connecting lines)

Syntax:

setConnectLineMarkers ( true | false );

 

boolean = getConnectLineMarkers();

Example:

perspective1.setDepthRadius(0);
perspective1.setMarkerSizeDefault(60);
perspective1.setConnectLineMarkers(true);
perspective1.setGraphType(41);

 

 

perspective1.setConnectLineMarkers(false);

 

Notes:

A vertical or horizontal line chart must be selected with the GraphType property and the DepthRadius property must be set to zero.

Also See:

ConnectScatterMarkers, DepthAngle, DepthRadius, MarkerSizeDefault

ConnectScatterMarkers

 

This property enables/disables the display of connecting lines between markers in a scatter chart. Setting this property to true draws a line connecting all markers in the same series in the order the points are in the data matrix. The color of each line matches the color of the series marker. You can use the MarkerSizeDefault property to set the size of the markers.

Data Type:

boolean

Range:

true (draw connecting lines) / false (do not draw connecting lines)

Default:

false (do not draw connecting lines)

Syntax:

setConnectScatterMarkers ( true | false );

 

boolean = getConnectScatterMarkers();

Example:

perspective1.setMarkerSizeDefault(60);
perspective1.setGraphType(61);
perspective1.setConnectScatterMarkers(true);

 

 

perspective1.setConnectScatterMarkers(false);

 

Notes:

A scatter chart must be selected with the GraphType property.

Also See:

ConnectLineMarkers, DepthRadius, MarkerSizeDefault

CubeFocusFactor

 

This property sets the focus factor for setting perspective distortion in a 3D chart. It is used in conjunction with the CubeViewer... properties to control the field of view of the cube within the chart frame.

Data Type:

double

Range:

1...100

Default:

50.0

Syntax:

setCubeFocusFactor ( value );

 

value = getCubeFocusFactor();

Example:

perspective1.setGraphType(0);
perspective1.setCubeViewerZ(93.0);
perspective1.setCubeFocusFactor(95.0);

 

 

perspective1.setCubeFocusFactor(20);
perspective1.setCubeViewerZ(13);

 

Notes:

If CubeIsometricProjection is set to true, this property will be ignored.

Also See:

CubeIsometricProjection, CubeViewerX, CubeViewerY, CubeViewerZ

CubeIsometricProjection

 

This property enables (true) / disables (false) isometric projection. When this property is set to true, perspective distortion (focus) factor is ignored and the graph cube is projected isometric-ly (i.e., no line of sight perspective distortion, but perfectly parallel lines, like a mechanical drawing).

Data Type:

boolean

Range:

true / false

 

true=

Enable isometric projection

 

false=

Disable isometric projection

Default:

false (Disable isometric projection)

Syntax:

setCubeIsometricProjection ( true | false );

 

boolean = getCubeIsometricProjection();

Example:

perspective1.setGraphType(0);
perspective1.setCubeIsometricProjection(true);

 

 

perspective1.setCubeIsometricProjection(false);

 

Also See:

CubeFocusFactor

CubeLightSourceX

 

This property sets the cube light source for the X-coordinate (unit space). In the typical configuration/view, larger values make the face of the left wall cube a lighter color. This property is ignored if Autoshading is set to false.

Data Type:

double

Range:

1...100

Default:

0.0

Syntax:

setCubeLightSourceX = ( value );

 

value = getCubeLightSourceX();

Example:

perspective1.setGraphType(0);
perspective1.setCubeLightSourceX(50.0);

 

 

perspective1.setCubeLightSourceX(10);

 

Also See:

CubeLightSourceY, CubeLightSourceZ

CubeLightSourceY

 

This property sets the cube light source for the Y-coordinate (unit space).

Data Type:

double

Range:

1...100

Default:

40.0

Syntax:

setCubeLightSourceY = ( value );

 

value = getCubeLightSourceY();

Example:

perspective1.setGraphType(0);
perspective1.setCubeLightSourceY(60.0);

 

 

perspective1.setCubeLightSourceY(20);

 

Also See:

CubeLightSourceX, CubeLightSourceZ

CubeLightSourceZ

 

This property sets the cube light source for the Z-coordinate (unit space).

Data Type:

double

Range:

1...100

Default:

100.0

Syntax:

setCubeLightSourceZ = ( value );

 

value = getCubeLightSourceZ();

Example:

perspective1.setGraphType(0);
perspective1.setCubeLightSourceZ(80.0);

 

 

perspective1.setCubeLightSourceZ(40.0);

 

Also See:

CubeLightSourceX, CubeLightSourceY

CubePanX

 

This property pans the chart (in 2D virtual coordinates) in the X direction. Before you use this property, the GraphType property must select one of the 3D chart types (0...7, 9...10, 12...14).

Data Type:

double

Range:

0...100

Default:

39.3

Syntax:

setCubePanX ( value );

 

value = getCubePanX ();

Example:

perspective1.setGraphType(0);
perspective1.setCubePanX(50.0);

 

 

perspective1.setCubePanX(30);

 

Also See:

CubePanY

CubePanY

 

This property pans the chart (in 2D virtual coordinates) in the Y direction. Before you use this property, the GraphType property must select one of the 3D chart types (0...7, 9...10, 12...14).

Data Type:

double

Range:

0...100

Default:

60.7

Syntax:

setCubePanY ( value );

 

value = getCubePanY ();

Example:

perspective1.setGraphType(0);
perspective1.setCubePanY(65.0);

 

 

perspective1.setCubePanY(50);

 

Also See:

CubePanX

CubeRiserInterpolation

 

This property controls whether risers in 3D charts are interpolated (faster) or explicitly calculated (more accurate). For isometric projections (CubeIsometricProjection is TRUE), the results are the same, so it is always OK to use interpolation. When perspective projection is used (CubeIsometricProjection is FALSE), users with very large datasets may want to turn this on for faster calculations.

Data Type:

integer

 

0=

Use isometric projection for large dataset only

 

1=

Isometric only

 

2=

Never

Default:

Zero

Syntax:

setCubeRiserInterpolation ( value );

 

value = getCubeRiserInterpolation();

Also See:

CubeIsometricProjection

 

 

CubeSizeX

 

This property gets and sets the size of the 3D cube in the (user)
X-direction. Before you use this property, the GraphType property must select one of the 3D chart types (0...7, 9...10, 12...14). The dimensions are expressed in Perspective for Java Virtual Coordinates. See
Chapter 3.

Data Type:

double

Range:

0...100

Default:

30.0

Syntax:

setCubeSizeX ( value );

 

value = getCubeSizeX();

Example:

perspective1.setCubeSizeX(40.0);
perspective1.setGraphType(0);

 

 

perspective1.setCubeSizeX(15.0);

 

Also See:

CubeSizeY, CubeSizeZ

CubeSizeY

 

This property gets and sets the size of the 3D cube in the (user)
Y-direction. Before you use this property, the GraphType property must select one of the 3D chart types (0...7, 9...10, 12...14). The dimensions are expressed in Perspective for Java Virtual Coordinates. See
Chapter 3.

Data Type:

double

Range:

0...100

Default:

25.0

Syntax:

setCubeSizeY ( value );

 

value = getCubeSizeY();

Example:

perspective1.setCubeSizeY(40.0);
perspective1.setGraphType(0);

 

 

perspective1.setCubeSizeY(10);

 

Also See:

CubeSizeX, CubeSizeZ

CubeSizeZ

 

This property gets and sets the size of the 3D cube in the (user)
Z-direction. Before you use this property, the GraphType property must select one of the 3D chart types (0...7, 9...10, 12...14). The dimensions are expressed in Perspective for Java Virtual Coordinates. See
Chapter 3.

Data Type:

double

Range:

0...100

Default:

30.0

Syntax:

setCubeSizeZ ( value );

 

value = getCubeSizeZ();

Example:

perspective1.setCubeSizeZ(40.0);
perspective1.setGraphType(0);

 

 

perspective1.setCubeSizeZ(15.0);

 

Also See:

CubeSizeX, CubeSizeY

CubeSquareRisers

 

This property enables (true) / disables (false) square risers. If true, this property forces the aspect ratio of 3D risers to be perfectly square regardless of the dimensions of the cube. If this property is set to false, risers will be drawn using the RiserWidth property and the aspect ratio of the cube. For ribbons and floating graph types, the Riser3DThicknessY property determines the height of the risers.

Data Type:

boolean

Range:

true / false

 

true=

Force risers to be square

 

false=

Do not force risers to be square

Default:

true

Syntax:

setCubeSquareRisers ( true | false );

 

boolean = getCubeSquareRisers ();

Example:

perspective1.setCubeSquareRisers(true);
perspective1.setGraphType(0);
perspective1.setViewing3DAnglePreset(1);

 

 

perspective1.setCubeSquareRisers(false);

 

Also See:

RiserWidth, Riser3DThicknessY

CubeTranslationX

 

This property sets the translation of a 3D cube (in 3D cube coordinates) in the X-direction. In the typical configuration/view, smaller values move the cube to the left size of the chart frame. Larger values move the cube to the right size of the chart frame.

Data Type:

double

Range:

0...100

Default:

65.0

Syntax:

setCubeTranslationX ( value );

 

value = getCubeTranslationX();

Example:

perspective1.setCubeTranslationX(75.0);
perspective1.setGraphType(0);

 

 

perspective1.setCubeTranslationX(50);

 

Also See:

CubeTranslationY, CubeTranslationZ

CubeTranslationY

 

This property sets the translation of a 3D cube (in 3D cube coordinates) in the Y-direction. In the typical configuration/view, smaller values move the cube down within the chart frame. Larger values move the cube up toward the top of the chart frame.

Data Type:

double

Range:

0...100

Default:

42.5

Syntax:

setCubeTranslationY ( value );

 

value = getCubeTranslationY();

Example:

perspective1.setCubeTranslationY(50.0);
perspective1.setGraphType(0);

 

 

perspective1.setCubeTranslationY(35);

 

Also See:

CubeTranslationX, CubeLightSourceZ

CubeTranslationZ

 

This property sets the translation of a 3D cube (in 3D cube coordinates) in the Z-direction. In the typical configuration/view, smaller values make the cube smaller within the chart frame. Larger values make the cube larger within the chart frame.

Data Type:

double

Range:

0...100

Default:

50.0

Syntax:

setCubeTranslationZ ( value );

 

value = getCubeTranslationZ();

Example:

perspective1.setCubeTranslationZ(85.0);
perspective1.setGraphType(0);

 

 

perspective1.setCubeTranslationZ(15);

 

Also See:

CubeTranslationX, CubeTranslationY

CubeViewerX

 

This property sets the viewer location (in 3D coordinates) in the X-direction. In the typical configuration/view, smaller values move the cube toward the right side of the chart frame. Larger values move the cube toward the left side of the chart frame.

Data Type:

double

Range:

0...100

Default:

50.0

Syntax:

setCubeViewerX ( value );

 

value = getCubeViewerX();

Example:

perspective1.setGraphType(0);
perspective1.setCubeViewerX(25.0);

 

 

perspective1.setCubeViewerX(75.0);

 

Also See:

CubeViewerY, CubeViewerZ

CubeViewerY

 

This property sets the viewer location (in 3D coordinates) in the Y-direction. In the typical configuration/view, smaller values move the cube up toward the top of the chart frame. Larger values moves the cube down within the chart frame.

Data Type:

double

Range:

0...100

Default:

60.0

Syntax:

setCubeViewerY ( value );

 

value = getCubeViewerY();

Example:

perspective1.setGraphType(0);
perspective1.setCubeViewerY(80.0);

 

 

perspective1.setCubeViewerY(40);

 

Also See:

CubeViewerX, CubeViewerZ

CubeViewerZ

 

This property sets the viewer location (in 3D coordinates) in the Z-direction. Smaller values make the cube larger within the frame, larger values make the cube smaller within the chart frame.

Data Type:

double

Range:

0...100

Default:

36.8

Syntax:

setCubeViewerZ ( value );

 

value = getCubeViewerZ();

Example:

perspective1.setGraphType(0);
perspective1.setCubeViewerZ(15.0);

 

 

perspective1.setCubeViewerZ(75.0);

 

Also See:

CubeFocusFactor, CubeViewerX, CubeViewerY

CubeWallThickX

 

This property sets the thickness of the 3D-cube wall in the (user) X-direction. In the typical configuration/view of a 3D chart, this property controls the thickness of the left wall of the 3D cube.

Data Type:

double

Range:

0...100

Default:

20.0

Syntax:

setCubeWallThickX ( value );

 

value = getCubeWallThickX ();

Example:

perspective1.setGraphType(0);
perspective1.setCubeWallThickX(80.0);

 

 

perspective1.setCubeWallThickX(10.0);

 

Also See:

CubeWallThickY, CubeWallThickZ

CubeWallThickY

 

This property gets and sets the thickness of the 3D-cube wall in the (user) Y-direction. In the typical configuration/view of a 3D chart, this property controls the thickness of the floor of the 3D cube.

Data Type:

double

Range:

0...100

Default:

20.0

Syntax:

setCubeWallThickY ( value );

 

value = getCubeWallThickY ();

Example:

perspective1.setGraphType(0);
perspective1.setCubeWallThickY(40.0);

 

 

perspective1.setCubeWallThickY(80.0);

 

Also See:

CubeWallThickX, CubeWallThickZ

CubeWallThickZ

 

This property gets and sets the thickness of the 3D cube wall in the (user) Z-direction. In the typical configuration/view of a 3D chart, this property controls the thickness of the left wall of the 3D cube.

Data Type:

double

Range:

0...100

Default:

20.0

Syntax:

setCubeWallThickZ ( value );

 

value = getCubeWallThickZ ();

Example:

perspective1.setGraphType(0);
perspective1.setCubeWallThickZ(40.0);

 

 

perspective1.setCubeWallThickZ(80.0);

 

Also See:

CubeWallThickX, CubeWallThickY

CubeZoomFactor

 

This property sets the global scaling factor for zooming in/out. Values greater than one, zoom in and produce a large display of the chart within the frame. Values between zero and one zoom out and produce a smaller display of the chart within the frame.

Data Type:

double

Range:

0...100

Default:

50.0

Syntax:

setCubeZoomFactor ( value );

 

value = getCubeZoomFactor ();

Example:

perspective1.setGraphType(0);
perspective1.setCubeZoomFactor(25);

 

 

perspective1.setCubeZoomFactor(40);

 

Also See:

CubeFocusFactor

CurveFitEquationDisplay

 

The value assigned to this property determines whether the equation associated with a curve fit line is displayed. The curve fit line is drawn by the setCurveFitType() method.

Data Type:

boolean

Range:

true/false

 

true =

Show equation with the curve fit line

 

false =

Do not show equation

Default:

true

Syntax:

setCurveFitEquationDisplay ( true | false );

 

boolean = getCurveFitEquationDisplay();

Example:

perspective1.setDepthAngle(0);
perspective1.setCurveFitEquationDisplay(true);
perspective1.setCurveFitType(1,1);
perspective1.setDepthRadius(0);

 

 

perspective1.setCurveFitEquationDisplay(true);

 

Also See:

CurveFitHighOrderFirst, getCurveFitType(), setCurveFitType()

 

 

CurveFitHighOrderFirst

 

When a curve fit equation is displayed with the CurveFitEquationDisplay property, this property determines the order of terms for equation text (TRUE: ax + b; FALSE: b + ax)

Data Type:

boolean

Range:

true/false

 

true =

ax + b

 

false =

b + ax

Default:

true

Syntax:

setCurveFitHighOrderFirst ( true | false );

 

boolean = getCurveFitHighOrderFirst();

Example:

perspective1.setCurveFitType(1,1);
perspective1.setCurveFitHighOrderFirst(true);

 

 

perspective1.setCurveFitHighOrderFirst(false);

 

Also See:

CurveFitEquationDisplay

 

 

CurveFitNumSegments

 

This property determines the number of interpolated points to calculate to draw a curve fit line. The curve fit line is enabled/disabled with the setCurveFitType() method.

Data Type:

integer

Range:

Any integer. Larger values will draw a smoother line.

Default:

50

Syntax:

setCurveFitNumSegments ( value );

 

value = getCurveFitNumSegments();

Example:

perspective1.setDepthAngle(0);
perspective1.setViewableSeries(4);
perspective1.setCurveFitNumSegments(100);
perspective1.setCurveFitType(1,1);
perspective1.setViewableGroups(3);
perspective1.setDepthRadius(0);

 

Also See:

setCurveFitType()