4. Chart-Specific Settings
 

Some settings in the editor menu are available for all chart types, some are only applicable for specific charts. This chapter describes the settings that are only available for specific chart types. They are:

 

n

3D Chart Settings

 

n

3D Custom Viewing Angles

 

n

3D Preset Viewing Angles

 

n

Bar, Line, and Area Settings

 

n

Dual Y Settings

 

n

Group Axis Settings

 

n

Pie Chart Settings

 

n

Stock Chart Settings

 

n

X1 Axis Settings

 

n

Y1 Axis Settings

 

n

Y2 Axis Settings

 

See Chapter 3 for settings that are applicable to all chart types.

3D CHART SETTINGS

This option is included in the menu when a 3D graph is selected in the Graph Type menu:

 

 

The 3D Chart Settings menu includes these dialogs:

 

Define Square markers, autoshading, and the cube light source.

 

Define Scaling parameters.

 

Define Axis Labels

 

Define Group Labels

 

Define Series Labels

 

Define Grid Displays

3D General Settings

This dialog is displayed when the General tab is selected in 3D Chart Settings. Select parameters in this dialog as described in the paragraphs below. Select the Apply button to add these parameters to the chart.

 

Force Risers to Square Dimensions: This selection enables/disables square risers. If selected (þ), this property forces the aspect ratio of 3D risers to be perfectly square regardless of the dimensions of the cube. When this field is not selected, risers will be drawn using the riser width and the aspect ratio of the cube. You can use the RiserWidth property to set the width of risers. For ribbons and floating graph types, you can use the Riser3DThicknessY property to set the height of the risers. The default value is not selected.

 

Autoshading: This selection enables/disables automatic shading of risers and the 3D cube. When this field is selected (þ), light source settings are used to automatically shade the faces of a 3D graph, simulating a cast light beam. If this field is not selected, all sides of 3D risers or the 3D cube are the same color. It is not possible to color each face separately. The default value is selected (þ).

 

Light PositionX/Y/Z: When Autoshading is selected (þ), use the Light Position sliders to change the shading of the 3D cube. These selections set the cube light source for the X-, Y, and Z-coordinate (unit space). The default values are: Light Position X=0, Light Position Y=40, Light Position Z = 100.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Force Risers to Square Dimensions

setCubeSquareRisers ( true | false );

 

Autoshading

setAutoshading ( true | false );

 

LightPositionX/Y/Z:

setCubeLightSourceX/Y/Z ( value );

3D Scale Settings

This dialog is displayed when the Combo tab is selected in 3D Chart Settings. Select the properties that you want to apply to the chart's numeric axis. Select the Apply button to add these selections to the chart.

 

Always Include Zero on Scale: This field selects whether or not the Y1 axis must include a zero value. If the Log Scale field is selected or the Max Value or Min Value is greater than zero, this field will be grayed-out. It is not valid when the logarithmic scale is used or Min and Max Values are greater than zero. The default value is not selected.

 

Use Manual Setting for Maximum: This field selects manual/automatic calculation of the maximum scale value on the Y1 axis in the chart. If this field is selected (þ), enter the maximum allowable scale value on the Y1 axis in the Max Value field. The default value is not selected (let the charting engine automatically calculate the maximum value on the Y1 Axis).

 

Max Value: When the "Use Manual Setting for Maximum" field is selected (þ), use this field to specify the maximum allowable scale value on the Y1 axis. The default value is 70.0.

 

Use Manual Setting for Minimum: This field selects manual/automatic calculation of the minimum scale value on the Y1 axis in the chart. If this field is selected (þ), enter the minimum allowable scale value on the Y1 axis in the Min Value field. The default value is not selected (let the charting engine automatically calculate the minimum value on the Y1 Axis).

 

Min Value: When the "Use Manual Setting for Minimum" field is selected (þ), use this field to specify the minimum allowable scale value on the Y1 axis. The default value is 0.0.

 

Log Scale: This field selects logarithmic or linear scale 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 (Min Value is less than or equal to zero), the request for log scale is ignored. The default value is linear scale (this field is not selected).

 

Draw from Zero Line: In applications where the data range can include negative numbers, this field determines whether the risers will be drawn pointing up and down from a zero line or whether all risers will draw straight up from the "bottom" of the graph. The default value is draw from a zero line (this field is selected).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Always Include Zero on Scale

setScaleMustIncludeZero(getY1Axis(),true | false);

 

Use Manual setting for Maximum

setScaleMaxAuto( getY1Axis(), true | false );

 

Max Value

setScaleMax( getY1Axis(), value );

 

Use Manual setting for Minimum

setScaleMinAuto( getY1Axis(), true | false );

 

Min Value

setScaleMin( getY1Axis(), value );

 

Log Scale

setLogScale(getY1Axis(), true | false );

 

Draw From Zero Line

setScaleFromZero( true | false );

3D Y1 Axis Settings

This dialog is displayed when the Y1 Axis Tab is selected in 3D Chart Settings. Use the check boxes to enable/disable the display of: all numeric axis labels, the minimum value, or the maximum axis label. When axis labels are displayed with Show Axis Labels, select the format of label values in the Format field. Select the Apply button to add these selections to the chart.

 

Show Axis Labels: This field enables/disables the display of labels on the Y1 axis in the chart. The default value is enabled (axis labels are displayed). Use the Format field to define the format of numeric labels. The location of Y1 labels can be controlled by the setY1AxisSide() property (i.e setY1AxisSide(2); will display Y1 axis scale on both sides of the cube).

 

Format: When "Show Axis Labels" is selected (þ), select the drop-down list box in this field to select a label format: General, 0%, 0.0%, $0, $0.00, etc. The default value is "General".

 

Don't Show Minimum Value: When "Show Axis Labels" is selected (þ), this field can be used to include/exclude the minimum value on the Y1 Axis. The default value is not selected (include the minimum label).

 

Don't Show Maximum Value: When "Show Axis Labels" is selected (þ), this field can be used to include/exclude the maximum value on the Y1 Axis. The default value is not selected (include the maximum label).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Axis Labels

setDisplay ( getY1Label(), true | false);

 

Format

setTextFormatPreset ( getY1Label(), value );

 

Don't Show Minimum Value

setExcludeMinLabel ( getY1Label(), true | false );

 

Don't Show Maximum Value

setExcludeMaxLabel ( getY1Label(), true | false );

3D Group Axis

This dialog is displayed when this Group Axis Tab is selected in 3D Chart Settings. Use the check boxes to enable/disable the display of all group labels, the first group label, and/or the last group label. Select the Apply button to add these selections to the chart.

 

Show Group Axis Labels: This field enables/disables the display of labels on the O1 axis in the chart. The default value is enabled (axis labels are displayed).

 

Don't Show First Group Label: When "Show Group Axis Labels" is selected (þ), this field can be used to include/exclude the first label on the O1 Axis. The default value is not selected (include the first label).

 

Don't Show Last Group Label: When "Show Group Axis Labels" is selected (þ), this field can be used to include/exclude the last label on the O1 Axis. The default value is not selected (include the last label).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Group Axis Labels

setDisplay ( getO1Label(), true | false );

 

Don't Show First Group Label

setExcludeMinLabel ( getO1Label(), true | false );

 

Down Show Last Group Label

setExcludeMaxLabel ( getO1Label(), true | false );

3D Series Axis

This dialog is displayed when the Series Axis Tab is selected in 3D Chart Settings. Use the check boxes to enable/disable the display all series labels, the first series label, and/or the last series label. Select the Apply button to add these selections to the chart.

 

Show Series Axis Labels: This field enables/disables the display of labels on the O2 axis in the chart. The default value is enabled (axis labels are displayed).

 

