CS465 JBuilder Instructions

Please direct any questions about these instructions to Andrew (ajb64@cornell.edu).

After downloading the framework code jar file, use WinZip or some similar program to extract it to your working directory. Place the files vecmath.jar, gl4java.jar, and GL4JavaJauGljJNI14.dll alongside it. We recommend z:\work on the CSUG machines. The z drive is for your personal files and is accessible over the network from any CSUG machine.

Once you've extracted the jar file, start up Borland JBuilder 8. It should be on all the CSUG machines. You will create a new project to manage the code involved in this assignment:

1) Select File->New Project... The Project wizard will pop up.

2) In step 1 of the project wizard, set the following:

Name: Brush
Directory: YourWorkDirectory (for example, z:/work)
Template: Default Project
Click next.

3) In step 2 of the project wizard, set the following:

Output path: YourWorkDirectory
Backup path: YourWorkDirectory/bak
Working directory: YourWorkDirectory

4) Now, set up the paths to your source files. If you extracted the jar properly they should be in YourWorkDirectory, so under the tab labeled "Source" set the default path to your work directory. Optionally set the Test path to YourWorkDirectory/test. You probably won't use this path.

5) Now, point the project to our required libraries, vecmath.jar and gl4java.jar. To do this select the tab labeled "Required Libraries." Click "Add" and a dialog will pop up asking which library to add. Neither of our libraries appear in this list, so you will have to create a link to them. Click New and a dialog will pop up. Pick a name for this link ("cs465" will do fine), and under "Library paths" click Add and select vecmath.jar and gl4java.jar. Now exit the dialogs, and "Cs465" should appear linked into your project.

6) You don't need to do anything in step 3 of the wizard, so complete it and you will see your new empty project.

7) While this project knows where your code is and knows where to find our libraries, it doesn't know what code you want to edit, so add the file Brush.java to the project. You can now edit this file freely and compile it, but it cannot run yet, as JBuilder does not have enough information about the Brush class. To set this information, select Project->Project Properties... and click the "Run" tab. This tab lets you select different configurations (sets of command line arguments, environment variables, etc) for running your program. To make a new configuration, click "New" and a dialog will pop up.

In this dialog, set the following:

Name: Whatever you want ("Testing configuration") might be good.
Build target: Make

And under the "Run" tab,
Type: Application
Main class: cs465.brush.Brush (click the ... button)
VM Parameters: (blank)
Application parameters: -Djava.library.path=YourWorkDirectory
The last setting is so that JBuilder can tell the JVM where to find GL4JavaJauGljJNI14.dll, which our framework code needs.

Exit out of these dialogs, and your project should now compile and run!

Cornell CS465 Fall 2003 (cs465-staff@cs.cornell.edu)