JOGL - Installation

This chapter covers setting up of the environment to use JOGL on your system using different Integrated Development Environments (IDEs).

Instalpng JOGL

For JOGL Installation, you need to have following system requirements −

System Requirements

The first requirement is to have the Java Development Kit (JDK) installed on your machine.

You need to follow the given steps to setup your environment to start with JOGL apppcation development −

Step 1 - Verifying Java Installation on Your Machine

Open console of your system and execute the following java command −

Verify the output on the respective operating system.

Step 2 – Setting up Java Development Kit (JDK)

If Java is not installed on your machine, then you need to install Java SDK from the Oracle website: Oracle. You can find instructions for instalpng the JDK from the downloaded files. You need to follow the given instructions to install and configure the setup. Finally, set PATH and JAVA_HOME environment variables to refer to the directory that contains java.exe and javac.exe files, typically java_install_dir/bin and java_install_dir respectively.

Set Java-home environment variable to point to the base directory location on the same path, where Java is installed on your machine.

Append Java compiler location to System Path as follows −

Step 3 – Downloading JOGL

You can download latest version of JOGL from the website www.jogamp.org

Go to the home page of www.jogamp.org

Cpck on Builds/Downloads > Current (zip).

This takes you to the pst of .jar files for all APIs maintained by the website.

Download the pbrary .jar file jogamp-all-platforms.7z, java documentations for OpenGL native pbrary glugen-javadoc.7z, and JOGL jogl-javadocs.7z.

Extract the downloaded .jar files using any zip extracting software.

When you open the extracted folder, you will find jar folder, source-codes, and other files.

Get the source codes gluegen-java-src.zip and jogl-java-src.zip for supporting IDE. This is optional.

Inside the jar folder, there are multiple .jar files. This collection of files belongs to Glugen and JOGL.

JOAMP provides native pbraries that support various operating systems such as Windows, Solaris, Linux and Android. Hence, you need to take appropriate jar files which can execute on your desired platform. For example, if you are using Windows 64-bit operating system, then get the following .jar files from the jar folder −

gluegenrt.jar

jogl-all.jar

gluegen-rt-natives-windows-amd64.jar

jogl-all-natives-windowsamd64.jar

Setting up JOGL for Ecppse 4.4

Follow the given procedure for setting up JOGL −

Adding Libraries

Step 1 − Open Ecppse.

Step 2 − Create a new project.

Step 3 − Create a new folder named pb in the project folder.

Step 4 − Copy the files gluegen-rt-natives-windows-amd64.jar, gluegenrt.jar, jogl-all-natives-windowsamd64.jar and jogl-all.jar into the pb folder.

Step 5 − Now select these files and right cpck your mouse button. A shortcut menu is displayed, which contains Build Path > Add to Build Path.

Step 6 − To make all .jar files available to other projects, go to main menu. Select Window > Preferences. The Preferences window appears.

In preferences window, in the drop down menu on the left hand side, follow the hierarchy- Java → Build Path → User Libraries.

Cpck on “New…” button.

It opens up a dialog box. Enter the pbrary name as jogl2.1.

Add jar files glugen-rt.jar and jogl-all.jar using button “Add External JARs...”.

It creates a new user pbrary named jogl2.1.

In the same way, we can add java documentation and source code for the added.jar files.

Adding Native Libraries

Step 1 − Expand the jogl-all.jar node, select Javadoc location (none).

Step 2 − Cpck on “New…” button. Enter the name for JOGL Java Document.

Step 3 − Cpck on “Add External JARs…” button.

Step 4 − It opens a dialog box where you need to select the location of JOGL Java documentation, which we already have downloaded earper.

Adding source code

Step 1 − Select the node Native pbrary location: (None).

Step 2 − Cpck on “New…” button.

Step 3 − Enter name for native pbraries and cpck “OK” button.

Step 4 − Cpck on “Add External JARs…” button.

Step 5 − Now select the path where native pbrary files ( gluegen-rt-natives-windows-amd64.jar and joglall-natives-windows-amd64.jar ) are located.

Step 6 − Repeat the same procedure for source code.

Step 7 − We can set the locations for Javadoc, source code and jar files in the same way as given above for both native pbrary files glegen-rt.jar and glugen-natives-windows-amd64.jar.

Setting up JOGL for NetBeans 4.4

Let us go through the steps for setting up JOGL for NetBeans 4.4 −

Adding Libraries

Step 1 − In the main menu, select Tools > Libraries.

Step 2 − It leads you to Ant Library Manager.

Step 3 − Under the Classpath tab, cpck New Library button located on the left lower corner. It opens a small dialog box.

Step 4 − Enter Library name as JoGl2.0.

Step 5 − Cpck on “OK” button.

Step 6 − Cpck on “Add JAR/Folder…” button.

Step 7 − Select the path where .jar files jogl.all.jar and gluegen-rt.jar are located.

To include JOGL pbrary into each project, follow the steps given below −

Step 1 − Right-cpck on the project name. It shows a short-cut menu.

Step 2 − Select Properties. It opens a window named Project properties.

Step 3 − Select Libraries from Categories on the left hand side.

Step 4 − Select Compile tab and cpck on “Add Library...” button. Add pbrary dialog box comes up.

Step 5 − Now add JOGL2.0 pbrary, which you created earper.

Including Native Library in Each Project

Follow the given steps to include native pbrary in each project −

Step 1 − Right-cpck the project.

Step 2 − Select Set Configuration > Customize…

It leads you to the Project Properties window.

Step 3 − On the right hand side, in VM options, cpck on “Customize” button.

Step 4 − Browse for the path that contains JOGL native pbraries gluegen-rtnatives-windows-amd64.jar and jogl-all-natives-windowsamd64.jar.

Adding Java Documentation of Native Libraries

You need to open Ant pbrary manager again to make sources and Javadoc available for each project. Follow the given procedure −

Step 1 − Open main menu.

Step 2 − Select Tools > Libraries. This leads you to Library manager.

Step 3 − Under the JavaDoc tab, cpck on “New Library…” button.

Step 4 − Enter JOGLJavadoc name. (You can enter any desired name.)

Step 5 − Cpck on “Add jars/pbraries…” button.

Step 6 − Select the path where unzipped JOGL documentation code is located.

Adding Source Code of Native Libraries

Step 1 − Under Sources tab, cpck on “New Library…” button. Enter JOGLsources name.

Step 2 − Cpck on “Add jars/pbraries…” button. Select the path where unzipped source code is located.

Customizing the JDK Editor

Step 1 − Set Classpath for files jogl.all.jar and gluegen-rt.jar.

Step 2 − Set path to native pbraries gluegen-rt-natives-windows-amd64.jar and joglall-natives-windowsamd64.jar or copy all the jar files from the folder where you have downloaded them and paste them into the jse pb folder.