Don't Show First Series Label: When "Show Series Axis Labels" is selected (þ), this field can be used to include/exclude the first label on the O2 Axis. The default value is not selected (include the first label).

 

Don't Show Last Series Label: When "Show Group Series Labels" is selected (þ), this field can be used to include/exclude the last label on the O2 Axis. The default value is not selected (include the last label).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Series Axis Labels

setDisplay ( getO2Label(), true | false );

 

Don't Show First Series Label

setExcludeMinLabel ( getO2Label(), true | false );

 

Don't Show Last Series Label

setExcludeMaxLabel ( getO2Label(), true | false );

3D Grid

This dialog is displayed when the Markers Tab is selected in 3D Chart Settings. Use the check boxes in this dialog to enable/disable the grid lines on the 3D cube and risers. Select the Apply button to add these selections to the chart.

 

Display Y-Axis Grids on Left Wall: This field enables/disables the display of Y-axis grid lines on the left wall of the 3D cube. The default value is not selected (do not display Y-axis grid lines on the left wall of the 3D cube).

 

Display Y-Axis Grids on Right Wall: This field enables/disables the display of Y-axis grid lines on the right wall of the 3D cube. The default value is not selected (do not display Y-axis grid lines on the right wall of the 3D cube).

 

Display Y-Axis Grids on Risers: This field enables/disables the display of Y-axis grid lines on the risers in the chart. The default value is not selected (do not display Y-axis grid lines on risers).

 

Display Series Axis Grids on Floor: This field enables/disables the display of series/O2-axis grid lines on the floor of the 3D cube. The default value is not selected (do not display O2-axis grid lines on the 3D cube floor).

 

Display Series Axis Grids on Right Wall: This field enables/disables the display of series/O2-axis grid lines on the right wall of the 3D cube. The default value is not selected (do not display O2-axis grid lines on the 3D cube right wall).

 

Display Group Axis Grids on Floor: This field enables/disables the display of group/O1-axis grid lines on the floor of the 3D cube. The default value is not selected (do not display O1-axis grid lines on the 3D cube floor).

 

Display Group Axis Grids on Right Wall: This field enables/disables the display of group/O1-axis grid lines on the right wall of the 3D cube. The default value is not selected (do not display O1-axis grid lines on the 3D cube right wall).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Display Y Axis Grids on Left Wall

setDisplay ( getCubeLeftWallGridY(),true | false);

 

Display Y Axis Grids on Right Wall

setDisplay ( getCubeRightWallGridY(),true | false);

 

Display Y Axis Grids on Risers

setDisplay ( getCubeRiserGridY(),true | false);

 

Display Series Axis Grids on Floor

setDisplay ( getCubeFloorGridX(),true | false);

 

Display Series Axis Grids on Right Wall

setDisplay ( getCubeRightWallGridX(),true | false);

 

Display Group Axis Grids on Floor

setDisplay ( getCubeFloorGridZ(),true | false);

 

Display Group Axis Grids on Left Wall

setDisplay ( getCubeLeftWallGridZ(),true | false);

3D CUSTOM VIEWING ANGLES

This option is included in the menu when a 3D graph is selected in the Graph Type menu:

 

 

The 3D Custom Viewing Angle menu includes these dialogs:

 

Rotate Cube

 

3D Pan Cube

 

Define Wall Sizes

 

Zoom In/Out Cube

 

2D Pan Cube

 

Set the cube focus factor

Rotate 3D Cube

This dialog is displayed when the Rotate Tab is selected in 3D Custom Viewing Angles. Position the mouse pointer over an arrow in the dialog and hold down the primary mouse button to rotate the 3D cube in the direction of the arrow. Select the Apply button to add these selections to the chart. Selections in this dialog add the following properties and methods to the code that defines this chart:

 

setCubeRotationMatrix ( value, value, value, value, ...)

3D Pan 3D Cube

This dialog is displayed when the 3D Pan tab is selected in 3D Custom Viewing Angles. Position the mouse pointer over an arrow in the dialog and hold down the primary mouse button to pan the 3D cube in the direction of the arrow. Select the Apply button to add these selections to the chart.

 

ç è : Use the left-arrow and right-arrow to move the 3D cube in the X-direction (in virtual coordinates). Each mouse click moves the cube left or right 100 units in virtual coordinates. Hold the primary mouse button down to move the cube continuously in the X-direction.

 

é ê : Use the up-arrow and down-arrow to move the 3D cube in the Y-direction (in virtual coordinates). Each mouse click moves the cube up or down 100 units in virtual coordinates. Hold the primary mouse button down to move the cube continuously in the Y-direction.

 

Front-Arrow/Back-Arrow: Use the front-arrow and back-arrow to move the 3D cube in the Z-direction. Each mouse click moves the cube forward or backward 100 units in 2D virtual coordinates. Hold the primary mouse button down to move the cube continuously in the Z-direction.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

ç è

setCubeTranslationX ( value );

 

é ê

setCubeTranslationY ( value );

 

Front/Back Arrows

setCubeTranslationZ ( value );

3D Cube Walls

This dialog is displayed when the Walls tab is selected in 3D Custom Viewing Angles. Position the mouse pointer over an arrow in the dialog and hold down the primary mouse button to adjust the thickness and size of walls in the 3D cube in the direction of the arrow. Select the Apply button to add these selections to the chart.

 

Upper-Left Corner of Cube Wall é ê : Use these arrows to increase/decrease the thickness of the cube left wall in the X-direction.

 

Center of Cube Wall é ê : Use these arrows to increase/decrease the size of the cube in the Y-direction.

 

Upper-Right Corner of Cube Wall é ê : Use these arrows to increase/decrease the thickness of the cube right wall in the Z-direction.

 

Left Center of Cube é ê : Use these arrows to increase/decrease the size of the cube in the Z-direction.

 

Right Center of Cube é ê : Use these arrows to increase/decrease the size of the cube in the X-direction.

 

Bottom of Cube é ê : Use these arrows to change the thickness of the floor.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Top Left Corner of Cube Wall (ç è )

setCubeWallThickX ( value );

 

Top Center of Cube Wall (ç è )

setCubeSizeY ( value );

 

Top Right Corner of Cube Wall (ç è )

setCubeWallThickZ ( value );

 

Center Left of Cube Wall (ç è )

setCubeSizeZ ( value );

 

Center Right of Cube Wall (ç è )

setCubeSizeX ( value );

 

Bottom of Cube (ç è )

setCubeWallThickY ( value );

Zoom 3D Cube

This dialog is displayed when the Zoom tab is selected in 3D Custom Viewing Angles. Position the mouse pointer over an arrow in the dialog and hold down the primary mouse button to zoom the 3D cube in the direction of the arrow. Select the Apply button to add these selections to the chart.

 

ì : Use the up-arrow to set the cube zoom factor to negative values. Values less than one make the cube smaller, values greater than one make the cube larger. The cube becomes smaller within the chart frame.

 

í : Use the down arrow to set the cube zoom factor to positive values. The cube becomes larger within the chart frame.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

ì

setCubeZoomFactor ( +value );

 

í

setCubeZoomFactor ( -value );

2D Pan 3D Cube

This dialog is displayed when the 2D Pan tab is selected in 3D Custom Viewing Angles. Position the mouse pointer over an arrow in the dialog and hold down the primary mouse button to pan the 3D cube in the direction of the arrow. Select the Apply button to add these selections to the chart.

 

ç è : Use the left-arrow and right-arrow to move the 3D cube in the X-direction (in 2D virtual coordinates). Each mouse click moves the cube left or right 100 units in virtual coordinates. Hold the primary mouse button down to move the cube continuously in the X-direction.

 

