In order to use the Perspective for Java Editor, you will need the following files: |
||
n |
A full Perspective for Java .JAR file (i.e., PFJFULL.JAR) |
|
n |
PFJ_GIFS.ZIP |
|
n |
PFJ_TILES.ZIP |
|
n |
TDGSecurity.class |
|
NOTE : |
The TDGSecurity.class file contains your personal registration number for using Perspective for Java. This file is not necessary if you are using Perspective for Java for demonstration/evaluation purposes. It is only necessary to eliminate the license-warning screen when you execute the compiled application. |
|
These files are available via the 3D web page at http://www.threedgraphics.com. See the Perspective for Java Programmer's Manual for the procedures required to download the files and to include the TDGSecurity.Class file in your .JAR file (if necessary). |
To create a full system on a local machine, install the files as follows: |
||
1. |
Create a directory on your hard disk. |
|
2. |
Copy the Perspective for Java .JAR file into the directory. |
|
3. |
Unzip the PFJ_GIFS.ZIP files into the same directory. The extracted files must reside in the same directory as the .JAR file. |
|
4. |
Create a "tiles" subdirectory. Unzip the PFJ_TILE.ZIP file into the "tiles" subdirectory. |
The start-up procedures for running the Perspective for Java Editor are slightly different depending on the operating environment in which the editor is being used. |
To run the editor as its own application, do the following: |
||
1. |
Open an MS DOS Prompt window. |
|
2. |
Change the directory to the directory where the Perspective .JAR file and .GIF files are stored. |
|
3. |
Type: JVIEW /cp:p "PFJFULL.JAR" TDGLoadSave.Class |
|
4. |
Press the <Enter> key |
To run the editor as an applet, include the following statement in your HTML: |
|
<APPLET CODE="TDGChartEditorApplet.class" width="700" height="500" archive="PFJFULL.jar"> |
|
Note that "width" and "height" values shown here are typical and may be different for your application. |
|
Use the <PARAM name....> string to define a starting chart type and any values you want to initially apply to the chart. Example: |
|
<PARAM name=TDGSCRIPT value=' |
|
If this information is not included, the chart editing area of the screen will be blank. |
To run the editor in a Unix environment, do the following: |
||
1. | Use any UNIX application, such as JAR.EXE from Sun, to extract the .CLASS files that are archived in the Perspective for Java .JAR file. Make sure you extract them from the .JAR file in the same directory/path where the .JAR file resides. | |
2. | At the command prompt in the directory/path where the .CLASS and .JAR files resides, type the following: | |
java TDGLoadSave.class | ||
Because UNIX is case-sensative, the upper/lower case combination of letters in "TDGLoadSave" is very important. The application will not be found if this exact sequence is not used. |
Following successful start-up using the Windows 95 or Unix procedures described above, the following message is displayed if the TDGSecurity.Class file is not included in the .JAR file: |
|
|
|
Select the "Click Here to Continue" button to display the Editor main window. |
This is the editor main window. It is the area in which the editor menu is displayed and where the chart is modified to reflect the chart properties that you select in the editor menu: |
|
|
|
This window contains two menus: 1) a File menu at the upper left corner of the window and 2) the Editor menu that is displayed by selecting the tab in the upper right corner of the window. |
Click the arrow button |
||
|
||
In addition to the chart that is being created/edited, the editor window consists of these sections: |
||
n |
The Editor Menu |
|
n |
The File Menu |
|
n |
Message Area |
When you click the arrow button |
||
|
||
The content of the editing menu will be different depending on the graph type that is selected in the Graph Type menu dialogs. |
||
n |
Chapter 3 describes the menu items that are available for all graph types. |
|
n |
Chapter 4 describes the menu items that are specific to certain graph types (i.e., 3D, Scatter, Stock, Pie, etc.) |
When you select an item in the menu, a dialog box displays a list of parameters that you can apply to the chart. For example, the following dialog box is displayed when the Bar, Line, Area Chart Settings menu item is displayed. |
|
|
|
Select chart parameters in the dialog box. Some parameters such as graph types are automatically applied when you select the chart parameters. Most dialog boxes include the Apply button. After you select chart parameters, the Apply button is required to assign the selected parameters to the chart. |
Some menu selections may cause the dialog box to extend beyond the available display space. When this is the case up-arrow and down-arrow scroll bars will be displayed at the upper and lower edge of the menu. |
|
Up Arrow Scroll Bar |
|
|
|
Down Arrow Scroll Bar |
|
|
|
Use your mouse pointer and the primary mouse button to reposition the dialog box up or down within the available display space. |
When you want to load or save a chart in the editor window. Select the File Menu in the menu bar at the top of the editor window. The File Menu is displayed in the following format: |
|
|
|
See Chapter 5 for additional information about loading and saving files in the various formats that are supported by the Perspective for Java Editor. |
The message area is located just below the chart display as shown in the following illustration: |
||
|
||
The following information may be displayed in this area of the window: |
||
n |
Error messages |
|
n |
Selected Properties that are different from default values |
|
n |
Chart editing strings |
|
If you select chart parameters in the editor dialogs that are outside the range of valid values for a particular setting, the message area will display a message indicating the error condition. |
||
When the "Output Properties as Different from Defaults..." option is selected in the File Menu, the message area will display any chart property that is selected in the editor dialogs that are different from the chart default settings. |
||
You may also type chart properties and methods in the message area and assign them to the chart that is being edited. Simply clear (highlight and delete) any information that is currently displayed in the window, type any new parameters that you want to assign to the chart, and select the "Input Param Strings from Message Window" in the File menu. See Chapter 5 for details. |