JOGL: Test Autobuilds

Here I like to summarize how to manually test the JOGL autobuilds, starting with 2009-07-02.

The general nightly download sites are

• http://download.java.net/media/jogl/builds/nightly/

Let’s assume we are in the test directory ‘test’, from which we operate from this point.

• Get http://download.java.net/media/jogl/builds/nightly/jogl-demos.zip
  Extract the archive, i.e. unzip jogl-demos.zip
• Get http://download.java.net/media/jogl/builds/nightly/jogl-2.0-pre-20090702-linux-amd64.zip
  In case we have build a reference implementation (RI) the substring ‘pre-yyyymmdd-‘ will be dropped.
  Replace the version 2.0 with the latest available and the OS/arch linux-amd64 with your test platform.
  Extract the archive, ie unzip jogl-2.0-pre-20090702-linux-amd64.zip
  Create a symbolic link or rename the archive directory from jogl-2.0-pre-20090702-linux-amd64 to jogl.
• If you like to test the binding to NV’s Cg, download and install http://developer.nvidia.com/object/cg_download.html

We assume java is in your binary search path.

On X11/Unix and MaxOSX you can test the build as follows:

sh java-run-newt.sh demos.es2.RedSquare -GL2 -GL2 -GL2
sh java-run.sh demos.gears.Gears

and with debug output

sh java-dbg-newt.sh demos.es2.RedSquare -GL2 -GL2 -GL2
sh java-dbg.sh demos.gears.Gears


On Windows you shall be able to run:

java-win32.bat demos.es2.RedSquare -GL2 -GL2 -GL2
java-win32.bat demos.gears.Gears

and with debug output

java-win32-dbg.bat demos.es2.RedSquare -GL2 -GL2 -GL2
java-win32-dbg.bat demos.gears.Gears

The windows scripts are pretty simple and flat.

The magic unix scripts offer more features and can be used either in the autobuild environment or in your development one.

• setenv-jogl.sh <JOGL-PROFILE> [<jogl-build-dir>]
  Looks up and invokes profile.jogl, finds gluegen, sets the environment variables (CLASSPATH, LD_LIBRARY_PATH & PATH).
• jogl/etc/profile.jogl <JOGL-PROFILE> [<jogl-build-dir>]
  JOGL profiles are one of JOGL_ALL, JOGL_ES1_MIN, JOGL_ES1_MAX, JOGL_ES2_MIN, JOGL_ES2_MAX, JOGL_GL2ES12_MIN, JOGL_GL2ES12_MAX, JOGL_GL2_MIN, JOGL_GL2_MAX.
  Looks up the set of JAR files necessary to satisfy the chosen JOGL-PROFILE.

This allows you to test a specific environment, ie ES2 without GL2 and AWT, using JOGL_ES2_MIN.
For this case I would recommend the native ES2 implementation from imageon SDK_OGLES2_LINUX_PCEMULATION_2.02.22.0756.