ToolTipDelay / Display / Mode


Description:
 

The ToolTipDelay property gets/sets the delay (in milliseconds) at which tool tips (CharTips and WidgeTips) will be displayed when the ToolTipDisplay property is set to true.

The ToolTipDisplay property enables/disables the display of tool tips.

The ToolTipMode property toggles CharTips between explicit developer information and user level information.

Data Type:
 

ToolTipDelay: Real
ToolTipDisplay: Boolean
ToolTipMode: Boolean

Valid Range:
 

ToolTipDelay: Any real number
ToolTipDisplay: true (display tool tips) / false (do not display tool tips)
ToolTipMode: false (user information) / true (developer information)

Default Value:
 

ToolTipDelay: 500
ToolTipDisplay: false (do not display tool tips)
ToolTipMode: false (display user information when ToopTipDisplay is true)

Example:
 

setToolTipDisplay( true );

Syntax:
 

setToolTipDelay ( value );
value = getToolTipDelay();

setToolTipDisplay ( true | false );
boolean = getToolTipDisplay ();

setToolTipMode ( true | false );
boolean = getToolTipMode();

Also See:
 

get/setToolTipCustomString() and setToolTipUser() methods in Chapter 8.

UseOffScreen


Description:

 

This property controls whether the chart will be drawn directly to the graphics device (true) or using an off-screen image buffer (false). Set this property to false when the drawing speed of the chart seems very slow. When this property is set to false, it can increase the drawing speed by a factor of three in some situations.

Data Type:

 

Boolean

Valid Range:

 

true (draw directly to graphics device) / false (use off screen image buffer)

Default Value:

 

false

Syntax:

 

setUseOffScreen ( true| false );
boolean = getOffScreen ();

UseSampleData


Description:
 

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

Data Type:
 

Boolean

Valid Range:
 

true (use sample data) / false (do not use sample data)

Default Value:
 

true

Syntax:
 

setUseSampleData ( true| false );
boolean = getUseSampleData();

Code Sample:
 

/* A basic extension of the java.applet.Applet class */
import java.awt.*;
import java.applet.*;
import TDG.Perspective;
public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setUseSampleData(false);
perspective1.setGraphType(17);
perspective1.setData(0,1,1);
perspective1.setData(0,2,2);
perspective1.setData(0,3,3);
perspective1.setData(0,4,4);
perspective1.setData(1,1,11);
perspective1.setData(1,2,12);
perspective1.setData(1,3,13);
perspective1.setData(1,4,14);
perspective1.setData(2,1,21);
perspective1.setData(2,2,22);
perspective1.setData(2,3,23);
perspective1.setData(2,4,24);
perspective1.setData(3,1,31);
perspective1.setData(3,2,32);
perspective1.setData(3,3,33);
perspective1.setData(3,4,34);
perspective1.setData(4,1,41);
perspective1.setData(4,2,42);
perspective1.setData(4,3,43);
perspective1.setData(4,4,44);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Also See:
 

"Default Values and Sample Data" in Chapter 3.

UseSeriesShapes


Description:
 

This property enables/disables the use of the shapes defined by the getMarkerTemplate() method for the legend icons.

Data Type:
 

Boolean

Valid Range:
 

true/false

 

true (Use getMarkerTemplate() shapes)
false (Do not use getMarkerTemplate() shapes)

Default Value:
 

false

Example:

setUseSeriesShapes ( false );

setUseSeriesShapes ( true );

Syntax:
 

setUseSeriesShapes ( true | false ); / boolean = getUseSeriesShapes();

Also See:
 

LegendDisplay, LegendMarkerPosition, LegendReverse, LegendTextAutofit, and the get/setMarkerShape(), get/setMarkerSize(), get/setMarkerTemplate(), get/setMarkerTemplateIndex() methods in Chapter 8

Viewing3DAnglePreset


Description:
 

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

Data Type:
 

Integer

Valid Range:
 

-1...15

 

Value

Description

-1

Custom

0

Standard

1

Tall and Skinny

2

From the Top

3

Distorted

4

Short and Fat

5

Group's Eye

6

Group Emphasis

7

Few Series

8

Few Groups

9

Distorted Standard

10

Shorted and Fatter

11

Thick Wall for Series

12

Thick Wall Standard

13

California Special

14

Blast-O-Vision

Default Value:
 

-1 (Custom)

Example:

setViewing3DAnglePreset ( 3 );

setViewing3DAnglePreset ( 5 );

Syntax:
 

setViewing3DAnglePreset ( value );
value = getViewing3DAnglePreset ();

Notes:
 

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:
 

CubeFocusFactor, CubeIsometricProjection, CubeLightSourceX/Y/Z, CubePanX/Y, CubeSizeX/Y/Z, CubeSquareRisers, CubeTranslationX/Y/Z, CubeViewerX/Y/Z, CubeWallThickX/Y/Z, CubeZoomFactor, and the GraphType property to select a 3D graph.

X1AxisDescending


Description:
 

This property is used to change the direction of the X-axis. When false, values ascend normally -- from left to right on the X-axis. When true, values are reversed and descend from left-to-right on the graph. Note that this property also reverses the order of the axis labels and changes all data-related objects (e.g., markers) from their previous state.

Data Type:
 

Boolean

Valid Range:
 

true /false

 

true = Descending values (scale labels are reversed in order)
false = Ascending values ("normal" axis)

Default Value:
 

false

Example:

setX1AxisDescending ( true );

setX1AxisDescending ( false );

Syntax:
 

setX1AxisDescending ( true | false ); / boolean = getX1AxisDescending();

Code Sample:
 

{
public void init()
{
perspective1 = new TDG.Perspective();
perspective1.setUseSampleData(false);
perspective1.setGraphType(61);
perspective1.setDepthAngle(0);
perspective1.setDepthRadius(0);
perspective1.setMarkerSizeDefault(60);
perspective1.setX1AxisDescending(false);
.
.
.
}
TDG.Perspective perspective1;
}

Also See:
 

get/setAxisDescending() in Chapter 8.

X1AxisLineDisplay


Description:
 

This property enables (true) / disables (false) the display of the X1 axis line.

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Display X1 axis line
false = Do not display X1 axis line

Default Value:
 

false

Example:

setX1AxisLineDisplay ( true );

setX1AxisLineDisplay ( false );

Syntax:
 

setX1AxisLineDisplay( true | false );
boolean = getX1AxisLineDisplay();

Code Sample:
 

id = perspective1.getX1AxisLine();
perspective1.setLineWidth ( id, 10 );
perspective1.setX1AxisLineDisplay(true);

Notes:
 

1.

The location of the line is determined by the X1AxisSide property.

 

2.

In the default configuration for this chart type, the X1AxisLine is the same width and location as the bottom of the chart frame. When this line size is used, the setting of this property does not change the appearance of the chart. To make a thicker and more visible axis line, use the getX1AxisLine() method to get the object ID of the line and setLineWidth() method to increase the width of the line.

Also See:
 

X1AxisSide and getX1AxisLine(), setLineWidth(), and get/setAxisSide in Chapter 8.

X1AxisSide


Description:
 

This property controls which side of the graph an X-axis will be imaged.

Data Type:
 

Integer

Valid Range:
 

0...2

   

#

Value

Description

0

Left

Image to low side of graph (bottom or left).

1

Right

Image to high side of graph (top or right).

2

Both

Image to both sides.

Default Value:
 

0 (Left/Bottom)

Example:

setX1AxisSide ( 1 );

setX1AxisSide ( 2 );

Syntax:
 

setX1AxisSide ( value );
value = getX1AxisSide ();

Code Sample:
 

import java.awt.*;
import java.applet.*;
import TDG.Perspective;
public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setUseSampleData(false);
perspective1.setGraphType(61);
perspective1.setMarkerSizeDefault(60);
perspective1.setX1AxisSide(2);
.
.
.
}
TDG.Perspective perspective1;
}

Also See:
 

X1AxisLineDisplay and get/setAxisSide() in Chapter 8.

X1ExcludeMaxLabel / X1ExcludeMinLabel


Description:
 

The X1ExcludeMaxLabel property enables (true) / disables (false) the exclusion of the maximum label on the X1 axis.

The X1ExcludeMinLabel property enables (true) / disables (false) the exclusion of the minimum label on the X1 axis.

Data Type:
 

Boolean

Valid Range:
 

X1ExcludeMaxLabel: true (exclude max label) / false (include max label)
X1ExcludeMinLabel: true (exclude min label) / false (include min label)

Default Value:
 

false (maximum and minimum labels are displayed)

Example:

setX1ExcludeMaxLabel ( true );

setX1ExcludeMaxLabel ( false );

Syntax:
 

setX1ExcludeMaxLabel ( true | false );
boolean = getX1ExcludeMaxLabel ();

setX1ExcludeMinLabel ( true | false );
boolean = getX1ExcludeMinLabel ();

Also See:
 

get/setExcludeMaxLabel() and get/setExcludeMinLabel() in Chapter 8

X1LabelAutofit / Display


Description:
 

The X1LabelAutofit property is used to automatically fit/size all numeric axis labels on the numeric X-axis. When autofitting is enabled (the default), the font size of these objects cannot be changed to a size that is larger than the relative location/size of the object and objects around it. When autofitting is disabled, the font size can be set to any value allowing very large font sizes to overlap other objects in the graph.

The X1LabelDisplay property enables (true) / disables (false) the display of labels on the X-axis.

Data Type:
 

Boolean

Valid Range:
 

X1LabelAutofit: true (autofit labels) / false (do not autofit labels)
X1LabelDisplay: true (display labels) / false (do not display labels)

Default Value:
 

true

Example:

