3D Chart Properties

AutoshadingWalls

This property enables/disables autoshading of the cube walls in a 3D chart. It can be used to enable/disable shading of the 3D cube walls independent of riser shading set by the Autoshading property.

DATA TYPE:

boolean

RANGE:

true / false; true = Enable autoshading, false = Disable autoshading

DEFAULT:

false

SYNTAX:

void setAutoshadingWalls(boolean newValue);
boolean getAutoshadingWalls();

EXAMPLE:

setAutoshading(true);
setAutoshadingWalls(false);

setAutoshading(true);
setAutoshadingWalls(true);

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(double newValue);
double getCubeFocusFactor();

EXAMPLE:

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

setCubeFocusFactor(20);
setCubeViewerZ(13);

NOTE:

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

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 = Enable isometric projection, false = Disable isometric projection

DEFAULT:

false (Disable isometric projection)

SYNTAX:

void setCubeIsometricProjection(boolean newValue);
boolean getCubeIsometricProjection();

EXAMPLE:

setGraphType(0);
setCubeIsometricProjection(true);

setCubeIsometricProjection(false);

ALSO SEE:

CubeFocusFactor

CubeLightSourceX/Y/Z

This properties set the cube light source for the X, Y-, and Z-coordinates (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:

X = 0.0, Y = 40.0, Z = 100.0

SYNTAX:

void setCubeLightSourceX =(double newValue);
double getCubeLightSourceX();
void setCubeLightSourceY =(double newValue);
double getCubeLightSourceY();
void setCubeLightSourceZ =(double newValue);
double getCubeLightSourceZ();

EXAMPLE:

setGraphType(0);
setCubeLightSourceY(60.0);

setCubeLightSourceY(20);

CubePanX/Y

These properties pan the 3D chart cube (in 2D virtual coordinates) in the X and Y directions.

DATA TYPE:

double

RANGE:

0...100

DEFAULT:

X = 39.3, Y = 60.7

SYNTAX:

void setCubePanX(double newValue);
double getCubePanX();
void setCubePanY(double newValue);
double getCubePanY();

EXAMPLE:

setGraphType(0);
setCubePanX(50.0);

setCubePanX(30);

CubeProportional

When a 3D chart type is selected, this property tells the chart to define the axis size proportional to the number of series (false) or groups (true).

DATA TYPE:

boolean

RANGE:

true / false; true = Draw cube proportional to number of groups, false = Draw cube proportional to number of series

DEFAULT:

true

SYNTAX:

setCubeProportional(boolean newValue);
boolean = getCubeProportional();

EXAMPLE:

setGraphType(0);
setCubeProportional(true);

setGraphType(0);
setCubeProportional(false);

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

RANGE:

0...2; 0 = Use isometric projection for large dataset only, 1 = Isometric only, 2 = Never

DEFAULT:

Zero

SYNTAX:

void setCubeRiserInterpolation(int newValue);
int getCubeRiserInterpolation();

ALSO SEE:

CubeIsometricProjection

CubeSizeX/Y/Z

These properties get/set the size of the 3D cube in the (user) X-, Y- and Z-direction. The dimensions are expressed in Perspective for Java Virtual Coordinates.

DATA TYPE:

double

RANGE:

0...100

DEFAULT:

X = 30.0, Y = 25.0, Z = 30.0

SYNTAX:

void setCubeSizeX(double newValue);
double getCubeSizeX();
void setCubeSizeY(double newValue);
double getCubeSizeY();
void setCubeSizeZ(double newValue);
double getCubeSizeZ();

EXAMPLE:

setCubeSizeX(40.0);
setGraphType(0);

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 = Force risers to be square, false = Do not force risers to be square

DEFAULT:

true

SYNTAX:

void setCubeSquareRisers(boolean newValue);
boolean getCubeSquareRisers();

EXAMPLE:

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

setCubeSquareRisers(false);

CubeTranslationX/Y/Z

These properties get/set the translation of a 3D cube (in 3D cube coordinates) in the X-, Y-, and Z-directions. Smaller CubeTranslationX 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. Smaller CubeTranslationY values move the cube down within the chart frame. Larger values move the cube up toward the top of the chart frame. Smaller CubeTranslationZ 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:

X = 65.0, Y = 42.5, Z = 50.0

SYNTAX:

void setCubeTranslationX(double newValue);
double getCubeTranslationX();
void setCubeTranslationY(double newValue);
double getCubeTranslationY();
void setCubeTranslationZ(double newValue);
double getCubeTranslationZ();

EXAMPLE:

setCubeTranslationX(75.0);
setGraphType(0);

setCubeTranslationX(50);

CubeViewerX/Y/Z

These properties get/set the viewer location (in 3D coordinates) in the X-, Y, and Z-directions. Smaller CubeViewerX 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. Smaller CubeViewerY values move the cube up toward the top of the chart frame. Larger values moves the cube down within the chart frame. Smaller CubeViewerZ 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:

X = 50.0, Y = 60.0, Z = 36.8

SYNTAX:

void setCubeViewerX(double newValue);
double getCubeViewerX();
void setCubeViewerY(double newValue);
double getCubeViewerY();
void setCubeViewerZ(double newValue);
double getCubeViewerZ();

EXAMPLE:

setGraphType(0);
setCubeViewerZ(15.0);

setCubeViewerZ(75.0);

ALSO SEE:

CubeFocusFactor

CubeWallThickX/Y/Z

These properties get/set the thickness of the 3D-cube walls in the (user) X-, Y-, and Z-directions. CubeWallThickX controls the thickness of the left wall of the 3D cube. CubeWallThickY controls the thickness of the floor of the 3D cube. CubeWallThickZ controls the thickness of the right wall of the 3D cube.

DATA TYPE:

double

RANGE:

0...100

DEFAULT:

20.0

SYNTAX:

void setCubeWallThickX(double newValue);
double getCubeWallThickX();
void setCubeWallThickY(double newValue);
double getCubeWallThickY();
void setCubeWallThickZ(double newValue);
double getCubeWallThickZ();

EXAMPLE:

setGraphType(0);
setCubeWallThickY(40.0);

setCubeWallThickY(80.0);

CubeZoomFactor

This property gets/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:

void setCubeZoomFactor(double newValue);
double getCubeZoomFactor();

EXAMPLE:

setGraphType(0);
setCubeZoomFactor(25);

setCubeZoomFactor(40);

ALSO SEE:

CubeFocusFactor

Display3DFloor

This property enables / disables drawing of the cube floor in a 3D chart.

DATA TYPE:

boolean

RANGE:

true / false; true = Draw cube floor, false = Do not draw cube floor

DEFAULT:

true

SYNTAX:

void setDisplay3DFloor(boolean newValue);
boolean getDisplay3DFloor();

EXAMPLE:

setGraphType(4);
setDisplay3DFloor(true);

setDisplay3DFloor(false);

NOTE:

This property only applies to 3D graph types. It will be ignored if any other chart type is selected.

ALSO SEE:

Display3DLeftWall, Display3DRightWall

Display3DLeftWall

This property enables / disables drawing of the cube left wall in a 3D chart.

DATA TYPE:

boolean

RANGE:

true / false; Show (true) / Hide (false) left wall of 3D cube

DEFAULT:

true

SYNTAX:

void setDisplay3DLeftWall(boolean newValue);
boolean getDisplay3DLeftWall();

EXAMPLE:

setDisplay3DLeftWall(true);
setGraphType(4);

setDisplay3DLeftWall(false);

NOTE:

This property only applies to 3D graph types. It will be ignored if any other chart type is selected.

ALSO SEE:

Display3DFloor, Display3DRightWall

Display3DRightWall

This property enables/disables drawing of the cube right wall in a 3D chart.

DATA TYPE:

boolean

RANGE:

true / false; Show (true) / Hide (false) right wall of 3D cube

DEFAULT:

true

SYNTAX:

void setDisplay3DRightWall(boolean newValue);
boolean getDisplay3DRightWall();

EXAMPLE:

setDisplay3DLeftWall(true);
setGraphType(4);

setDisplay3DLeftWall(false);

NOTE:

This property only applies to 3D graph types. It will be ignored if any other chart type is selected.

ALSO SEE:

Display3DLeftWall, Display3DFloor

Grid3DFloorDisplayX/Z

When a 3D chart is selected with GraphType, these properties enable (true)/disable (false) X- and Z-axis grid lines on the 3D cube floor.

DATA TYPE:

boolean

RANGE:

true / false; true = Draw grid lines, false = Do not draw grid lines

DEFAULT:

false

SYNTAX:

void setGrid3DFloorDisplayX(boolean newValue);
boolean get3DFloorDisplayX();
void setGrid3DFloorDisplayZ(boolean newValue);
boolean get3DFloorDisplayZ();

EXAMPLE:

setGrid3DFloorDisplayX(true);
setGraphType(4);
setAutoshading(false);

setGrid3DFloorDisplayZ(true);
setGraphType(4);
setAutoshading(false);

ALSO SEE:

Grid3DLeftWallDisplayY/Z, Grid3DRightWallDisplayX/Y, Grid3DRiserDisplayX/Y/Z

Grid3DLeftWallDisplayY/Z

When a 3D chart is selected with GraphType, these properties enable (true) / disable (false) Y- and Z-axis grid lines on the 3D cube left wall.

DATA TYPE:

boolean

RANGE:

true / false; true = Draw grid lines, false = Do not draw grid lines

DEFAULT:

false

SYNTAX:

void setGrid3DLeftWallDisplayY(boolean newValue);
boolean getGrid3DLeftWallDisplayY();
void setGrid3DLeftWallDisplayZ(boolean newValue);
boolean getGrid3DLeftWallDisplayZ();

EXAMPLE:

setGraphType(4);
setGrid3DLeftWallDisplayY(true);
setAutoshading(false);

setGraphType(4);
setGrid3DLeftWallDisplayZ(true);
setAutoshading(false);

ALSO SEE:

Grid3DFloorDisplayX/Z, Grid3DRightWallDisplayX/Y, Grid3DRiserDisplayX/Y/Z

Grid3DRightWallDisplayX/Y

When a 3D chart is selected with GraphType, these properties enable (true)/ disable (false) X- and Y-axis grid lines on the right wall of the 3D cube.

DATA TYPE:

boolean

RANGE:

true / false; true = Draw grid lines, false = Do not draw grid lines

DEFAULT:

false

SYNTAX:

void setGrid3DRightWallDisplayX(boolean newValue);
boolean getGrid3DRightWallDisplayX();
void setGrid3DRightWallDisplayY(boolean newValue);
boolean getGrid3DRightWallDisplayY();

EXAMPLE:

setGraphType(4);
setGrid3DRightWallDisplayX(true);
setAutoshading(false);

setGraphType(4);
setGrid3DRightWallDisplayY(true);
setAutoshading(false);

ALSO SEE:

Grid3DFloorDisplayX/Z, Grid3DLeftWallDisplayY/Z, Grid3DRiserDisplayX/Y/Z

Grid3DRiserDisplayX/Y/Z

When a 3D chart is selected with GraphType, these property enable (true) / disable (false) X-, Y-, and Z-axis grid lines on the risers in a 3D chart.

DATA TYPE:

boolean

RANGE:

true / false; true = Draw grid lines, false = Do not draw grid lines

DEFAULT:

false

SYNTAX:

void setGrid3DRiserDisplayX(boolean newValue);
boolean getGrid3DRiserDisplayX();
void setGrid3DRiserDisplayY(boolean newValue);
boolean getGrid3DRiserDisplayY();
void setGrid3DRiserDisplayZ(boolean newValue);
boolean getGrid3DRiserDisplayZ();

EXAMPLE:

setGrid3DRiserDisplayY(true);
setGraphType(1);

setGrid3DRiserDisplayZ(true);
setGraphType(12);

ALSO SEE:

Grid3DFloorDisplayX/Z, Grid3DLeftWallDisplayY/Z, Grid3DRightWallDisplayX/Y

Riser3DThicknessY

This property determines the thickness of risers in 3D ribbon, floating cube, and floating pyramid graphs. It is used in combination with CubeSquareRisers and RiserWidth to set the X-, Z-, and Y-thickness of the risers (ribbons, cube, or pyramids).

DATA TYPE:

integer

RANGE:

1...100

DEFAULT:

75

SYNTAX:

void setRiser3DThicknessY(int newValue);
int getRiser3DThicknessY();

EXAMPLE:

setGraphType(4);
setRiser3DThicknessY(100);
setAutoshading(false);
setO2LabelAutofit(true);

setRiser3DThicknessY(25);

NOTE:

A 3D Ribbon, Floating Cube, or Floating Pyramid graph type must be selected.

ALSO SEE:

RiserWidth, CubeSquareRisers

Viewing3DAnglePreset

This property selects an entry in the table of "preset" viewing angles for 3D graphs.

DATA TYPE:

integer

RANGE:

-1...15

Viewing3DAnglePreset Value

Description

-1 =

Custom (as set by CubeViewerX/Y/Z, CubeWallThickX/Y/Z, etc.)

0=

Standard

1=

View Along Groups

2=

View Along Series

3=

Distorted

4=

Isometric Standard

5=

Distorted Standard

6=

Group Emphasis

7=

Blast-O-Vision

8=

Thin Wall Standard

9=

Isometric View Along Groups

10=

Isometric View Along Groups #2

11=

High Backed Standard

12=

Upwardly Distorted

13=

Downtilt Standard

14=

Narrow Isometric

15=

Isometric View Along Groups

DEFAULT:

0 (Standard)

SYNTAX:

void setViewing3DAnglePreset(int newValue);
int getViewing3DAnglePreset();

NOTE:

This property only affects 3D graphs. This property must be set to -1 (custom) in order for most Cube... properties to be applied to the graph.

ALSO SEE:

Examples in the Perspective for Java Programmer's Manual, CubeFocusFactor, CubeIsometricProjection, CubeLightSourceX/Y/Z, CubePanX/Y, CubeSizeX/Y/Z, CubeSquareRisers, CubeTranslationX/Y/Z, CubeViewerX/Y/Z, CubeWallThickX/Y/Z, CubeZoomFactor