Chapter 3.
Options for All Chart Types
NOTE: |
The hyperlinks in this chapter access the Perspective for Java Programmer's Manual. In order to use these links, the HTML files for the Perspective for Java Programmer's Manual must be installed in the same directory. |
|
Some options in the editor menu are available for all chart types, some are only applicable for specific charts. This chapter describes the options that are available for all chart types. They are: |
||
|
Graph Type |
|
|
Color and Line Options |
|
|
Font Options |
|
|
Chart Titles |
|
|
Data Scrolling |
|
|
Create GIF, Load and Save |
|
|
Apply Gradient Fill |
|
|
Apply Texture Fill |
|
See Chapter 4 for options that are applicable to specific chart types. |
Select the Graph Type option from the menu to change the general format of the graph: |
||
|
||
Select the tabs in the Graph Type dialog to see the available graph types in each of these categories: |
||
|
3D charts |
|
|
Bar charts |
|
|
Line charts |
|
|
Area charts |
|
|
Pie charts |
|
|
Scatter and Bubble charts |
|
|
Stock Charts |
|
|
Special (Polar, Radar, Histogram, Spectral Map) charts |
|
This dialog is displayed when the 3D tab is selected from the Graph Type menu: |
|
|
When you move the mouse pointer over a chart in the list, the message area at the bottom of the dialog describes the chart. Click on the graph type you want to assign to the chart in the main window. The chart is automatically updated to reflect the selected graph type. The contents of the menu will also be changed to reflect options that are available for each chart type. |
|
From left-to-right and top-to-bottom, selections in this dialog include the following: |
|
3D Bars (GraphType=0): Standard 3D chart. Display a bar for each value in the data set. |
|
3D Pyramid (GraphType=1): Pyramids are a good type for showing volume information, like an amount of some item. |
|
3D Octagon (GraphType=2): Octagons drawn in 3D. Can be made more elliptical or more perfectly columnar. |
|
3D Floating Cubes (GraphType=4): Excellent 3D type for data values that are close to each other. You can see under and around the cubes. |
|
3D Floating Pyramids (GraphType=5): Pretty, diamond-like pyramids floating in air trace out your data points. |
|
3D Connected Series Area (GraphType=6): Good for showing trend information along the series dimension. |
|
3D Connected Series Ribbon (GraphType=7): Good for showing trend information along the series dimension. |
|
3D Connected Group Area (GraphType=9): Good for showing trend information along the group dimension. |
|
3D Connected Group Ribbon (GraphType=10): Good for showing trend information along the group dimension. |
|
3D Surface (GraphType=12): Graphs all data points as a 3D surface, like a rolling wave. |
|
3D Surface with Sides (GraphType=13): Graphs all data points as a 3D surface, with solid sides. |
|
3D Honeycomb Surface (GraphType=14): Graphs all data points as a 3D surface using a "honeycomb" effect. |
|
A selection in the 3D Graph dialog will add the GraphType property to the code that defines the chart: |
|
setGraphType ( value ); | |
Where: value = a number in the range 0-2, 4-7, 9-10, 12-14 |
|
This dialog is displayed when the Bar tab is selected in the Graph Type menu. |
|
|
When you move the mouse pointer over a chart in the list, the message area at the bottom of the dialog describes the chart. Click on the graph type you want to assign to the chart in the main window. The chart is automatically updated to reflect the selected graph type. The contents of the menu will also be changed to reflect options that are available for each chart type. |
|
From left-to-right and top-to-bottom, selections in this dialog include the following: |
|
Vertical Clustered Bars (GraphType=17): Side by side groups of bars. The standard type of two-dimensional bar chart. |
|
Vertical Stacked Bars (GraphType=18): Stacked groups of bars. Each stack is comprised of all series in this group, added up to get a total. The axis is the total value of the cumulative points. |
|
Vertical Dual-Axis Clustered Bars (GraphType=19): Also called a Dual-Y chart. Any series can be assigned to either of the two axes. |
|
Vertical Dual-Axis Stacked Bars (GraphType=20): Also called a Dual-Y stacked chart. Separate stacks will be created for the data on each of the two axes. |
|
Vertical Bi-Polar Clustered Bars (GraphType=21): A Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Vertical Bi-Polar Stacked Bars (GraphType=22): A Stacked Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Vertical Percent Bars (GraphType=23): A bar version of a pie chart. Each group calculates the percent of the total required for each series. The axis goes from 0 to 100%. |
|
Horizontal Clustered Bars (GraphType=24): Side by side groups of bars. The standard type of two-dimensional bar chart. |
|
Horizontal Stacked Bars (GraphType=25): Stacked groups of bars. Each stack is comprised of all series in this group, added up to get a total. The axis is the total value of the cumulative points. |
|
Horizontal Dual-Axis Clustered Bars (GraphType=26): Also called a Dual-Y chart. Any series can be assigned to either of the two axes. |
|
Horizontal Dual-Axis Stacked Bars (GraphType=27): Also called a Dual-Y stacked chart. Separate stacks will be created for the data on each of the two axes. |
|
Horizontal Bi-Polar Clustered Bars (GraphType=28): A Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Horizontal Bi-Polar Stacked Bars (GraphType=29): A Stacked Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Horizontal Percent Bars (GraphType=30): A bar version of a pie chart. Each group calculates the percent of the total required for each series. The axis goes from 0 to 100%. |
|
A selection in this dialog will add the GraphType property to the code that defines the chart: |
|
setGraphType ( value ); | |
Where: value = a number in the range 17-30 |
|
This dialog is displayed when the Line tab is selected in the Graph Type menu. |
|
|
When you move the mouse pointer over a chart in the list, the message area at the bottom of the dialog describes the chart. Click on the graph type you want to assign to the chart in the main window. The chart is automatically updated to reflect the selected graph type. The contents of the menu will also be changed to reflect options that are available for each chart type. |
|
From left-to-right and top-to-bottom, selections in this dialog include the following: |
|
Vertical Absolute Line (GraphType=41): Lines draw on top and under each other to show the absolute relationships between data series. |
|
Vertical Stacked Line (GraphType=42): Lines stack on top of each other. The axis is the cumulative total of all the groups. |
|
Vertical Dual-Axis Absolute Line (GraphType=43): Also called a Dual-Y line chart. Any series can be assigned to either of the two axes. |
|
Vertical Dual-Axis Stacked Line (GraphType=44): Also called a Dual-Y stacked line chart. Separate stacks will be created for the data on each of the two axes. |
|
Vertical Bi-Polar Absolute Line (GraphType=45): A Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Vertical Bi-Polar Stacked Line (GraphType=46): A Stacked Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Vertical Percent Line (GraphType=47): A line version of a pie chart. Each group calculates the percent of the total required for each series. The axis goes from 0 to 100%. |
|
Horizontal Absolute Line (GraphType=48): Lines draw on top and under each other to show the absolute relationships between data series. |
|
Horizontal Stacked Line (GraphType=49): Lines stack on top of each other. The axis is the cumulative total of all the groups. |
|
Horizontal Dual-Axis Absolute Line (GraphType=50): Also called a Dual-Y line chart. Any series can be assigned to either of the two axes. |
|
Horizontal Dual-Axis Stacked Line (GraphType=51): Also called a Dual-Y stacked line chart. Separate stacks will be created for the data on each of the two axes. |
|
Horizontal Bi-Polar Absolute Line (GraphType=52): A Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Horizontal Bi-Polar Stacked Line (GraphType=53): A Stacked Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Horizontal Percent Line (GraphType=54): A line version of a pie chart. Each group calculates the percent of the total required for each series. The axis goes from 0 to 100%. |
|
A selection in this dialog will add the GraphType property to the code that defines the chart: |
|
setGraphType ( value ); | |
Where: value = a number in the range 41-54 |
|
This dialog is displayed when the Area tab is selected in the Graph Type menu. |
|
|
When you move the mouse pointer over a chart in the list, the message area at the bottom of the dialog describes the chart. Click on the graph type you want to assign to the chart in the main window. The chart is automatically updated to reflect the selected graph type. The contents of the menu will also be changed to reflect options that are available for each chart type. |
|
From left-to-right and top-to-bottom, selections in this dialog include the following: |
|
Vertical Absolute Area (GraphType=31): Areas draw on top of each other to show the absolute relationships between data series. Use when some data "pokes up" behind other. |
|
Vertical Stacked Area (GraphType=32): Areas stack on top of each other. The axis is the cumulative total of all the groups. |
|
Vertical Bi-Polar Absolute Area (GraphType=33): A Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Vertical Bi-Polar Stacked Area (GraphType=34): A Stacked Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Vertical Percent Area (GraphType=35): An area version of a pie chart. Each group calculates the percent of the total required for each series. The axis goes from 0 to 100%. |
|
Horizontal Absolute Area (GraphType=36): Areas draw on top of each other to show the absolute relationships between data series. Use when some data "pokes up" behind other. |
|
Horizontal Stacked Area (GraphType=37): Areas stack on top of each other. The axis is the cumulative total of all the groups. |
|
Horizontal Bi-Polar Absolute Area (GraphType=38): A Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Horizontal Bi-Polar Stacked Area (GraphType=39): A Stacked Dual-Y chart with the two axes physically split into separate sections, so that each can be seen independently of the other. |
|
Horizontal Percent Area (GraphType=40): An area version of a pie chart. Each group calculates the percent of the total required for each series. The axis goes from 0 to 100%. |
|
A selection in this dialog will add the GraphType property to the code that defines the chart: |
|
setGraphType ( value ); | |
Where: value = a number in the range 31-40 |
|
This dialog is displayed when the Pie tab is selected in the Graph Type menu. |
|
|
When you move the mouse pointer over a chart in the list, the message area at the bottom of the dialog describes the chart. Click on the graph type you want to assign to the chart in the main window. The chart is automatically updated to reflect the selected graph type. The contents of the menu will also be changed to reflect options that are available for each chart type. |
|
From left-to-right and top-to-bottom, selections in this dialog include the following: |
|
Pie (GraphType=55): The most widely used chart for displaying percentages of a total. |
|
Ring Pie (GraphType=56): A ring variant of a pie chart. The total of all slices is placed in the center. Very popular in Asian countries. |
|
Multi Pie (GraphType=57): A separate pie is drawn for each group in the data set. A pie variation on Percent Bars. |
|
Multi Ring Pie (GraphType=58): A separate ring pie is drawn for each group in the data set. |
|
Multi Proportional Pie (GraphType=59): Each pie is sized in proportion to its total across the entire data set. |
|
Multi Proportional Ring Pie (GraphType=60): Each ring pie is sized in proportion to its total across the entire data set. |
|
A selection in this dialog will add the GraphType property to the code that defines the chart: |
|
setGraphType ( value ); | |
Where: value = a number in the range 55-60 |
|
This dialog is displayed when the Scatter tab is selected in the Graph Type menu. |
|
|
When you move the mouse pointer over a chart in the list, the message area at the bottom of the dialog describes the chart. Click on the graph type you want to assign to the chart in the main window. The chart is automatically updated to reflect the selected graph type. The contents of the menu will also be changed to reflect options that are available for each chart type. |
|
From left-to-right and top-to-bottom, selections in this dialog include the following: |
|
XY Scatter (GraphType=61): TWO values per marker, X and Y, in that order. A standard X-Y plot. |
|
XY Scatter Dual-Axis (GraphType=62): Dual-Y scatter chart. TWO values per marker, X and Y, in that order. |
|
XY Scatter with Labels (GraphType=63): THREE values per maker, X, Y and text label, in that order. Each XY point is discreetly labeled. |
|
XY Scatter with Labels Dual-Axis (GraphType=64): A Dual-Y scatter chart with labeled markers. Requires THREE values per marker, X, Y, and text label, in that order. |
|
Bubble Chart (Graph Type=89): THREE values per marker, X, Y, and Z, in that order. An X- Y plot where marker size depends on Z. |
|
Bubble Chart with Labels (Graph Type 90): FOUR values per marker, X, Y, Z, and text label, in that order. An X- Y plot where marker size depends on Z, with labels. |
|
Bubble Chart Dual-Axes (Graph Type 91): THREE values per marker, X, Y, and Z, in that order. An X- Y plot where marker size depends on Z. |
|
Bubble Chart with Labels Dual-Axes (Graph Type 92): FOUR values per marker, X, Y, Z, and text label, in that order. An X- Y plot where marker size depends on Z, with labels. |
|
A selection in this dialog will add the GraphType property to the code that defines the chart: |
|
setGraphType ( value ); | |
Where: value = a number in the range 61-64 |
|
This dialog is displayed when the Stock tab is selected in the Graph Type menu. |
|
|
When you move the mouse pointer over a chart in the list, the message area at the bottom of the dialog describes the chart. Click on the graph type you want to assign to the chart in the main window. The chart is automatically updated to reflect the selected graph type. The contents of the menu will also be changed to reflect options that are available for each chart type. |
|
From left-to-right and top-to-bottom, selections in this dialog include the following: |
|
Stock Hi-Lo (GraphType=73): Requires TWO values per maker: High and Low, in that order. A standard financial equity chart. |
|
Stock Hi-Lo Dual-Axis (GraphType=74): Dual-Y HiLo chart. TWO values per marker: High and Low. |
|
Stock Hi-Lo Bi-Polar (GraphType=75): Dual-Y chart with the axis split into separate sections. TWO values per marker: High and Low. |
|
Stock Hi-Lo Close (GraphType=76): THREE values per marker: High, Low and Close, in that order. A standard financial equity chart. |
|
Stock Hi-Lo Close Dual-Axis (GraphType=77): Dual-Y version of HiLoClose chart. Requires THREE values per marker: High, Low, and Close. |
|
Stock Hi-Lo Close Bi-Polar (GraphType=78): Dual-Y chart with the axis split into separate sections. THREE values per marker: High, Low, and Close. |
|
Stock Hi-Lo Open-Close (GraphType=79): FOUR values per marker: Open, High, Low, and Close. A standard financial equity chart. |
|
Stock Hi-Lo Open-Close Dual-Axis (GraphType=80): Dual-Y version of OpenHiLoClose chart. FOUR values per marker: Open, High, Low, and Close. A standard financial equity chart. |
|
Stock Hi-Lo Open-Close Bi-Polar (GraphType=81): Dual-Y chart with two axes split into separate sections. FOUR values per marker: Open, High, Low, and Close. |
|
Stock Hi-Lo with Volume (GraphType=82): Display stock performance along with volume. Requires THREE values per marker: High, Low and Volume. |
|
Stock Hi-Lo Close with Volume (GraphType=88): Display stock performance along with volume. Requires FOUR values per marker: High, Low, Close, and Volume. |
|
Stock Hi-Lo Open-Close with Volume (GraphType=83): Display stock performance along with volume. Requires FIVE values per marker: Open, High, Low, Close, and Volume. |
|
Open-Hi-Lo-Close Candle Stock Chart (GraphType=70): Requires FOUR values per marker: Open, High, Low, and Close, in that order. |
|
Open-Hi-Lo-Close Candle Stock Chart with Volume (GraphType=71): Requires FIVE values per marker: Open, High, Low, Close and Volume. |
|
Candle Stock Hi-Lo Open-Close Chart (GraphType=72): FOUR - values per marker: Open, High, Low, and Close. A "candle" financial equity chart. |
|
Candle Stock Hi-Lo Open-Close Chart with Volume (GraphType=84): Display "candle" stock performance along with volume. FIVE values per marker: Open, High, Low, Close, and Volume.. |
|
A selection in this dialog will add the GraphType property to the code that defines the chart: |
|
setGraphType ( value ); | |
Special Graph Types
|
This dialog is displayed when the Special tab is selected in the Graph Type menu. |
|
|
When you move the mouse pointer over a chart in the list, the message area at the bottom of the dialog describes the chart. Click on the graph type you want to assign to the chart in the main window. The chart is automatically updated to reflect the selected graph type. The contents of the menu will also be changed to reflect options that are available for each chart type. |
|
From left-to-right and top-to-bottom, selections in this dialog include the following: |
|
XY Polar (GraphType=65): A polar coordinate scatter chart. Requires TWO values per marker, distance and degree, in that order. |
|
XY Polar Dual-Axis (GraphType=66): A Dual-Y polar coordinate scatter chart. Requires TWO values per marker, distance and degree, in that order. |
|
Radar Line (GraphType=67): A circular line chart. Excellent for cyclical data, such as hourly or monthly figures. |
|
Radar Area (GraphType=68): A circular area chart. Excellent for comparisons or cyclical data sets. |
|
Radar Line Dual-Axis (GraphType=69): A circular line chart. Excellent for cyclical data, such as hourly or monthly figures. |
|
Vertical Histogram (GraphType=85): Standard histogram. Groups all of the data together and assigns it to "buckets" based on value. There are no series or groups in this chart type. |
|
Horizontal Histogram (GraphType=86): Groups all of the data together and assigns it to "buckets" based on value. There are no series or groups in this chart type. |
|
Spectral Map (Graph Type=87): Row or column matrix of markers, colored according to data value. |
|
A selection in this dialog will add the GraphType property to the code that defines the chart: |
|
setGraphType ( value ); | |
Where: value = a number in the range 65-69, 85-86 |
Color and line options is used to change the color of objects in the chart: |
||
|
||
The Color and Line Options dialog includes different selection tabs based on the object in the chart that is selected. |
||
If an object with an interior is selected (i.e., riser or chart frame), these tabs are displayed: |
||
|
Select the fill color of objects |
|
|
Select the line color of objects |
|
When a line object is selected in a chart and you can change the width of the line, the color grid dialog includes these tabs: |
||
|
Select the color of objects |
|
|
Line Width |
|
This dialog is displayed when Line Color or Fill Color Tab is selected: |
|
|
Select an object in the chart and select a color from the grid to change the color of any object in the chart. If a line object is selected, the following method is added to the code that defines the chart: |
|
setBorderColor (aGetObjectIDMethod(),new Color(value, value, value )); | |
If an area object is selected, the following method is added to the code that defines the chart: |
|
setFillColor(aGetObjectIDMethod(),new Color (value, value, value)); | |
Example: setFillColor( getCubeFloor(),new Color(192,192,192)); |
|
ý NOTE: |
Note that aGetObjectIDMethod() is not a Perspective for Java method. It is a notation convention used in this document to indicate one of the Perspective for Java methods that returns an object ID. The Editor chooses the appropriate method based on the object that is selected in the chart. For example, the getO1Label() method is used if the O1 Axis Label is selected in the chart. |
|
This dialog is displayed when a line object is selected in the chart and the Line Width tab is selected in Color and Line Options. |
|
|
Use the Line Width slider bar to specify the width of a line object. A value of zero selects a line width of one pixel. Values greater than zero specify the relative width of the line in pixels based on the applet size. |
|
Select the Apply button to assign the width to the line. This selection will add a setLineWidth() method to the code that defines this graph: |
|
setLineWidth ( aGetObjectIDMethod(), value); | |
Example: setLineWidth ( getY1ZeroLine(), 2 ); |
|
ý NOTE: |
Note that aGetObjectIDMethod() is not a Perspective for Java method. It is a notation convention used in this document to indicate one of the Perspective for Java methods that returns an object ID. The Editor chooses the appropriate method based on the object that is selected in the chart. For example, the getO1Label() method is used if the O1 Axis Label is selected in the chart. |
The Font Options menu is used to select a font name, size, and format of text objects and to enable/disable text autofitting: |
|||
|
|||
This dialog is displayed when Font Options is selected from the menu: |
|||
|
|||
|
Select a text object in the graph (Chart Title, Subtitle, Footnote, Axis Labels, Legend Text, etc.) |
||
|
Select items in the Font Options dialog to change the format of the selected text object. |
||
The drop-down list boxes in this dialog can be used to select a font name and size. When the autofitting toggle button is selected, the font size is restricted to the values set by TextAutofitMin and TextAutofitMax for all text objects except the chart title, subtitle, and footnote. The Wrap check box enables/disables wrapping of the selected text object. When this box is not checked, the selected text object must be displayed on one line. When this box is checked (þ ), the text can be displayed on multiple lines. |
|||
|
Toggle autofitting of the text object. |
||
|
Toggle Bold on/off |
||
|
Toggle Italic on/off |
||
|
Toggle Underline on/off |
||
|
Toggle Shadow on/off |
||
|
Left Justify text |
||
|
Center Justify text |
||
|
Right Justify text |
||
|
Display text object horizontally |
||
|
Rotate text object left, counter-clockwise 90 degrees |
||
|
Rotate text object right, clockwise 90 degrees |
||
The font selections in this dialog add the following properties and methods to the code that defines this chart: |
|||
Editor Field |
Property/Method |
||
Font Name |
setFontName (aGetObjectIDMethod(), true | false ); | ||
Example: setFontName (getO1Label(), "Courier" ); |
|||
|
setAutofit ( aGetObjectIDMethod(), true | false ); | ||
Example: setAutofit ( getO1Label(), false ); |
|||
Font Size |
setFontSizeVC ( aGetObjectIDMethod(), value ); | ||
Example: setFontSizeVC ( getO1Label(), 1410 ); |
|||
Wrap |
setTextWrap ( aGetObjectIDMethod(), true | false ); | ||
Example: setTextWrap ( getO1Label(), true ); |
|||
|
setFontStyle ( aGetObjectIDMethod(), value ); | ||
Example: setFontStyle( getO1Label(), 7 ); |
|||
|
setShadowDisplay (aGetObjectIDMethod(),true|false ); | ||
Example: setShadowDisplay ( getO1Label(), true ); |
|||
|
setTextJustHoriz ( aGetObjectIDMethod(), value ); | ||
Example: setTextJustHoriz(getO1Label(),2); |
|||
|
setTextRotation ( aGetObjectIDMethod(), value ); | ||
Example: setTextRotation ( getO1Label(), 1 ); |
|||
ý NOTE: |
Note that aGetObjectIDMethod() is not a Perspective for Java method. It is a notation convention used in this document to indicate one of the Perspective methods that returns an object ID. The Editor chooses the appropriate method based on the object that is selected in the chart. For example, getO1Label() is used if the O1 Axis Label is selected in the chart. |
This menu option is used to define chart titles: |
|||
|
|||
When the Chart Titles option is selected from the menu, a dialog is displayed in the following format: |
|||
|
|||
This dialog is used to define chart title, subtitle, footnote, and axis title strings. The number of axis titles (O1, O2, X1, Y2, and Y2) will be different depending on the Graph Type. |
|||
|
Enter a title string in each field where you want to define title text. |
||
|
Select the check boxes to the right of each field to toggle the display of each title. |
||
|
Select the Apply button to display the selected title strings in the chart. |
||
The selections in this dialog add the following methods to the code that defines this chart: |
|||
Editor Field |
Property/Method |
||
Chart Title |
setTextString (getTitle(),"Title String"); | ||
Chart Subtitle |
setTextString (getSubtitle(),"Subtitle String "); | ||
Chart Footnote |
setTextString (getFootnote (),"Footnote String "); | ||
O1 Axis Title: |
setTextString (getO1AxisTitle(),"O1 Axis Title"); | ||
O2 Axis Title |
setTextString (getO2AxisTitle(),"O2 Axis Title"); | ||
X1 Axis Title |
setTextString (getX1AxisTitle(),"X1 Axis Title"); | ||
Y1 Axis Title |
setTextString (getY1AxisTitle(),"Y1 Axis Title"); | ||
Y2 Axis Title |
setTextString (getY2AxisTitle(),"Y2 Axis Title"); | ||
ý NOTE: |
If the default display attribute of a chart title is false, the setDisplay() method will also be added to the code to enable the display of the defined title object. Example: setDisplay(getO2Title(),true); If you clear a title string, the setDisplay method will be added to the code to disable display of the cleared text object. Example: setDisplay(getO2Title(), false); |
The Data Scrolling menu option is used to scroll the data by selecting the visibility and offset of groups and series. |
|||
|
|||
When the Data Scrolling option is selected from the menu, a dialog is displayed in the following format: |
|||
|
|||
This dialog is used to select the maximum number of groups and/or series to be displayed in the graph. It can also be used to select the first group and/or series to be drawn. |
|||
Enter values in the Visible Groups and Groups Offset fields to select the number of groups and the first group to be included in the chart. When you select the Apply button the data scrolling grid is updated to reflect your entries. For example, the data scrolling grid is displayed in the following format when Visible Groups is set to "4" and Groups Offset is set to "2". The chart will also be updated to reflect the current selections. |
|||
|
|||
The data scrolling grid is displayed in the following format when Visible Series is set to "4" and Series Offset is set to "2". |
|||
|
|||
Visible Groups: Use this field to select the maximum number of groups to be displayed in the graph. |
|||
Visible Series: Use this field to select the maximum number of series to be displayed in the graph. |
|||
Groups Offset: Use this field to select the first group to be displayed in the graph. |
|||
Series Offset: Use this field to select the first series to be displayed in the graph. |
|||
|
Select the "Display all Series & Groups" button to display all series and groups included in the data set that defines the graph. |
||
|
Select the Apply button to display the selected series and groups in the chart. Groups and/or Series data scrolling bars will be displayed in the chart. You may use the scroll bar to change the Groups Offset and Series Offset. |
||
The selections in this dialog add the following methods to the code that defines this chart: |
|||
Editor Field |
Property/Method |
||
Group Offset |
setScrollOffsetGroup( value ); | ||
Visible Groups |
setViewableGroups ( value ); | ||
Series Offset |
setScrollOffsetSeries ( value ); | ||
Visible Series |
setViewableSeries ( value ); |
This menu option is used to load and save GIF images to or from an FTP site: |
||
|
||
Select a tab in the Create Gif, Load and Save dialog to select one of the following load or save operations: |
||
|
Select this tab to save the chart image as a .GIF to an FTP site. |
|
|
Select this tab to save the chart image as text to an FTP site. |
|
|
Select this tab to load text that defines a chart from an FTP site. |
|
|
Select this tab to save the chart image as a .GIF to a file. |
|
|
Select this tab to load the chart with text from a file. |
Save Chart Image as GIF to FTP
|
When this tab is selected in the Create GIF, Load & Save dialog, the Save Chart Image as GIF to FTP dialog is displayed: |
|
|
||
|
Specify the location (FTP Host, User ID, Password, Directory, and File Name) where you want to save the currently displayed chart as a .GIF image. |
|
|
Select the "Save Chart Image as GIF to FTP" button to save the chart as a .GIF image to an FTP site. |
|
The following method is used to send the GIF image to the FTP site: |
||
sendGIFToFTP ( FTP Host, User ID, Password, Directory, File Name ); |
|
When this tab is selected in the Create GIF, Load & Save dialog, the Save Chart as Text to FTP dialog is displayed: |
|
|
||
|
Specify the location (FTP Host, User ID, Password, Directory, and File Name) where you want to save the currently displayed chart as a text file. |
|
|
Select the "Save Chart as Text to FTP" button to save the chart as a text file to an FTP site. |
|
The following method is used to send the text that defines the chart to the FTP site: |
||
sendChartToFTP ( FTP Host, User ID, Password, Directory, File Name ); |
|
When this tab is selected in the Create GIF, Load & Save dialog, the Load Chart Text From FTP dialog is displayed: |
|
|
||
|
Specify the location (FTP Host, User ID, Password, Directory, and File Name) from which the text file is to be loaded. |
|
|
Select the "Load Chart Text from FTP" button to load the text file from an FTP site. |
|
The following method is used to load the text file that defines the chart from the FTP site: |
||
getChartFromFTP ( FTP Host, User ID, Password, Directory, File Name ); |
Save Chart Image as GIF to File
|
When this tab is selected in the Create GIF, Load & Save dialog, the Save Chart Image as .GIF to File dialog is displayed: |
|
|
||
|
Specify the location (File Name) where you and to save the currently displayed chart image as .GIF. |
|
|
Select the "Save Chart Image as GIF to File " button to save the chart as a .GIF image to a file. |
|
The following method is used to save the chart image in a file: |
||
sendGIFToFile (File Name); |
|
When this tab is selected in the Create GIF, Load & Save dialog, the Load Chart Text From File dialog is displayed: |
|
|
||
|
Specify the location (File Name) from which the text file is to be loaded. |
|
|
Select the "Load Chart Text from File" button to load the chart as a text file from a file. |
This menu item is used to apply a gradient to an area object in a chart: |
||
|
||
When the Apply Gradient Fill option is selected from the menu, a menu is displayed in the following format: |
||
|
||
|
Select a gradient fill pattern (e.g., Blue to Black, Blue Tube, Red Tube, etc.) and direction (Right, Left, Down, Up, etc.). |
|
|
Select an object in the chart. |
|
|
Select the "Apply Gradient" button to apply the gradient fill to the object in the graph. Gradients can be applied to any filled object (not lines) in the chart (including text objects). |
|
The selections in this dialog add the following properties and methods to the code that defines this chart: |
||
setFillType (aGetObjectIDMethod(), 2); | ||
setGradientDirection (aGetObjectIDMethod(), value); | ||
setGradientNumPins (aGetObjectIDMethod(), value); | ||
setGradientPinLeftColor (aGetObjectIDMethod(),new Color (value,value,value), value); | ||
setGradientPinLeftColor (aGetObjectIDMethod(),new Color( value,value,value), value); | ||
setGradientPinPosition (aGetObjectIDMethod(),value, value); | ||
setGradientPinPosition (aGetObjectIDMethod(), value, value); | ||
setGradientPinRightColor (aGetObjectIDMethod(),new Color (value, value, value), value); | ||
setGradientPinRightColor (aGetObjectIDMethod(),new Color (value, value, value), value); | ||
ý NOTE: |
Note that aGetObjectIDMethod() is not a Perspective for Java method. It is a notation convention used in this document to indicate one of the Perspective for Java methods that returns an object ID. The Editor chooses the appropriate method based on the object that is selected in the chart. For example, the getO1Label() method is used if the O1 Axis Label is selected in the chart. |
|
As an example, the following methods select the background object in the chart and assign the "Sunset" gradient to the object in the Radial, Center, Top direction: |
||
setFillType (getBackgrnd(),2); | ||
setGradientDirection (getBackgrnd(),10); | ||
setGradientNumPins (getBackgrnd(),2); | ||
setGradientPinLeftColor (getBackgrnd(), new Color(255,0,0),1); | ||
setGradientPinLeftColor (getBackgrnd(),new Color(0,0,255),0); | ||
setGradientPinPosition (getBackgrnd(),1.0,1); | ||
setGradientPinPosition (getBackgrnd(),0.0,0); | ||
setGradientPinRightColor (getBackgrnd(),new Color(255,0,0),1); | ||
setGradientPinRightColor (getBackgrnd(),new Color (0,0,255),0); |
Select the Apply Texture Fill option from the menu to apply a texture to an area object in a chart: |
||||
|
||||
When the Apply Texture Fill option is selected from the menu, this dialog is displayed: |
||||
|
||||
Use the tabs across the top of this dialog to select one of the texture types: |
||||
|
Select granite texture fills (e.g., Purple_pink, Tan, White, Yellow_Black, etc.) |
|||
|
Select marble texture fills (e.g., Soft Blue, Carrera White, Black White, Pink Grey, etc.) |
|||
|
Select other texture fills (e.g., Oil, Pearl, Metal Weave, Beads, Bricks, etc.) |
|||
|
Select rough texture fills (e.g., Cement, Stone, Standstone, etc.) |
|||
|
Select stone texture fills (e.g., Buff, Green, Rose, Limestone, etc.) |
|||
|
Select wood texture fills (e.g., Beech, Curly Maple, Maple, Oak, etc.) |
|||
|
Select a texture fill pattern by selecting the drop-down list box or by using the left and right arrows (< >) to scroll through the list of textures in each category. |
|||
|
Select an object in the chart. |
|||
|
Select the "Apply Texture" button to apply the texture to the object in the graph. Textures can be applied to any object in the chart (including text objects). |
|||
The selections in this dialog add the following methods to the code that defines this chart: |
||||
setFillType (getSeries (#), 3 ); | ||||
setTextureDisplayMode (getSeries(#),0); | ||||
setTextureURL ( getSeries(#), "file:/drive:/directory/FileName.GIF"); | ||||
As an example, the following methods assign the Hard_Rock_Green.GIF texture file to series one in the chart: |
||||
setFillType (getSeries (1), 3 ); |
||||
setTextureDisplayMode(getSeries(1),0); |
||||
setTextureURL(getSeries(1),"file:/C:/3dg/Editor/tiles/Hard_Rock_Green.GIF"); |