é ê : Use the up-arrow and down-arrow to move the 3D cube in the Y-direction (in 2D virtual coordinates). Each mouse click moves the cube up or down 100 units in virtual coordinates. Hold the primary mouse button down to move the cube continuously in the Y-direction.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

ç è

setCubePanX ( value );

 

é ê

setCubePanY ( value );

FOV

This dialog is displayed when the FOV tab is selected in 3D Custom Viewing Angles. Position the mouse pointer over a cube in the dialog and hold down the primary mouse button to change the cube focus factor. Select the Apply button to add these selections to the chart.

 

Front Cube: Hold down the primary mouse button on the front cube to make the 3D cube smaller within the chart frame.

 

Back Cube: Hold down the primary mouse button on the back cube to make the 3D cube larger within the chart frame.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

setCubeFocusFactor( value );

3D PRESET VIEWING ANGLES

This option is included in the menu when a 3D graph is selected in the Graph Type menu:

 

 

When the 3D Preset Viewing Angles option is selected from the menu, this dialog is displayed:

 

 

Select one of the preset viewing angles in this dialog. It will automatically be applied to the graph. This selection will add the following property to the code that defines the chart.

 

set3DViewingAnglePreset (value );

 

Where: value = a number in the range 0...15

BAR, LINE, AREA CHART SETTINGS

This option is included in the menu when a Bar, Line, or Area graph is selected in the Graph Type menu:

 

 

The Bar, Line, Area Chart Settings menu includes these dialogs:

 

Draw from zero line and data text displays.

 

Define Riser types (bar, line, area) for each series.

 

Apply a 3D effect to the graph.

 

Define the look of bar risers.

 

Select marker types and sizes.

Bar, Line, Area General Settings

This dialog is displayed when the General Tab is selected in Bar, Line, Area Chart Settings. The Draw from Zero Line check box enables/disables drawing of risers from zero. The Show Data Values check box enables/disables the display of data text values next to risers. When the Show Data Values check box is selected (þ ), use the Position and Distance slider bars to define where the data values are displayed.

 

Select the Apply button to add these selections to the chart.

 

Draw from Zero Line: In applications where the data range can include negative numbers, this field determines whether the risers will be drawn pointing up and down from a zero line or whether all risers will draw straight up from the "bottom" of the graph. The default value is draw from a zero line (this field is selected).

 

Show Data Values: This field enables/disables the display of data values next to risers or markers in a chart. The default value is disabled.

 

Position: When the "Show Data Values" field is selected (þ), this field sets an angle from center-point that all data text is drawn from. The default value is 90 degrees.

 

Distance: When the "Show Data Values" field is selected (þ), this field sets the radius that a data text value will be drawn out from the center of a chart riser. The default value is 20.

ý NOTE:

In this release of the Perspective for Java Editor, it is necessary to enter setDataTextPosition(0); in the message window and use the "Input Param String from Message Window" option in the file menu in order to use the Position and Distance sliders in this dialog.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Draw from Zero Line

setScaleFromZero ( true | false );

 

Show Data Values

setDisplay (getDataText(), true | false );

 

Position

setDataTextAngle ( value );

 

Distance

setDataTextRadius ( value );

Bar, Line Area Combo Settings

This dialog is displayed when the Combo tab is selected in Bar, Line, Area Chart Settings. Select a riser in the chart in the editor window. Then choose one of the selections in this dialog to assign a riser type (bar, line, area, or default for graph type) to the series. Select the Apply button to add these selections to the chart. Selections in this dialog add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Bar

