Richard Craig – EngD Systems Thinking in Cyberdefence

After a headache trying to find the right files and the standard ‘playing about’, I’ve finally got my OpenGl ‘Hello World’ example up and running. Before I forget, I thought I’d post my installation list as others seem to be getting dated.

I’ve modified the instructions from Matt Kindy http://kindy.net/jogl_setup.txt

DOWNLOAD ECLIPSE

1. Download Eclipse from the
http://www.eclipse.org/downloads/

I’m currently using ‘Eclipse for RCP and RAP Developers, 189 MB windows 32 Bit‘

2. There is no installer (executable program) used to install Eclipse. Just unzipping to a directory in an appropriate location on your hard disk (e.g. ‘C:\eclipse\‘). It is very strongly recommended that you locate the eclipse directory at the root of your computer hard drive or on a directory path with no spaces in its name (e.g. ‘C:\software\eclipse\‘). Eclipse does not write entries to the Windows registry so you can simply delete (or move) the directory, installed files, shortcuts, and/or the workspace: there is no executable uninstaller either so shift+Delete anytime.

3. Run Eclipse by running ‘C:\software\eclipse.exe‘ executable

DOWNLOAD JOGL

1. Download JOGL from the JogAmp.org site:
http://jogamp.org/deployment/webstart/archive/

At the bottom you’ll find jogl-v2.0-rc2.zip 03-Mar-2011 03:23 18M

Download and extract the ZIP file into a folder.

COPYING FILES
2. Create a folder in a convenient place to contain the necessary JOGL .jar files
e.g ‘C:\software\java\jogl\2.0\‘

3. Copy the .jar files from the folder in step 1 to the folder created in step 2.

============================
OPTIONS
Now this is where the given example and my way differs.
I will add my way at the end, so feel free to follow this way or jump to my way at the end
============================

4. Copy these DLL files to the Java Runtime Environment bin folder (e.g. ‘C:\Program Files\Java\jre6\bin‘):
gluegen-rt.dll
jogl.dll
jogl_awt.dll
jogl_cg.dll

SETTING ENVIRONMENT VARIABLES
5. Open the Windows environment variable window:
- Right-click My computer, choose Properties
- In Vista, choose “Advanced System Settings”;
In XP, choose the Advanced tab
- Click the “Environment Variables” button
- Under “System Variables” you will edit the following variables:

6. CLASSPATH
Add to the end of CLASSPATH the path to the JOGL .jar files folder (created in step 2)
- be sure the added path string is separated from the original string by a semicolon (;)

7. java.library.path
Create this environment variable with the path to the JRE bin folder (see step 4)

USING IN ECLIPSE
8. When you make a project in Eclipse, you will need to add the JOGL .jar files
to the project. To do so:
- right-click the project name and choose properties
- Choose “Java Build Path” in the left pane
- Choose the “Libraries” tab
- Click “Add External JARs”
- Browse to the folder from step 2. Add each of the JOGL .jar files to the project

IMPORTING THE JOGL LIBRARIES IN JAVA
9. To use in your Java program, add these lines to the appropriate class files:

import javax.media.opengl.*;
import com.sun.opengl.util.*;
import javax.media.opengl.glu.*;

Specifically, you’ll need these classes:
javax.media.opengl.GL
com.sun.opengl.util.GLUT
com.sun.opengl.util.Animator\
among others.

============================
My Way from Step 4.
============================

Eclipse

4. Start Eclipse and create a new java project File > New > java project
You can call the project ‘HelloWorld’
Make sure the execution environment is ‘JavaSE-1.6′
Click NEXT

5. Select the Libraries tab and click ‘Add Library’
Select ‘User Library’ as we’re going to create our own Jogl library
Select ‘User Libraries’ as the list should be empty
Now click ‘New’ and call the library ‘Jogl2.0′ and click ‘ok’

Click on the new ‘Jogl2.0′ library
Select ‘Add JARs’ and move to your jogl directory (type C:\software\java\jogl\2.0\lib into the filename and click open)

Add files to library
nativewindow.all.jar
newt.all.jar
gluegen-rt.jar
jogl.all.jar

Optional
You might want to expand (click on the plus sign) the library and attached files
then click on ‘Native library location’ and click ‘Edit’
then enter the path to your jogl lib directory (‘C:\software\java\jogl\2.0\lib‘)
repeat for all attached files

6. Now you should have a user library to add called ‘jogl2.0′ (or whatever you called yours)
Whenever you start a new project you’ll be able to right click on the project icon
Select Properties
select Java build path
select Add library > User library > Jogl2.0

JoGL ‘Hello World’ Example

Now you’ve got Eclipse and Jogl installed, you’ll probably want a great JoGL ‘Hello World’  example to try >>