How to: Getting started with JOGL

[kaffiene]

Thanks Ken 

[tiger7]

Hi.

Can anyone say why my app(one of the lastest jogl and jdk6, WinXP SP2)  has these problems?
 
1. After going fullscreen the bottom part of the screen(START button line) is under the "start" button.
2. Before pressing alt-tab it draws a twice slimer line at the top of the screen, but after alt-tab this problem and the first problem  will be solved.

1   2   3   4   5   6   7   8   9   10   11   12   13   14   15   16   17   18   19   20   21   22   23   24   25   26   27   28   29   30   31   32   33   34   35   36   37   38   39   40   41   42   43   44   45   46   47   48   49   50   51   52   53   54   55   56   57   58   59   60   61   62   63   64   65   66   67   68   69   70   71   72   73   74   75   76   77   78   79   80   81   82   83   84   85   86   87   88   89   90   91   92   93   94   95   96   97   98   99   100   101   102   103   104   105   106   107   108   109   110   111   112   113   114   115   116   117   118   119   120   121   122   123   124   125   126   127   128   129   130   131   132   133   134   135   136   137   138   139   140   141   142   143   144

import java.awt.GraphicsDevice; import java.awt.GraphicsEnvironment; import java.awt.event.*; import javax.swing.JFrame; import javax.media.opengl.*; public class Test   extends JFrame     implements GLEventListener, KeyListener {   private GLCapabilities caps;   private GLCanvas canvas;   GLAutoDrawable drawable;   int x = 50;     public Test()   {     super("Test");     caps = new GLCapabilities();     canvas = new GLCanvas(caps);     canvas.addGLEventListener(this);     canvas.addKeyListener(this);       getContentPane().add(canvas);   }   public void run()   {    setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);    setUndecorated(true);    GraphicsDevice gd = GraphicsEnvironment.getLocalGraphicsEnvironment().getDefaultScreenDevice();    gd.setFullScreenWindow(this);        setVisible(true);    setLocationRelativeTo(null);     setVisible(true);     canvas.requestFocusInWindow();   }   public static void main(String[] args)   {     new Test().run();   }   public void init(GLAutoDrawable drawable)   {     GL gl = drawable.getGL();     this.drawable = drawable;     float values[] = new float[2];     gl.glGetFloatv(GL.GL_LINE_WIDTH_GRANULARITY, values, 0);     gl.glGetFloatv(GL.GL_LINE_WIDTH_RANGE, values, 0);     gl.glEnable(GL.GL_LINE_SMOOTH);     gl.glEnable(GL.GL_BLEND);     gl.glBlendFunc(GL.GL_SRC_ALPHA, GL.GL_ONE_MINUS_SRC_ALPHA);     gl.glHint(GL.GL_LINE_SMOOTH_HINT, GL.GL_DONT_CARE);     gl.glLineWidth(1.5f);     gl.glClearColor(0.0f, 0.0f, 0.0f, 0.0f);   }     public void display(GLAutoDrawable drawable)   {    GL gl = drawable.getGL();     gl.glClear(GL.GL_COLOR_BUFFER_BIT);     gl.glColor3f(0.0f, 1.0f, 0.0f);     gl.glPushMatrix();         drawBlocksAndBorder(drawable);         gl.glPopMatrix();     gl.glFlush();   }     private void drawBlocksAndBorder(GLAutoDrawable drawable)   {     GL gl = drawable.getGL();     gl.glBegin(gl.GL_QUADS);                  // Draw A Quad    gl.glVertex3f( getCoordX(0), getCoordY(0), 0.0f);            // Top Left    gl.glVertex3f( getCoordX(800), getCoordY(0), 0.0f);            // Top Right    gl.glVertex3f( getCoordX(800), getCoordY(25), 0.0f);            // Bottom Right    gl.glVertex3f( getCoordX(0), getCoordY(25), 0.0f);            // Bottom Left    gl.glEnd();     gl.glFlush();       }   public void reshape(GLAutoDrawable drawable, int x, int y, int w, int h)   {   }   public void displayChanged(GLAutoDrawable drawable, boolean modeChanged,       boolean deviceChanged)   {   }   public void keyTyped(KeyEvent key)   {   }   public void keyPressed(KeyEvent key)   {   }   public void keyReleased(KeyEvent key)   {   }     public float getCoordX(float x)   {      if(x<640)      {         return -(640-x*1.6f)/640;      }      else if(x>640)      {         return (-640+x*1.6f)/640;      }       else        {           return 0;        }    }         public float getCoordY(float y)   {      if(y<512)      {         return (512-y*1.7066f)/512;      }      else if(y>512)      {         return -(-512+y*1.7066f)/512;      }       else        {           return 0;        }    }       }

[Ken Russell]

The call to setLocationRelativeTo() is messing things up. Take it out and things should work fine.

Games published by our own members! Go get 'em!

[Humunculus]

Ok guys, hey there, n00b talking.

I am sure this issue has been addressed like a million  times (and i see some far more serious questions aroud this thread)  but i'll risk asking here.
I have problems on setting JOGL.

I have winXP-32, JDK and JRE 1.6.0 installed and net beans 5.5
I have added my jdk bin path (normaly c:\program files\java\jdk1.6.0\bin) to the windows path.
I am now trying to set up jogl.

So i got

jogl.dll
jogl_cg.dll
jogl_awt.dll

copied in my bin folder and jogl.jar in lib/ext folder.
Now correct if i am wrong. at first i put them in the jre1.6.0 folders calles so, meaning:
..\jre1.6.0\bin       &
..\jre1.6.0\lib\ext

That didn't work for me, i got a compile time error:                         package net.java.games.jogl does not exist

I tried copying the files to other location like
..\jdk1.6.0\jre\bin     &
..\jdk1.6.0\jre\lib\ext
and even ..\jdk1.6.0\bin for the .dll(s) (just in case)

my "java.library.path" gives :
C:\Program Files\Java\jdk1.6.0\jre\bin;.;C:\WINDOWS\Sun\Java\bin;C:\WINDOWS\system32;C:\WINDOWS;C:\Python24\.;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\Program Files\ATI Technologies\ATI Control Panel;C:\Program Files\Java\jdk1.6.0\jre\bin


Oh i also tried to add the jogl.jar to the project in net beans as described in the help file : Working with Projects-->Standard Projects-->Managing the classpath.... nothing....

I know it must be something stupid that i do wrong or sth.... so plz can someone tell me.....what does this n00b do wrong?

Thank you in advance.

[cylab]

First remove every file related to jogl/gluegen jars and dlls you have spread across your system. Especially don't _ever_ install jogl to global locations such as jre\lib or c:\windows.

Since you are using netbeans, just use my module: http://www.java-gaming.org/forums/index.php?topic=12530.msg126787#msg126787

Note: If you already created a JOGL library inside Netbeans using |Tools| -> |Library Manager|, make sure to delete it prior to the module installation.

package net.java.games.jogl does not exist

I assume you are trying to compile examples from other sites. "net.java.games.jogl" is outdated and was replaced by "javax.media.opengl"

[Humunculus]

great! thanks! i'll try it out asap and let ypu know if anything comes up.
thx a lot.


....got question though. is there a setting without using the module you linked? just asking out of curiosity.


(PS here, i found in many sites (outdated maybe) that i had to install the files in lib/ext and bin. Why is it that this is bad?)

thanks again

[cylab]

....got question though. is there a setting without using the module you linked? just asking out of curiosity.

Yes there is.
- Downloaded the JOGL distribution for your platform (e.g. "jogl-1.1.0-rc3-windows-i586.zip")
- Unzip it into a local folder (e.g. "C:\development\javalibs\")
- Start Netbeans, go to |Tools| -> |Library Manager|
- Click [New Library] and create a "Class Library" named "JOGL-DEPS" (don't call it JOGL, since this breaks my module )
- Click [Add Jar/Folder] and select "jogl.jar" and "gluegen-rt.jar" from the "lib" directory of the unzipped JOGL distribution
- Close the Library Mananger using [OK]
- Create a "Java Application" from Netbeans "General" project templates
- Go to the "Libraries" node of the new project and right click "Add"
- Select "JOGL-DEPS" and close the dialog
- Open the project properties
- Go to the "run" node and add "-Djava.library.path=C:/development/javalibs/jogl-1.1.0-rc3-windows-i586/lib" to the VM options

That should be it. My module adds the ability to build distributions of your app and comes with a out of the box running example app.

(PS here, i found in many sites (outdated maybe) that i had to install the files in lib/ext and bin. Why is it that this is bad?)

It breaks Java Webstart deployment of JOGL apps, since the locally installed version has precedence over the one in the Webstart descriptor, so if the webstarted App needs a different version, it doesn't run and you will have no clue, why...

[Humunculus]

Enlightening! Thanks a lot mate!

[Humunculus]

I have another probablly stupid question.

When i try to

import    com.sun.opengl.utils.Animator;

i get a 'package does not exist' error during compile. Net beans indicate also that i have not  Javadoc documentetion or haven't added specified javadoc in my java platform manager.

should i get some specific javadoc, or .jar file and install or is it something else? Maybe it is also outdated? in fact i am really confused as of where to get correct examples of code that works.

Sorry for being so inadequate in this, i just moved here from C, things were clearer to me there 
I am really trying to get a going here 

thanks for any help.

[cylab]

When i try to
import    com.sun.opengl.utils.Animator;

Just remove the unknow import, place your cursor over a the read underlined usage of Animator in your code, wait for a yellow "light bulb" to apear on the left side of the editor, click on it and select "import ....Animator". The IDE does the rest.

Use this "technique" with outdated examples as well. Just remove the imports, search for red underlined class usages and let the imports be fixed by the IDE.

in fact i am really confused as of where to get correct examples of code that works.

There are quite a lot of working examples in the jogl-demos distribution on the jogl-files page: https://jogl.dev.java.net/servlets/ProjectDocumentList?folderID=5971&expandFolder=5971

Games published by our own members! Go get 'em!

[Humunculus]

again you save me. I hope i will ask more content questions in the future if need be.
thanks a lot for bith patience and advice.


P.S. I must be blind to not see those zip files ....god.....

[Humunculus]

Okey,thanks to your advice and some more searching for an example as simple as it comes i think i am finally getting closer to actually running something in jogl...yay 
anyway, i still got a problem, hopefully the final one before going deeper into this stuff.

i got an example that creates a very basic JOGL GLEventListener.
It compiles with no errors (thx again), but i go tthis run time error:

Exception in thread "main" java.lang.UnsatisfiedLinkError: no jogl in java.library.path

I tried to correct this by adding:       -Djava.library.path=C:\Program Files\javalib\jogl-1_0_0-windows-i586\lib
in the run tab of the project at VM options.

yet i get another error:   

java.lang.NoClassDefFoundError: Files\javalib\jogl-1_0_0-windows-i586\lib


only this time i got no idea how to fix it. 

Also i am following the Java tutorials at java.sun.com/docs/books/tutorial/     in order to a grip of what's goin on around java  but i could use more that this (for example a good explanation on madules packets javadocs and stuff). 

Thanks again in advance for any help.

[cylab]

- with java, always use forward slashes, even on windows
- theres a space in your path, so you have to quote the string

1	-Djava.library.path="c:/Program Files/javalib/jogl-1_0_0-windows-i586/lib"

[Humunculus]

thanks again. it seems to work with no problem using both   " / "  or   " \ ".

[kylix999]

hi

do you know some prog or anything that will make more simple running jogl prog, i know i can use bat file with -cp option but i was thinking is it posiible to make it more easier for end user who do not have any knowledge what classpath is etc

for example i would like to make it as simple like is eclipse made, you know estract downloaded zip and normally click eclipse etc
with normal java progs in jar without external libraries it is easy just 2xClick jar and it works but with jogl... it will not
i was thinking also is it possible to use jnlp file just locally  but i do not have such experience with it


for example now i am using such bat code:

1   2   3

java -jar M3G_MAKER.jar -cp "c:\jogl.jar;." -Djava.library.path="c:\jogl" -Dsun.java2d.noddraw=true

the problem is that manualy user must ceate jogl folder and than copy jogl files to it so when he clicks bat file prog will work
but how to make it simple?
for example lets imagine some directory where my prog jar is:

progDiectory:
--------lib/jogl
--------data
--------M3G_MAKER.jar


so main is progdirectory , lib , data are subdirectoiries of progDirectory and lets imagine that jogl must be in that lib directory and
and progDirectory can be anywhere on hdd...
you know what i mean?

so how to make my prog not on fixed lib jogl directory dependent?

any ideas?

[Agrv2236]

You can use the following tree :
prog/system/lib/jogl.dll
prog/system/lib/jogl_cg.dll
prog/system/lib/jogl_awt.dll
prog/system/lib/gluegen-rt.dll
prog/system/jogl.jar
prog/system/gluegen-rt.jar
prog/system/M3G_MAKER.jar
prog/data/*
prog/M3G_MAKER.bat

with the following M3G_MAKER.bat :

1   2   3

@echo off cd system java -Djava.library.path=lib -cp gluegen-rt.jar;jogl.jar;M3G_MAKER.jar  -Dsun.java2d.noddraw=true M3G_MAKER.Main

[hell32.dll]

that's all good but after installing librarys my IntelliJIDEA do that:

import javax.media.opengl.GLEventListener;
import javax.media.opengl.GL;
import javax.media.opengl.GLDrawable;
import javax.media.opengl.DebugGL;

but i'm need to import not from javax, i'm need do implements library from net... like in exaples
and import net.java.games.jogl.GL; is not avalible

because if i'm implements from javax then someone funcs is not avalible...for example : drawable.getGL()

[jboyd99]

This is a desperate plea. I have a VERY SIMPLE request:

Please pin a topic explaining the options and caveats for deploying JOGL apps. Failing that, please respond as to why this won't happen. It would be greatly appreciated by many people.

The more detailed issue follows. Note how I'm giving a pretty good outline of the proposed HOWTO, sans the definitive answers...

Having searched around high and low, I have seen many explanations as to how to deploy JOGL apps. The majority consensus seems to be to use Java Web Start. In some places I've seen it recommended that the JOGL libraries (both JAR files and platform-specific native pieces) be added to the JRE's standard extension directory; in other places I have seen dire warnings not to do this (with sketchy explanations given as to why not). The latter recommend either JWS or setting the system-wide CLASSPATH and platform-specific library path environment variables. I have also seen mention of a method to use JOGL in applets, but have not yet tried to do this myself.

Here are some problems with these suggestions:

1. In many situations, Java Web Start is not desirable. To name a few: you have a ginormous app you want to distribute on a CD or other media that uses JOGL; you want users to be able to run the app as a locally installed, offline application, since it has nothing to do with the internet; you are really lazy and don't want to investigate the poorly documented JWS setup and write a big XML file; you don't have access to a static web server host; you are using JOGL in an app containing other libraries that can not be deployed this way. I think I've made my point on this.

2. Setting the CLASSPATH and PATH does not appear to work. At least didn't work for me. (JOGL 1.1.0, JRE 1.5.0_9, Windows XP) I cannot for the life of me think why it wouldn't work, but it does not. I tried rebooting; nothing. I set both these variables to the location containing all the JOGL libraries (JARs and .DLLs). As I've seen documented. When I try to execute my simple JOGL app, either by double-clicking the JAR file or doing java -jar testapp.jar from the command line, I get an error. (In double-click case this error erroneously tells me that main class could not be found; by putting JOGL libraries into the JRE's extension directory, the app runs just fine, indicating that in fact the main class is easy to find, and is specified correctly in the jar manifest, but this would seem to be a JRE issue.)

3. I can run by test app by giving a full java -classpath ".;%CLASSPATH%;C:\jogl\jogl.jar;C:\jogl\gluegen.jar" -jar testapp.jar . However this is a pain in the ass, and the whole point here is I am trying to allow end users to run this app. For that matter, even setting the system-wide CLASSPATH and PATH variables (or LD_LIBRARY_PATH on Linux, whatever it is on OS X) is not something users are going to do for the most part. (For development its also simple to let my IDE add the JARs to the build path and test within the IDE.)

3. Because of 1,2, and 3, I appear to be left with no options but to copy the JOGL libraries into my JRE's lib/ext directory. Though this is discouraged with dire warnings, it works just fine for me so far. As for these dire warnings, I do understand that this method will break whenever the JRE is updated to another version (again, a JRE issue; IMHO it ought to be smart enough to keep already installed extensions when updating, or allow users to choose this option). I have also been warned that this causes a conflict when other apps using Java Web Start but using a different (or even same?) version of JOGL are loaded. So that's no good...

4. When I've tried to have a couple friends test my app, they have had failures I cannot explain. One, also using Windows XP, was unable to get the app to run correctly when double-clicking even after placing the JOGL libraries in the JRE's extension directory. She was able to run from the command-line though, doing java -jar testapp.jar, with the libraries in the extension dir. This mystifies me, as I am able to double-click the jar file. Another friend on OS X who out of paranoia has so far refused to place the libraries into the extension dir has had errors even when invoking from the command-line with the full classpath to the libraries specified, that he solved only by moving to the same directory as my app before invoking. The point is, it has been a pain in the ass to tell other users how to run the app.

5. So based on these points, it appears there is *no* reliable way to run JOGL apps, other than Java Web Start (see point #1). Correct me if I'm wrong, but isn't deploying an app likely to be something *all* developers will want to do at some point? It seems there ought to be a simple way to allow users to have the same experience with a Java app (3D or otherwise) as with any other application. I am not averse to using an installer package like InstallAnywhere, or even writing my own batch and shell files for different target platforms so users can double-click something, but as this post details, I'm not sure where the JOGL stuff ought to be installed or what those scripts ought to contain.

I hope the detail here is helpful and not aggravating and that it is appreciated that the need for solid answers to these issues in a highly visible place is important to all potential JOGL users and developers. If such a resource exists, by all means point me to it and I will apologize for being redundant (but please pin it on these forums).

Thanks.

Jason Boyd

 

[cylab]

@hell32.dll
The net.java.games.jogl.GL is outdated and deprecated. Use the javax.media.opengl package. For examples try to work throught the jogl-demos, they are all reworked for the new api. Maybe see this thread for more information.

@jboyd99
Placing the jogl jars in the jre/ext directory is dangerous because of webstart conflicts with other jogl apps. I even consider this a non-option from the end-user perspective, too. Just create a directory tree like Agrv2236 suggested (note that M3G_MAKER has to be substituted with <your application>), include the desired jogl-version in the package and use a bat or cmd-file to start. Another option would be to write an installer-script (innosetup or something) that creates a desktop/startmenu shortcut for starting the app. If you ship on cd, also packaging a JRE would be the safest thing to do.

One, also using Windows XP, was unable to get the app to run correctly when double-clicking even after placing the JOGL libraries in the JRE's extension directory. She was able to run from the command-line though, doing java -jar testapp.jar, with the libraries in the extension dir.

Maybe your friend installed some software (like WinZIP, Nokia application installer etc.), that registers itself for the jar file type. This is a long standing problem with executable jars in general :/

[kfaissal]

We are developing a large scale traffic simulator for research purposes. We are using java/JOGL in Windows environment.

We are in the process of buying a new workstation for our lab. Is it a right decision to go with intel 64 bit quad core processor with Windows Vista? Would we expect any problems running JOGL on such platform?

What JOGL binaries should we use? if any?

[skooter]

First of all - GREAT tutorial/updates. I've just finished a course on OpenGL for ANSI-C and this changeover is brill...

kfaissal - I'm running a dual-core intel 32bit with Vista and JoGL works fine! Chews up a hellavalot of processing tho' (just for a simple triangle) using jogl-1.1.1-rc1-windows-i586 bins (I'm assuming those are old - although I only downloaded them a few months ago). Make sure you use javax.media.opengl.* tho'. Having said that I've got all the dlls and jars installed in my jre, which I understand may cause clashed for you. Good luck figuring that out!

xxS

[cylab]

kfaissal - I'm running a dual-core intel 32bit with Vista and JoGL works fine! Chews up a hellavalot of processing tho' (just for a simple triangle) using

Looks like it is falling back to software rendering. There are some issues on Vista but imho all related to drivers.

[ekjo014]

I have written a more up to date tutorial. introducing basically the same concepts.

http://cgi.cse.unsw.edu.au/~ekjo014/index.php?n=Programming.JOGLTutorial

[cylab]

While your tutorial is good, both links you supply for installing JOGL suggest to copy the jogl.jar to the lib/ext directory, which is strongly discouraged, since it breaks webstart installation. This can lead to downloaded applications not working on the machine! Just copy the jogl jars somewhere on your system (e.g. C:\development\jogl) and set the CLASSPATH and PATH (LD_LIBRARY_PATH on Linux) variables accordingly.

[ekjo014]

yes that is true. my tute is meant mainnly for n00bs, and the installation section is included only as a courtesy

[cylab]

yes, I do understand that, but especially noobs would have problems debugging this situation, if they try to run a webstart app depending on a different jogl version.

[ekjo014]

yeah true. i'll update when i get the chance.

[capowski]

I struggled to get JOGL running correctly as many above people describe.  But Netbeans saved me.  If you use
the NetBeans IDE version 6.0 or later, it comes with the openGL pack, and all that JOGL stuff is done for you.
You don't even have to know what the word "classpath" means.  In addition, NetBeans provides a dozen openGL
examples, and provides them in the best possible way, i.e., as a project in the IDE that you can select.  It makes
it so easy to learn, because, for example, you can select the openGL gears demo, run it, modify it, run it again, etc.
Kudos to netbeans!

I'm struggling now with the same thing that Jason Boyd described, how to deploy a Java-openGL project on the
internet.  I have deployed many applets, but cannot figure out how to write an applet that uses openGL.  I have written
many openGL applications, but haven't been able to deploy any of them successfully.  Does anyone know of a
tutorial or examples that allows us to put an Java-openGL program (either applet or application) on the web so that
someone else can run it as they now can run a Java applet (without openGL)?

[Ricardo-san]

Hey people. I just downloaded the JOGL files to my HD. So, all I have to do is include the .jar in  my app? I don't have admin access on my computer so I can't install applications...

[cylab]

For compiling JOGL based apps, you need to specify the needed jars on
the classpath:

javac -classpath path/to/jogl.jar:path/to/gluegen-rt.jar
       -sourcepath app/sources -d app/classes

and run it via

java -Djava.library.path=path/to/jogl/natives:path/to/gluegen/natives
      -classpath path/to/jogl.jar:path/to/gluegen-rt.jar:app/classes
      org.yourorg.YourApp

Replace : with ; when using windows.

You can put the above in a .sh(unix) or .bat(windows) file.