JOGL tutorial is extraordinarily confusing. Here's why.

I am new to JOGL and was trying out the triangle applet example in https://jogamp.org/wiki/index.php/Using_JOGL_in_Java_Web_Start . At first I couldn't get it to work and was very confused. After searching these forums for a while, however, I found the problem.

It turns out the tutorials contain errors that can be very confusing for a beginner. I'll list them below:

>In http://jogamp.org/wiki/index.php/Setting_up_a_JogAmp_project_in_your_favorite_IDE , under "Eclipse IDE project", jogl.all.jar is alternatively referred to as "jogl.all.jar" (in the screenshots), "jogl.jar" (in the bullet point saying "Add gluegen-rt.jar and jogl.jar to the project.") and "jogl-all.jar" (in the bullet point saying "Expand the jogl-all and gluegen-rt JARs...").
>Even worse: "jogl.all.jar" isn't included in the file mentioned in http://jogamp.org/wiki/index.php/Downloading_and_installing_JOGL (URL: http://jogamp.org/deployment/jogamp-current/archive/jogamp-all-platforms.7z). I instead downloaded my version from http://jogamp.org/deployment/archive/rc/v2.0-rc5/jar/

To those responsible for the site, please look into this!
/Andreas

On 01/11/2014 01:45 AM, andreasdr [via jogamp] wrote: http://jogamp.org/wiki/index.php/Setting_up_a_JogAmp_project_in_your_favorite_IDE
   jogl.jar -> jogl-all.jar

No jogl.all.jar in any of above Wiki pages ..

Thank you for finding the issues.

>>Even worse: "jogl.all.jar" isn't included in the file mentioned in
> http://jogamp.org/wiki/index.php/Downloading_and_installing_JOGL (URL:
> http://jogamp.org/deployment/jogamp-current/archive/jogamp-all-platforms.7z).
> I instead downloaded my version from
> http://jogamp.org/deployment/archive/rc/v2.0-rc5/jar/

jogamp-all-platforms.7z is actually correct,
since it includes all jar files referenced.

the page very well lists all jar files included

sorry for your inconveniences,
however such tiny typos shall not to be too confusion.
(sure .. not for me sitting in the woods :)

>
> To those responsible for the site, please look into this!

Oh dear ..


> /Andreas

~Sven

Isn't it "jogl.all.jar" that the tutorial on the wiki page should be referencing? This is how I got it to work in Eclipse on my 64 bit Windows system:

I loosely follow the tutorial in http://jogamp.org/wiki/index.php/Setting_up_a_JogAmp_project_in_your_favorite_IDE but:
1. I add jogl.all.jar, jogl-all-natives-windows-amd64.jar, gluegen-rt.jar, gluegen-rt-natives-windows-amd64.jar, which I get from http://jogamp.org/deployment/archive/rc/v2.0-rc5/jar/ to the folder "JOGL" located in my Eclipse workspace.
2. I add jogl-java-src.zip, gluegen-java-src.zip, which I get from http://jogamp.org/deployment/jogamp-current/archive/jogamp-all-platforms.7z
3. I follow the tutorial with respect to how to create the "JOGL" java project and set up jogl.all.jar and gluegen-rt.jar (linking them to the zip files etc.) etc.
4. I link the java project I'm working in (in this case, the triangle project) to the "JOGL" java project in the build path.

But of course, you know better what is correct and how to clarify the tutorial. Thanks for your response!

/Andreas

jogl-all.jar is one of the JARs included in jogamp-all-platforms.7z

I do agree it isn't entirely clear that jogamp-all-platforms.7z is what you want, especially if you don't want JOCL and JOAL.

On 01/11/2014 02:48 AM, andreasdr [via jogamp] wrote:
> Isn't it "jogl.all.jar" that the tutorial on the wiki page should be
> referencing? This is how I got it to work in Eclipse on my 64 bit Windows system:
>
> I loosely follow the tutorial in
> http://jogamp.org/wiki/index.php/Setting_up_a_JogAmp_project_in_your_favorite_IDE but:
>
> 1. I add jogl.all.jar, jogl-all-natives-windows-amd64.jar, gluegen-rt.jar,
> gluegen-rt-natives-windows-amd64.jar, which I get from

Why do you use this version ?

> http://jogamp.org/deployment/archive/rc/v2.0-rc5/jar/ to the folder "JOGL"

AFAIK our deployment/download page and build/version page
does describe whats best to use ..

Look at the date of v2.0-rc5 !

Right now, I recommend 2.1.4-RC, or use the 2.1.3 release.

~Sven

bgroenks96 wrote

jogl-all.jar is one of the JARs included in jogamp-all-platforms.7z

