Prerequisites


Follow all steps described in How to build JOGL.
If you could successfully pass the junit.run tests, you may continue here.

Platform and Component Requirements


First you have to install an OpenCL SDK on your platform.
  • GPU NVidia Geforce >= 8
    Install the latest NVidia graphics driver available for your platform,
    and the GPU computing SDK (gpucomputingsdk).
  • GPU AMD
    Install the latest AMD graphics driver available for your platform,
    and install the AMD Stream SDK, see below.
  • CPU x86 x86_64 SSE3

Build Steps


Here are the steps that are required in order to build JOCL.

  1. Optain the source code using git: It is crucial that you checkout the source code under the common root directory:
        /home/dude/projects/jogamp> git clone git://github.com/mbien/jocl.git jocl
                                
    Now you should have following directory structure:
        /home/dude/projects/jogamp
        /home/dude/projects/jogamp/gluegen
        /home/dude/projects/jogamp/jogl
        /home/dude/projects/jogamp/jocl
                                
  2. Unset your CLASSPATH environment variable:
    The Ant build requires that the JOGL jars not be visible on the classpath. On Unix, type unsetenv CLASSPATH into a csh or tcsh shell, or unset CLASSPATH into a Bourne shell. On Windows, type set CLASSPATH= into a command prompt.
  3. Optional Copy and edit jocl.properties:
    To specify different basic options for the build,
    copy jocl/make/jocl.properties into your home directory (pointed to by the Java system property user.home).
    Edit the copy to change desired settings.
  4. Build the source tree:
    Open a command shell in the "jocl" directory of the source tree and type "ant jar".
  5. Test your build:
    Stay in your command shell in the "jocl" directory of the source tree and type "ant test".
  6. Build Javadoc:
    Stay in your command shell in the "jocl" directory of the source tree and type "ant javadoc". This will produce the end-user documentation for JOCL.

Common build problems

  • TODO