Installing JOGL for eclipse (updated 1/26/2007)

These instructions assume you already have Eclipse installed.  The links I
provide below are for the September 14, 2006 build of JOGL.
This is currently called: Current release build (JSR-231 1.0.0)

===========================================================================

NOTE WELL: Other builds have many differences so, it's important we all 
use the SAME version of the library!
Do not use the nightly, archived, beta, etc. builds.

===========================================================================

Go to this link:

https://jogl.dev.java.net/servlets/ProjectDocumentList?folderID=5971&expandFolder=5971

Note: this was arrived at by clicking the "Current release build (JSR-231 1.0.0)" link
on https://jogl.dev.java.net/ 

1. Download the following:

 jogl-1_0_0-YOUR_OS.zip
 where YOUR_OS is either linux-i586, macosx-universal, windows-i586, etc.
 (see the description column for clues ...)

2. Unzip the file you downloade in 1.
   This will give you jogl.jar as well as run-time (native) libraries 

   e.g when I unzipped the file for linux I got:

   /usr/local/jogl-1_0_0-linux-i586/lib$ ls
   jogl.jar  libjogl_awt.so  libjogl_cg.so  libjogl_drihack.so  libjogl.so

3. You need to point the compiler to jogl.jar
   To do this, you should note where you put it and then in any project that you
   make in Eclipse, do:

   Project -> Properties -> Java Build Path, 
   
   click the Libraries tab if not already selected

   then click the Add External JARs... button

   and navigate to where you put the jogl.jar and open/choose jogl.jar

4. To set up the native libraries you should have a Native Library location field under
   jogl.jar (after you click the little triangle) and if so, click it, edit it and
   state where the native libraries live (probably same directory that jogl.jar lived).

   Alternatively, you could:

     When executing programs written with JOGL in eclipse, do
      Run -> Run...
       and choose Java Application on the left.  Make sure Project and Main class are set.
     Then in the Arguments tab, in the bottom part VM arguments: you may have to add
     something like:
      -Djava.library.path="theDirectoryWhereNativeJOGLLibrariesLive"

      for JOGL programs to run --- this obviously tells eclipse what directory your 
      libraries are in.

5. When executing programs written with JOGL in eclipse, do
 Run -> Run...
 and choose Java Application.  Make sure Project and Main class are set.
Then in the Arguments tab, in the bottom part VM arguments, if you didn't set up
the Native Library Location as specified in 4. you may have to add
something like:
-Djava.library.path="theDirectoryWhereNativeJOGLLibrariesLive"

for JOGL programs to run.

6. If you want the documentation for JOGL classes/methods etc., download:

jogl-1_0_0-docs.zip and unzip it.  Then view the index.html file in a web browser.

7. Also, if you're interested, you may want to download the demos.

Enjoy.