setX1LabelDisplay ( true );

setX1LabelDisplay ( false );

Syntax:
 

setX1LabelAutofit ( true | false );
boolean = getX1LabelAutofit ();

setX1LabelDisplay ( true | false );
boolean = getX1LabelDisplay ();

Notes:
 

When the X1LabelAutofit property is enabled (true), font size changes are ignored. Typically, your user interface should gray-out font size menu selections when this property is enabled.

Also See:
 

X1LabelFormat, X1LabelRotate, X1LabelStagger

X1LabelFormat / X1LabelFormatPattern


Description:
 

When the X1LabelDisplay property is set to true and data value labels are displayed on the X axis, these properties can be used to select the format of the data values. X1LabelFormat can be used to select one of the standard preset formats. X1LabelFormatPatten can be used to specify a standard Java number format pattern.

Data Type:
 

X1LabelFormat: Integer
X1LabelFormatPattern: String

Valid Range:
 

X1LabelFormat: -1...14 (-1 = Use format set by X1LabelFormatPattern)

 

Value

Format

Example

Value

Format

Example

 

0

General

560

8

$0K

$56K

 

1

0

560

9

0M

56M

 

2

0%

56%

10

$0M

$56M

 

3

0.0%

56.6%

11

0B

56B

 

4

0.00%

56.66%

12

$0B

$56B

 

5

$0.00

$56.66

13

0T

56T

 

6

$0

$56

14

$0T

$56T

 

7

0K

56K

     
 

X1LabelFormatPattern: A pattern string in the following format:
pattern:= subpattern{;subpattern}
subpattern:= {prefix}integer{.fraction}{suffix}
prefix:= '\\u0000'..'\\uFFFD' - specialCharacters
suffix:= '\\u0000'..'\\uFFFD' - specialCharacters
integer:= '#'* '0'* '0'
fraction:= '0'* '#'*
See Chapter 3 for more detailed information about this format pattern.

Default Value:
 

X1LabelFormat: 0 (General)
X1LabelFormatPattern: "#,#"

Syntax:
 

setX1LabelFormat ( value );
value = getX1LabelFormat ();
setX1LabelFormatPattern ( patternString );
patternString = getX1LabelFormatFormat ();

Also See:
 

X1LabelAutofit, X1LabelDisplay, X1LabelRotate, X1LabelStagger

X1LabelRotate


Description:
 

This property can be used to rotate labels on the X-axis.

Data Type:
 

Integer

Valid Range:
 

0-2

 

#

Description

0

No text rotation

1

Rotate text 90 degrees (reads top to bottom)

2

Rotate text 270 degrees (reads bottom to top)

Default Value:
 

0 (no text rotation)

Syntax:
 

setX1LabelRotate ( value );
value = getX1LabelRotate ();

Code Sample:
 

/*
A basic extension of the java.applet.Applet class
*/

import java.awt.*;
import java.applet.*;

import TDG.Perspective;
public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setX1LabelRotate(1);
perspective1.setX1LabelStagger(true);
perspective1.setX1ScaleMinAuto(false);
perspective1.setX1OffScaleDisplay(false);
perspective1.setGraphType(85);
perspective1.setX1AxisLineDisplay(false);
perspective1.setX1LabelFormat(2);
perspective1.setX1ScaleMaxAuto(false);
perspective1.setX1TitleString("X1 Axis Title");
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Also See:
 

X1LabelAutofit, X1LabelDisplay, X1LabelFormat, X1LabelStagger

X1LabelStagger


Description:
 

This property specifies whether or not text for this graph axis should be staggered. Staggered labels are drawn in a zig-zag fashion, with labels weaving in and under each other. This property affects all X-axis labels.

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Stagger the labels on the axis
false = Draw them as normal

Default Value:
 

false

Example:

setX1LabelStagger ( true );

setX1LabelStagger ( false );

Syntax:
 

setX1LabelStagger ( true | false );
boolean = getX1LabelStagger();

Code Sample:
 

perspective1.setGraphType(61);
perspective1.setMarkerSizeDefault(60);
perspective1.setX1LabelFormat(2);
perspective1.setX1LabelStagger(true);

Also See:
 

X1LabelAutofit, X1LabelDisplay, X1LabelFormat, X1LabelRotate, and get/setLabelStagger() in Chapter 8.

X1LogScale


Description:
 

This property specifies the scale (logarithmic or linear) for the numeric X-axis. When the scale range is set to automatic, any data items with X1 values less than or equal to zero are graphed as null for log scale. If a manual scale range is specified to include negative values (X1ScaleMin less than or equal to zero), the request for log scale is ignored. X1LogScale is automatically set to false (linear scale).

Data Type:
 

Boolean

Valid Range:
 

true (use logrithmic scale) / false (use linear scale)

Default Value:
 

false

Example:

setX1LogScale ( true );

setX1LogScale ( false );

Syntax:
 

setX1LogScale ( true | false ) / boolean = getX1LogScale ();

Code Sample:
 

public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setUseSampleData(false);
perspective1.setGraphType(61);
perspective1.setMarkerSizeDefault(60);
perspective1.setX1LogScale(false);
perspective1.setData(0,0,10);
perspective1.setData(0,1,11);
perspective1.setData(0,2,12);
perspective1.setData(0,3,13);
perspective1.setData(1,0,20);
perspective1.setData(1,1,21);
perspective1.setData(1,2,22);
perspective1.setData(1,3,23);
perspective1.setData(2,0,30);
perspective1.setData(2,1,31);
perspective1.setData(2,2,32);
perspective1.setData(2,3,33);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}

Also See:
 

get/setLogScale() in Chapter 8

X1MajorGridDisplay


Description:
 

This property controls whether or not major grid lines are displayed on the primary (X1) numeric axis.

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Display X-axis major grid lines
false = Do not display X-axis major grid lines

Default Value:
 

true

Example:

setX1MajorGridDisplay ( true );
setX1MinorGridDisplay( false );

setX1MajorGridDisplay ( false );
setX1MinorGridDisplay ( false );

Syntax:
 

setX1MajorGridDisplay ( true | false );
boolean = getX1MajorGridDisplay ();

Also See:
 

X1MajorGridStyle, X1MinorGridDisplay, X1MinorGridStyle

X1MajorGridStep / X1MajorGridStepAuto


Description:
 

The X1MajorGridStep property can be used to control the number of major grid lines/steps that will be imaged on the X-axis of the chart. For example, grid steps 1, 6, 11, 16, ...51 will be imaged if the range of values in the chart is 1...51 and this property is set to 5. If this property is set to 10, grid steps 1, 11, 21, 31...51 would be displayed. Assigning a value to this property will automatically set the X1MajorGridStepAuto property to false.

The X1MajorGridStepAuto property enables (true) / disables (false) automatic calculation of the number of major grid lines on the numeric X-axis of a chart. When this property is set to true, the value assigned to X1MajorGridStep is ignored. Also see the Notes below.

Data Type:
 

X1MajorGridStep: Real
X1MajorGridStepAuto: Boolean

Valid Range:
 

X1MajorGridStep: Any Positive Real Number (See Notes below)

X1MajorGridStepAuto: true (automatically calculate grid steps) / false (use the value set by X1MajorGridStep)

Default Value:
 

X1MajorGridStep: 10.0
X1MajorGridStepAuto: true

Example:

setX1MajorGridStepAuto ( false );
setX1MajorGridStep ( 2 );

setX1MajorGridStepAuto ( false );
setX1MajorGridStep ( 4 );

Syntax:
 

setX1MajorGridStep ( value );
value = getX1MajorGridStep ();

setX1MajorGridStepAuto ( true | false );
boolean = getX1MajorGridStepAuto ();

Notes:
 

If the value assigned to X1MajorGridStep is negative or results in greater than 50 grid lines, the X1MajorGridStepAuto property is automatically set to true and the X1MajorGridStep value is ignored.

Also See:
 

X1MinorGridStep, X1MinorGridStepAuto, and the get/setGridStep() and get/setGridStepAuto() methods in Chapter 8.

X1MajorGridStyle


Description:
 

This property controls the appearance of major grid lines on the numeric X-axis of a chart.

Data Type:
 

Integer

Valid Range:
 

0...4

 

#

Description

0

Normal grid lines, height of frame

1

Normal grid lines extend beyond the height of frame

2

Small tick marks from frame edge inward

3

Small tick marks from frame edge outward

4

TickIn and TickOut span across the frame edge

Default Value:
 

0 (Normal Grid)

Example:

setX1MajorGridStyle ( 3 );

setX1MajorGridStyle ( 4 );

Syntax:
 

setX1MajorGridStyle ( value );
value = getX1MajorGridStyle ();

Also See:
 

X1MajorGridDisplay, X1MinorGridDisplay, X1MinorGridStyle, and the get/setGridStyle() method in Chapter 8.

X1MinorGridDisplay


Description:
 

This property enables (true) / disables (false) the display of minor grid lines on the X-axis.

Data Type:
 

Boolean

Valid Range:
 

true / false
true=Enable minor grid display / false=Disable minor grid display

Default Value:
 

false

Example:

setX1MajorGridDisplay ( false );
setX1MinorGridDisplay( true );

setX1MajorGridDisplay ( false );
setX1MinorGridDisplay ( false );

Syntax:
 

setX1MinorGridDisplay ( true | false );
boolean = getX1MinorGridDisplay ();

Code Sample:
 

public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setUseSampleData(false);
perspective1.setGraphType(61);
perspective1.setMarkerSizeDefault(60);
perspective1.setX1MajorGridDisplay(false);
perspective1.setX1MinorGridDisplay(true);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Also See:
 

