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);
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.
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:
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);
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);
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);
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:
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);
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);
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);
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:
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);
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:
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:
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:
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:
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
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
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
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
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:
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