Yes, but jogl.all.jar isn't included, and if I understand it correctly, this file is required for the jogl library to work.

No this is jogl-all.jar.

Edit.: The screen captures need to be fixed too.

Sven Gothel wrote

Why do you use this version ?

> http://jogamp.org/deployment/archive/rc/v2.0-rc5/jar/ to the folder "JOGL"

AFAIK our deployment/download page and build/version page
does describe whats best to use ..

Look at the date of v2.0-rc5 !

Right now, I recommend 2.1.4-RC, or use the 2.1.3 release.

~Sven

The reason to use that version was just desperation to hang on to whatever I found to work :).

I just realized that you're right that the page http://jogamp.org/wiki/index.php/Downloading_and_installing_JOGL contains correct information. I.e. the files listed under "Unzipping the files" are really the correct files to be included from the .7z-file. Doing that and following the tutorial meant that I could compile the triangle example. A message in red font showed up in the console, however, which I don't know what to make of. Note that the execution of the applet wasn't stopped:


FPSAnimator P1:Thread[thread applet-triangleexample.OneTriangleAWTApplet.class-FPSAWTAnimator-Timer0,4,file:/C:/Users/andreasdr/Dropbox/Programming/Java/workspaceeclipse/TriangleExample/bin/-threadGroup]: Task[thread Thread[thread applet-triangleexample.OneTriangleAWTApplet.class-FPSAWTAnimator-Timer0,4,file:/C:/Users/andreasdr/Dropbox/Programming/Java/workspaceeclipse/TriangleExample/bin/-threadGroup], stopped false, paused false shouldRun true, shouldStop false -- started true, animating true, paused false, drawable 1, drawablesEmpty false]

So now the only confusion that remains is the fact that the tutorial in http://jogamp.org/wiki/index.php/Setting_up_a_JogAmp_project_in_your_favorite_IDE refers to jogl-all.jar in three different ways: "jogl.all.jar" (in the screenshots), "jogl.jar" (in the bullet point saying "Add gluegen-rt.jar and jogl.jar to the project.") and "jogl-all.jar" (in the bullet point saying "Expand the jogl-all and gluegen-rt JARs...")

gouessej wrote

No this is jogl-all.jar.

Edit.: The screen captures need to be fixed too.

You're absolutely right. I get it now, see my previous post.

andreasdr wrote

The reason to use that version was just desperation to hang on to whatever I found to work :).

This is not the latest version. This is not our fault if you pick any obsolete version.

andreasdr wrote

So now the only confusion that remains is the fact that the tutorial in http://jogamp.org/wiki/index.php/Setting_up_a_JogAmp_project_in_your_favorite_IDE refers to jogl-all.jar in three different ways: "jogl.all.jar" (in the screenshots), "jogl.jar" (in the bullet point saying "Add gluegen-rt.jar and jogl.jar to the project.") and "jogl-all.jar" (in the bullet point saying "Expand the jogl-all and gluegen-rt JARs...")

No. Refresh your web browser cache. There are only the screen captures which need to be fixed now.

Thanks for pointing out the spelling mistakes.

gouessej wrote

No. Refresh your web browser cache. There are only the screen captures which need to be fixed now.

Ah, I didn't notice they were updated. Thanks!
/Andreas

andreasdr wrote

gouessej wrote

No. Refresh your web browser cache. There are only the screen captures which need to be fixed now.

Ah, I didn't notice they were updated. Thanks!
/Andreas

I did the original screen captures, so I will try to do updated ones later today.

On 01/11/2014 03:54 PM, Wade Walker [via jogamp] wrote: I don't think this is necessary and worth any of our time,
however - if you still like to do so - thank you!

IMHO - folks should be able to match that ..

:)

The images are all fixed, so jogl-all.jar appears everywhere instead of jogl.all.jar. I redid the Eclipse ones the hard way (by redoing the screen captures) before realizing I could just photoshop a hyphen into the images :) I know this is a minor detail, but I'd rather it be correct to avoid confusion. For every one person who complains to us about this, there are probably dozens who were annoyed, but just didn't say anything.

Wade Walker wrote

The images are all fixed, so jogl-all.jar appears everywhere instead of jogl.all.jar. I redid the Eclipse ones the hard way (by redoing the screen captures) before realizing I could just photoshop a hyphen into the images :) I know this is a minor detail, but I'd rather it be correct to avoid confusion. For every one person who complains to us about this, there are probably dozens who were annoyed, but just didn't say anything.

Thanks! I think it is important that that page in particular doesn't contain any errors, since it is one of the first things - if not the very first - that a newcomer to JOGL will read.