setSeriesType(getSeries(#),1);

 

Line

setSeriesType(getSeries(#),2);

 

Area

setSeriesType ( getSeries(#), 3 );

 

Default for Graph type

setSeriesType ( getSeries(#), 0 );

Bar, Line Area Extrude Settings

This dialog is displayed when the Extrude tab is selected in Bar, Line, Area Chart Settings. Use 3D Extrusion Effect enables/disables the application of a 3D effect on a 2D chart. When this check box is selected (þ ), use the Direction, Thickness, and Line Thickness slider bars to define the depth angle and thickness of the 3D extrusion effect. Select the Apply button to add these selections to the chart.

 

Use 3D Extrusion: This field determines whether or not a 3D effect is applied to this 2D graph. When it is selected (þ), use the Direction and Thickness fields to specify how much 3D effect is applied to the chart frame and risers. The default value is selected (þ).

 

Direction: When the "Use 3D Extrusion" field is selected (þ), this field sets the angle of a line from the front of the chart frame to the back (in degrees). The default value is 45.

 

Thickness: When the "Use 3D Extrusion" field is selected (þ), this field sets how far out the extruded frame will be extended. Small values produce a very narrow chart, larger values produce a thicker chart. The default value is 25.

 

Line Thickness: When the "Use 3D Extrusion" field is selected (þ) for a vertical or horizontal line chart or a combo chart with lines, this field defines the width of the "fake 3D" lines in the chart. It is expressed as a value in the range 1 to 100. A value of 1 produces very thin lines, a value of 100 produces very thick 3D ribbons. The default value is 30.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Use 3D Extrusion (not selected)

setDepthRadius( 0 );

 

Direction

setDepthAngle ( value );

 

Thickness

setDepthRadius ( value );

 

Line Thickness

setDataLineThickness ( value );

Bar, Line, Area Options 1

This dialog is displayed when this Options Tab is selected in Bar, Line, Area Chart Settings. The Show as Pictograph check box enables/disables the display of bar risers as a pictograph. Enable Bar Resizing... enables/disables the user's ability to resize bars in a chart with the CTRL/primary mouse button. Use the Width and Spacing slider bars to define the width of bar risers and the spacing between them.

 

Select the Apply button to add these selections to the chart.

 

Show as Pictograph: This field enables/disables the display of bars as pictographs in a flat 2D chart. The default value is disabled. Note that the "Use 3D Extrusion" field in the Extrude Settings dialog must be disabled in order to use this feature.

 

Enable Bar Resizing with CTRL+Resize: This field enables/disables resize bar mode. When it is enabled (þ), the user interface will allow resizing of bars. The user can change the size of bars by using the control key and the mouse to stretch or reduce the size of the bars. This action will also change the internal data value assigned to the bar. If data callbacks are being used to provide data input to the chart, any resize operation will be reset to the value provided by the data call back. The default value is selected (the user can resize bars).

 

Width: This field controls the width of bars in a graph. The riser width is expressed as a percentage of the space available for each group of bars. When this field is set to 100, all bars touch each other and there is no space in between them. When this field is set to zero, the bars are displayed as thin lines with no space detectable. The default value is 75.

 

Spacing: For bar graphs only, this field sets the spacing between bars within a group (clusters) in a side-by-side bar graph. A larger number creates more space between bars within a group. When this field is set to zero, there is no space between the bars within a group and all bars within the group will touch each other. When this field is set to 100, the bars within a group are as far apart as possible. The default value is zero.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show as Pictograph

setDisplayBarAsPictograph ( true | false );

 

Enable Bar Resizing with CTRL+Resize

setResizeBarMode ( true | false);

 

Width

setRiserWidth ( value );

 

Spacing

setRiserBarGroupSpacing ( value );

Bar, Line, Area Options 2

This dialog is displayed when this Options Tab is selected in Bar, Line, Area Chart Settings. For Line charts, the Show Marker check box enables/disables the display of markers. When this check box is selected, the Marker Shape and Marker Size fields define the shape and size of the markers. Use Marker Shapes on Legends enables/disables the use of the selected marker shapes in the legend area of the chart. Show Lines enables/disables the display of connecting lines in a line chart.

 

Select the Apply button to add these selections to the chart.

 

Show Marker: This field enables/disables the display of markers in a 2D chart. Use this field to turn off markers in a Line Chart when you only want to see the lines themselves and not the markers. The default value is selected (markers are displayed). Note that the Thickness field in the Extrude dialog must be set to zero in order for this selection to be properly applied to the chart.

 

Marker Shape: When "Show Marker" is selected (þ) for a line chart, use this field to select a marker shape for each series in the chart. Click on a series in the chart and then select a marker shape in this dialog.

 

Marker Size: When "Show Marker" is selected (þ) for a line chart, use this field to select the size of markers. The default value is 30.

 

Use Marker Shapes on Legends: This field enables/disables the use of the series shapes selected in the "Marker Shape" field in the legend area of the chart.

 

Show Lines: This field enables/disables the display of connecting markers in a line chart. When this field is not selected in a line chart, the result will be a "floating marker" effect with only markers and no connecting lines.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Marker

setMarkerDisplay ( true | false );

 

Marker Shape

setMarkerShape ( getSeries(#), value );

 

Marker Size

setMarkerSize ( getSeries(#), value );

 

Use Marker Shapes on Legends

setUseSeriesShapes ( true | false );

 

Show Lines

setConnectLineMarkers ( true | false);

DUAL Y SETTINGS

This option is only included in the menu when a dual-axis chart is selected.

 

 

When Dual Y Settings is selected, this dialog is displayed:

 

 

Y1 Axis/Y2 Axis: In dual axis charts, these fields can be used to specify which series appear on each numeric (Y1 and Y2) axis in the chart. Select one or more series in the Y2 Axis list box and select the << button to move these series to the Y1 axis in the chart. Select one or more series in the Y1 Axis list box and select the >> button to move these series to the Y2 Axis in the chart. You can also double click on a series to move it from one axis to the other.

 

Split Position: This field sets the position within the chart frame where the Dual-Y split position will be created. The default value of 50 is exactly in the middle. A lower number will move the split position closer to the bottom of the chart; a higher value will move it closer to the top of the chart.

 

Dual Axis Line/Plane: This field enables/disables the display of a line that separates the two halves of a dual axis chart. The default value is selected (þ), the dual-axis split line is displayed.

 

Select the Apply button to add these selections to the chart.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Y1 Axis

setAxisAssignment ( getSeries(#), 0 );

 

Y2 Axis

setAxisAssignment ( getSeries(#), 1 );

 

Split Position

setDualAxisSplitPosition ( value );

 

Dual Axis Line/Plane

setDisplay ( getFrameSeparator(), true | false);

GROUP AXIS SETTINGS

This option is included in the menu when a Bar, Line, Area, or Stock chart is selected in the Graph Type menu:

 

 

The Group Axis Settings menu includes these dialogs:

 

Define where the group axis is imaged.

 

Enable/Disable group axis label displays.

 

Select group axis grid lines.

Group Axis General Settings

This dialog is displayed when the General tab is selected in Group Axis Settings. Select the location where you want the group axis label to appear in the chart. Select the Apply button to add these selections to the chart.

 

Bottom Side of Chart: Select this field (þ) if you want the primary ordinal (O1) axis to be imaged at the bottom of a vertical chart or on the left side of a horizontal chart. This is the default value.

 

Top Side of Chart: Select this field (þ) if you want the primary ordinal (O1) axis to be imaged at the top of a vertical chart or the right side of a horizontal chart.

 

Both Sides of Chart: Select this field (þ) if you want the primary ordinal (O1) axis to be imaged at the top and bottom of a vertical chart or left and right sides of a horizontal chart.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Bottom Side of Chart

setAxisSide (getO1Axis(), 0);

 

Top Side of Chart

setAxisSide (getO1Axis(), 1);

 

Both Sides of Chart

setAxisSide (getO1Axis(), 2);

Group Axis Labels

This dialog is displayed when the Labels tab is selected in Group Axis Settings. Use the check boxes to enable/disable the display of group axis labels. Select the Apply button to add these selections to the chart.

 

Show Axis Labels: This field enables/disables the display of primary ordinal (O1) axis labels. The default value is enabled (group/O1 axis labels are displayed).

 

Don't Show First Label: When "Show Axis Labels" is selected (þ), this field enables/disables the display of the first group label on the primary ordinal (O1) axis. The default value is disabled (the first group label is displayed).

 

Don't Show Last Label: When "Show Axis Labels" is selected (þ), this field enables/disables the display of the last group label on the primary ordinal (O1) axis. The default value is disabled (the last group label is displayed).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Axis Labels

setDisplay ( getO1Label(), true | false);

 

Don't Show First Label

setExcludeMinLabel ( getO1Label(), true | false );

 

Don't Show Last Label

setExcludeMaxLabel ( getO1Label(), true | false );

Group Axis Grids

This dialog is displayed when the Grids tab is selected in Group Axis Settings. Use the check boxes in this dialog to enable/disable the display of major and minor grid lines. When either check box is selected, use the Style field to select a major and minor grid line format. Select the Apply button to add these selections to the chart.

 

Show Major Grid Lines: This field enables/disables the display of major grid lines for the primary ordinal (O1) axis. The default value is enabled (þ).

 

Style: When "Show Major Grid Lines" is selected (þ), use this field to select the style of the major grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

 

Show Minor Grid Lines: This field enables/disables the display of minor grid lines for the primary ordinal (O1) axis. The default value is disabled (minor grid lines are not displayed).

 

Style: When "Show Minor Grid Lines" is selected (þ), use this field to select the style of the minor grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Major Grid Lines

setDisplay ( getO1MajorGrid(), true | false );

 

Style

setGridStyle ( getO1MajorGrid(), value );

 

Show Minor Grid Lines

setDisplay ( getO1MinorGrid(), true | false );

 

Style

setGridStyle ( getO1MinorGrid(), value );

PIE CHART SETTINGS

This option is included in the menu when a Pie chart is selected in the Graph Type menu:

 

 

The Pie Chart Settings menu includes these dialogs:

 

Select feeler and label displays and delete slices.

 

Select the Pie Tilt and Depth.

 

Select Ring Pie formats.

 

Select the number of pies in a multiple pie chart.

Pie Chart Slices

This dialog is displayed when the Slices tab is selected in Pie Chart Settings. Select one of the radio buttons to enable/disable the display of feelers and text labels. Select the format of labels in the Format field. Select a slice in the pie chart in the editor window and select the "Delete Selected Slices" check box to remove the selected slice from the chart. The "Restore All Slices" check box will restore any deleted slices. Select the Apply button to add these selections to the chart.

 

Show Feeler and Text Labels: Select this field (þ) if you want to display feeler lines and text labels in a pie chart. This is the default value for all pie chart types.

 

Show Labels on Slices: Select this field (þ) if you want to display text labels only on slices in the pie chart. Feeler lines will not be drawn.

 

Show Labels Next to Slices: Select this field (þ) if you want to display text labels only next to slices in the pie chart. Feeler lines will not be drawn.

 

No Feelers or Labels: Select this field (þ) if you do not want to display feeler lines or text labels in the pie chart.

 

Format: When "Show Feeler and Text Labels", "Show Labels on Slices", or "Show Labels Next to Slices" is selected (þ), use the field to specify the format of text labels that are displayed: General, 0%, 0.0%, $0, $0.00, etc. The default value is 0%.

 

Delete Selected Slices: Select a slice in a pie chart, and select this field (þ) to delete the slice from the chart. If a multiple pie chart type is selected, all slices for the respective series will be deleted.

 

Restore All Slices: When the "Delete Selected Slices" field has been used to delete one or more slices from a pie chart, this field will restore all of the deleted slices.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Feeler and Text Labels

setPieFeelerTextDisplay (1);

 

Show Labels on Slices

setPieFeelerTextDisplay (3);

 

Show Labels Next to Slices

setPieFeelerTextDisplay (2);

 

No Feelers or Labels

setPieFeelerTextDisplay (0);

 

Format

setTextFormatPreset ( getPieSliceLabel(), value );

 

Delete Selected Slices

setPieSliceDelete ( getSeries(#), true | false );

 

Restore all Slices

Not Stored

Pie Chart Look

This dialog is displayed when the Look tab is selected in Pie Chart Settings. Use the slider bars in this dialog to adjust the tilt, rotation and depth of the chart. Select the Apply button to add these selections to the chart.

 

Pie Tilt: This field tilts a pie chart a specified number of degrees. The default value is 15.

 

Pie Rotate: This field rotates a pie chart a specified number of degrees. The default value is zero.

 

Pie Depth: This field specifies the depth of the piecrust in a pie chart. The default value is 30.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Pie Tilt

setPieTilt ( value );

 

Pie Rotation

setPieRotate ( value);

 

Pie Depth

setPieDepth ( value );

Pie Chart Ring Settings

This dialog is displayed when the Ring tab is selected in Pie Chart Settings. You must have previously selected a ring pie chart type in the Graph Type Menu. Use the slider bar to adjust the size of the ring in a ring pie chart. The check box enables/diables the display of a total value in the center of the ring in a pie chart. When this check box is selected, use the Format field to select the format of the total value. Select the Apply button to add these selections to the chart.

 

Pie Ring Hole Size: This field determines the relative size of the ring (inner circle) in a ring pie. The default value is 55.

 

Show Pie Ring Total: This field enables/disables the display of a total value in the center of a pie ring chart. The default value is enabled (þ).

 

Format: When "Show Pie Ring Total" is selected (þ), use the field to specify the format of total value: General, 0%, 0.0%, $0, $0.00, etc. The default value is General.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Pie Ring Hole Size

setPieRingSize ( value );

 

Show Pie Ring Total

setDisplay ( getPieRingLabel(), true | false);

 

Format

setTextFormatPreset ( getPieRingLabel(), value );

Pie Chart Multiples

This dialog is displayed when the Multi tab is selected in Pie Chart Settings. You must have previously selected a multi-pie chart type in the Graph Type Menu. Use the slider bar in this dialog to select the number of pies per row in a multi-pie chart. Select the Apply button to add these selections to the chart. Selections in this dialog add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Pies Per Row

setPiesPerRow ( value );

STOCK CHART SETTINGS

This option is included in the menu when a stock chart is selected in the Graph Types menu:

 

 

The Stock Chart Settings menu includes these dialogs:

 

Enable/Disable moving average line and data files. Define the format and location of data values.

 

Enable/Disable the 52-week high and low line display

 

Enable/Disable Open/Close tick marks and define the width and length.

Stock Chart General Settings

This dialog is displayed when the General tab is selected in Stock Chart Settings. Use the check boxes in this dialog to enable/disable the display of a moving average line and data values in the stock chart. When Show Data Values is selected, use the Position and Distance slider bars to define the location of data values. The Bar Width slider bar can be used to adjust the width of risers in the chart.

 

Select the Apply button to add these selections to the chart.

 

Show Moving Average Line: This field enables/disables the display of a moving average line in the stock chart. The default value is disabled.

 

Show Data Values: This field enables/disables the display of High values only. If the chart does not have a high value, no data value is displayed. The default value is disabled.

 

Position: When the "Show Data Values" field is selected (þ), this field sets an angle from center-point that all data text is drawn from. The default value is 90 degrees.

 

Distance: When the "Show Data Values" field is selected (þ), this field sets the radius that a data text value will be drawn out from the center of a chart riser. The default value is 20.

ý NOTE:

In this release of the Perspective for Java Editor, it is necessary to enter setDataTextPosition(0); in the message window and use the "Input Param String from Message Window" option in the file menu in order to use the Position and Distance sliders in this dialog.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Moving Average Line

setDisplay(getStockMALine(), true | false );
 

Show Data Values

setDisplay(getDataText(), true | false );
 

Position

setDataTextAngle ( value );
 

Distance

setDataTextRadius ( value );
 

Bar Width

setRiserWidth ( value );

Stock Chart 52-Week Settings

This dialog is displayed when the 52-Week tab is selected in Stock Chart Settings. Use the check boxes to enable/disable the display of a 52-Week High and/or Low Line in the stock chart. When enabled for display, enter a 52-Week High and/or Low value in the fields below. Select the Apply button to add these selections to the chart.

 

Show 52-Week High Line: This field enables/disables the display of a 52-week high line in a stock chart. The default value is disabled.

 

Value: When "Show 52-Week High Line" is selected (þ), use this field to define a 52-week high value. The default value is 40.0.

 

Show 52-Week Low Line: This field enables/disables the display of a 52-week low line in a stock chart. The default value is disabled.

 

Value: When "Show 52-Week Low Line" is selected (þ), use this field to define a 52-week low value. The default value is 10.0.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show 52-Week High Line

setDisplay(getStock52WeekHighLine(), true | false );
 

Value

setStock52WeekHighValue ( value );
 

Show 52-Week Low Line

setDisplay(getStock52WeekLowLine(), true | valse);
 

Value

setStock52WeekLowValue ( value );

Stock Chart Tick Settings

This dialog is displayed when the Ticks tab is selected in Stock Chart Settings. Select the Apply button to add these selections to the chart.

 

Split Riser at Close Value: This field enables/disables the display of split risers at the stock close value. The default value is enabled.

 

Thickness: This field sets the thickness of tick marks in a stock chart. The default value is 2 pixels. If close and/or open values are not available, the tick mark(s) will not be displayed.

ý NOTE:

The thickness of tick marks can also be controlled by selecting the tick mark object and using the Color and Line Settings dialog. See Chapter 3 for details.

 

Length: This field sets the length of tick marks in a stock chart. The default value is 50. If close and/or open values are not available, the tick mark(s) will not be displayed.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Split Riser at Close Value

setDisplay(getStockLowerRiser(), true | false );
 

Thickness

setLineWidth(getStockCloseTick(), value );
 

Length

setStockTickLength (value );

X1 AXIS SETTINGS

This option is included in the menu for graph types that have an X-axis (e.g., XY Scatter Charts, Polar Charts, and Histograms):

 

 

The X1 Axis Settings menu includes these dialogs:

 

Location, format, and display of the X1 Axis
 

Automatic/Manual and Minimum/Maximum Scaling
 

Display and Format of X1 Axis Labels
 

Automatic/Manual and Minimum/Maximum Grids

X1 Axis General Settings

This dialog is displayed when the General tab is selected in X1 Axis Settings. Select the location in the chart where you want the axis imaged. Descending Axis draws the axis labels in ascending or descending order. The Axis Line and Zero Line check boxes enable/disable display of the axis base line and zero line. Select the Apply button to add these selections to the chart.

 

Left Side of Chart: Select this field (þ) if you want the X1 numeric axis to be imaged at the left side of a horizontal chart or on the bottom side of a vertical chart. This is the default value.

 

Right Side of Chart: Select this field (þ) if you want the X1 numeric axis to be imaged at the right of a horizontal chart or the top of a vertical.

 

Both Sides of Chart: Select this field (þ) if you want the X1 numeric axis to be imaged at the top and bottom of a vertical chart or left and right sides of a horizontal chart.

 

Descending: This field is used to select descending or ascending values on the X1 numeric. The default value is ascending (this field is not selected). For example, assume the values 0, 10, 20, ... 70 are displayed from left to right across the bottom of an XY Scatter chart. If this field is selected and applied to the chart, these values would be displayed from right-to-left across the bottom of the chart (70, 60, 50...0)

 

Axis Line: This field is used to enable/disable the display of the X1 axis base line. The default value is enabled (þ).

 

Zero Line: This field is used to enable/disable the display of a zero line on the X1 axis. The default value is disabled (this field is not selected).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Left Side of Chart

setAxisSide ( getX1Axis(), 0 );

 

Right Side of Chart

setAxisSide ( getX1Axis(), 1 );

 

Both Sides of Chart

setAxisSide ( getX1Axis(), 2 );

 

Descending Axis

setAxisDescending ( getX1Axis(), true | false );

 

Axis Line

setDisplay ( getX1AxisLine(), true | false);

 

Zero Line

setDisplay ( getX1ZeroLine(), true | false );

X1 Axis Scale Settings

This dialog is displayed when the Scale tab is selected in X1 Axis Settings. The check boxes enable/disable "Always include Zero", log scale, and manual maximum and minimum scaling. When manual maximum and/or minimum scaling is enabled, enter values in the Max Value and/or Min Value fields. Select the Apply button to add these selections to the chart.

 

Always Include Zero on Scale: This field selects whether or not the X1 axis must include a zero value. If the Log Scale field is selected or the Max Value or Min Value is greater than zero, this will be grayed-out. It is not valid when the logarithmic scale is used or Min and Max Values are greater than zero. The default value is not selected (a zero is not required on the X1 axis).

 

Log Scale: This field selects logarithmic or linear scale for the numeric X1-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 (Min Value is less than or equal to zero), the request for log scale is ignored. The default value is linear scale (this field is not selected).

 

Use Manual Setting for Maximum: This field selects manual/automatic calculation of the maximum scale value on the X1 axis in the chart. If this field is selected (þ), enter the maximum allowable scale value on the X1 axis in the Max Value field. The default value is not selected (let the charting engine automatically calculate the maximum value on the X1 Axis).

 

Max Value: When the "Use Manual Setting for Maximum" field is selected (þ), use this field to specify the maximum allowable scale value on the X1 axis. The default value is 70.0.

 

Use Manual Setting for Minimum: This field selects manual/automatic calculation of the minimum scale value on the X1 axis in the chart. If this field is selected (þ), enter the minimum allowable scale value on the X1 axis in the Min Value field. The default value is not selected (let the charting engine automatically calculate the minimum value on the X1 Axis).

 

Min Value: When the "Use Manual Setting for Minimum" field is selected (þ), use this field to specify the minimum allowable scale value on the X1 axis. The default value is 0.0.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Always Include Zero

setScaleMustIncludeZero (getX1Axis(), true | false );

 

Log Scale

setLogScale ( getX1Axis(), true | false );

 

Use Manual setting for Maximum

setScaleMaxAuto ( getX1Axis(), true | false );

 

Max Value

setScaleMax ( getX1Axis(), value);

 

Use Manual setting for Minimum

setScaleMinAuto ( getX1Axis(), true | false );

 

Min Value

setScaleMin ( getX1Axis(), value);

X1 Axis Labels

This dialog is displayed when the Labels tab is selected in X1 Axis Settings. Use the check boxes to enable/disable the display of all axis labels, the minimum axis label, or the maximum axis label. When Show Axis Labels is selected, select a label format in the Format field. Select the Apply button to add these selections to the chart.

 

Show Axis Labels: This field enables/disables the display of labels on the X1 axis in the chart. The default value is enabled (axis labels are displayed). Use the Format field to define the format of numeric labels. When this box is checked, the setting in the general tab determines where the labels are displayed (left, right, both).

 

Format: When "Show Axis Labels" is selected (þ), select the drop-down list box in this field to select a label format: General, 0%, 0.0%, $0, $0.00, etc. The default value is "General".

 

Don't Show Minimum Value: When "Show Axis Labels" is selected (þ), this field can be used to include/exclude the minimum value on the X1 Axis. The default value is not selected (include the minimum label).

 

Don't Show Maximum Value: When "Show Axis Labels" is selected (þ), this field can be used to include/exclude the maximum value on the X1 Axis. The default value is not selected (include the maximum label).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Axis Labels

setDisplay ( getX1Label(), true | false );

 

Format

setTextFormatPreset ( getX1Label(), value );

 

Don't Show Minimum Value

setExcludeMinLabel ( getX1Label(), true | false );

 

Don't Show Maximum Value

setExcludeMaxLabel ( getX1Label(), true | false );

X1 Axis Grids

This dialog is displayed when the Grids tab is selected in X1 Axis Settings. Use the check boxes in this dialog to enable/disable the display of major and minor grid lines. When either check box is selected, use the Style field to select the format of major and minor grid lines. The Automatic Grids radio buttons enable/disable automatic calculation of the number of major/minor grid lines. When these radio buttons are not selected, select a number of major or minor grid lines in the Manual Intervals fields.

 

Select the Apply button to add these selections to the chart.

 

Show Major Grid Lines: This field enables/disables the display of major grid lines for the X1 axis. The default value is enabled (þ).

 

Style: When "Show Major Grid Lines" is selected (þ), use this field to select the style of the major grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

 

Automatic Grids: This field enables/disables automatic calculation of the number of major grid lines on the X1-axis. The default value is enabled (the number of major grid lines on the X1-axis is automatically calculated). When this field is not selected, specify the number of grid steps in the "Manual Intervals" field.

 

Manual Intervals: When "Automatic Grids" is not selected, use this field to set the number of major grid lines/steps that will be imaged on the X1-axis. 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 field is set to 5. If this field is set to 10, grid steps 1, 11, 21, 31...51 would be displayed. Do not use a negative value or a value that results in greater than 50 grid lines.

 

Show Minor Grid Lines: This field enables/disables the display of minor grid lines for the X1 axis. The default value is disabled (minor grid lines are not displayed on the X1-axis).

 

Style: When "Show Minor Grid Lines" is selected (þ), use this field to select the style of the minor grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

 

Automatic Grids: This field enables/disables automatic calculation of the number of minor grid lines on the X1-axis. The default value is enabled (the number of minor grid lines on the X1-axis is automatically calculated). When this field is not selected, specify the number grid steps in the "Manual Intervals" field

 

Manual Intervals: When "Automatic Grids" is not selected, use this field to set the number of minor grid lines/steps that will be imaged on the X1-axis. Do not use a negative value or a value that results in greater than 50 grid lines.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Major Grid Lines

setDisplay ( getX1MajorGrid(), true | false );

 

Style

setGridStyle ( getX1MajorGrid(), value );

 

Automatic Grids

setGridStepAuto ( getX1MajorGrid(), true | false );

 

Manual Intervals

setGridStep ( getX1MajorGrid(), value );

 

Show Minor Grid Lines

setDisplay ( getX1MinorGrid(), true | false );

 

Style

setGridStyle ( getX1MinorGrid(), value );

 

Automatic Grids

setGridStepAuto ( getX1MinorGrid(), true | false );

 

Manual Intervals

setGridStep ( getX1MinorGrid(), value );

Y1 AXIS SETTINGS

This option is included in the menu for all graph types except Pies:

 

 

The Y1 Axis Settings menu includes these dialogs:

 

Location, format, and display of the Y1 Axis
 

Automatic/Manual and Minimum/Maximum Scaling
 

Display and Format of Y1 Axis Labels
 

Automatic/Manual and Minimum/Maximum Grids

Y1 Axis General Settings

This dialog is displayed when the General tab is selected in Y1 Axis Settings. Select the location in the chart where you want the axis imaged. Descending Axis draws the axis labels in ascending or descending order. The Axis Line and Zero Line check boxes enable/disable display of the axis base line and zero line. Select the Apply button to add these selections to the chart.

 

Left Side of Chart: Select this field (þ) if you want the Y1 numeric axis to be imaged at the left side of a vertical chart or on the bottom side of a horizontal chart. This is the default value.

 

Right Side of Chart: Select this field (þ) if you want the Y1 numeric axis to be imaged at the right of a vertical chart or the top of a horizontal chart.

 

Both Sides of Chart: Select this field (þ) if you want the Y1 numeric axis to be imaged at the left and right sides of a vertical chart or top and bottom of a horizontal chart.

 

Descending: This field is used to select descending or ascending values on the Y1 numeric. The default value is ascending (this field is not selected). For example, assume the values 0, 10, 20, ... 70 are displayed from bottom-to-top on the left side of a standard 2D bar chart. If this field is selected and applied to the chart, these values would be displayed from top-to-bottom and the risers are also imaged from the top of the chart rather than the bottom.

 

Axis Line: This field is used to enable/disable the display of the Y1 axis base line. The default value is enabled (þ).

 

Zero Line: This field is used to enable/disable the display of a zero line on the Y1 axis. The default value is disabled (this field is not selected).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Left Side of Chart

setAxisSide ( getY1Axis(), 0 );

 

Right Side of Chart

setAxisSide ( getY1Axis(), 1 );

 

Both Sides of Chart

setAxisSide ( getY1Axis(), 2 );

 

Descending Axis

setAxisDescending ( getY1Axis(), true | false );

 

Axis Line

setDisplay ( getY1AxisLine(), true | false);

 

Zero Line

setDisplay ( getY1ZeroLine(), true | false );

Y1 Axis Scale Settings

This dialog is displayed when the Scale tab is selected in Y1 Axis Settings. The check boxes enable/disable "Always include Zero", log scale, and manual maximum and minimum scaling. When manual maximum and/or minimum scaling is enabled, enter values in the Max Value and/or Min Value fields. Select the Apply button to add these selections to the chart.

 

Always Include Zero on Scale: This field selects whether or not the Y1 axis must include a zero value. If the Log Scale field is selected or the Max Value or Min Value is greater than zero, this will be grayed-out. It is not valid when the logarithmic scale is used or Min and Max Values are greater than zero. The default value is not selected.

 

Log Scale: This field selects logarithmic or linear scale 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 (Min Value is less than or equal to zero), the request for log scale is ignored. The default value is linear scale (this field is not selected).

 

Use Manual Setting for Maximum: This field selects manual/automatic calculation of the maximum scale value on the Y1 axis in the chart. If this field is selected (þ), enter the maximum allowable scale value on the Y1 axis in the Max Value field. The default value is not selected (let the charting engine automatically calculate the maximum value on the Y1 Axis).

 

Max Value: When the "Use Manual Setting for Maximum" field is selected (þ), use this field to specify the maximum allowable scale value on the Y1 axis. The default value is 70.0.

 

Use Manual Setting for Minimum: This field selects manual/automatic calculation of the minimum scale value on the Y1 axis in the chart. If this field is selected (þ), enter the minimum allowable scale value on the Y1 axis in the Min Value field. The default value is not selected (let the charting engine automatically calculate the minimum value on the Y1 Axis).

 

Min Value: When the "Use Manual Setting for Minimum" field is selected (þ), use this field to specify the minimum allowable scale value on the Y1 axis. The default value is 0.0.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Always Include Zero

setScaleMustIncludeZero (getY1Axis(), true | false );

 

Log Scale

setLogScale ( getY1Axis(), true | false );

 

Use Manual setting for Maximum

setScaleMaxAuto ( getY1Axis(), true | false );

 

Max Value

setScaleMax ( getY1Axis(), value);

 

Use Manual setting for Minimum

setScaleMinAuto ( getY1Axis(), true | false );

 

Min Value

setScaleMin ( getY1Axis(), value);

Y1 Axis Labels

This dialog is displayed when the Labels tab is selected in Y1 Axis Settings. Use the check boxes to enable/disable the display of all axis labels, the minimum axis label, or the maximum axis label. When Show Axis Labels is selected, select a label format in the Format field. Select the Apply button to add these selections to the chart.

 

Show Axis Labels: This field enables/disables the display of labels on the Y1 axis in the chart. The default value is enabled (axis labels are displayed). Use the Format field to define the format of numeric labels. When this box is checked, the setting in the general tab determines where the labels are displayed (left, right, both).

 

Format: When "Show Axis Labels" is selected (þ), select the drop-down list box in this field to select a label format: General, 0%, 0.0%, $0, $0.00, etc. The default value is "General".

 

Don't Show Minimum Value: When "Show Axis Labels" is selected (þ), this field can be used to include/exclude the minimum value on the Y1 Axis. The default value is not selected (include the minimum label).

 

Don't Show Maximum Value: When "Show Axis Labels" is selected (þ), this field can be used to include/exclude the maximum value on the Y1 Axis. The default value is not selected (include the maximum label).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Axis Labels

setDisplay ( getY1Label(), true | false );

 

Format

setTextFormatPreset ( getY1Label(), value );

 

Don't Show Minimum Value

setExcludeMinLabel ( getY1Label(), true | false );

 

Don't Show Maximum Value

setExcludeMaxLabel ( getY1Label(), true | false );

Y1 Axis Grids

This dialog is displayed when the Grids tab is selected in Y1 Axis Settings. Use the check boxes in this dialog to enable/disable the display of major and minor grid lines. When either check box is selected, use the Style field to select the format of major and minor grid lines. The Automatic Grids radio buttons enable/disable automatic calculation of the number of major/minor grid lines. When these radio buttons are not selected, select a number of major or minor grid lines in the Manual Intervals fields.

 

Select the Apply button to add these selections to the chart.

 

Show Major Grid Lines: This field enables/disables the display of the major grid lines for the Y1 axis. The default value is enabled (þ).

 

Style: When "Show Major Grid Lines" is selected (þ), use this field to select the style of the major grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

 

Automatic Grids: This field enables/disables automatic calculation of the number of major grid lines on the Y1-axis. The default value is enabled (the number of major grid lines is automatically calculated).

 

Manual Intervals: When "Automatic Grids" is not selected, use this field to set the number of major grid lines/steps that will be imaged on the Y1-axis. 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. Do not use a negative value or a value results that in greater than 50 grid lines.

 

Show Minor Grid Lines: This field enables/disables the display of the minor grid lines for the Y1 axis. The default value is disabled (minor grid lines are not displayed on the Y1-axis).

 

Style: When "Show Minor Grid Lines" is selected (þ), use this field to select the style of the minor grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

 

Automatic Grids: This field enables/disables automatic calculation of the number of minor grid lines on the Y1-axis. The default value is enabled (the number of minor grid lines is automatically calculated).

 

Manual Intervals: When "Automatic Grids" is not selected, use this field to set the number of minor grid lines/steps that will be imaged on the Y1-axis. Do not use a negative value or a value that results in greater than 50 grid lines.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Major Grid Lines

setDisplay ( getY1MajorGrid(), true | false );

 

Style

setGridStyle ( getY1MajorGrid(), value );

 

Automatic Grids

setGridStepAuto ( getY1MajorGrid(), true | false );

 

Manual Intervals

setGridStep ( getY1MajorGrid(), value );

 

Show Minor Grid Lines

setDisplay ( getY1MinorGrid(), true | false );

 

Style

setGridStyle ( getY1MinorGrid(), value );

 

Automatic Grids

setGridStepAuto ( getY1MinorGrid(), true | false );

 

Manual Intervals

setGridStep ( getY1MinorGrid(), value );

Y2 AXIS SETTINGS

This option is included in the menu for all graph types except Pies:

 

 

The Y2 Axis Settings menu includes these dialogs:

 

Location, format, and display of the Y2 Axis
 

Automatic/Manual and Minimum/Maximum Scaling
 

Display and Format of Y2 Axis Labels
 

Automatic/Manual and Minimum/Maximum Grids

Y2 Axis General Settings

This dialog is displayed when the General tab is selected in Y2 Axis Settings. Select the location in the chart where you want the axis imaged. Descending Axis draws the axis labels in ascending or descending order. The Axis Line and Zero Line check boxes enable/disable display of the axis base line and zero line. Select the Apply button to add these selections to the chart.

 

Left Side of Chart: Select this field (þ) if you want the Y2 numeric axis to be imaged at the left side of a vertical chart or on the bottom side of a horizontal chart.

 

Right Side of Chart: Select this field (þ) if you want the Y2 numeric axis to be imaged at the right of a vertical chart or the top of a horizontal. This is the default value.

 

Both Sides of Chart: Select this field (þ) if you want the Y2 numeric axis to be imaged at the left and right sides a vertical chart or top and bottom of a horizontal chart.

 

Descending: This field is used to select descending or ascending values on the Y2 numeric. The default value is ascending (this field is not selected).

 

Axis Line: This field is used to enable/disable the display of the Y2 axis base line. The default value is enabled (þ).

 

Zero Line: This field is used to enable/disable the display of a zero line on the Y2 axis. The default value is disabled (this field is not selected).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Left Side of Chart

setAxisSide ( getY2Axis(), 0 );

 

Right Side of Chart

setAxisSide ( getY2Axis(), 1 );

 

Both Sides of Chart

setAxisSide ( getY2Axis(), 2 );

 

Descending Axis

setAxisDescending ( getY2Axis(), true | false );

 

Axis Line

setDisplay ( getY2AxisLine(), true | false);

 

Zero Line

setDisplay ( getY2ZeroLine(), true | false );

Y2 Axis Scale Settings

This dialog is displayed when the Scale tab is selected in Y2 Axis Settings. The check boxes enable/disable "Always include Zero", log scale, and manual maximum and minimum scaling. When manual maximum and/or minimum scaling is enabled, enter values in the Max Value and/or Min Value fields. Select the Apply button to add these selections to the chart.

 

Always Include Zero on Scale: This field selects whether or not the Y2 axis must include a zero value. If the Log Scale field is selected or the Max Value or Min Value is greater than zero, this will be grayed-out. It is not valid when the logarithmic scale is used or Min and Max Values are greater than zero. The default value is not selected.

 

Log Scale: This field selects logarithmic or linear scale 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 (Min Value is less than or equal to zero), the request for log scale is ignored. The default value is linear scale (this field is not selected).

 

Use Manual Setting for Maximum: This field selects manual/automatic calculation of the maximum scale value on the Y2 axis in the chart. If this field is selected (þ), enter the maximum allowable scale value on the Y2 axis in the Max Value field. The default value is not selected (let the charting engine automatically calculate the maximum value on the Y2 Axis).

 

Max Value: When the "Use Manual Setting for Maximum" field is selected (þ), use this field to specify the maximum allowable scale value on the Y2 axis. The default value is 70.0.

 

Use Manual Setting for Minimum: This field selects manual/automatic calculation of the minimum scale value on the Y2 axis in the chart. If this field is selected (þ), enter the minimum allowable scale value on the Y2 axis in the Min Value field. The default value is not selected (let the charting engine automatically calculate the minimum value on the Y2 Axis).

 

Min Value: When the "Use Manual Setting for Minimum" field is selected (þ), use this field to specify the minimum allowable scale value on the Y2 axis. The default value is 0.0.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Always Include Zero

setScaleMustIncludeZero (getY2Axis(), true | false );

 

Log Scale

setLogScale ( getY2Axis(), true | false );

 

Use Manual setting for Maximum

setScaleMaxAuto ( getY2Axis(), true | false );

 

Max Value

setScaleMax ( getY2Axis(), value);

 

Use Manual setting for Minimum

setScaleMinAuto ( getY2Axis(), true | false );

 

Min Value

setScaleMin ( getY2Axis(), value);

Y2 Axis Labels

This dialog is displayed when the Labels tab is selected in Y2 Axis Settings. Use the check boxes to enable/disable the display of all axis labels, the minimum axis label, or the maximum axis label. When Show Axis Labels is selected, select a label format in the Format field. Select the Apply button to add these selections to the chart.

 

Show Axis Labels: This field enables/disables the display of labels on the Y2 axis in the chart. The default value is enabled (axis labels are displayed). Use the Format field to define the format of numeric labels. When this box is checked, the setting in the general tab determines where the labels are displayed (left, right, both).

 

Format: When "Show Axis Labels" is selected (þ), select the drop-down list box in this field to select a label format: General, 0%, 0.0%, $0, $0.00, etc. The default value is "General".

 

Don't Show Minimum Value: When "Show Axis Labels" is selected (þ), this field can be used to include/exclude the minimum value on the Y2 Axis. The default value is not selected (include the minimum label).

 

Don't Show Maximum Value: When "Show Axis Labels" is selected (þ), this field can be used to include/exclude the maximum value on the Y2 Axis. The default value is not selected (include the maximum label).

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Axis Labels

setDisplay ( getY2Label(), true | false );

 

Format

setTextFormatPreset ( getY2Label(), value );

 

Don't Show Minimum Value

setExcludeMinLabel ( getY2Label(), true | false );

 

Don't Show Maximum Value

setExcludeMaxLabel ( getY2Label(), true | false );

Y2 Axis Grids

This dialog is displayed when the Grids tab is selected in Y2 Axis Settings. Use the check boxes in this dialog to enable/disable the display of major and minor grid lines. When either check box is selected, use the Style field to select the format of major and minor grid lines. The Automatic Grids radio buttons enable/disable automatic calculation of the number of major/minor grid lines. When these radio buttons are not selected, select a number of major or minor grid lines in the Manual Intervals fields.

 

Select the Apply button to add these selections to the chart.

 

Show Major Grid Lines: This field enables/disables the display of the major grid lines for the Y2 axis. The default value is enabled (þ).

 

Style: When "Show Major Grid Lines" is selected (þ), use this field to select the style of the major grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

 

Automatic Grids: This field enables/disables automatic calculation of the number of major grid lines on the Y2-axis

 

Manual Intervals: When "Automatic Grids" is not selected, use this field to set the number of major grid lines/steps that will be imaged on the Y2-axis. 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. Do not use a negative value or a value that results in greater than 50 grid lines.

 

Show Minor Grid Lines: This field enables/disables the display of the minor grid lines for the Y2 axis. The default value is disabled.

 

Style: When "Show Minor Grid Lines" is selected (þ), use this field to select the style of the minor grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

 

Automatic Grids: This field enables/disables automatic calculation of the number of minor grid lines on the Y2-axis

 

Manual Intervals: When "Automatic Grids" is not selected, use this field to set the number of minor grid lines/steps that will be imaged on the Y2-axis. Do not use a negative value or a value that results in greater than 50 grid lines.

 

Properties and Methods: These selections add the following properties and methods to the code that defines this chart:

 

Editor Field

Property/Method

 

Show Major Grid Lines

setDisplay ( getY2MajorGrid(), true | false );

 

Style

setGridStyle ( getY2MajorGrid(), value );

 

Automatic Grids

setGridStepAuto ( getY2MajorGrid(), true | false );

 

Manual Intervals

setGridStep ( getY2MajorGrid(), value );

 

Show Minor Grid Lines

setDisplay ( getY2MinorGrid(), true | false );

 

Style

setGridStyle ( getY2MinorGrid(), value );

 

Automatic Grids

setGridStepAuto ( getY2MinorGrid(), true | false );

 

Manual Intervals

setGridStep ( getY2MinorGrid(), value );