X1MajorGridDisplay, X1MinorGridStep,X1MinorGridStepAuto,X1MinorGridStyle, and the get/setGridStyle() method in Chapter 8.

X1MinorGridStep / X1MinorGridStepAuto


Description:
 

The X1MinorGridStep property sets a number of minor grid steps on the X-axis of the chart. Minor grid lines are drawn between the major grid lines (when they are displayed) and the location of the minor gridlines depend very much on the setting for the major grid lines. When a value is assigned to this property, the X1MinorGridStepAuto property is automatically set to false. If the value assigned to this property results in greater than 50 minor grid lines between each major grid line, the X1MinorGridStepAuto property is automatically set to true.

The X1MinorGridStepAuto property enables/disables automatic grid steps for the X-axis minor grid lines. When this property is set to true, the value assigned to the X1MinorGridStep property is ignored.

Data Type:
 

X1MinorGridStep: Real / X1MinorGridStepAuto: Boolean

Valid Range:
 

X1MinorGridStep: Any Positive Real Number (See Note>

X1MinorGridStepAuto: true ( automatically calculate the number of minor grid steps) / false (use the value set by X1MinorGridStep)

Default Value:
 

X1MinorGridStep: 10.0 / X1MinorGridStepAuto: true

Example:

setX1MinorGridStepAuto ( false );
setX1MinorGridStep ( 3 );

setX1MinorGridStepAuto ( false );
setX1MinorGridStep ( 4 );

Syntax:
 

setX1MinorGridStep ( value ); / value = getX1MinorGridStep ();

setX1MinorGridStepAuto ( true | false );
boolean = getX1MinorGridStepAuto();

Notes:

 

If X1MinorGridStep is set to a negative value or a value that results in greater than 50 minor grid lines between each major grid line, the X1MinorGridStepAuto property is automatically set to true.

Also See:
 

X1MajorGridStep, X1MajorGridStepAuto, X1MinorGridDisplay, X1MinorGridStyle, and the get/setGridStep() and get/setGridStepAuto() methods in Chapter 8.

X1MinorGridStyle


Description:
 

This property controls the appearance of minor grid lines on the numeric X-axis of a chart.

Data Type:
 

Integer

Valid Range:
 

0...4

 

#

Description

0

Normal grid lines, height of frame

1

Normal grid lines extend beyond the height of frame

2

Small tick marks from frame edge inward

3

Small tick marks from frame edge outward

4

TickIn and TickOut span across the frame edge

Default Value:
 

0 (Normal Grid)

Example:

setX1MinorGridStyle( 3 );

setX1MinorGridStyle ( 4 );

Syntax:
 

setX1MinorGridStyle ( value ); / value = getX1MinorGridStyle ();

Code Sample:
 

public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setGraphType(61);
perspective1.setMarkerSizeDefault(60);
perspective1.setX1MajorGridDisplay(false);
perspective1.setX1MinorGridDisplay(true);
perspective1.setX1MinorGridStyle(3);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Also See:
 

X1MinorGridDisplay, X1MinorGridStep,X1MinorGridStepAuto, X1MajorGridStyle, X1MajorGridDisplay, and the get/setGridStyle() method in Chapter 8.

X1MustIncludeZero


Description:
 

This property determines whether or not the chart includes zero. If the logrithmic scale is enabled with X1LogScale(true) or a manual scale range excludes zero (X1ScaleMax and X1ScaleMin are greater than zero), this property is ignored.

Data Type:
 

Boolean

Valid Range:
 

true/false
true = Include Zero / False = Exclude Zero if it is not within the given automatic scale range

Default Value:
 

true

Syntax:
 

setX1MustIncludeZero ( true | false );
boolean = getX1MustIncludeZero ();

Also See:
 

X1ScaleMax, X1ScaleMin, X1ZeroLineDisplay

X1OffScaleDisplay


Description:
 

This property enables/disables the display of values that are out of range by clipping them to fit within the range. When this property is enabled (true), values smaller than or greater than a given range are represented as markers or risers at the scale limit (minimum or maximum). For example, a value of 700 goes beyond the specified range of 250-500, so its marker in a scatter chart would be displayed at the right edge of the chart. When this property is disabled (false), only values that fall directly between a given range are displayed (e.g. in the example above, the 700 marker would be omitted.)

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Display values less than or greater than a given range at the scale limit (minimum or maximum)
false = Only display values that fall between a given range

Default Value:
 

true

Example:

setX1OffScaleDisplay ( false );

setX1OffScaleDisplay ( true );

Syntax:
 

setX1OffScaleDisplay ( true | false );
boolean = getX1OffScaleDisplay ();

Code Sample:
 

perspective1.setMarkerSizeDefault(60);
perspective1.setDepthAngle(0);
perspective1.setX1ScaleMax(60.0);
perspective1.setX1ScaleMinAuto(false);
perspective1.setGraphType(61);
perspective1.setX1ScaleMin(20.0);
perspective1.setX1ScaleMaxAuto(false);
perspective1.setX1OffScaleDisplay(false);

Also See:
 

get/setDisplayOffScale() in Chapter 8

X1ScaleMax / X1ScaleMaxAuto


Description:
 

The X1ScaleMax property specifies the maximum data value that can be used to image the graph and its axis. When a value is assigned to this property, the X1ScaleMaxAuto property is automatically set to false.

The X1ScaleMaxAuto property enables (true) / disables (false) use of the value assigned to the setX1ScaleMax property.

Data Type:
 

X1ScaleMax: Real
X1ScaleMaxAuto: Boolean

Valid Range:
 

X1ScaleMax: Any real value.

X1ScaleMaxAuto: true (automatically calculate maximum scale) / false (use value set by X1ScaleMax)

Default Value:
 

X1ScaleMax: 100.0
X1ScaleMaxAuto: true

Example:

setX1ScaleMaxAuto ( false );
setX1ScaleMax ( 30 );

setX1ScaleMaxAuto ( false );
setX1ScaleMax ( 35 );

Syntax:
 

setX1ScaleMax ( value );
value = getX1ScaleMax ();

setX1ScaleMaxAuto ( true | false );
boolean = getX1ScaleMaxAuto ();

Code Sample:
 

perspective1.setGraphType(61);
perspective1.setMarkerSizeDefault(60);
perspective1.setX1ScaleMaxAuto(false);
perspective1.setX1ScaleMax(30);
perspective1.setX1ScaleMinAuto(false);
perspective1.setX1ScaleMin(20);

Notes:
 

If X1ScaleMax is set to a value less than X1ScaleMin, the values will be automatically switched and and the X1AxisDescending property will be set to true.

Also See:
 

X1ScaleMin, X1ScaleMinAuto, and the get/setScaleMax() and get/setScaleMaxAuto() methods in Chapter 8

X1ScaleMin / X1ScaleMinAuto


Description:
 

The X1ScaleMin property specifies the minimum data value that can be used to manually image the graph and its axis. When a value is assigned to this property, the X1ScaleMinAuto property is automatically set to false.

The X1ScaleMinAuto property enables (true) /disables (false) automatic minimum scaling.

Data Type:
 

X1ScaleMin: Real
X1ScaleMinAuto: Boolean

Valid Range:
 

X1ScaleMin: Any real value

X1ScaleMinAuto: true ( automatically calculate minimum scale) / false (use value set by X1ScaleMin)

Default Value:
 

X1ScaleMin: Zero
X1ScaleMinAuto: true

Example:

setX1ScaleMinAuto ( false );
setX1ScaleMin ( 20 );

setX1ScaleMinAuto ( false );
setX1ScaleMin ( 15 );

Syntax:
 

setX1ScaleMin ( value ); / value = getX1ScaleMin ();

setX1ScaleMinAuto ( true | false ); / boolean = getX1ScaleMinAuto ();

Code Sample:
 

perspective1.setGraphType(61);
perspective1.setMarkerSizeDefault(60);
perspective1.setX1ScaleMaxAuto(false);
perspective1.setX1ScaleMax(30);
perspective1.setX1ScaleMinAuto(false);
perspective1.setX1ScaleMin(20);

Notes:
 

If X1ScaleMax is set to a value less than X1ScaleMin, the values will be automatically switched and and the X1AxisDescending property will be set to true.

Also See:
 

X1ScaleMax, X1ScaleMaxAuto, and the get/setScaleMin() and get/setScaleMinAuto() methods in Chapter 8

X1TitleAutofit / Display / String


Description:
 

The X1TitleAutofit property enables (true) /disables (false) autofitting of the X-axis title that is defined by the X1TitleString property and enabled for display by the X1TitleDisplay property.

The X1TitleDisplay property enables (true) /disables (false) drawing of X-axis title string that is defined by the X1TitleString property.

The X1TitleString property can be used to define the title string for the X-axis in a chart. When a title string is assigned to this property, the X1TitleDisplay property is automatically set to true.

Data Type:
 

X1TitleAutofit: Boolean
X1TitleDisplay: Boolean
X1TitleString: string

Valid Range:
 

X1TitleAutofit: true (autofit X1 Title) / false (do not autofit)
X1TitleDisplay: true (display X1 Title) / false (do not display X1 title)
X1TitleString: Any printable characters

Default Value:
 

X1TitleAutofit: true
X1TitleDisplay: false
X1TitleString: null string

Example:

setX1TitleDisplay ( true );

setX1TitleDisplay ( false );

Syntax:
 

setX1TitleAutofit ( true | false );
boolean = getX1TitleAutofit ();

setX1TitleDisplay ( true | false );
boolean = getX1TitleDisplay ();

setX1TitleString ( "X1TitleString" );
String = getX1TitleString();

Also See:
 

get/setAutofit() in Chapter 8

X1ZeroLineDisplay


Description:
 

This property enables/disables drawing of the zero line on the X-axis when zero is within the X1 axis scale range.

Data Type:
 

Boolean

Valid Range:
 

true/false
true = Draw Zero Line / false = Do not draw zero line

Default Value:
 

false

Example:

setX1ZeroLineDisplay ( true );

setX1ZeroLineDisplay ( false );

Syntax:
 

setX1ZeroLineDisplay ( true | false );
boolean = getX1ZeroLineDisplay ();

Also See:
 

X1MustIncludeZero, X1ScaleMax, X1ScaleMin

Y1AxisDescending


Description:
 

This property is used to change the direction of the Y-axis. When false, values ascend normally -- from left to right on the Y-axis. When true, values are reversed and descend from left-to-right on the graph. Note that this property also reverses the order of the axis labels and changes all data-related objects (e.g., markers) from their previous state.

Data Type:
 

Boolean

Valid Range:
 

true /false

 

true = Descending values (scale labels are reversed in order)
false = Ascending values ("normal" axis)

Default Value:
 

false

Example:

setY1AxisDescending ( true );

setY1AxisDescending ( false );

Syntax:
 

setY1AxisDescending ( true | false ); / boolean = getY1AxisDescending();

Code Sample:
 

import java.awt.*;
import java.applet.*;
import TDG.Perspective;
public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setDepthAngle(0);
perspective1.setX1AxisDescending(true);
perspective1.setDepthRadius(0);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Also See:
 

get/setAxisDescending() in Chapter 8

Y1AxisLineDisplay


Description:
 

This property enables (true) / disables (false) display of the Y1 axis line.

Data Type:
 

Boolean

Valid Range:
 

true /false
true = Display Y1 Axis Line
false = Do not display Y1 Axis Line

Default Value:
 

true

Example:

setY1AxisLineDisplay ( true );

setY1AxisLineDisplay ( false );

Syntax:
 

setY1AxisLineDisplay ( true | false );
boolean = getY1AxisLineDisplay ();

Code Sample:
 

id = perspective1.getY1AxisLine();
perspective1.setLineWidth ( id, 5 );
perspective1.setY1AxisLineDisplay(true);

Notes:
 

1.

The location of the line is determined by the Y1AxisSide property.

 

2.

In the default configuration for this chart type, the Y1AxisLine is the same width and location as the bottom of the chart frame. When this line size is used, the setting of this property does not change the appearance of the chart. To make a thicker and more visible axis line, use the getY1AxisLine() method to get the object ID of the line and setLineWidth() method to increase the width of the line.

Also See:
 

Y1AxisSide and the getY1AxisLine(), setLineWidth(),get/setAxisAssignment() and get/setAxisSide() methods in Chapter 8.

Y1AxisSide


Description:
 

This property controls which side of the graph an Y-axis will be imaged.

Data Type:
 

Integer

Valid Range:
 

0...2

   

#

Value

Description

0

Left

Image to low side of graph (bottom or left).

1

Right

Image to high side of graph (top or right).

2

Both

Image to both sides.

Default Value:
 

Left (0)

Example:

setY1AxisSide ( 1 );

setY1AxisSide ( 2 );

Syntax:
 

setY1AxisSide ( value );
value = getY1AxisSide ();

Code Sample:
 

<html>
<head>
<title>TDGChartApplet Demonstration #1</title>
</head>
<body>
<h2 align="center">This BiPolar Bar Chart is created entirely from HTML:</h2>
<applet code="TDGChartEditorApplet.class" width="640" height="480" archive="JavaCHARTg.jar">
<param name="TDGSCRIPT"
value="
setTitleString(&quot;Sample Chart from HTML&quot;);/*Set Title */
setGraphType(21); /* Set the graph type to BiPolar Bars */
setY1AxisSide(1);
">
</applet>
</body>
</html>

Also See:
 

Y1AxisLineDisplay and the get/setAxisAssignment() and get/setAxisSide() methods in Chapter 8.

Y1ExcludeMaxLabel / Y1ExcludeMinLabel


Description:
 

The Y1ExcludeMaxLabel property enables (true) / disables (false) the exclusion of the maximum label on the Y1 axis.

The Y1ExcludeMinLabel property enables (true) / disables (false) the exclusion of the minimum label on the Y1 axis.

Data Type:
 

Boolean

Valid Range:
 

Y1ExcludeMaxLabel: true (exclude max label) / false (include max label)
Y1ExcludeMinLabel: true (exclude min label) / false (include min label)

Default Value:
 

false (maximum and minimum labels are displayed)

Example:

setY1ExcludeMaxLabel ( true );

setY1ExcludeMinLabel ( true );

Syntax:
 

setY1ExcludeMaxLabel ( true | false );
boolean = getY1ExcludeMaxLabel ();

setY1ExcludeMinLabel ( true | false );
boolean = getY1ExcludeMinLabel ();

Also See:
 

get/setExcludeMaxLabel() and get/setExcludeMinLabel in Chapter 8.

Y1LabelAutofit / Display


Description:
 

The Y1LabelAutofit property is used to automatically fit/size all numeric axis labels on the numeric Y1-axis. When autofitting is enabled (the default), the font size of these objects cannot be changed to a size that is larger than the relative location/size of the object and objects around it. When autofitting is disabled, the font size can be set to any value allowing very large font sizes to overlap other objects in the graph.

The Y1LabelDisplay property enables (true) / disables (false) the display of labels on the Y1-axis.

Data Type:
 

Boolean

Valid Range:
 

Y1LabelAutofit: true (AutoFit/size labels)/ false (do not auto-fit. Align labels to axis; do not resize)

Y1LabelDisplay: true (display labels and title) / false (do not display labels and title)

Default Value:
 

true

Example:

setY1LabelDisplay ( true );

setY1LabelDisplay ( false );

Syntax:
 

setY1LabelAutofit ( true | false );
boolean = getY1LabelAutofit ();

setY1LabelDisplay ( true | false );
boolean = getY1LabelDisplay ();

Notes:
 

When the Y1LabelAutofit property is enabled (true), font size changes are ignored. Typically, your user interface should gray-out font size menu selections when this property is enabled.

Also See:
 

Y1LabelFormat, Y1LabelRotate, Y1LabelStagger

Y1LabelFormat / Y1LabelFormatPattern


Description:
 

When the Y1LabelDisplay property is set to true and data value labels are displayed on the Y1 axis, these properties can be used to select the format of the data values. Y1LabelFormat can be used to select one of the standard preset formats. Y1LabelFormatPatten can be used to specify a standard Java number format pattern.

Data Type:
 

Y1LabelFormat: Integer
Y1LabelFormatPattern: String

 

Y1LabelFormat: -1...14 (-1 = Use format set by Y1LabelFormatPattern)

 

Value

Format

Example

Value

Format

Example

 

0

General

560

8

$0K

$56K

 

1

0

560

9

0M

56M

 

2

0%

56%

10

$0M

$56M

 

3

0.0%

56.6%

11

0B

56B

 

4

0.00%

56.66%

12

$0B

$56B

 

5

$0.00

$56.66

13

0T

56T

 

6

$0

$56

14

$0T

$56T

 

7

0K

56K

     
 

Y1LabelFormatPattern: A pattern string in the following format:
pattern:= subpattern{;subpattern}
subpattern:= {prefix}integer{.fraction}{suffix}
prefix:= '\\u0000'..'\\uFFFD' - specialCharacters
suffix:= '\\u0000'..'\\uFFFD' - specialCharacters
integer:= '#'* '0'* '0'
fraction:= '0'* '#'*
See Chapter 3 for more detailed information about this format pattern.

Default Value:
 

Y1LabelFormat: 0 (General)
Y1LabelFormatPattern: "#.#"

Syntax: setY1LabelFormatPattern ( patternString );
patternString = getY1LabelFormatPattern ();
 

setY1LabelFormat ( value );
value = getY1LabelFormat ();

Also See:
 

Y1LabelAutofit, Y1LabelDisplay, Y1LabelRotate, Y1LabelStagger

Y1LabelRotate


Description:
 

This property can be used to rotate data labels on the Y1-axis.

Data Type:
 

Integer

Valid Range:
 

0-2

 

#

Description

0

No text rotation

1

Rotate text 90 degrees (reads top to bottom)

2

Rotate text 270 degrees (reads bottom to top)

Default Value:
 

0 (no text rotation)

Syntax:
 

setY1LabelRotate ( value );
value = getY1LabelRotate ();

Code Sample:
 

/*
A basic extension of the java.applet.Applet class
*/

import java.awt.*;
import java.applet.*;

import TDG.Perspective;
public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setY1LabelAutofit(false);
perspective1.setY1LabelStagger(true);
perspective1.setY1LabelFormat(2);
perspective1.setGraphType(21);
perspective1.setY1LabelRotate(1);
perspective1.setLegendDisplay(false);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Also See:
 

Y1LabelAutofit, Y1LabelDisplay, Y1LabelFormat, Y1LabelStagger

Y1LabelStagger


Description:
 

This property specifies whether or not text for this graph axis should be staggered. Staggered labels are drawn in a zig-zag fashion, with labels weaving in and under each other. This property affects all Y1-axis labels.

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Stagger the labels on the axis
false = Draw them as normal

Default Value:
 

false

Example:

setY1LabelStagger ( true );

setY1LabelStagger ( false );

Syntax:
 

setY1LabelStagger ( true | false );
boolean = getY1LabelStagger ();

Code Sample:
 

import java.awt.*;
import java.applet.*;
import TDG.Perspective;
public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setY1LabelStagger(true);
perspective1.setLegendDisplay(false);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Notes:
  This property is not supported in 3D charts.
Also See:
 

Y1LabelAutofit, Y1LabelDisplay, Y1LabelFormat, Y1LabelRotate, and get/setLabelStagger() in Chapter 8

Y1LogScale


Description:
 

This property specifies the scale (logarithmic or linear) for the numeric Y1-axis. When the scale range is set to automatic, any data items with Y1 values less than or equal to zero are graphed as null for log scale. If a manual scale range is specified to include negative values (Y1ScaleMin less than or equal to zero), the request for log scale is ignored. Y1LogScale is automatically set to false (linear scale).

Data Type:
 

Boolean

Valid Range:
 

true (use logrithmic scale) / false (use linear scale)

Default Value:
 

false

Example:

setY1LogScale ( true );

setY1LogScale ( false );

Syntax:
 

setY1LogScale ( true | false )
boolean = getY1LogScale ();

Also See:
 

get/setLogScale() in Chapter 8

Y1MajorGridDisplay


Description:
 

This property controls whether or not major grid lines are displayed on the primary (Y1) numeric axis.

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Display Y1-axis major grid lines
false = Do not display Y1-axis major grid lines

Default Value:
 

true

Example:

setY1MajorGridDisplay ( true );
setY1MinorGridDisplay ( false );

setY1MajorGridDisplay ( false );
setY1MinorGridDisplay ( false );

Syntax:
 

setY1MajorGridDisplay ( true | false );
boolean = getY1MajorGridDisplay ();

Also See:
 

Y1MajorGridStyle, Y1MinorGridDisplay, Y1MinorGridStyle, and the get/setGridStyle() method in Chapter 8

Y1MajorGridStep / Y1MajorGridStepAuto


Description:
 

The Y1MajorGridStep property can be used to control the number of major grid lines on the Y1-axis of the chart. Assigning a value to this property will automatically set the Y1MajorGridStepAuto property to false.

The Y1MajorGridStepAuto property enables (true) / disables (false) automatic calculation of the number of major grid lines on the numeric Y1-axis of a chart. When this property is set to true, the value assigned to Y1MajorGridStep is ignored. Also see Notes below.

Data Type:
 

Y1MajorGridStep: Real
Y1MajorGridStepAuto: Boolean

Valid Range:
 

Y1MajorGridStep: Any Positive Real Number (See Notes below)

Y1MajorGridStepAuto: true (automatically calculate the number of major grid steps on the Y1 axis) / false (use value set by Y1MajorGridStep)

Default Value:
 

Y1MajorGridStep: 10.0
Y1MajorGridStepAuto: true

Example:

setY1MajorGridStepAuto ( false );
setY1MajorGridStep ( 6 );

setY1MajorGridStepAuto ( false );
setY1MajorGridStep ( 8 );

Syntax:
 

setY1MajorGridStep ( value );
value = getY1MajorGridStep ();

setY1MajorGridStepAuto ( true | false );
boolean = getY1MajorGridStepAuto ();

Notes:
 

If the value assigned to Y1MajorGridStep is negative or results in greater than 50 grid lines, the Y1MajorGridStepAuto property is automatically set to true and the Y1MajorGridStep value is ignored.

Also See:
 

Y1MinorGridStep, Y1MinorGridStepAuto, and the get/setGridStep() and get/setGridStepAuto() methods in Chapter 8.

Y1MajorGridStyle


Description:
 

This property controls the appearance of major grid lines on the numeric Y1-axis of a chart.

Data Type:
 

Integer

Valid Range:
 

0...4

 

#

Description

0

Normal grid lines, height of frame

1

Normal grid lines extend beyond the height of frame

2

Small tick marks from frame edge inward

3

Small tick marks from frame edge outward

4

TickIn and TickOut span across the frame edge

Default Value:
 

0 (Normal Grid)

Example:

setY1MajorGridStyle ( 2 );

setY1MajorGridStyle ( 4 );

Syntax:
 

setY1MajorGridStyle ( value );
value = getY1MajorGridStyle ();

Also See:
 

Y1MajorGridDisplay, Y1MinorGridDisplay, Y1MinorGridStyle, and the get/setGridStyle() method in Chapter 8

Y1MinorGridDisplay


Description:
 

This property enables (true) / disables (false) the display of minor grid lines on the Y1-axis.

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Display Y1-axis minor grid lines
false = Do not display Y1-axis minor grid lines

Default Value:
 

true

Example:

setY1MajorGridDisplay ( false );
setY1MinorGridDisplay ( true );

setY1MajorGridDisplay ( false );
setY1MinorGridDisplay ( false );

Syntax:
 

setY1MinorGridDisplay ( true | false );
boolean = getY1MinorGridDisplay ();

Code Sample:
 

public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setY1MajorGridDisplay(false);
perspective1.setY1MinorGridDisplay(true);
perspective1.setLegendDisplay(false);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Also See:
 

Y1MajorGridDisplay, Y1MajorGridStyle, Y1MinorGridStep,Y1MinorGridStepAuto, Y1MinorGridStyle, and get/setGridStyle() in Chapter 8

Y1MinorGridStep / Y1MinorGridStepAuto


Description:
 

The Y1MinorGridStep property sets a number of minor grid steps on the Y1-axis of the chart. Minor grid lines are drawn between the major grid lines (when they are displayed) and the location of the minor gridlines depend very much on the setting for the major grid lines. When a value is assigned to this property, the Y1MinorGridStepAuto property is automatically set to false. If the value assigned to this property results in greater than 50 minor grid lines between each major grid line, the Y1MinorGridStepAuto property is automatically set to true.

The Y1MinorGridStepAuto property enables/disables automatic grid steps for the Y1-axis minor grid lines.

Data Type:
 

Y1MinorGridStep: Real / Y1MinorGridStepAuto: Boolean

Valid Range:
 

Y1MinorGridStep: Any Positive Real Number (See Note)

Y1MinorGridStepAuto: true (automatically calculate minor grid steps on the Y1 axis) / false (use value set by Y1MinorGridStep)

Default Value:
 

Y1MinorGridStep: 10.0 / Y1MinorGridStepAuto: true

Example:

setY1MajorGridStep( 40 );
setY1MinorGridStep ( 10 );

setY1MajorGridStep( 40 );
setY1MinorGridStep ( 20 );

Syntax:
 

setY1MinorGridStep ( value ) / value = getY1MinorGridStep ();

setY1MinorGridStepAuto ( true | false );
boolean = getY1MinorGridStepAuto ();

Notes:

 

If Y1MinorGridStep is set to a negative value or a value that results in greater than 50 minor grid lines between each major grid line, the Y1MinorGridStepAuto property is automatically set to true.

Also See:
 

Y1MajorGridStep, Y1MajorGridStepAuto, Y1MinorGridDisplay, Y1MinorGridStyle,and the get/setGridStep() and get/setGridStepAuto() methods in Chapter 8.

Y1MinorGridStyle


Description:
 

This property controls the appearance of minor grid lines on the numeric Y1-axis of a chart.

Data Type:
 

Integer

Valid Range:
 

0...4

 

#

Description

0

Normal grid lines, height of frame

1

Normal grid lines extend beyond the height of frame

2

Small tick marks from frame edge inward

3

Small tick marks from frame edge outward

4

TickIn and TickOut span across the frame edge

Default Value:
 

0 (Normal Grid)

Example:

setY1MinorGridStyle ( 2 );

setY1MinorGridStyle ( 4 );

Syntax:
 

setY1MinorGridStyle ( value );
value = getY1MinorGridStyle ();

Also See:
 

Y1MajorGridDisplay, Y1MajorGridStyle, Y1MinorGridDisplay, and get/setGridStyle in Chapter 8

Y1MustIncludeZero


Description:
 

This property determines whether or not the chart must include zero on the Y1 axis. If the logrithmic scale is enabled with Y1LogScale(true) or a manual scale range excludes zero (Y1ScaleMax and Y1ScaleMin are greater than zero), this property is ignored

Data Type:
 

Boolean

Valid Range:
 

true/false
true = Include Zero / False = Exclude Zero if it is not within the given automatic scale range

Default Value:
 

true

Syntax:
 

setY1MustIncludeZero ( true | false );
boolean = getY1MustIncludeZero ();

Also See:
 

Y1ScaleMax, Y1ScaleMin, Y1ZeroLineDisplay

Y1OffScaleDisplay


Description:
 

This property enables/disables the display of values that are out of range by clipping them to fit within the range. When this property is enabled (true), values less than or greater than a given range are represented at the scale limit (minimum or maximum). For example, a value of 700 goes beyond the specified range of 250-500, so its bar would go all the way to the top of the chart. When this property is disabled (false), only values that fall directly between a given range are displayed (e.g. in the example above, the 700 bar would be omitted.)

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Display values less than or greater than a given range at the scale limit (minimum or maximum)
false = Only display values that fall between a given range

Default Value:
 

false

Example:

setY1OffScaleDisplay ( true );

setY1OffScaleDisplay ( false );

Syntax:
 

setY1OffScaleDisplay ( true | false );
boolean = getY1OffScaleDisplay ();

Code Sample:
 

perspective1.setY1ScaleMaxAuto(false);
perspective1.setY1OffScaleDisplay(false);
perspective1.setDepthAngle(0);
perspective1.setY1ScaleMax(50.0);
perspective1.setY1ScaleMinAuto(false);
perspective1.setY1ScaleMin(10.0);

Also See:
 

get/setDisplayOffScale() in Chapter 8

Y1ScaleMax / Y1ScaleMaxAuto


Description:
 

The Y1ScaleMax property specifies the maximum data value that can be used to image the graph and its axis. When a value is assigned to this property, the Y1ScaleMaxAuto property is automatically set to false.

The Y1ScaleMaxAuto property enables (true) / disables (false) use of the value assigned to the setY1ScaleMax property.

Data Type:
 

Y1ScaleMax: Real
Y1ScaleMaxAuto: Boolean

Valid Range:
 

Y1ScaleMax: Any real number

Y1ScaleMax: true (automatically calculate minimum value) / false (use value set by Y1ScaleMax)

Default Value:
 

Y1ScaleMax: 70.0
Y1ScaleMaxAuto: true

Example:

setY1ScaleMaxAuto ( false );
setY1ScaleMax ( 40 );

setY1ScaleMaxAuto ( false );
setY1ScaleMax ( 80 );

Syntax:
 

setY1ScaleMax ( value );
value = getY1ScaleMax ();

setY1ScaleMaxAuto ( true | false );
boolean = getY1ScaleMaxAuto ();

Code Sample:
 

perspective1.setY1ScaleMaxAuto(false);
perspective1.setY1ScaleMax(40.0);
perspective1.setY1ScaleMinAuto(false);
perspective1.setY1ScaleMin(-20.0);

Notes:
 

If Y1ScaleMax is set to a value less than Y1ScaleMin, the values will be automatically switched and and the Y1AxisDescending property will be set to true.

Also See:
 

Y1ScaleMin, Y1ScaleMinAuto, and the get/setScaleMax() and get/setScaleMaxAuto() methods in Chapter 8

Y1ScaleMin / Y1ScaleMinAuto


Description:
 

The Y1ScaleMin property specifies the minimum data value that can be used to manually image the graph and its axis. When a value is assigned to this property, the Y1ScaleMinAuto property is automatically set to false.

The Y1ScaleMinAuto property enables (true) /disables (false) automatic minimum scaling. When this property is set to true, the value assigned to the Y1ScaleMin property is ignored.

Data Type:
 

Y1ScaleMin: Real
Y1ScaleMinAuto: Boolean

Valid Range:
 

Y1ScaleMin: Any real value

Y1ScaleMinAuto: true (automatically calculated minimum scale) / false (use value set by Y1ScaleMin)

Default Value:
 

Y1ScaleMin: Zero
Y1ScaleMinAuto: true

Example:

setY1ScaleMinAuto ( false );
setY1ScaleMin ( -20 );

setY1ScaleMinAuto ( false );
setY1ScaleMin ( 10 );

Syntax:
 

setY1ScaleMin ( value );
value = getY1ScaleMin ();

setY1ScaleMinAuto ( true | false );
boolean = getY1ScaleMinAuto ();

Code Sample:
 

perspective1.setY1ScaleMaxAuto(false);
perspective1.setY1ScaleMax(40.0);
perspective1.setY1ScaleMinAuto(false);
perspective1.setY1ScaleMin(-20.0);

Notes:
 

If Y1ScaleMax is set to a value less than Y1ScaleMin, the values will be automatically switched and and the Y1AxisDescending property will be set to true.

Also See:
 

Y1ScaleMax, Y1ScaleMaxAuto, and the get/setScaleMin() and get/setScaleMinAuto() methods in Chapter 8

Y1TitleAutofit / Display / String


Description:
 

The Y1TitleAutofit property enables (true) /disables (false) autofitting of the Y1-axis title that is defined by the Y1TitleString property and enabled for display by the Y1TitleDisplay property.

The Y1TitleDisplay property enables (true) /disables (false) drawing of Y1-axis title string that is defined by the Y1TitleString property.

This Y1TitleString property is used to define the title string for the Y1-axis in a chart. When a title string is assigned to this property, the Y1TitleDisplay property is automatically set to true.

Data Type:
 

Y1TitleAutofit and Y1TitleDisplay: Boolean
Y1TitleString: String

Valid Range:
 

Y1TitleAutofit: true (autofit Y1 Title) / false (do not autofit Y1 Title)
Y1TitleDisplay: true (display Y1 Title) / false (do not display Y1 Title)
Y1TitleString: Any printable characters

Default Value:
 

Y1TitleAutofit: true
Y1TitleDisplay: false
Y1TitleString: null string

Example:

setY1TitleAutofit ( true );

setY1TitleAutofit ( false );

Syntax:
 

setY1TitleAutofit ( true | false ); / boolean = getY1TitleAutofit ();

setY1TitleDisplay ( true | false ); / boolean = getY1TitleDisplay ();

setY1TitleString ( "Y1TitleString" ); / string = getY1TitleString();

Notes:
 

If the Y1LabelDisplay is set to false, the title string will not be drawn regardless of the Y1TitleDisplay or Y1TitleString property.

Also See:
 

get/setAutofit() in Chapter 8

Y1ZeroLineDisplay


Description:
 

This property enables/disables drawing of the zero line on the Y1-axis when zero is within the Y1 axis scale range.

Data Type:
 

Boolean

Valid Range:
 

true/false
true = Draw Zero Line / false = Do not draw zero line

Default Value:
 

false

Example:

setY1ZeroLineDisplay ( true );

setY1ZeroLineDisplay ( false );

Syntax:
 

setY1ZeroLineDisplay ( true | false );
boolean = getY1ZeroLineDisplay ();

Notes:
 

To increase the width of the zero line, use the getY1ZeroLine() method to get the object ID of the line and the setLineWidth() method to specify the width (in pixels) of the line.

Also See:
 

Y1MustIncludeZero, Y1ScaleMax, Y1ScaleMin, and the getY1ZeroLine() and setLineWidth() methods in Chapter 8

Y2AxisDescending


Description:
 

This property is used to change the direction of the Y-axis. When false, values ascend normally -- from left to right on the Y-axis. When true, values are reversed and descend from left-to-right on the graph. Note that this property also reverses the order of the axis labels and changes all data-related objects (e.g., markers) from their previous state.

Data Type:
 

Boolean

Valid Range:
 

true /false

 

true = Descending values (scale labels are reversed in order)
false = Ascending values ("normal" axis)

Default Value:
 

false

Example:

setY2AxisDescending ( true );

setY2AxisDescending ( false );

Syntax:
 

setY2AxisDescending ( true | false );
boolean = getY2AxisDescending();

Also See:
 

get/setAxisDescending() in Chapter 8

Y2AxisLineDisplay


Description:
 

This property enables (true) / disables (false) display of the Y2 axis line.

Data Type:
 

Boolean

Valid Range:
 

true /false
true = Display Y2 Axis Line / false = Do not display Y2 Axis Line

Default Value:
 

false

Example:

setY2AxisLineDisplay ( true );

setY2AxisLineDisplay ( false );

Syntax:
 

setY2AxisLineDisplay ( true | false );
boolean = getY2AxisLineDisplay ();

Code Sample:
 

id = perspective1.getY2AxisLine();
perspective1.setLineWidth ( id, 5 );
perspective1.setY2AxisLineDisplay(true);

Notes:
 

1.

The location of the line is determined by the Y2AxisSide property.

 

2.

In the default configuration for this chart type, the Y2AxisLine is the same width and location as the bottom of the chart frame. When this line size is used, the setting of this property does not change the appearance of the chart. To make a thicker and more visible axis line, use the getY2AxisLine() method to get the object ID of the line and setLineWidth() method to increase the width of the line.

Also See:
 

Y2AxisSide and the get/setAxisSide() and get/setAxisAssignment() methods in Chapter 8.

Y2AxisSide


Description:
 

This property controls which side of the graph an Y-axis will be imaged.

Data Type:
 

Integer

Valid Range:
 

0...2

   

#

Value

Description

0

Left

Image to low side of graph (bottom or left).

1

Right

Image to high side of graph (top or right).

2

Both

Image to both sides.

Default Value:
 

1 (Right)

Example:

setY2AxisSide ( 0 );

setY2AxisSide ( 2 );

Syntax:
 

setY2AxisSide ( value );
value = getY2AxisSide ();

Also See:
 

get/setAxisSide() and get/setAxisAssignment() in Chapter 8

Y2ExcludeMaxLabel / Y2ExcludeMinLabel


Description:
 

The Y2ExcludeMaxLabel property enables (true) / disables (false) the exclusion of the maximum label on the Y2 axis.

The Y2ExcludeMinLabel property enables (true) / disables (false) the exclusion of the minimum label on the Y2 axis.

Data Type:
 

Boolean

Valid Range:
 

Y2ExcludeMaxLabel: true (exclude max label) / false (include max label)
Y2ExcludeMinLabel: true (exclude min label) / false (include min label)

Default Value:
 

false (maximum and minimum labels are displayed)

Example:
setY2ExcludeMaxLabel ( true ); setY2ExcludeMaxLabel ( false );
Syntax:
 

setY2ExcludeMaxLabel ( true | false );
boolean = getY2ExcludeMaxLabel();

setY2ExcludeMinLabel ( true | false );
boolean = getY2ExcludeMinLabel();

Also See:
 

get/setExcludeMaxLabel() and get/setExcludeMinLabel() in Chapter 8

Y2LabelAutofit / Y2LabelDisplay


Description:
 

The Y2LabelAutofit property is used to automatically fit/size all numeric axis labels on the numeric Y2-axis. When autofitting is enabled (the default), the font size of these objects cannot be changed to a size that is larger than the relative location/size of the object and objects around it. When autofitting is disabled, the font size can be set to any value allowing very large font sizes to overlap other objects in the graph.

The Y2LabelDisplay property enables (true) / disables (false) the display of labels on the Y2-axis.

Data Type:
 

Boolean

Valid Range:
 

Y2LabelAutofit: true (autofit/size labels) / false (do not autofit, align labels to axis, do not resize)

Y2LabelDisplay: true (display labels) / false (do not display labels)

Default Value:
 

true

Example:

setY2LabelDisplay ( true );

setY2LabelDisplay ( false );

Syntax:
 

setY2LabelAutofit ( true | false ); / boolean = getY2LabelAutofit ();
setY2LabelDisplay ( true | false ); / boolean = getY2LabelDisplay();

Notes:
 

1.

When the Y2LabelAutofit property is enabled (true), font size changes are ignored. Typically, your user interface should gray-out font size menu selections when this property is enabled.

 

2.

The format of data labels on this axis is defined by the Y2LabelFormat property. In this example, Y2LabelFormat is set to 9. If Y2AxisSide is set to three (none), labels will not be drawn in the graph regardless of the value of this property.

Also See:
 

Y2LabelFormat, Y2LabelRotate, Y2LabelStagger, and the get/setLabelStagger() method in Chapter 8

Y2LabelFormat / Y2LabelFormatPattern


Description:
 

When the Y2LabelDisplay property is set to true and data value labels are displayed on the Y2 axis, these properties can be used to select the format of the data values. Y2LabelFormat can be used to select one of the standard preset formats. Y2LabelFormatPatten can be used to specify a standard Java number format pattern.

Data Type:
 

Y2LabelFormat: Integer
Y2LabelFormatPattern: String

Valid Range:
 

Y2LabelFormat: -1...14 (-1 = Use format set by Y2LabelFormatPattern)

 

Value

Format

Example

Value

Format

Example

 

0

General

560

8

$0K

$56K

 

1

0

560

9

0M

56M

 

2

0%

56%

10

$0M

$56M

 

3

0.0%

56.6%

11

0B

56B

 

4

0.00%

56.66%

12

$0B

$56B

 

5

$0.00

$56.66

13

0T

56T

 

6

$0

$56

14

$0T

$56T

 

7

0K

56K

     
 

Y2LabelFormatPattern: A pattern string in the following format:
pattern:= subpattern{;subpattern}
subpattern:= {prefix}integer{.fraction}{suffix}
prefix:= '\\u0000'..'\\uFFFD' - specialCharacters
suffix:= '\\u0000'..'\\uFFFD' - specialCharacters
integer:= '#'* '0'* '0'
fraction:= '0'* '#'*
See Chapter 3 for more detailed information about this format pattern.

Default Value:
 

Y2LabelFormat: 0 (General)
Y2LabelFormatPattern: "#.#"

Syntax:
 

setY2LabelFormat ( value );
value = getY2LabelFormat ()
; setY2LabelFormatPattern ( patternString );
patternString = getY2LabelFormatPattern();

Also See:
 

Y2LabelAutofit, Y2LabelDisplay, Y2LabelStagger, Y2LabelRotate, and the get/setLabelStagger() method in Chapter 8

Y2LabelRotate


Description:
 

This property defines the format of data labels on the Y2-axis.

Data Type:
 

Integer

Valid Range:
 

0-2

 

#

Description

0

No text rotation

1

Rotate text 90 degrees (reads top to bottom)

2

Rotate text 270 degrees (reads bottom to top)

Default Value:
 

0 (no text rotation)

Syntax:
 

setY2LabelRotate ( value );
value = getY2LabelRotate ();

Code Sample:
 

/*
A basic extension of the java.applet.Applet class
*/

import java.awt.*;
import java.applet.*;

import TDG.Perspective;
public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setY2LabelStagger(true);
perspective1.setDepthAngle(0);
perspective1.setY2OffScaleDisplay(false);
perspective1.setGraphType(21);
perspective1.setY2ScaleMinAuto(false);
perspective1.setY2ScaleMaxAuto(false);
perspective1.setY2AxisLineDisplay(false);
perspective1.setLegendDisplay(false);
perspective1.setY2ScaleMax(40.0);
perspective1.setDepthRadius(0);
perspective1.setY2LabelRotate(1);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Also See:
 

Y2LabelAutofit, Y2LabelDisplay, Y2LabelFormat, Y2LabelStagger, and the get/setLabelStagger() method in Chapter 8

Y2LabelStagger


Description:
 

This property specifies whether or not text for this graph axis should be staggered. Staggered labels are drawn in a zig-zag fashion, with labels weaving in and under each other. This property affects all Y2-axis labels.

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Stagger the labels on the axis
false = Draw them as normal

Default Value:
 

false

Example:

setY2LabelStagger ( true );

setY2LabelStagger ( false );

Syntax:
 

setY2LabelStagger ( true | false );
boolean = getY2LabelStagger ();

Notes:
  This property is not supported in 3D charts.
Also See:
 

Y2LabelAutofit, Y2LabelDisplay, Y2LabelFormat, Y2LabelRotate, and the get/setLabelStagger() method in Chapter 8

Y2LogScale


Description:
 

This property specifies the scale (logarithmic or linear) for the numeric Y2-axis. When the scale range is set to automatic, any data items with Y2 values less than or equal to zero are graphed as null for log scale. If a manual scale range is specified to include negative values (Y2ScaleMin less than or equal to zero), the request for log scale is ignored. Y2LogScale is automatically set to false (linear scale).

Data Type:
 

Boolean

Valid Range:
 

true (use logrithmic scale) / false (use linear scale)

Default Value:
 

false

Example:

setY2LogScale ( true );

setY2LogScale ( false );

Syntax:
 

setY2LogScale ( true | false );
boolean = getY2LogScale ();

Code Sample:
 

perspective1.setGraphType(21);
perspective1.setY2ScaleMinAuto(true);
perspective1.setY2ScaleMaxAuto(true);
perspective1.setY2LogScale(true);

Also See:
 

get/setLogScale() in Chapter 8

Y2MajorGridDisplay


Description:
 

This property controls whether or not major grid lines are displayed on the primary (Y2) numeric axis.

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Display Y2-axis major grid lines
false = Do not display Y2-axis major grid lines

Default Value:
 

true

Example:

setY2MajorGridDisplay ( true );
setY2MinorGridDisplay ( false );

setY2MajorGridDisplay ( false );
setY2MinorGridDisplay ( false );

Syntax:
 

setY2MajorGridDisplay ( true | false );
boolean = getY2MajorGridDisplay();

Notes:
 

Note that grid lines may still be imaged in this axis of the chart of the Y2MinorGridDisplay property is set to true. In the example, the Y2MinorGridDisplay is set to false.

Also See:
 

Y2MajorGridStyle, Y2MinorGridDisplay, and Y2MinorGridStyle

Y2MajorGridStep / Y2MajorGridStepAuto


Description:
 

The Y2MajorGridStep property can be used to control the number of major grid lines on the Y2-axis of the chart. Assigning a value to this property will automatically set the Y2MajorGridStepAuto property to false.

The Y2MajorGridStepAuto property enables (true) / disables (false) automatic calculation of the number of major grid lines on the numeric Y2-axis of a chart. Also see the Notes below.

Data Type:
 

Y2MajorGridStep: Real
Y2MajorGridStepAuto: Boolean

Valid Range:
 

Y2MajorGridStep: Any Positive Real Number (See Notes below)

Y2MajorGridStepAuto: true (enable automatic calculation of major grid steps) / false (use value set by Y2MajorGridStep)

Default Value:
 

Y2MajorGridStep: 10.0
Y2MajorGridStepAuto: true

Example:

setY2MajorGridStepAuto ( false );
setY2MajorGridStep ( 20 );

setY2MajorGridStepAuto ( false );
setY2MajorGridStep ( 40 );

Syntax:
 

setY2MajorGridStep ( value );
value = getY2MajorGridStep();

setY2MajorGridStepAuto ( true | false );
boolean = getY2MajorGridStepAuto();

Notes:
 

If the value assigned to Y2MajorGridStep is negative or results in greater than 50 grid lines, the Y2MajorGridStepAuto property is automatically set to true and the Y2MajorGridStep value is ignored.

Also See:
 

Y2MinorGridStep, Y2MinorGridStepAuto, and the get/setGridStep() and get/setGridStepAuto methods in Chapter 8

Y2MajorGridStyle


Description:
 

This property controls the appearance of major grid lines on the numeric Y2-axis of a chart.

Data Type:
 

Integer

Valid Range:
 

0...4

 

#

Description

0

Normal grid lines, height of frame

1

Normal grid lines extend beyond the height of frame

2

Small tick marks from frame edge inward

3

Small tick marks from frame edge outward

4

TickIn and TickOut span across the frame edge

Default Value:
 

0 (Normal Grid)

Example:

setY2MajorGridStyle ( 4 );

setY2MajorGridStyle ( 2 );

Syntax:
 

setY2MajorGridStyle ( value );
value = getY2MajorGridStyle ();

Also See:
 

Y2MajorGridDisplay and the get/setGridStyle() method in Chapter 8

Y2MinorGridDisplay


Description:
 

This property enables (true) / disables (false) the display of minor grid lines on the Y2-axis. The format of minor grid lines that are displayed by this property are defined by the Y2MinorGridStyle property. The number of minor grid lines that are displayed is defined by the Y2MinorGridStep and Y2MinorGridStepAuto properties.

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Display Y2-axis minor grid lines
false = Do not display Y2-axis minor grid lines

Default Value:
 

true

Example:

setY2MinorGridDisplay ( true );

setY2MinorGridDisplay ( false );

Syntax:
 

setY2MinorGridDisplay ( true | false );
boolean = getY2MinorGridDisplay ();

Also See:
 

Y2MinorGridStep, Y2MinorGridStepAuto, Y2MinorGridStyle

Y2MinorGridStep / Y2MinorGridStepAuto


Description:
 

This Y2MinorGridStep property sets a number of minor grid steps on the Y2-axis of the chart. Minor grid lines are drawn between the major grid lines (when they are displayed) and the location of the minor gridlines depend very much on the setting for the major grid lines. When a value is assigned to this property, the Y2MinorGridStepAuto property is automatically set to false. If the value assigned to this property results in greater than 50 minor grid lines between each major grid line, the Y2MinorGridStepAuto property is automatically set to true.

The Y2MinorGridStepAuto property enables/disables automatic grid steps for the Y2-axis minor grid lines. When this property is set to true, the value assigned to Y2MinorGridStep is ignored.

Data Type:
 

Y2MinorGridStep: Real / Y2MinorGridStepAuto: Boolean

Valid Range:
 

Y2MinorGridStep: Any Positive Real Number (See Note)

Y2MinorGridStepAuto: true (enable automatic calculation of minor grid steps) / false (use value set by Y2MinorGridStep)

Default Value:
 

Y2MinorGridStep: 10.0 / Y2MinorGridStepAuto: true

Example:

setY2MinorGridStepAuto ( false );
setY2MinorGridStep ( 5 );

setY2MinorGridStepAuto ( false );
setY2MinorGridStep ( 4 );

Syntax:
 

setY2MinorGridStep ( value );
value = getY2MinorGridStep();

setY2MinorGridStepAuto ( true | false );
boolean = getY2MinorGridStepAuto();

Notes:

 

If Y2MinorGridStep is set to a negative value or a value that results in greater than 50 minor grid lines between each major grid line, the Y2MinorGridStepAuto property is automatically set to true.

Also See:
 

Y2MajorGridStep, Y2MajorGridStepAuto, Y2MinorGridDisplay, Y2MinorGridStyle, and the get/setGridStep () and get/setGridStepAuto methods in Chapter 8

Y2MinorGridStyle


Description:
 

This property controls the appearance of minor grid lines on the numeric Y2-axis of a chart.

Data Type:
 

Integer

Valid Range:
 

0...4

 

#

Description

0

Normal grid lines, height of frame

1

Normal grid lines extend beyond the height of frame

2

Small tick marks from frame edge inward

3

Small tick marks from frame edge outward

4

TickIn and TickOut span across the frame edge

Default Value:
 

0 (Normal Grid)

Example:

setY2MinorGridStyle ( 3 );

setY2MinorGridStyle ( 0 );

Syntax:
 

setY2MinorGridStyle ( value );
value = getY2MinorGridStyle ();

Also See:
 

Y2MajorGridDisplay, Y2MajorGridStyle, Y2MinorGridDisplay, and the get/setGridStyle() method in Chapter 8

Y2MustIncludeZero


Description:
 

This property determines whether or not the chart includes zero. If the logrithmic scale is enabled with Y2LogScale(true) or a manual scale range excludes zero (Y2ScaleMax and Y2ScaleMin are greater than zero), this property is ignored

Data Type:
 

Boolean

Valid Range:
 

true/false
true = Include Zero / False = Exclude Zero if it is not within the given automatic scale range

Default Value:
 

true

Syntax:
 

setY2MustIncludeZero ( true | false );
boolean = getY2MustIncludeZero ();

Also See:
 

Y2ScaleMax, Y2ScaleMin, Y2ZeroLineDisplay

Y2OffScaleDisplay


Description:
 

This property enables/disables the display of values that are out of range by clipping them to fit within the range. When this property is enabled (true), values less than or greater than a given range are represented at the scale limit (minimum or maximum). For example, a value of 700 goes beyond the specified range of 250-500, so its riser would go all the way to the top of the chart. When this property is disabled (false), only values that fall directly between a given range are displayed (e.g. in the example above, the 700 riser would be omitted.)

Data Type:
 

Boolean

Valid Range:
 

true / false
true = Display values less than or greater than a given range at the scale limit (minimum or maximum)
false = Only display values that fall between a given range

Default Value:
 

false

Syntax:
 

setY2OffScaleDisplay ( true | false );
boolean = getY2OffScaleDisplay ();

Code Sample:
 

/*
A basic extension of the java.applet.Applet class
*/

import java.awt.*;
import java.applet.*;

import TDG.Perspective;
public class Applet1 extends Applet
{
public void init()
{
setLayout(null);
setSize(300,200);
perspective1 = new TDG.Perspective();
perspective1.setMarkerSizeDefault(60);
perspective1.setY2OffScaleDisplay(false);
perspective1.setY2ScaleMin(20.0);
perspective1.setGraphType(62);
perspective1.setY2ScaleMinAuto(false);
perspective1.setY2ScaleMaxAuto(false);
perspective1.setY2TitleDisplay(true);
perspective1.setY1TitleString("Y1 Axis");
perspective1.setY2TitleString("Y2 Axis");
perspective1.setY2ScaleMax(40.0);
perspective1.setBounds(0,0,300,200);
add(perspective1);
}
TDG.Perspective perspective1;
}

Also See:
 

get/setDisplayOffScale() in Chapter 8

Y2ScaleMax / Y2ScaleMaxAuto


Description:
 

The Y2ScaleMaxAuto property enables (true) / disables (false) use of the value assigned to the Y2ScaleMax property.

The Y2ScaleMax property specifies the maximum data value that can be used to image the graph and its axis. When a value is assigned to this property, the Y2ScaleMaxAuto property is automatically set to false.

Data Type:
 

Y2ScaleMax: Real
Y2ScaleMaxAuto: Boolean

Valid Range:
 

Y2ScaleMax: Any real number
Y2ScaleMaxAuto: true (enable autoscaling) / false (disable autoscaling)

Default Value:
 

Y2ScaleMax: 80.0
Y2ScaleMaxAuto: true

Example:

setY2ScaleMaxAuto ( false );
setY2ScaleMax ( 200 );

setY2ScaleMaxAuto ( false );
setY2ScaleMax ( 20 );

Syntax:
 

setY2ScaleMax ( value );
value = getY2ScaleMax ();

setY2ScaleMaxAuto ( true | false );
boolean = getY2ScaleMaxAuto();

Notes:
 

If Y2ScaleMax is set to a value less than Y2ScaleMin, the values will be automatically switched and and the Y2AxisDescending property will be set to true.

Also See:
 

Y2ScaleMin, Y2ScaleMinAuto, and the get/setScaleMax() and get/setScaleMaxAuto methods in Chapter 8

Y2ScaleMin / Y2ScaleMinAuto


Description:
 

The Y2ScaleMinAuto property enables/disables automatic minimum scaling. When this property is true, the value assigned to the Y2ScaleMin property is ignored.

The Y2ScaleMin property specifies the minimum data value that can be used to manually image the graph and its axis. When a value is assigned to this property, the Y2ScaleMinAuto property is automatically set to false.

Data Type:
 

Y2ScaleMin: Real
Y2ScaleMinAuto: Boolean

Valid Range:
 

Y2ScaleMin: Any real number
Y2ScaleMinAuto: true (enable autoscaling) / false (disable autoscaling)

Default Value:
 

Y2ScaleMin: 10.0
Y2ScaleMinAuto: true

Example:

setY2ScaleMinAuto ( false );
setY2ScaleMin ( 20 );

setY2ScaleMinAuto ( false );
setY2ScaleMin ( 40 );

Syntax:
 

setY2ScaleMin ( value );
value = getY2ScaleMin();

setY2ScaleMinAuto ( true | false );
boolean = getY2ScaleMinAuto();

Notes:
 

If Y2ScaleMax is set to a value less than Y2ScaleMin, the values will be automatically switched and and the Y2AxisDescending property will be set to true.

Also See:
 

Y2ScaleMax, Y2ScaleMaxAuto, and the get/setScaleMin() and get/setScaleMinAuto methods in Chapter 8

Y2TitleAutofit / Display / String


Description:
 

These properties control the autofitting, display, and definition of the Y2-axis title.

The Y2TitleAutofit property enables (true) /disables (false) autofitting of the Y2-axis title.

The Y2TitleDisplay property enables (true) /disables (false) drawing of Y2-axis title string that is defined by the Y2TitleString property.

The Y2TitleString property is used to define the title string for the Y2-axis in a chart. When a title string is assigned to this property, the Y2TitleDisplay property is automatically set to true.

Data Type:
 

Y2TitleAutofit and Y2TitleDisplay: Boolean
Y2TitleString: String

Valid Range:
 

Y2TitleAutofit: true (autofit) / false (do not autofit)
Y2TitleDisplay: true (display) / false (do not display)
Y2TitleString: Any printable characters

Default Value:
 

Y2TitleAutofit: true
Y2TitleDisplay: false
Y2TitleString: null string

Example:

setY2TitleDisplay ( true );

setY2TitleDisplay ( false );

Syntax:
 

setY2TitleAutofit ( true | false ); / boolean = getY2TitleAutofit ();
setY2TitleDisplay ( true | false ); / boolean = getY2TitleDisplay ();
setY2TitleString ( "Y2TitleString" ); / String = getY2TitleString();

Notes:
 

If the Y2LabelDisplay is set to false, the title string defined by Y2TitleString property will not be imaged in the graph.

Also See:
 

get/setAutofit() in Chapter 8

Y2ZeroLineDisplay


Description:
 

This property enables/disables drawing of the zero line on the Y2-axis when zero is within the Y2 axis scale range.

Data Type:
 

Boolean

Valid Range:
 

true/false
true = Draw Zero Line / false = Do not draw zero line

Default Value:
 

true

Example:

setY2ZeroLineDisplay ( true );

setY2ZeroLineDisplay ( false );

Syntax:
 

setY2ZeroLineDisplay ( true | false );
boolean = getY2ZeroLineDisplay ();

Also See:
 

Y2MustIncludeZero, X1ScaleMax, X1ScaleMin