Software Installation Notes (XP Instructions)

Java JDK and JRE

Download Java SE 6 Update 7 which contains both the Java JDK and JRE. For uniformity we recommend that any previous SE or JREs be removed from your computer before configuration.

Decide in which partition Java is to go. In that partition, create the folder, Java, in the root directory. Then create the subdirectories Java\jdk and Java\jre, for example, C:\Java\jdk and C:\Java\jre.

At a minimum, install the Development Tools and the Public JRE. Note that the JDK installs first. When installing the JRE, also install the JRE for Browsers. When installed on the system partition, this will require around 457Mb. When installed in another partition, the JDK and JRE still require about 227Mb on the system partition. The install will occur in two phases - first the JDK and then the JRE. Make sure you have specified the correct directory location for each phase before proceding with each install.

JOGL

Download jogl-1.1.1-windows-i586.zip. Open the .zip file and extract the folder it contains. Rename the folder jogl and move it into the Java folder created in the Java install, ie, to Java\jogl.

In Java\jogl\lib you will find four .dll files. Copy these into the Windows system directory, C:\WINDOWS\system32.

Setting Environment Variables For Command Line Execution

Setting up the Java environment requires creating two environment variables and adding three directories to the system CLASSPATH and PATH variables. In the Control Panel, click on System, Advanced, and select Environment Variables. Do the following for the System variables, assuming here that the Java directory is on the C partition:

• Click New and create the System variable JOGL_HOME with value C:\Java\jogl
• Click New and create the System variable JAVA_HOME with value C:\Java\jdk

• Select the System variable CLASSPATH and click Edit. Append ;%JOGL_HOME%\lib\gluegen-rt.jar;%JOGL_HOME%\lib\jogl.jar to CLASSPATH
• Select the System variable Path and click Edit. Append ;%JAVA_HOME%\bin to Path

Don't forget the semicolons!

Eclipse

Download the 85Mb Eclipse IDE for Java. Open the downloaded .zip file and copy the enclosed Eclipse folder into the Java folder. Then place a shortcut to the downloaded executable in this folder, Eclipse.exe, on your desktop.

To create a new project in Eclipse, do the following:

  File
    New
      Java Project (enter project name)
        Finish

Next add the JOGL libraries to your project:

  Project
    Properties
      Java Build Path
        Libraries
          Add External JARS (look in C:\Java\jogl\lib)
            Select gluegen-rt.jar and jogl.jar and then click Open and OK

To open an existing project when you can't find it, you need the Package Explorer:

  Window
    Show View
      Package Explorer