Jogl setup on Windows XP and Vista


0. Install Java Standard Edition JDK 6.0 (http://java.sun.com/javase/) into your computer.

1. Go to https://jogl.dev.java.net/, click the link " Current release build (JSR-231 1.1.0)" on the center of the page, download jogl-1.1.0-windows-i586.zip. Uncompress it, you will get a directory called jogl-1_1_0-windows-i586, which contains a bunch if descriptive files and a sub-directory called lib. Under the lib, you will find the jogl related packages jogl.jar, gluegen-rt.jar and four dll's, gluegen-rt.dll, jogl.dll, jogl_awt.dll and jogl_cg.dll.

2. Move all these .dll files into a directory (in my case, it's "C:\Program Files\Java\extern\bin") and add this directory to your PATH environment variable.

To do this, under Windows XP, you right click "My Computer", and then select "Property". Select the page "Advanced" and click button "Environment Variables". Find the item "Path" from the list box "System variables" and double click it. In the edit box "Variable value", append your directory as a new entry (separate it with a ";").

Under Windows Vista, you right click "Computer", and then select "Property". Select "Advanced system settings" on the left panel and click button "Environment Variables". Find the item "Path" from the list box "System variables" and double click it. In the edit box "Variable value", append your directory as a new entry (separate it with a ";"). If the user access control is turned on, you will have to confirm to continue unless you are logged in as administrator.

If get a "command not found" error when you use "jar", you might need to manually add the java binary directory into your PATH variable as well. It's the "bin" directory under where you install jdk. In my case, it's "C:\Program Files\Java\jdk1.6\bin"

3. Move the file "jogl.jar" and "gluegen-rt.jar" into a directory and add the FULL path into the CLASSPATH environment variable (it similar as you deal with the "Path" variable). If you could not find this variable under "System variables" list, you should add it by clicking the button "New". In this case, you should also add the current directory, "." into your CLASSPATH separated by ";". In my case, the CLASSPATH is now

.;C:\Program Files\Java\extern\lib\gluegen-rt.jar;C:\Program Files\Java\extern\lib\jogl.jar;\C:\Program Files\Java\extern\lib\vecmath.jar

4. "vecmath.jar" listed above is available at cereal: ~decarlo/428/lib/vecmath.jar

Note:
1. If you are using NetBeans, Eclipse or any other IDEs, you should look into your project setting to find out where to include the jogl.jar and vecmath.jar as your external packages. And you still need to make sure the Path environmental variable is properly set up.

2. As is pointed in the jogl documentation, dropping the JOGL jar and native library into the extension directory of the JRE is strongly discouraged. Doing so can cause conflicts with third-party applications launched via Java Web Start, and causes confusion later when upgrading the distribution.


CS428 Home