https://jogamp.org/wiki/api.php?action=feedcontributions&feedformat=atom&user=GouessejJogampWiki - User contributions [en]2026-04-21T13:12:28ZUser contributionsMediaWiki 1.44.0https://jogamp.org/wiki/index.php?title=WebAssembly_(wasm)_Target_Platform&diff=2230WebAssembly (wasm) Target Platform2025-08-25T07:54:12Z<p>Gouessej: /* GraalVM */ support wasm as a target</p>
<hr />
<div>Extracted from [[SW Tracking Report Feature Objectives Overview|Feature & Objectives]].<br />
<br />
= Overview =<br />
See [https://jogamp.org/bugzilla//show_bug.cgi?id=1506 Bug 1506] describing this feature.<br />
<br />
Since Java Applets are not more supported within browser or by OpenJDK for years,<br />
it may seems feasible to evaluate the WebAssembly target running within e.g. web browser nowadays.<br />
<br />
An initial evaluation on small C++ projects using the emscripten front-end for LLVM's clang++ to wasm compiler, which supports many ported system libraries like SDL, OpenGL, .. has been undertaken successfully with variable results.<br />
* [https://webassembly.org/ WebAssembly]<br />
* [https://emscripten.org/ emscripten]<br />
* [https://jausoft.com/cgit/cs_class/gfxbox2.git/about/ gfxbox2 C++/wasm evaluation]<br />
* Project [https://jausoft.com/cgit/gamp.git/about/ Gamp]<br />
<br />
The wasm target is comparable to Java bytecode but the wasm virtual machine is not as performant, efficient or flexible as actual native code. The lack of hassle free native threads and native high-performance may remind one of the first JVM steps. The wasm code runs within a virtual machine like the JVM and additionally lacks of native binding capabilities.<br />
<br />
Some limitations may be overcome, others are likely by design as it usually runs on the same browser virtual machine as the JavaScript companion. Compromises must be made on shared memory and native threads, cached non-local file I/O and socket communication - while other native features will simply never work, e.g. operating system ioctl-calls, etc.<br />
<br />
Opening the door for any language to be compiled to a platform independent intermediate representation (IR) like Java’s bytecode suitable for a versatile runtime environment including its virtual machine is surely still desirable.<br />
<br />
= Initial C++/wasm Evaluation =<br />
[https://jausoft.com/cgit/cs_class/gfxbox2.git/about/ Our little gfxbox2 games] compiled to [https://webassembly.org/ wasm] run about ~50% slower [https://jausoft.com/cgit/cs_class/gfxbox2.git/about/#online-webassembly-examples within a browser] than in native code, depending on coding strategy of our graphics (pixelmap vs SDL/OpenGL primitives). <br />
<br />
The used [https://emscripten.org/ emscripten] frontend allowed us to use memory-growth, envelop files used in the wasm file, add cheap stack-overflow cockies and nullptr writes and so forth. Utilization of OpenGL ES via SDL2 was a breeze.<br />
<br />
The underlying LLVM compiler did an excellent job and overall, the transition was easy and almost involved no code changes but dropping native thread (std::thread) usage.<br />
<br />
The overall program structure had to be adapted to align to the single-thread main-loop workflow<br />
and specific emscripten-javascript hooks added to allow seamless interaction.<br />
All in all, nothing to be too afraid of and depending on the class of applications to be ported <br />
to the browser these days, a feasible procedure.<br />
<br />
= Project [https://jausoft.com/cgit/gamp.git/about/ Gamp] =<br />
[https://jausoft.com/cgit/gamp.git/about/ Gamp] stands for Graphics, Audio, Multimedia and Processing, the same way as JogAmp, but natively plus using WebAssembly.<br />
<br />
Gamp replicates JogAmp's experience natively via C++ in a condensed form, allowing a similar workflow on native targets and [https://jausoft.com/cgit/gamp.git/about/#online-webassembly-examples within the browser] via WebAssembly. Ironically this will bring back runs everywhere including the web.<br />
<br />
Initial goal reimplementing [https://jausoft.com/blog/tag/graph_type_rendering/ Resolution independent NURBS curves rendering using programmable graphics pipeline (Graph)] has been completed.<br />
<br />
Gamp uses [https://jausoft.com/cgit/jaulib.git/about/ jaulib] for general purpose functionality including linear algebra and geometry and builds upon initial wasm experience collected with [https://jausoft.com/cgit/cs_class/gfxbox2.git/about/ gfxbox2].<br />
<br />
= Java Support =<br />
Java bytecode compiler to wasm including some ''runtime envelop'' <br />
* [https://github.com/google/j2cl/blob/master/docs/getting-started-j2wasm.md J2wasm] within [https://github.com/google/j2cl J2CL] emits naïve Wasm using the text format and it relies on Binaryen toolchain to assemble, link, and optimize<br />
** [https://www.wingolog.org/pub/epfl-wasm-gc-feb-2024-slides.pdf 2024 Slides]<br />
* [https://github.com/konsoletyper/teavm TeaVM] [https://teavm.org/docs/intro/overview.html overview]<br />
* [https://github.com/i-net-software/JWebAssembly JWebAssembly] [https://github.com/i-net-software/JWebAssembly/wiki doc]<br />
* [https://mirkosertic.github.io/Bytecoder/ Bytecoder]<br />
<br />
Further interesting bits & pieces<br />
* [https://openjdk.org/jeps/457 JEP 457: Class-File API ]<br />
* [https://openjdk.org/projects/babylon/articles/linq Babylon]<br />
<br />
== GraalVM ==<br />
GraalVM experimentally hosts wasm only and is producing a wasm target for the wasm (browser) runtime.<br />
* [https://www.graalvm.org/latest/reference-manual/wasm/ GraalVM + wasm (WebAssembly runtime in Java)]<br />
** with the help of emscripten<br />
** [https://www.graalvm.org/22.0/reference-manual/native-image/JNI/ GraalVM + JNI]<br />
* [https://2025.wasm.io/slides/the-future-of-write-once-run-anywhere-from-java-to-webassembly-wasmio25.pdf GraalVM Native Image supporting wasm as a target]<br />
<br />
[https://github.com/oracle/graal/issues/3391 Request for enhancement about wasm target in GraalVM].<br />
<br />
= Java Browser Outlook =<br />
So far the only question arises why reinventing the wheel once again? Dropping utilization of a well working JVM for the web had no technical reasoning.<br />
<br />
However, in case no suitable wasm target for the Java bytecode and the Java Runtime pieces can be established, one might either want to also look into bringing back the JRE into the browser or painfully drop Java for C++, as the latter is already close to have acceptable (slower and limited) wasm target runtime properties.</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Rudimentary_standalone_example_using_the_fixed_pipeline_by_Julien_Gouesse&diff=2204Rudimentary standalone example using the fixed pipeline by Julien Gouesse2024-03-04T18:35:17Z<p>Gouessej: </p>
<hr />
<div>This program displays a simple 3D rendering of a polygon using JOGL. Please note though that this code is a demonstration of the use of JOGL and as such makes use of immediate mode drawing commands; this serves to show how the conventional C style API is used through JOGL, but it is strongly recommended to make use of modern OpenGL techniques.<br />
<br />
<pre>import java.awt.*;<br />
import java.awt.event.*;<br />
import com.jogamp.opengl.*;<br />
import com.jogamp.opengl.awt.GLCanvas;<br />
import com.jogamp.opengl.fixedfunc.*;<br />
import com.jogamp.opengl.util.Animator;<br />
<br />
/**<br />
* Self-contained example (within a single class only to keep it simple) <br />
* displaying a rotating quad<br />
*/<br />
public class JOGLQuad implements GLEventListener {<br />
<br />
private float rotateT = 0.0f;<br />
<br />
@Override<br />
public void display(GLAutoDrawable gLDrawable) {<br />
final GL2 gl = gLDrawable.getGL().getGL2();<br />
gl.glClear(GL.GL_COLOR_BUFFER_BIT);<br />
gl.glClear(GL.GL_DEPTH_BUFFER_BIT);<br />
gl.glLoadIdentity();<br />
gl.glTranslatef(0.0f, 0.0f, -5.0f);<br />
<br />
// rotate about the three axes<br />
gl.glRotatef(rotateT, 1.0f, 0.0f, 0.0f);<br />
gl.glRotatef(rotateT, 0.0f, 1.0f, 0.0f);<br />
gl.glRotatef(rotateT, 0.0f, 0.0f, 1.0f);<br />
<br />
// Draw A Quad<br />
gl.glBegin(GL2.GL_QUADS); <br />
gl.glColor3f(0.0f, 1.0f, 1.0f); // set the color of the quad<br />
gl.glVertex3f(-1.0f, 1.0f, 0.0f); // Top Left<br />
gl.glVertex3f( 1.0f, 1.0f, 0.0f); // Top Right<br />
gl.glVertex3f( 1.0f,-1.0f, 0.0f); // Bottom Right<br />
gl.glVertex3f(-1.0f,-1.0f, 0.0f); // Bottom Left<br />
// Done Drawing The Quad<br />
gl.glEnd(); <br />
<br />
// increasing rotation for the next iteration <br />
rotateT += 0.2f; <br />
}<br />
<br />
@Override<br />
public void init(GLAutoDrawable glDrawable) {<br />
GL2 gl = glDrawable.getGL().getGL2();<br />
gl.glShadeModel(GLLightingFunc.GL_SMOOTH);<br />
gl.glClearColor(0.0f, 0.0f, 0.0f, 0.0f);<br />
gl.glClearDepth(1.0f);<br />
gl.glEnable(GL.GL_DEPTH_TEST);<br />
gl.glDepthFunc(GL.GL_LEQUAL);<br />
gl.glHint(GL2ES1.GL_PERSPECTIVE_CORRECTION_HINT, GL.GL_NICEST);<br />
}<br />
<br />
@Override<br />
public void reshape(GLAutoDrawable gLDrawable, int x, int y, int width, int height) {<br />
GL2 gl = gLDrawable.getGL().getGL2();<br />
final float aspect = (float) width / (float) height;<br />
gl.glMatrixMode(GLMatrixFunc.GL_PROJECTION);<br />
gl.glLoadIdentity();<br />
final float fh = 0.5f;<br />
final float fw = fh * aspect;<br />
gl.glFrustumf(-fw, fw, -fh, fh, 1.0f, 1000.0f);<br />
gl.glMatrixMode(GLMatrixFunc.GL_MODELVIEW);<br />
gl.glLoadIdentity();<br />
}<br />
<br />
@Override<br />
public void dispose(GLAutoDrawable gLDrawable) {<br />
}<br />
<br />
public static void main(String[] args) {<br />
final GLCanvas canvas = new GLCanvas();<br />
final Frame frame = new Frame("Jogl Quad drawing");<br />
final Animator animator = new Animator(canvas);<br />
canvas.addGLEventListener(new JOGLQuad());<br />
frame.add(canvas);<br />
frame.setSize(640, 480);<br />
frame.setResizable(false);<br />
frame.addWindowListener(new WindowAdapter() {<br />
public void windowClosing(WindowEvent e) {<br />
animator.stop();<br />
frame.dispose();<br />
System.exit(0);<br />
}<br />
});<br />
frame.setVisible(true);<br />
animator.start();<br />
canvas.requestFocus();<br />
}<br />
}<br />
</pre><br />
<br />
You can compile the source code above with Java >= 9 by entering (the JogAmp fat JAR jogamp-fat.jar is required):<br />
<pre>javac -cp jogamp-fat.jar JOGLQuad.java</pre><br />
<br />
You can run this example by entering (under other operating systems except Windows):<br />
<pre>java --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.desktop/sun.java2d=ALL-UNNAMED --add-opens java.desktop/sun.awt=ALL-UNNAMED -cp jogamp-fat.jar:. JOGLQuad</pre><br />
<br />
You can run this example by entering (under Windows):<br />
<pre>java --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.desktop/sun.java2d=ALL-UNNAMED --add-opens java.desktop/sun.awt=ALL-UNNAMED --add-opens java.desktop/sun.awt.windows=ALL-UNNAMED -cp jogamp-fat.jar;. JOGLQuad</pre></div>Gouessejhttps://jogamp.org/wiki/index.php?title=Rudimentary_standalone_example_using_the_fixed_pipeline_by_Julien_Gouesse&diff=2203Rudimentary standalone example using the fixed pipeline by Julien Gouesse2024-03-04T12:52:54Z<p>Gouessej: </p>
<hr />
<div>This program displays a simple 3D rendering of a polygon using JOGL. Please note though that this code is a demonstration of the use of JOGL and as such makes use of immediate mode drawing commands; this serves to show how the conventional C style API is used through JOGL, but it is strongly recommended to make use of modern OpenGL techniques.<br />
<br />
<pre>import java.awt.*;<br />
import java.awt.event.*;<br />
import com.jogamp.opengl.*;<br />
import com.jogamp.opengl.awt.GLCanvas;<br />
import com.jogamp.opengl.fixedfunc.*;<br />
import com.jogamp.opengl.util.Animator;<br />
<br />
/**<br />
* Self-contained example (within a single class only to keep it simple) <br />
* displaying a rotating quad<br />
*/<br />
public class JOGLQuad implements GLEventListener {<br />
<br />
private float rotateT = 0.0f;<br />
<br />
@Override<br />
public void display(GLAutoDrawable gLDrawable) {<br />
final GL2 gl = gLDrawable.getGL().getGL2();<br />
gl.glClear(GL.GL_COLOR_BUFFER_BIT);<br />
gl.glClear(GL.GL_DEPTH_BUFFER_BIT);<br />
gl.glLoadIdentity();<br />
gl.glTranslatef(0.0f, 0.0f, -5.0f);<br />
<br />
// rotate about the three axes<br />
gl.glRotatef(rotateT, 1.0f, 0.0f, 0.0f);<br />
gl.glRotatef(rotateT, 0.0f, 1.0f, 0.0f);<br />
gl.glRotatef(rotateT, 0.0f, 0.0f, 1.0f);<br />
<br />
// Draw A Quad<br />
gl.glBegin(GL2.GL_QUADS); <br />
gl.glColor3f(0.0f, 1.0f, 1.0f); // set the color of the quad<br />
gl.glVertex3f(-1.0f, 1.0f, 0.0f); // Top Left<br />
gl.glVertex3f( 1.0f, 1.0f, 0.0f); // Top Right<br />
gl.glVertex3f( 1.0f,-1.0f, 0.0f); // Bottom Right<br />
gl.glVertex3f(-1.0f,-1.0f, 0.0f); // Bottom Left<br />
// Done Drawing The Quad<br />
gl.glEnd(); <br />
<br />
// increasing rotation for the next iteration <br />
rotateT += 0.2f; <br />
}<br />
<br />
@Override<br />
public void init(GLAutoDrawable glDrawable) {<br />
GL2 gl = glDrawable.getGL().getGL2();<br />
gl.glShadeModel(GLLightingFunc.GL_SMOOTH);<br />
gl.glClearColor(0.0f, 0.0f, 0.0f, 0.0f);<br />
gl.glClearDepth(1.0f);<br />
gl.glEnable(GL.GL_DEPTH_TEST);<br />
gl.glDepthFunc(GL.GL_LEQUAL);<br />
gl.glHint(GL2ES1.GL_PERSPECTIVE_CORRECTION_HINT, GL.GL_NICEST);<br />
}<br />
<br />
@Override<br />
public void reshape(GLAutoDrawable gLDrawable, int x, int y, int width, int height) {<br />
GL2 gl = gLDrawable.getGL().getGL2();<br />
final float aspect = (float) width / (float) height;<br />
gl.glMatrixMode(GLMatrixFunc.GL_PROJECTION);<br />
gl.glLoadIdentity();<br />
final float fh = 0.5f;<br />
final float fw = fh * aspect;<br />
gl.glFrustumf(-fw, fw, -fh, fh, 1.0f, 1000.0f);<br />
gl.glMatrixMode(GLMatrixFunc.GL_MODELVIEW);<br />
gl.glLoadIdentity();<br />
}<br />
<br />
@Override<br />
public void dispose(GLAutoDrawable gLDrawable) {<br />
}<br />
<br />
public static void main(String[] args) {<br />
final GLCanvas canvas = new GLCanvas();<br />
final Frame frame = new Frame("Jogl Quad drawing");<br />
final Animator animator = new Animator(canvas);<br />
canvas.addGLEventListener(new JOGLQuad());<br />
frame.add(canvas);<br />
frame.setSize(640, 480);<br />
frame.setResizable(false);<br />
frame.addWindowListener(new WindowAdapter() {<br />
public void windowClosing(WindowEvent e) {<br />
animator.stop();<br />
frame.dispose();<br />
System.exit(0);<br />
}<br />
});<br />
frame.setVisible(true);<br />
animator.start();<br />
canvas.requestFocus();<br />
}<br />
}<br />
</pre><br />
<br />
You can compile the source code above with Java >= 9 by entering (the JogAmp fat JAR jogamp-fat.jar is required):<br />
<pre>javac -cp jogamp-fat.jar JOGLQuad.java</pre><br />
<br />
You can run this example by entering (under other operating systems except Windows):<br />
<pre>java --add-exports java.base/java.lang=ALL-UNNAMED --add-exports java.desktop/sun.java2d=ALL-UNNAMED --add-opens java.desktop/sun.awt=ALL-UNNAMED -cp jogamp-fat.jar:. JOGLQuad</pre><br />
<br />
You can run this example by entering (under Windows):<br />
<pre>java --add-exports java.base/java.lang=ALL-UNNAMED --add-exports java.desktop/sun.java2d=ALL-UNNAMED --add-opens java.desktop/sun.awt=ALL-UNNAMED --add-opens java.desktop/sun.awt.windows=ALL-UNNAMED -cp jogamp-fat.jar;. JOGLQuad</pre></div>Gouessejhttps://jogamp.org/wiki/index.php?title=Rudimentary_standalone_example_using_the_fixed_pipeline_by_Julien_Gouesse&diff=2202Rudimentary standalone example using the fixed pipeline by Julien Gouesse2024-03-04T12:18:30Z<p>Gouessej: Adds instructions to compile and run the example</p>
<hr />
<div>This program displays a simple 3D rendering of a polygon using JOGL. Please note though that this code is a demonstration of the use of JOGL and as such makes use of immediate mode drawing commands; this serves to show how the conventional C style API is used through JOGL, but it is strongly recommended to make use of modern OpenGL techniques.<br />
<br />
<pre>import java.awt.*;<br />
import java.awt.event.*;<br />
import com.jogamp.opengl.*;<br />
import com.jogamp.opengl.awt.GLCanvas;<br />
import com.jogamp.opengl.fixedfunc.*;<br />
import com.jogamp.opengl.util.Animator;<br />
<br />
/**<br />
* Self-contained example (within a single class only to keep it simple) <br />
* displaying a rotating quad<br />
*/<br />
public class JOGLQuad implements GLEventListener {<br />
<br />
private float rotateT = 0.0f;<br />
<br />
@Override<br />
public void display(GLAutoDrawable gLDrawable) {<br />
final GL2 gl = gLDrawable.getGL().getGL2();<br />
gl.glClear(GL.GL_COLOR_BUFFER_BIT);<br />
gl.glClear(GL.GL_DEPTH_BUFFER_BIT);<br />
gl.glLoadIdentity();<br />
gl.glTranslatef(0.0f, 0.0f, -5.0f);<br />
<br />
// rotate about the three axes<br />
gl.glRotatef(rotateT, 1.0f, 0.0f, 0.0f);<br />
gl.glRotatef(rotateT, 0.0f, 1.0f, 0.0f);<br />
gl.glRotatef(rotateT, 0.0f, 0.0f, 1.0f);<br />
<br />
// Draw A Quad<br />
gl.glBegin(GL2.GL_QUADS); <br />
gl.glColor3f(0.0f, 1.0f, 1.0f); // set the color of the quad<br />
gl.glVertex3f(-1.0f, 1.0f, 0.0f); // Top Left<br />
gl.glVertex3f( 1.0f, 1.0f, 0.0f); // Top Right<br />
gl.glVertex3f( 1.0f,-1.0f, 0.0f); // Bottom Right<br />
gl.glVertex3f(-1.0f,-1.0f, 0.0f); // Bottom Left<br />
// Done Drawing The Quad<br />
gl.glEnd(); <br />
<br />
// increasing rotation for the next iteration <br />
rotateT += 0.2f; <br />
}<br />
<br />
@Override<br />
public void init(GLAutoDrawable glDrawable) {<br />
GL2 gl = glDrawable.getGL().getGL2();<br />
gl.glShadeModel(GLLightingFunc.GL_SMOOTH);<br />
gl.glClearColor(0.0f, 0.0f, 0.0f, 0.0f);<br />
gl.glClearDepth(1.0f);<br />
gl.glEnable(GL.GL_DEPTH_TEST);<br />
gl.glDepthFunc(GL.GL_LEQUAL);<br />
gl.glHint(GL2ES1.GL_PERSPECTIVE_CORRECTION_HINT, GL.GL_NICEST);<br />
}<br />
<br />
@Override<br />
public void reshape(GLAutoDrawable gLDrawable, int x, int y, int width, int height) {<br />
GL2 gl = gLDrawable.getGL().getGL2();<br />
final float aspect = (float) width / (float) height;<br />
gl.glMatrixMode(GLMatrixFunc.GL_PROJECTION);<br />
gl.glLoadIdentity();<br />
final float fh = 0.5f;<br />
final float fw = fh * aspect;<br />
gl.glFrustumf(-fw, fw, -fh, fh, 1.0f, 1000.0f);<br />
gl.glMatrixMode(GLMatrixFunc.GL_MODELVIEW);<br />
gl.glLoadIdentity();<br />
}<br />
<br />
@Override<br />
public void dispose(GLAutoDrawable gLDrawable) {<br />
}<br />
<br />
public static void main(String[] args) {<br />
final GLCanvas canvas = new GLCanvas();<br />
final Frame frame = new Frame("Jogl Quad drawing");<br />
final Animator animator = new Animator(canvas);<br />
canvas.addGLEventListener(new JOGLQuad());<br />
frame.add(canvas);<br />
frame.setSize(640, 480);<br />
frame.setResizable(false);<br />
frame.addWindowListener(new WindowAdapter() {<br />
public void windowClosing(WindowEvent e) {<br />
animator.stop();<br />
frame.dispose();<br />
System.exit(0);<br />
}<br />
});<br />
frame.setVisible(true);<br />
animator.start();<br />
canvas.requestFocus();<br />
}<br />
}<br />
</pre><br />
<br />
You can compile the source code above with Java >= 9 by entering (the JogAmp fat JAR jogamp-fat.jar is required):<br />
<pre>javac -cp jogamp-fat.jar JOGLQuad.java</pre><br />
<br />
You can run this example by entering (under other operating systems except Windows):<br />
<pre>java --add-exports java.base/java.lang=ALL-UNNAMED --add-exports java.desktop/sun.java2d=ALL-UNNAMED --add-opens java.desktop/sun.awt=ALL-UNNAMED -cp jogamp-fat.jar:. JOGLQuad</pre><br />
<br />
You can run this example by entering (under Windows):<br />
<pre>java --add-exports java.base/java.lang=ALL-UNNAMED --add-exports java.desktop/sun.java2d=ALL-UNNAMED --add-opens java.desktop/sun.awt=ALL-UNNAMED -cp jogamp-fat.jar;. JOGLQuad</pre></div>Gouessejhttps://jogamp.org/wiki/index.php?title=SW_Tracking_Report_Feature_Objectives_Overview&diff=2201SW Tracking Report Feature Objectives Overview2024-02-14T09:04:20Z<p>Gouessej: /* Graph UI */</p>
<hr />
<div>This list exposes building blocks <br />
for potential use and business case scenarios<br />
using Java & JogAmp on Desktop and Embedded Devices.<br />
<br />
Notably [[#Graph|Graph & Graph UI]] as well as [[#NEWT_+_Wayland|Wayland]] & [[#Vulkan|Vulkan]] support could be of interest here?<br />
<br />
Also see [[Completed Features Objectives]] ...<br />
<br />
= Graph =<br />
[https://jausoft.com/blog/tag/graph_type_rendering/ Graph/GraphUI Progress Blog Entries]<br />
<br />
== Desired Work Items ==<br />
<br />
This is an ad-hoc list of desired features and fixes,<br />
which shall result in proper bug-reports soon.<br />
<br />
After having reached [https://jausoft.com/blog/2024/01/21/graphui-frustum-culling-clipping-modelview-space/ UI usability with widgets and clipping],<br />
the following items are becoming more interesting<br />
<br />
* Fix general issues with current implementation and API, if any<br />
* Fix Graph rendering bugs (Tessellation)<br />
** [https://jausoft.com/blog/2024/02/13/fixing-jogamps-graph-delaunay-tessellation-of-complex-non-convex-shapes/ First round done]<br />
* Use of super-sized triangles to render Graph lines & curves to allow<br />
** Using a one-pass smooth AA Graph renderer to save resources otherwise used in our pass-2 FBO supersampling renderer<br />
** Generate outlines, i.e. outlined fonts<br />
** Generate special effects like glowing/pumping outlines indicating selection etc<br />
* Allow passing or better attaching per-vertex color to Graph Outline (API)<br />
* <s>Add subtitles in MediaPlayer GraphUI widget</s> ''([https://jausoft.com/blog/2024/02/07/graphui-mediaplayer-feature-complete/ done])''<br />
* Add video encoding in our FFmpeg binding, i.e. an FFMPEGMediaRecorder (Encoding + Multiplexing)<br />
<br />
Further more, if so desired, a C++ implementation of our Graph + GraphUI framework <br />
may also be of interest.<br />
<br />
In case any company or organization is interested and likes to support <br />
this work and may also like to receive support in adopting this framework,<br />
please contact [[Maintainer_and_Contacts#Commercial_Support|Göthel Software e.K.]]<br />
<br />
== Graph UI ==<br />
<br />
[https://jausoft.com/blog/2023/02/22/reimagine-java-on-desktop-bare-metal-devices/ ''Graph UI'' will enable an immersive UI within the 3D scene] on the desktop, mobile and on bare-metal embedded systems without a windowing system.<br />
<br />
Graph UI utilizes [https://jausoft.com/blog/2011/10/05/jogljogamp-red-square-moscow-nurbs-graphicon2011/ Resolution Independent NURBS Curves Rendering using Programmable Graphics Pipeline], i.e. rendering curves directly on the GPU, resolution independent [ [https://jogamp.org/doc/gpunurbs2011/p70-santina.pdf paper], [https://jogamp.org/doc/gpunurbs2011/graphicon2011-slides.pdf slides] ].<br />
<br />
This method allows us to have an ultimate fast font and UI rendering engine, suitable for all devices and applications. No CPU based curve nor font pre-rendering (matching a target resolution) is required.<br />
<br />
Think of an integrated QT or OpenJFX in your 2D/3D application<br />
working on desktop and embedded devices even w/o any windowing system on top <br />
of a plain console [{{SERVER}}/bugzilla/show_bug.cgi?id=1156 DRM/GBM as support by JOGL(EGL) and NEWT]<br />
as demonstrated [https://ict.zafena.se/improved-graphical-information-technology/ by Xerxes on a Raspberry Pi4].<br />
<br />
[https://jausoft.com/blog/2023/02/22/reimagine-java-on-desktop-bare-metal-devices/ Reimagine Java on Desktop & Bare-Metal Devices] <br />
demonstrates the updated Graph Curve Rendering and UI, while [https://jausoft.com/blog/2024/01/21/graphui-frustum-culling-clipping-modelview-space/ this update shows clipping and widgets]. [https://jausoft.com/blog/tag/graph_type_rendering/ Further updates will be posted here...].<br />
<br />
Notably the ''Graph Curve Rendering'' is almost feature complete, as well as our own user input including gesture detection within NEWT.<br />
<br />
;Parent Main Node<br />
: [{{SERVER}}/bugzilla/showdependencytree.cgi?id=803&hide_resolved=0 Dependency Tree]<br />
: [{{SERVER}}/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=IN_PROGRESS&bug_status=RESOLVED&bug_status=VERIFIED&columnlist=product%2Ccomponent%2Cassigned_to%2Cbug_status%2Cresolution%2Cversion%2Cshort_desc%2Cchangeddate&component=core&component=Plugin&list_id=2265&product=GraphUI&query_format=advanced&resolution=---&resolution=FIXED&resolution=INVALID&resolution=WONTFIX&resolution=DUPLICATE&resolution=WORKSFORME&resolution=MOVED All GraphUI]<br />
<br />
;Open Items ''graphui''<br />
<bugzilla><br />
{<br />
"status":["IN_PROGRESS","CONFIRMED", "UNCONFIRMED"],<br />
"product":"graphui",<br />
"include_fields":"id,version,product,component,priority,severity,status,summary"<br />
}<br />
</bugzilla><br />
<br />
;Completed Items ''graphui''<br />
<bugzilla><br />
{<br />
"status":["RESOLVED","VERIFIED"],<br />
"product":"graphui",<br />
"include_fields":"id,version,product,component,status,resolution,summary"<br />
}<br />
</bugzilla><br />
<br />
== Jogl / Graph ==<br />
<br />
[{{SERVER}}/bugzilla/showdependencytree.cgi?id=1064&hide_resolved=0 Dependency Tree Graph Font Issues]<br />
<br />
[{{SERVER}}/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=IN_PROGRESS&bug_status=RESOLVED&bug_status=VERIFIED&columnlist=product%2Ccomponent%2Cassigned_to%2Cbug_status%2Cresolution%2Cversion%2Cshort_desc%2Cchangeddate&component=graph&list_id=2264&product=Jogl&query_format=advanced&resolution=---&resolution=FIXED&resolution=INVALID&resolution=WONTFIX&resolution=DUPLICATE&resolution=WORKSFORME&resolution=MOVED All Jogl Graph]<br />
<br />
;Open Items ''Jogl / graph''<br />
<bugzilla><br />
{<br />
"status":["IN_PROGRESS","CONFIRMED", "UNCONFIRMED"],<br />
"product":"jogl",<br />
"component":"graph",<br />
"include_fields":"id,version,product,component,priority,severity,status,summary"<br />
}<br />
</bugzilla><br />
<br />
;Completed Items ''Jogl / graph''<br />
<bugzilla><br />
{<br />
"status":["RESOLVED","VERIFIED"],<br />
"product":"jogl",<br />
"component":"graph",<br />
"include_fields":"id,version,product,component,status,resolution,summary"<br />
}<br />
</bugzilla><br />
<br />
= OpenJFX =<br />
<br />
[https://jogamp.org/bugzilla//show_bug.cgi?id=607#c20 Bug report 607] describes different ways to either <br />
* enhance external rendering via JOGL into an OpenJFX UI elements, or<br />
* to replace OpenJFX's Glass w/ NEWT and Prism's OpenGL coding with JOGL<br />
<br />
= NEWT =<br />
<br />
* [{{SERVER}}/bugzilla/showdependencytree.cgi?id=807&hide_resolved=0 Dependency Tree NEWT Input Devices]<br />
* [{{SERVER}}/bugzilla/showdependencytree.cgi?id=814&hide_resolved=0 Dependency Tree NEWT Pointer Event]<br />
<br />
<bugzilla><br />
{<br />
"product":["newt","jinput"],<br />
"version":["2.5.0","3.0.0","tbd"],<br />
"cf_type":"FEATURE",<br />
"include_fields":"id,version,product,component,priority,severity,status,summary"<br />
}<br />
</bugzilla><br />
<br />
= NEWT + Wayland =<br />
Currently NEWT supports the X11/Xorg windowing server on Unix alike platforms.<br />
<br />
It might be desired to add direct support to Wayland, as we already added support for <br />
[https://jogamp.org/bugzilla/show_bug.cgi?id=1156 bare metal devices w/o a windowing system via the Linux DRM/GBM console mode] <br />
throughout JOGL + NEWT.<br />
<br />
= Vulkan =<br />
<br />
<bugzilla><br />
{<br />
"component":"vulkan",<br />
"cf_type":"FEATURE",<br />
"include_fields":"id,version,product,component,priority,severity,status,summary"<br />
}<br />
</bugzilla><br />
<br />
= Video Encoding/Decoding & Player =<br />
<br />
Across our releases, we supported video encoding and decoding (with a player)<br />
based on either FFmpeg or Android's library as [https://youtu.be/4gWStKCioi8?t=132 shown in this clip at 2:12 min mark].<br />
<br />
Goal would be to <br />
* Update general ffmpeg video decoding support<br />
* Enhance ffmpeg video encoding support<br />
* Potentially add better control about video-frame to framebuffer control for editing software<br />
<br />
See [https://jogamp.org/bugzilla//buglist.cgi?bug_status=__open__&component=video&list_id=3053&product=Jogl related buglist]<br />
<br />
<bugzilla><br />
{<br />
"component":"video",<br />
"include_fields":"id,version,product,component,priority,severity,status,summary"<br />
}<br />
</bugzilla><br />
<br />
= iOS Enhancements =<br />
<br />
Early iOS support has been demonstrated in 2019<br />
* [https://jausoft.com/blog/2019/06/17/jogamp-ios-arm64-bring-up/ iOS Arm64 bring-up]<br />
* [https://jausoft.com/blog/2019/06/23/jogamp-ios-arm64-port-first-visuals/ iOS Arm64 Port: First Visuals]<br />
* [https://jausoft.com/blog/2019/07/08/jogamp-ios-arm64-port-newt/ iOS Arm64 Port: NEWT]<br />
<br />
Enhancing this port would allow to use JogAmp in a similar fashion as on Android,<br />
but using an OpenJDK iOS build.<br />
<br />
= [[SCC Overview|Source Certification Contract (SCC)]] =<br />
<br />
[{{SERVER}}/bugzilla/showdependencytree.cgi?id=1368&hide_resolved=0 Dependency Tree]<br />
<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=1368 Root Parent Entry]<br />
<br />
<bugzilla><br />
{<br />
"id":["1368", "1369"],<br />
"include_fields":"id,version,product,component,priority,severity,status,summary"<br />
}<br />
</bugzilla><br />
<br />
= Misc =<br />
<br />
<!-- bugzilla><br />
{<br />
"product"!=["graphui","newt"],<br />
"component"!=["graph","vulkan"],<br />
"version":["2.5.0","3.0.0","tbd"],<br />
"cf_type":"FEATURE",<br />
"include_fields":"id,version,product,component,priority,severity,status,summary"<br />
}<br />
</bugzilla--><br />
<br />
<bugzilla><br />
{<br />
"version":["2.5.0","3.0.0","tbd"],<br />
"cf_type":"FEATURE",<br />
"include_fields":"id,version,product,component,priority,severity,status,summary"<br />
}<br />
</bugzilla></div>Gouessejhttps://jogamp.org/wiki/index.php?title=Maven&diff=2157Maven2023-06-03T11:25:26Z<p>Gouessej: </p>
<hr />
<div>__TOC__<br />
<br />
JogAmp now contains support for Maven. From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages are pushed to <br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they are pushed only to [https://jogamp.org/deployment/maven/ the Jogamp Test Repository].<br />
<br />
= Add dependencies on the correct packages =<br />
<br />
If you don't know which packages you want, you almost certainly want to use the<br />
<tt>jogl-all-main</tt> and <tt>gluegen-rt-main</tt> packages, as these automatically<br />
set up the correct dependencies on the native jar files for all platforms.<br />
<br />
N.B: Please note that the version 2.3.2 was released in 2015, is obsolete, is the last version available in Maven Central and is only mentioned as an example but the later versions are only available in the JogAmp test repository (not in Maven Central).<br />
<br />
As an example, if your project uses JOGL <tt>2.3.2</tt>:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.gluegen</groupId><br />
<artifactId>gluegen-rt-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
Maven will pull all of the dependencies the next time you attempt to build the project.<br />
<br />
Additionally, for <tt>joal</tt> and <tt>jocl</tt> support:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.jocl</groupId><br />
<artifactId>jocl-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.joal</groupId><br />
<artifactId>joal-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
An example project is available in the <tt>maven</tt> subdirectory of the <tt>jogl-demos</tt> project<br />
[https://jogamp.org/git/?p=jogl-demos.git;a=tree;f=maven].<br />
<br />
= Package details =<br />
<br />
For each JogAmp project, there are essentially two packages published: One contains the main compiled<br />
jar files and any associated native library jar files, and the other simply contains <i>dependencies</i><br />
on those files. Using <tt>jogl-all</tt> and <tt>jogl-all-main</tt> as the example, the <tt>jogl-all</tt><br />
package in the jogamp.org test repository:<br />
<br />
https://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all/2.3.2/<br />
<br />
Note that there are many native jar files attached to the main package. However, if you were to use<br />
the following dependency in your own project:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</pre><br />
<br />
Maven would download <tt>jogl-all-2.3.2.jar</tt> but would completely ignore all of the other<br />
native jar files. Why? The reason for this is that the native jar files are uploaded as extra artifacts<br />
to the <tt>jogl-all</tt> package and are, in a manner of speaking, not really considered to be part of<br />
the package where dependencies are concerned. The POM for the <tt>jogl-all-main</tt> package adds<br />
explicit dependencies on all of the extra artifacts in the <tt>jogl-all</tt> package:<br />
<br />
https://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all-main/2.3.2/jogl-all-main-2.3.2.pom<br />
<br />
So, when you add a dependency on <tt>jogl-all-main</tt> in your own project, the native jar files of<br />
<tt>jogl-all</tt> are brought in as transitive dependencies and everything works as expected.<br />
<br />
= Available packages =<br />
<br />
{|<br />
|Group ID<br />
|Artifact ID<br />
|Since<br />
|Description<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-android<br />
|2.0.2-rc12<br />
|GlueGen runtime code and native libraries (Android)<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for the GlueGen runtime<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt<br />
|2.0-rc11<br />
|GlueGen runtime code and native libraries<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen<br />
|2.0-rc11<br />
|GlueGen non-runtime code and native libraries (and atomic jars)<br />
|-<br />
|org.jogamp.joal<br />
|joal-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOAL<br />
|-<br />
|org.jogamp.joal<br />
|joal<br />
|2.0-rc11<br />
|JOAL code and native libraries<br />
|-<br />
|org.jogamp.joal<br />
|joal-android<br />
|2.2.0<br />
|JOAL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOCL<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-android<br />
|2.2.0<br />
|JOCL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl<br />
|2.0-rc11<br />
|JOCL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all<br />
|2.0-rc11<br />
|JOGL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android<br />
|2.0.2-rc12<br />
|JOGL code and native libraries (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android-main<br />
|2.2.0<br />
|Meta-package for automatic dependency resolution for JOGL (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (mobile)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile<br />
|2.0-rc11<br />
|JOGL mobile code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt<br />
|2.0-rc11<br />
|JOGL code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl<br />
|2.0.2<br />
|JOGL atomic jar files<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow<br />
|2.0.2<br />
|Native window drivers for NEWT (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow-main<br />
|2.2.0<br />
|Native window drivers for NEWT (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|newt<br />
|2.0.2<br />
|NEWT code and native libraries (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|newt-main<br />
|2.2.0<br />
|NEWT code and native libraries (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|occulusvr<br />
|2.2.0<br />
|JOGL code and native libraries (Oculus VR atomic jar files)<br />
|-<br />
|}<br />
<br />
= Atomic jar files (optional) =<br />
<br />
The so-called <i>atomic</i> jar files are provided as attachments to the <tt>jogl</tt>, <tt>newt</tt>,<br />
<tt>nativewindow</tt> and <tt>gluegen</tt> packages. As an example, to depend only on the Linux AMD64<br />
native jar files, on X11, using only the core of <tt>jogl</tt> and the native window toolkit in your<br />
own projects, use the following dependencies:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.2</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.2</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.2</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.2</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.2</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.2</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
</pre><br />
<br />
Note that the choice of which atomic jars are required is really outside of the scope of this<br />
documentation. It's recommended that you browse the packages in question to see which jar<br />
files are available. It's <i>not</i> recommended to depend on platform-specific jar files<br />
in the manner shown above unless there's an extremely good reason to do so; to do otherwise<br />
harms portability for no good reason!<br />
<br />
= The jogamp.org test repository =<br />
<br />
Bleeding edge, experimental packages will continue to be made available from the<br />
[https://jogamp.org/deployment/maven Jogamp Test Repository]. Most users won't need this, but<br />
it can be used by adding a new profile in your <tt>~/.m2/settings.xml</tt> file that specifies<br />
the repository:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<settings<br />
xmlns="http://maven.apache.org/SETTINGS/1.0.0" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <br />
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><br />
<profiles><br />
<profile><br />
<id>jogamp</id><br />
<repositories><br />
<repository><br />
<id>jogamp-remote</id><br />
<name>jogamp test mirror</name><br />
<url>https://www.jogamp.org/deployment/maven/</url><br />
<layout>default</layout><br />
</repository><br />
</repositories><br />
</profile><br />
</profiles><br />
<activeProfiles><br />
<activeProfile>jogamp</activeProfile><br />
</activeProfiles><br />
</settings><br />
</pre><br />
<br />
This repository can be added into the POM file like in this [https://jogamp.org/cgit/jogl-demos.git/tree/maven/trivial-test/pom.xml very simple example].<br />
<br />
Maven will then check this repository for packages in addition to Maven Central when resolving dependencies.<br />
<br />
'''''Please note that some packages on the Jogamp test repository are subject to unannounced changes at any moment and may break existing code at any time! Do not use for production code!'''''<br />
<br />
Since <tt>2.4.0</tt>, the releases and the release candidates are pushed only to this repository.<br />
<br />
= Android =<br />
<br />
There is a [[Maven_And_Android|separate page]] documenting one method of producing packages that work on both Android and ordinary<br />
desktop Java.<br />
<br />
= Producing a fat jar =<br />
<br />
See [[JogAmp_JAR_File_Handling#Maven_Assembly_Plugin|JAR File Handling]].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Maven&diff=2156Maven2023-06-03T11:20:33Z<p>Gouessej: </p>
<hr />
<div>__TOC__<br />
<br />
JogAmp now contains support for Maven. From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages are pushed to <br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they are pushed only to [https://jogamp.org/deployment/maven/ the Jogamp Test Repository].<br />
<br />
= Add dependencies on the correct packages =<br />
<br />
If you don't know which packages you want, you almost certainly want to use the<br />
<tt>jogl-all-main</tt> and <tt>gluegen-rt-main</tt> packages, as these automatically<br />
set up the correct dependencies on the native jar files for all platforms.<br />
<br />
As an example, if your project uses JOGL <tt>2.3.2</tt>:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.gluegen</groupId><br />
<artifactId>gluegen-rt-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
Maven will pull all of the dependencies the next time you attempt to build the project.<br />
<br />
Additionally, for <tt>joal</tt> and <tt>jocl</tt> support:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.jocl</groupId><br />
<artifactId>jocl-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.joal</groupId><br />
<artifactId>joal-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
An example project is available in the <tt>maven</tt> subdirectory of the <tt>jogl-demos</tt> project<br />
[https://jogamp.org/git/?p=jogl-demos.git;a=tree;f=maven].<br />
N.B: Please note that the version 2.3.2 was released in 2015 and is the latest version available in Maven Central but it is not the latest version available. Please look at the JogAmp test repository to find other versions.<br />
<br />
= Package details =<br />
<br />
For each JogAmp project, there are essentially two packages published: One contains the main compiled<br />
jar files and any associated native library jar files, and the other simply contains <i>dependencies</i><br />
on those files. Using <tt>jogl-all</tt> and <tt>jogl-all-main</tt> as the example, the <tt>jogl-all</tt><br />
package in the jogamp.org test repository:<br />
<br />
https://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all/2.3.2/<br />
<br />
Note that there are many native jar files attached to the main package. However, if you were to use<br />
the following dependency in your own project:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</pre><br />
<br />
Maven would download <tt>jogl-all-2.3.2.jar</tt> but would completely ignore all of the other<br />
native jar files. Why? The reason for this is that the native jar files are uploaded as extra artifacts<br />
to the <tt>jogl-all</tt> package and are, in a manner of speaking, not really considered to be part of<br />
the package where dependencies are concerned. The POM for the <tt>jogl-all-main</tt> package adds<br />
explicit dependencies on all of the extra artifacts in the <tt>jogl-all</tt> package:<br />
<br />
https://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all-main/2.3.2/jogl-all-main-2.3.2.pom<br />
<br />
So, when you add a dependency on <tt>jogl-all-main</tt> in your own project, the native jar files of<br />
<tt>jogl-all</tt> are brought in as transitive dependencies and everything works as expected.<br />
<br />
= Available packages =<br />
<br />
{|<br />
|Group ID<br />
|Artifact ID<br />
|Since<br />
|Description<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-android<br />
|2.0.2-rc12<br />
|GlueGen runtime code and native libraries (Android)<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for the GlueGen runtime<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt<br />
|2.0-rc11<br />
|GlueGen runtime code and native libraries<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen<br />
|2.0-rc11<br />
|GlueGen non-runtime code and native libraries (and atomic jars)<br />
|-<br />
|org.jogamp.joal<br />
|joal-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOAL<br />
|-<br />
|org.jogamp.joal<br />
|joal<br />
|2.0-rc11<br />
|JOAL code and native libraries<br />
|-<br />
|org.jogamp.joal<br />
|joal-android<br />
|2.2.0<br />
|JOAL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOCL<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-android<br />
|2.2.0<br />
|JOCL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl<br />
|2.0-rc11<br />
|JOCL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all<br />
|2.0-rc11<br />
|JOGL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android<br />
|2.0.2-rc12<br />
|JOGL code and native libraries (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android-main<br />
|2.2.0<br />
|Meta-package for automatic dependency resolution for JOGL (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (mobile)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile<br />
|2.0-rc11<br />
|JOGL mobile code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt<br />
|2.0-rc11<br />
|JOGL code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl<br />
|2.0.2<br />
|JOGL atomic jar files<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow<br />
|2.0.2<br />
|Native window drivers for NEWT (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow-main<br />
|2.2.0<br />
|Native window drivers for NEWT (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|newt<br />
|2.0.2<br />
|NEWT code and native libraries (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|newt-main<br />
|2.2.0<br />
|NEWT code and native libraries (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|occulusvr<br />
|2.2.0<br />
|JOGL code and native libraries (Oculus VR atomic jar files)<br />
|-<br />
|}<br />
<br />
= Atomic jar files (optional) =<br />
<br />
The so-called <i>atomic</i> jar files are provided as attachments to the <tt>jogl</tt>, <tt>newt</tt>,<br />
<tt>nativewindow</tt> and <tt>gluegen</tt> packages. As an example, to depend only on the Linux AMD64<br />
native jar files, on X11, using only the core of <tt>jogl</tt> and the native window toolkit in your<br />
own projects, use the following dependencies:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.2</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.2</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.2</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.2</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.2</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.2</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.2</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
</pre><br />
<br />
Note that the choice of which atomic jars are required is really outside of the scope of this<br />
documentation. It's recommended that you browse the packages in question to see which jar<br />
files are available. It's <i>not</i> recommended to depend on platform-specific jar files<br />
in the manner shown above unless there's an extremely good reason to do so; to do otherwise<br />
harms portability for no good reason!<br />
<br />
= The jogamp.org test repository =<br />
<br />
Bleeding edge, experimental packages will continue to be made available from the<br />
[https://jogamp.org/deployment/maven Jogamp Test Repository]. Most users won't need this, but<br />
it can be used by adding a new profile in your <tt>~/.m2/settings.xml</tt> file that specifies<br />
the repository:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<settings<br />
xmlns="http://maven.apache.org/SETTINGS/1.0.0" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <br />
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><br />
<profiles><br />
<profile><br />
<id>jogamp</id><br />
<repositories><br />
<repository><br />
<id>jogamp-remote</id><br />
<name>jogamp test mirror</name><br />
<url>https://www.jogamp.org/deployment/maven/</url><br />
<layout>default</layout><br />
</repository><br />
</repositories><br />
</profile><br />
</profiles><br />
<activeProfiles><br />
<activeProfile>jogamp</activeProfile><br />
</activeProfiles><br />
</settings><br />
</pre><br />
<br />
This repository can be added into the POM file like in this [https://jogamp.org/cgit/jogl-demos.git/tree/maven/trivial-test/pom.xml very simple example].<br />
<br />
Maven will then check this repository for packages in addition to Maven Central when resolving dependencies.<br />
<br />
'''''Please note that some packages on the Jogamp test repository are subject to unannounced changes at any moment and may break existing code at any time! Do not use for production code!'''''<br />
<br />
Since <tt>2.4.0</tt>, the releases and the release candidates are pushed only to this repository.<br />
<br />
= Android =<br />
<br />
There is a [[Maven_And_Android|separate page]] documenting one method of producing packages that work on both Android and ordinary<br />
desktop Java.<br />
<br />
= Producing a fat jar =<br />
<br />
See [[JogAmp_JAR_File_Handling#Maven_Assembly_Plugin|JAR File Handling]].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Maven&diff=2155Maven2023-06-03T11:16:51Z<p>Gouessej: /* Add dependencies on the correct packages */</p>
<hr />
<div>__TOC__<br />
<br />
JogAmp now contains support for Maven. From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages are pushed to <br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they are pushed only to [https://jogamp.org/deployment/maven/ the Jogamp Test Repository].<br />
<br />
= Add dependencies on the correct packages =<br />
<br />
If you don't know which packages you want, you almost certainly want to use the<br />
<tt>jogl-all-main</tt> and <tt>gluegen-rt-main</tt> packages, as these automatically<br />
set up the correct dependencies on the native jar files for all platforms.<br />
<br />
As an example, if your project uses JOGL <tt>2.3.2</tt>:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.gluegen</groupId><br />
<artifactId>gluegen-rt-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
Maven will pull all of the dependencies the next time you attempt to build the project.<br />
<br />
Additionally, for <tt>joal</tt> and <tt>jocl</tt> support:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.jocl</groupId><br />
<artifactId>jocl-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.joal</groupId><br />
<artifactId>joal-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
An example project is available in the <tt>maven</tt> subdirectory of the <tt>jogl-demos</tt> project<br />
[https://jogamp.org/git/?p=jogl-demos.git;a=tree;f=maven].<br />
N.B: Please note that the version 2.3.2 was released in 2015 and is the latest version available in Maven Central but it is not the latest version available. Please look at the JogAmp test repository to find other versions.<br />
<br />
= Package details =<br />
<br />
For each JogAmp project, there are essentially two packages published: One contains the main compiled<br />
jar files and any associated native library jar files, and the other simply contains <i>dependencies</i><br />
on those files. Using <tt>jogl-all</tt> and <tt>jogl-all-main</tt> as the example, the <tt>jogl-all</tt><br />
package in the jogamp.org test repository:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all/2.3.1/<br />
<br />
Note that there are many native jar files attached to the main package. However, if you were to use<br />
the following dependency in your own project:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</pre><br />
<br />
Maven would download <tt>jogl-all-2.3.1.jar</tt> but would completely ignore all of the other<br />
native jar files. Why? The reason for this is that the native jar files are uploaded as extra artifacts<br />
to the <tt>jogl-all</tt> package and are, in a manner of speaking, not really considered to be part of<br />
the package where dependencies are concerned. The POM for the <tt>jogl-all-main</tt> package adds<br />
explicit dependencies on all of the extra artifacts in the <tt>jogl-all</tt> package:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all-main/2.3.1/jogl-all-main-2.3.1.pom<br />
<br />
So, when you add a dependency on <tt>jogl-all-main</tt> in your own project, the native jar files of<br />
<tt>jogl-all</tt> are brought in as transitive dependencies and everything works as expected.<br />
<br />
= Available packages =<br />
<br />
{|<br />
|Group ID<br />
|Artifact ID<br />
|Since<br />
|Description<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-android<br />
|2.0.2-rc12<br />
|GlueGen runtime code and native libraries (Android)<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for the GlueGen runtime<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt<br />
|2.0-rc11<br />
|GlueGen runtime code and native libraries<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen<br />
|2.0-rc11<br />
|GlueGen non-runtime code and native libraries (and atomic jars)<br />
|-<br />
|org.jogamp.joal<br />
|joal-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOAL<br />
|-<br />
|org.jogamp.joal<br />
|joal<br />
|2.0-rc11<br />
|JOAL code and native libraries<br />
|-<br />
|org.jogamp.joal<br />
|joal-android<br />
|2.2.0<br />
|JOAL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOCL<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-android<br />
|2.2.0<br />
|JOCL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl<br />
|2.0-rc11<br />
|JOCL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all<br />
|2.0-rc11<br />
|JOGL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android<br />
|2.0.2-rc12<br />
|JOGL code and native libraries (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android-main<br />
|2.2.0<br />
|Meta-package for automatic dependency resolution for JOGL (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (mobile)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile<br />
|2.0-rc11<br />
|JOGL mobile code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt<br />
|2.0-rc11<br />
|JOGL code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl<br />
|2.0.2<br />
|JOGL atomic jar files<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow<br />
|2.0.2<br />
|Native window drivers for NEWT (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow-main<br />
|2.2.0<br />
|Native window drivers for NEWT (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|newt<br />
|2.0.2<br />
|NEWT code and native libraries (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|newt-main<br />
|2.2.0<br />
|NEWT code and native libraries (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|occulusvr<br />
|2.2.0<br />
|JOGL code and native libraries (Oculus VR atomic jar files)<br />
|-<br />
|}<br />
<br />
= Atomic jar files (optional) =<br />
<br />
The so-called <i>atomic</i> jar files are provided as attachments to the <tt>jogl</tt>, <tt>newt</tt>,<br />
<tt>nativewindow</tt> and <tt>gluegen</tt> packages. As an example, to depend only on the Linux AMD64<br />
native jar files, on X11, using only the core of <tt>jogl</tt> and the native window toolkit in your<br />
own projects, use the following dependencies:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
</pre><br />
<br />
Note that the choice of which atomic jars are required is really outside of the scope of this<br />
documentation. It's recommended that you browse the packages in question to see which jar<br />
files are available. It's <i>not</i> recommended to depend on platform-specific jar files<br />
in the manner shown above unless there's an extremely good reason to do so; to do otherwise<br />
harms portability for no good reason!<br />
<br />
= The jogamp.org test repository =<br />
<br />
Bleeding edge, experimental packages will continue to be made available from the<br />
[https://jogamp.org/deployment/maven Jogamp Test Repository]. Most users won't need this, but<br />
it can be used by adding a new profile in your <tt>~/.m2/settings.xml</tt> file that specifies<br />
the repository:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<settings<br />
xmlns="http://maven.apache.org/SETTINGS/1.0.0" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <br />
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><br />
<profiles><br />
<profile><br />
<id>jogamp</id><br />
<repositories><br />
<repository><br />
<id>jogamp-remote</id><br />
<name>jogamp test mirror</name><br />
<url>https://www.jogamp.org/deployment/maven/</url><br />
<layout>default</layout><br />
</repository><br />
</repositories><br />
</profile><br />
</profiles><br />
<activeProfiles><br />
<activeProfile>jogamp</activeProfile><br />
</activeProfiles><br />
</settings><br />
</pre><br />
<br />
This repository can be added into the POM file like in this [https://jogamp.org/cgit/jogl-demos.git/tree/maven/trivial-test/pom.xml very simple example].<br />
<br />
Maven will then check this repository for packages in addition to Maven Central when resolving dependencies.<br />
<br />
'''''Please note that some packages on the Jogamp test repository are subject to unannounced changes at any moment and may break existing code at any time! Do not use for production code!'''''<br />
<br />
Since <tt>2.4.0</tt>, the releases and the release candidates are pushed only to this repository.<br />
<br />
= Android =<br />
<br />
There is a [[Maven_And_Android|separate page]] documenting one method of producing packages that work on both Android and ordinary<br />
desktop Java.<br />
<br />
= Producing a fat jar =<br />
<br />
See [[JogAmp_JAR_File_Handling#Maven_Assembly_Plugin|JAR File Handling]].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Maven&diff=2154Maven2023-06-03T11:16:02Z<p>Gouessej: /* Add dependencies on the correct packages */</p>
<hr />
<div>__TOC__<br />
<br />
JogAmp now contains support for Maven. From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages are pushed to <br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they are pushed only to [https://jogamp.org/deployment/maven/ the Jogamp Test Repository].<br />
<br />
= Add dependencies on the correct packages =<br />
<br />
If you don't know which packages you want, you almost certainly want to use the<br />
<tt>jogl-all-main</tt> and <tt>gluegen-rt-main</tt> packages, as these automatically<br />
set up the correct dependencies on the native jar files for all platforms.<br />
<br />
As an example, if your project uses JOGL <tt>2.3.2</tt>:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.gluegen</groupId><br />
<artifactId>gluegen-rt-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
Maven will pull all of the dependencies the next time you attempt to build the project.<br />
<br />
Additionally, for <tt>joal</tt> and <tt>jocl</tt> support:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.jocl</groupId><br />
<artifactId>jocl-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.joal</groupId><br />
<artifactId>joal-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
An example project is available in the <tt>maven</tt> subdirectory of the <tt>jogl-demos</tt> project<br />
[http://jogamp.org/git/?p=jogl-demos.git;a=tree;f=maven].<br />
N.B: Please note that the version 2.3.2 was released in 2015 and is the latest version available in Maven Central but it is not the latest version available. Please look at the JogAmp test repository to find other versions.<br />
<br />
= Package details =<br />
<br />
For each JogAmp project, there are essentially two packages published: One contains the main compiled<br />
jar files and any associated native library jar files, and the other simply contains <i>dependencies</i><br />
on those files. Using <tt>jogl-all</tt> and <tt>jogl-all-main</tt> as the example, the <tt>jogl-all</tt><br />
package in the jogamp.org test repository:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all/2.3.1/<br />
<br />
Note that there are many native jar files attached to the main package. However, if you were to use<br />
the following dependency in your own project:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</pre><br />
<br />
Maven would download <tt>jogl-all-2.3.1.jar</tt> but would completely ignore all of the other<br />
native jar files. Why? The reason for this is that the native jar files are uploaded as extra artifacts<br />
to the <tt>jogl-all</tt> package and are, in a manner of speaking, not really considered to be part of<br />
the package where dependencies are concerned. The POM for the <tt>jogl-all-main</tt> package adds<br />
explicit dependencies on all of the extra artifacts in the <tt>jogl-all</tt> package:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all-main/2.3.1/jogl-all-main-2.3.1.pom<br />
<br />
So, when you add a dependency on <tt>jogl-all-main</tt> in your own project, the native jar files of<br />
<tt>jogl-all</tt> are brought in as transitive dependencies and everything works as expected.<br />
<br />
= Available packages =<br />
<br />
{|<br />
|Group ID<br />
|Artifact ID<br />
|Since<br />
|Description<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-android<br />
|2.0.2-rc12<br />
|GlueGen runtime code and native libraries (Android)<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for the GlueGen runtime<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt<br />
|2.0-rc11<br />
|GlueGen runtime code and native libraries<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen<br />
|2.0-rc11<br />
|GlueGen non-runtime code and native libraries (and atomic jars)<br />
|-<br />
|org.jogamp.joal<br />
|joal-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOAL<br />
|-<br />
|org.jogamp.joal<br />
|joal<br />
|2.0-rc11<br />
|JOAL code and native libraries<br />
|-<br />
|org.jogamp.joal<br />
|joal-android<br />
|2.2.0<br />
|JOAL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOCL<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-android<br />
|2.2.0<br />
|JOCL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl<br />
|2.0-rc11<br />
|JOCL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all<br />
|2.0-rc11<br />
|JOGL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android<br />
|2.0.2-rc12<br />
|JOGL code and native libraries (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android-main<br />
|2.2.0<br />
|Meta-package for automatic dependency resolution for JOGL (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (mobile)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile<br />
|2.0-rc11<br />
|JOGL mobile code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt<br />
|2.0-rc11<br />
|JOGL code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl<br />
|2.0.2<br />
|JOGL atomic jar files<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow<br />
|2.0.2<br />
|Native window drivers for NEWT (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow-main<br />
|2.2.0<br />
|Native window drivers for NEWT (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|newt<br />
|2.0.2<br />
|NEWT code and native libraries (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|newt-main<br />
|2.2.0<br />
|NEWT code and native libraries (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|occulusvr<br />
|2.2.0<br />
|JOGL code and native libraries (Oculus VR atomic jar files)<br />
|-<br />
|}<br />
<br />
= Atomic jar files (optional) =<br />
<br />
The so-called <i>atomic</i> jar files are provided as attachments to the <tt>jogl</tt>, <tt>newt</tt>,<br />
<tt>nativewindow</tt> and <tt>gluegen</tt> packages. As an example, to depend only on the Linux AMD64<br />
native jar files, on X11, using only the core of <tt>jogl</tt> and the native window toolkit in your<br />
own projects, use the following dependencies:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
</pre><br />
<br />
Note that the choice of which atomic jars are required is really outside of the scope of this<br />
documentation. It's recommended that you browse the packages in question to see which jar<br />
files are available. It's <i>not</i> recommended to depend on platform-specific jar files<br />
in the manner shown above unless there's an extremely good reason to do so; to do otherwise<br />
harms portability for no good reason!<br />
<br />
= The jogamp.org test repository =<br />
<br />
Bleeding edge, experimental packages will continue to be made available from the<br />
[https://jogamp.org/deployment/maven Jogamp Test Repository]. Most users won't need this, but<br />
it can be used by adding a new profile in your <tt>~/.m2/settings.xml</tt> file that specifies<br />
the repository:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<settings<br />
xmlns="http://maven.apache.org/SETTINGS/1.0.0" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <br />
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><br />
<profiles><br />
<profile><br />
<id>jogamp</id><br />
<repositories><br />
<repository><br />
<id>jogamp-remote</id><br />
<name>jogamp test mirror</name><br />
<url>https://www.jogamp.org/deployment/maven/</url><br />
<layout>default</layout><br />
</repository><br />
</repositories><br />
</profile><br />
</profiles><br />
<activeProfiles><br />
<activeProfile>jogamp</activeProfile><br />
</activeProfiles><br />
</settings><br />
</pre><br />
<br />
This repository can be added into the POM file like in this [https://jogamp.org/cgit/jogl-demos.git/tree/maven/trivial-test/pom.xml very simple example].<br />
<br />
Maven will then check this repository for packages in addition to Maven Central when resolving dependencies.<br />
<br />
'''''Please note that some packages on the Jogamp test repository are subject to unannounced changes at any moment and may break existing code at any time! Do not use for production code!'''''<br />
<br />
Since <tt>2.4.0</tt>, the releases and the release candidates are pushed only to this repository.<br />
<br />
= Android =<br />
<br />
There is a [[Maven_And_Android|separate page]] documenting one method of producing packages that work on both Android and ordinary<br />
desktop Java.<br />
<br />
= Producing a fat jar =<br />
<br />
See [[JogAmp_JAR_File_Handling#Maven_Assembly_Plugin|JAR File Handling]].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Maven&diff=2153Maven2023-06-03T11:14:49Z<p>Gouessej: /* Add dependencies on the correct packages */</p>
<hr />
<div>__TOC__<br />
<br />
JogAmp now contains support for Maven. From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages are pushed to <br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they are pushed only to [https://jogamp.org/deployment/maven/ the Jogamp Test Repository].<br />
<br />
= Add dependencies on the correct packages =<br />
<br />
If you don't know which packages you want, you almost certainly want to use the<br />
<tt>jogl-all-main</tt> and <tt>gluegen-rt-main</tt> packages, as these automatically<br />
set up the correct dependencies on the native jar files for all platforms.<br />
<br />
As an example, if your project uses JOGL <tt>2.3.2</tt>:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.gluegen</groupId><br />
<artifactId>gluegen-rt-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all-main</artifactId><br />
<version>2.3.2</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
Maven will pull all of the dependencies the next time you attempt to build the project.<br />
N.B: Please note that the version 2.3.2 was released in 2015 and is the latest version available in Maven Central but it is not the latest version available. Please look at the JogAmp test repository to find other versions.<br />
<br />
Additionally, for <tt>joal</tt> and <tt>jocl</tt> support:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.jocl</groupId><br />
<artifactId>jocl-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.joal</groupId><br />
<artifactId>joal-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
An example project is available in the <tt>maven</tt> subdirectory of the <tt>jogl-demos</tt> project<br />
[http://jogamp.org/git/?p=jogl-demos.git;a=tree;f=maven].<br />
<br />
= Package details =<br />
<br />
For each JogAmp project, there are essentially two packages published: One contains the main compiled<br />
jar files and any associated native library jar files, and the other simply contains <i>dependencies</i><br />
on those files. Using <tt>jogl-all</tt> and <tt>jogl-all-main</tt> as the example, the <tt>jogl-all</tt><br />
package in the jogamp.org test repository:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all/2.3.1/<br />
<br />
Note that there are many native jar files attached to the main package. However, if you were to use<br />
the following dependency in your own project:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</pre><br />
<br />
Maven would download <tt>jogl-all-2.3.1.jar</tt> but would completely ignore all of the other<br />
native jar files. Why? The reason for this is that the native jar files are uploaded as extra artifacts<br />
to the <tt>jogl-all</tt> package and are, in a manner of speaking, not really considered to be part of<br />
the package where dependencies are concerned. The POM for the <tt>jogl-all-main</tt> package adds<br />
explicit dependencies on all of the extra artifacts in the <tt>jogl-all</tt> package:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all-main/2.3.1/jogl-all-main-2.3.1.pom<br />
<br />
So, when you add a dependency on <tt>jogl-all-main</tt> in your own project, the native jar files of<br />
<tt>jogl-all</tt> are brought in as transitive dependencies and everything works as expected.<br />
<br />
= Available packages =<br />
<br />
{|<br />
|Group ID<br />
|Artifact ID<br />
|Since<br />
|Description<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-android<br />
|2.0.2-rc12<br />
|GlueGen runtime code and native libraries (Android)<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for the GlueGen runtime<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt<br />
|2.0-rc11<br />
|GlueGen runtime code and native libraries<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen<br />
|2.0-rc11<br />
|GlueGen non-runtime code and native libraries (and atomic jars)<br />
|-<br />
|org.jogamp.joal<br />
|joal-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOAL<br />
|-<br />
|org.jogamp.joal<br />
|joal<br />
|2.0-rc11<br />
|JOAL code and native libraries<br />
|-<br />
|org.jogamp.joal<br />
|joal-android<br />
|2.2.0<br />
|JOAL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOCL<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-android<br />
|2.2.0<br />
|JOCL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl<br />
|2.0-rc11<br />
|JOCL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all<br />
|2.0-rc11<br />
|JOGL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android<br />
|2.0.2-rc12<br />
|JOGL code and native libraries (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android-main<br />
|2.2.0<br />
|Meta-package for automatic dependency resolution for JOGL (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (mobile)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile<br />
|2.0-rc11<br />
|JOGL mobile code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt<br />
|2.0-rc11<br />
|JOGL code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl<br />
|2.0.2<br />
|JOGL atomic jar files<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow<br />
|2.0.2<br />
|Native window drivers for NEWT (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow-main<br />
|2.2.0<br />
|Native window drivers for NEWT (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|newt<br />
|2.0.2<br />
|NEWT code and native libraries (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|newt-main<br />
|2.2.0<br />
|NEWT code and native libraries (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|occulusvr<br />
|2.2.0<br />
|JOGL code and native libraries (Oculus VR atomic jar files)<br />
|-<br />
|}<br />
<br />
= Atomic jar files (optional) =<br />
<br />
The so-called <i>atomic</i> jar files are provided as attachments to the <tt>jogl</tt>, <tt>newt</tt>,<br />
<tt>nativewindow</tt> and <tt>gluegen</tt> packages. As an example, to depend only on the Linux AMD64<br />
native jar files, on X11, using only the core of <tt>jogl</tt> and the native window toolkit in your<br />
own projects, use the following dependencies:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
</pre><br />
<br />
Note that the choice of which atomic jars are required is really outside of the scope of this<br />
documentation. It's recommended that you browse the packages in question to see which jar<br />
files are available. It's <i>not</i> recommended to depend on platform-specific jar files<br />
in the manner shown above unless there's an extremely good reason to do so; to do otherwise<br />
harms portability for no good reason!<br />
<br />
= The jogamp.org test repository =<br />
<br />
Bleeding edge, experimental packages will continue to be made available from the<br />
[https://jogamp.org/deployment/maven Jogamp Test Repository]. Most users won't need this, but<br />
it can be used by adding a new profile in your <tt>~/.m2/settings.xml</tt> file that specifies<br />
the repository:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<settings<br />
xmlns="http://maven.apache.org/SETTINGS/1.0.0" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <br />
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><br />
<profiles><br />
<profile><br />
<id>jogamp</id><br />
<repositories><br />
<repository><br />
<id>jogamp-remote</id><br />
<name>jogamp test mirror</name><br />
<url>https://www.jogamp.org/deployment/maven/</url><br />
<layout>default</layout><br />
</repository><br />
</repositories><br />
</profile><br />
</profiles><br />
<activeProfiles><br />
<activeProfile>jogamp</activeProfile><br />
</activeProfiles><br />
</settings><br />
</pre><br />
<br />
This repository can be added into the POM file like in this [https://jogamp.org/cgit/jogl-demos.git/tree/maven/trivial-test/pom.xml very simple example].<br />
<br />
Maven will then check this repository for packages in addition to Maven Central when resolving dependencies.<br />
<br />
'''''Please note that some packages on the Jogamp test repository are subject to unannounced changes at any moment and may break existing code at any time! Do not use for production code!'''''<br />
<br />
Since <tt>2.4.0</tt>, the releases and the release candidates are pushed only to this repository.<br />
<br />
= Android =<br />
<br />
There is a [[Maven_And_Android|separate page]] documenting one method of producing packages that work on both Android and ordinary<br />
desktop Java.<br />
<br />
= Producing a fat jar =<br />
<br />
See [[JogAmp_JAR_File_Handling#Maven_Assembly_Plugin|JAR File Handling]].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Setting_up_a_JogAmp_project_in_your_favorite_IDE&diff=2152Setting up a JogAmp project in your favorite IDE2023-05-21T10:14:04Z<p>Gouessej: Gradle</p>
<hr />
<div>__TOC__<br />
<br />
These instructions assume that you've created a project in your favorite IDE, and now you want your project to be able to use a JogAmp library like JOGL, JOCL, JOAL, or GlueGen. We use JOGL as an example below, but these instructions work equally well for any other JogAmp library.<br />
<br />
= Download a JogAmp library =<br />
<br />
If you haven't done so already, download and extract the JogAmp library you want to use. For example, to download and extract JOGL, see the instructions at [[Downloading and installing JOGL]].<br />
<br />
To use a JogAmp library you'll do three things:<br />
<br />
* Add its JAR files to the Java classpath<br />
* Add its native libraries in one of two ways:<br />
** Either place its native JAR files in the same directory as the library JAR files<br />
** Or add its native library files(the <tt>.dll</tt>,<tt>.so</tt>, and <tt>.jnilib</tt> files) to the Java library path<br />
* Optional: Associate the *-java-src.zip files with the corresponding JAR files.<br />
<br />
Each IDE has a slightly different way to do these things, as we show below. Using the native JAR files is usually slightly easier than using the native library files directly, and native JARs make it possible for all platforms' libraries to coexist in one project, so this is the recommended method.<br />
<br />
Please note that all JogAmp libraries depend on the GlueGen runtime libraries. These are included in every JogAmp library for convenience, but are only required once in the classpath and library path of your project.<br />
<br />
See [[JogAmp JAR File Handling|JogAmp JAR File Handling]], for details on native JAR files and custom JAR bundling.<br />
<br />
= Eclipse IDE project =<br />
<br />
Probably the simplest way to use JOGL in an Eclipse project is to create another Eclipse project to contain the JOGL JARs, then make your project depend on this new JOGL project. In the example below, I include only the 64-bit Windows native JARs, but you can put native JARs for as many platforms as you wish together into the JOGL Eclipse project.<br />
<br />
=== Create a JOGL project ===<br />
<br />
* Put all the JOGL code JARs, native JARs for all platforms you wish to support, and source ZIP files in a directory called "JOGL" in your workspace directory.<br />
* Click "File > New > Java Project". Type "JOGL" as the project name and click "Next".<br />
[[File:Eclipse_project_setup_01_create_project.png|300px|thumb|none|Create JOGL project]]<br />
* Remove the native JARs from the project, leaving only gluegen-rt.jar and jogl-all.jar.<br />
[[File:Eclipse_project_setup_02_remove_native_JARs.png|300px|thumb|none|Remove native JARs]]<br />
NOTE: The gluegen-rt-natives-*-*.jar and jogl-all-natives-*-*.jar are not<br />
required in the classpath by JOGL, but are required by Eclipse to export<br />
your project as a runnable JAR file.<br />
* Expand the jogl-all and gluegen-rt JARs. For each of them, double-click "Source attachment", click "Workspace...", navigate to the corresponding <tt>*-java-src.zip</tt> file in the project, select it, click "OK", and click "OK" again to dismiss the "Source Attachment Configuration" dialog. The JARs should look like this when you're done:<br />
[[File:Eclipse_project_setup_03_JARs_with_source_attached.png|300px|thumb|none|Attach source to JARs]]<br />
* Click the "Order and Export" tab. Check both JOGL JARs, then click "Finish".<br />
[[File:Eclipse_project_setup_04_order_and_export.png|300px|thumb|none|Exporting JOGL JARs]]<br />
<br />
=== Add dependency on the JOGL project ===<br />
<br />
* Right-click your project and click "Properties".<br />
* Select the "Java Build Path" on the left, then click the "Projects" tab on the right.<br />
* Click the "Add..." button, check "JOGL", and click "OK".<br />
* Your dependent project should look like this. Click "OK" to dismiss the "Properties" dialog.<br />
[[File:Eclipse_project_setup_05_project_dependency.png|300px|thumb|none|JOGL project dependency]]<br />
<br />
That's it! Your project can now use the library.<br />
<br />
= Eclipse IDE user library =<br />
<br />
If you don't want to put JOGL in a separate Eclipse project, you can put it in a user library instead. The drawback to this is that the user library is defined in your .metadata directory and contains absolute paths, so it's hard to share with others. But for a non-shared project this works fine.<br />
<br />
=== Create a user library ===<br />
<br />
* Click "Window > Preferences", then select "Java > Build Path > User Libraries" on the left.<br />
* Click the "New..." button, type "JOGL" for the library name, and click "OK".<br />
[[File:Eclipse_setup_01_create_user_library.png|300px|thumb|none|Create user library]]<br />
* Click the "Add JARs..." button, navigate to the directory where you've stored the JARs, select all the non-native JARs, then click "Open".<br />
* If you're using native JAR files:<br />
** Make sure the <tt>gluegen-rt-natives-*-*.jar</tt> and <tt>jogl-all-natives-*-*.jar</tt> files for each platform you want to run on are in the same directory as the other JAR files. The native JAR files don't need to be added to the classpath.<br />
* Expand each non-native JAR in the list<br />
** Double-click "Source attachment", type the module's source zip name, (e.g. <tt>jogl-java-src.zip</tt> for the JAR file <tt>jogl-all.jar</tt>), and click "OK".<br />
** If you're using native library files:<br />
*** Double-click "Native library location", type the directory where native library files are stored, and click "OK".<br />
[[File:Eclipse_setup_02_set_native_library_locations.png|300px|thumb|none|Set native library locations]]<br />
* Click "OK" to exit Preferences dialog.<br />
<br />
=== Add the user library to your project's dependencies ===<br />
<br />
* Right-click your project in the Package Explorer and click "Properties".<br />
* Select "Java Build Path" and click the "Libraries" tab.<br />
[[File:Eclipse_setup_03_add_library_to_project.png|300px|thumb|none|Add library to project]]<br />
* Click "Add Library...", select "User Library", click "Next", check "JOGL", and click "Finish".<br />
[[File:Eclipse_setup_04_add_JOGL_library_to_project.png|300px|thumb|none|Add JOGL library to project]]<br />
* Click "OK" to dismiss the Properties dialog.<br />
<br />
That's it! You can now use the library in your project.<br />
<br />
= IntelliJ IDEA =<br />
=== Add a library dependency to your project ===<br />
<br />
* Click "File > Project Structure".<br />
* Select "Modules" on the left, then click the "Dependencies" tab on the right.<br />
* Click the "+" button on the right, then select "Library... > Java".<br />
[[File:IntelliJ_setup_01_add_library.png|300px|thumb|none|Add library]]<br />
* Navigate to the directory where you extracted the JARs, select it, and click "OK".<br />
[[File:IntelliJ_setup_02_find_library.png|300px|thumb|none|Find library]]<br />
* Click "OK" to dismiss the Configure Library dialog.<br />
[[File:IntelliJ_setup_03_configure_library.png|300px|thumb|none|Configure library]]<br />
* Click "OK" to dismiss the Project Structure dialog. The external libraries in your project should now look like this if you're using native JAR files:<br />
[[File:IntelliJ_setup_04_external_library_native_JARs.png|300px|thumb|none|Native JARs]]<br />
or like this if you're using native library files:<br />
[[File:IntelliJ_setup_04_external_library.png|300px|thumb|none|Native library files]]<br />
<br />
* If you're using native JAR files:<br />
** Make sure the <tt>gluegen-rt-natives-*-*.jar</tt> and <tt>jogl-all-natives-*-*.jar</tt> files for each platform you want to run on are in the same directory as the other JAR files.<br />
* Otherwise, if you're using native library files:<br />
** Click "Run > Edit Configurations".<br />
** Type <tt>-Djava.library.path=your/path/to/native/library/files</tt> in the "VM Parameters" box. Note that paths with spaces must be double-quoted on Windows.<br />
[[File:IntelliJ_setup_05_run_configuration.png|300px|thumb|none|Edit run configuration]]<br />
** Click "OK" to dismiss the Run/Debug Configurations dialog.<br />
<br />
That's it! You can now use the library in your project.<br />
<br />
= NetBeans IDE = <br />
=== Create a library and add it to your project ===<br />
<br />
* Right-click your project and click "Properties".<br />
* Select "Libraries" on the left and click "Add Library...".<br />
* Click the "Create" button, then type "JOGL" for the library name and click "OK".[[File:NetBeans_setup_01_create_library.png|300px|thumb|none|Create library]]<br />
* Click "Add JAR/Folder...", then navigate to the directory you extracted the JAR files, select them and click "Add JAR/Folder".<br />
* Click "OK" to dismiss the Customize Library dialog.<br />
* Click "Add Library" to dismiss the Add Library dialog.[[File:NetBeans_setup_02_add_library.png|300px|thumb|none|Add library]]<br />
* Click "OK" to dismiss the Project Properties dialog. The libraries in your project should look like this.[[File:NetBeans_setup_03_libraries_in_project.png|300px|thumb|none|Libraries in project]]<br />
<br />
* If you're using native JAR files:<br />
** Make sure the <tt>gluegen-rt-natives-*-*.jar</tt> and <tt>jogl-all-natives-*-*.jar</tt> files for each platform you want to run on are in the same directory as the other JAR files. The native JAR files don't need to be added to the classpath.<br />
* Otherwise, if you're using native library files:<br />
** Click "Run > Set Project Configuration > Customize...". Select "Run" on the left if it isn't selected already.<br />
** Type <tt>-Djava.library.path=your/path/to/native/library/files</tt> in the "VM Options" box.<br />
** NOTE: If the library path has spaces in it, you must put quotes around it (at least on Windows) or you may get an odd NoClassDefFoundError when you try to run.[[File:NetBeans_setup_04_native_library_path.png|300px|thumb|none|Native library path]]<br />
** Click "OK" to dismiss the Project Properties dialog.<br />
<br />
That's it! You can now use the library in your project.<br />
<br />
= Maven =<br />
<br />
From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages for all the JogAmp projects have been pushed to<br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they have been pushed only to [https://jogamp.org/deployment/maven/ the JogAmp test repository]. Please see the<br />
[[Maven]] page for details on how to use them in your projects.<br />
<br />
= Gradle =<br />
<br />
From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages for all the JogAmp projects have been pushed to<br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they have been pushed only to [https://jogamp.org/deployment/maven/ the JogAmp test repository]. Please add the following code into build.gradle to use the version <tt>2.4.0</tt> from the Jogamp test repository:<br />
<pre><br />
repositories {<br />
maven { url "https://jogamp.org/deployment/maven" }<br />
}<br />
<br />
dependencies {<br />
implementation 'org.jogamp.gluegen:gluegen-rt-main:2.4.0'<br />
implementation 'org.jogamp.jogl:jogl-all-main:2.4.0'<br />
}<br />
</pre><br />
<br />
= vi and other text editors =<br />
=== Create your project with the editor of your choice ===<br />
* For example, to open vi, simply type <tt>vi</tt> and press <return>.<br />
* Type all your code, then save it.<br />
<br />
=== Compile and run your project from the command line ===<br />
* We assume your JOGL JAR files are in a directory called <tt>jar</tt>. If you're using native JARs, we assume they're also in the <tt>jar</tt> directory. If you're using native library files, we assume they're in a directory called <tt>lib</tt>.<br />
<br />
* First compile your program. We assume all your code is in a single file called <tt>name/someone/MyProject.java</tt>.<br />
** Windows: Type <tt>javac -classpath "jar\gluegen-rt.jar;jar\jogl-all.jar" name\someone\MyProject.java</tt><br />
** Linux/MacOS X: Type <tt>javac -classpath "jar/gluegen-rt.jar:jar/jogl-all.jar" name/someone/MyProject.java</tt><br />
<br />
* Then run your project. We assume your main class is <tt>name.someone.MyProject</tt>. If you're using native JARs:<br />
** Windows: Type <tt>java -classpath "jar\gluegen-rt.jar;jar\jogl-all.jar;." name.someone.MyProject</tt><br />
** Linux/MacOS X: Type <tt>java -classpath "jar/gluegen-rt.jar:jar/jogl-all.jar:." name.someone.MyProject</tt><br />
* If you're using native library files:<br />
** Windows: Type <tt>java -classpath "jar\gluegen-rt.jar;jar\jogl-all.jar;." -Djava.library.path=lib -Djogamp.gluegen.UseTempJarCache=false name.someone.MyProject</tt><br />
** Linux/MacOS X: Type <tt>java -classpath "jar/gluegen-rt.jar:jar/jogl-all.jar:." -Djava.library.path=lib -Djogamp.gluegen.UseTempJarCache=false name.someone.MyProject</tt><br />
<br />
That's it! You can now use the library in your project.</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Maven&diff=2151Maven2023-05-21T09:57:07Z<p>Gouessej: /* The jogamp.org test repository */</p>
<hr />
<div>__TOC__<br />
<br />
JogAmp now contains support for Maven. From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages are pushed to <br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they are pushed only to [https://jogamp.org/deployment/maven/ the Jogamp Test Repository].<br />
<br />
= Add dependencies on the correct packages =<br />
<br />
If you don't know which packages you want, you almost certainly want to use the<br />
<tt>jogl-all-main</tt> and <tt>gluegen-rt-main</tt> packages, as these automatically<br />
set up the correct dependencies on the native jar files for all platforms.<br />
<br />
As an example, if your project uses JOGL <tt>2.3.1</tt>:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.gluegen</groupId><br />
<artifactId>gluegen-rt-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
Maven will pull all of the dependencies the next time you attempt to build the project.<br />
<br />
Additionally, for <tt>joal</tt> and <tt>jocl</tt> support:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.jocl</groupId><br />
<artifactId>jocl-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.joal</groupId><br />
<artifactId>joal-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
An example project is available in the <tt>maven</tt> subdirectory of the <tt>jogl-demos</tt> project<br />
[http://jogamp.org/git/?p=jogl-demos.git;a=tree;f=maven].<br />
<br />
= Package details =<br />
<br />
For each JogAmp project, there are essentially two packages published: One contains the main compiled<br />
jar files and any associated native library jar files, and the other simply contains <i>dependencies</i><br />
on those files. Using <tt>jogl-all</tt> and <tt>jogl-all-main</tt> as the example, the <tt>jogl-all</tt><br />
package in the jogamp.org test repository:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all/2.3.1/<br />
<br />
Note that there are many native jar files attached to the main package. However, if you were to use<br />
the following dependency in your own project:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</pre><br />
<br />
Maven would download <tt>jogl-all-2.3.1.jar</tt> but would completely ignore all of the other<br />
native jar files. Why? The reason for this is that the native jar files are uploaded as extra artifacts<br />
to the <tt>jogl-all</tt> package and are, in a manner of speaking, not really considered to be part of<br />
the package where dependencies are concerned. The POM for the <tt>jogl-all-main</tt> package adds<br />
explicit dependencies on all of the extra artifacts in the <tt>jogl-all</tt> package:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all-main/2.3.1/jogl-all-main-2.3.1.pom<br />
<br />
So, when you add a dependency on <tt>jogl-all-main</tt> in your own project, the native jar files of<br />
<tt>jogl-all</tt> are brought in as transitive dependencies and everything works as expected.<br />
<br />
= Available packages =<br />
<br />
{|<br />
|Group ID<br />
|Artifact ID<br />
|Since<br />
|Description<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-android<br />
|2.0.2-rc12<br />
|GlueGen runtime code and native libraries (Android)<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for the GlueGen runtime<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt<br />
|2.0-rc11<br />
|GlueGen runtime code and native libraries<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen<br />
|2.0-rc11<br />
|GlueGen non-runtime code and native libraries (and atomic jars)<br />
|-<br />
|org.jogamp.joal<br />
|joal-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOAL<br />
|-<br />
|org.jogamp.joal<br />
|joal<br />
|2.0-rc11<br />
|JOAL code and native libraries<br />
|-<br />
|org.jogamp.joal<br />
|joal-android<br />
|2.2.0<br />
|JOAL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOCL<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-android<br />
|2.2.0<br />
|JOCL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl<br />
|2.0-rc11<br />
|JOCL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all<br />
|2.0-rc11<br />
|JOGL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android<br />
|2.0.2-rc12<br />
|JOGL code and native libraries (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android-main<br />
|2.2.0<br />
|Meta-package for automatic dependency resolution for JOGL (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (mobile)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile<br />
|2.0-rc11<br />
|JOGL mobile code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt<br />
|2.0-rc11<br />
|JOGL code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl<br />
|2.0.2<br />
|JOGL atomic jar files<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow<br />
|2.0.2<br />
|Native window drivers for NEWT (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow-main<br />
|2.2.0<br />
|Native window drivers for NEWT (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|newt<br />
|2.0.2<br />
|NEWT code and native libraries (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|newt-main<br />
|2.2.0<br />
|NEWT code and native libraries (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|occulusvr<br />
|2.2.0<br />
|JOGL code and native libraries (Oculus VR atomic jar files)<br />
|-<br />
|}<br />
<br />
= Atomic jar files (optional) =<br />
<br />
The so-called <i>atomic</i> jar files are provided as attachments to the <tt>jogl</tt>, <tt>newt</tt>,<br />
<tt>nativewindow</tt> and <tt>gluegen</tt> packages. As an example, to depend only on the Linux AMD64<br />
native jar files, on X11, using only the core of <tt>jogl</tt> and the native window toolkit in your<br />
own projects, use the following dependencies:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
</pre><br />
<br />
Note that the choice of which atomic jars are required is really outside of the scope of this<br />
documentation. It's recommended that you browse the packages in question to see which jar<br />
files are available. It's <i>not</i> recommended to depend on platform-specific jar files<br />
in the manner shown above unless there's an extremely good reason to do so; to do otherwise<br />
harms portability for no good reason!<br />
<br />
= The jogamp.org test repository =<br />
<br />
Bleeding edge, experimental packages will continue to be made available from the<br />
[https://jogamp.org/deployment/maven Jogamp Test Repository]. Most users won't need this, but<br />
it can be used by adding a new profile in your <tt>~/.m2/settings.xml</tt> file that specifies<br />
the repository:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<settings<br />
xmlns="http://maven.apache.org/SETTINGS/1.0.0" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <br />
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><br />
<profiles><br />
<profile><br />
<id>jogamp</id><br />
<repositories><br />
<repository><br />
<id>jogamp-remote</id><br />
<name>jogamp test mirror</name><br />
<url>https://www.jogamp.org/deployment/maven/</url><br />
<layout>default</layout><br />
</repository><br />
</repositories><br />
</profile><br />
</profiles><br />
<activeProfiles><br />
<activeProfile>jogamp</activeProfile><br />
</activeProfiles><br />
</settings><br />
</pre><br />
<br />
This repository can be added into the POM file like in this [https://jogamp.org/cgit/jogl-demos.git/tree/maven/trivial-test/pom.xml very simple example].<br />
<br />
Maven will then check this repository for packages in addition to Maven Central when resolving dependencies.<br />
<br />
'''''Please note that some packages on the Jogamp test repository are subject to unannounced changes at any moment and may break existing code at any time! Do not use for production code!'''''<br />
<br />
Since <tt>2.4.0</tt>, the releases and the release candidates are pushed only to this repository.<br />
<br />
= Android =<br />
<br />
There is a [[Maven_And_Android|separate page]] documenting one method of producing packages that work on both Android and ordinary<br />
desktop Java.<br />
<br />
= Producing a fat jar =<br />
<br />
See [[JogAmp_JAR_File_Handling#Maven_Assembly_Plugin|JAR File Handling]].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Maven&diff=2150Maven2023-05-21T09:56:19Z<p>Gouessej: /* The jogamp.org test repository (optional) */</p>
<hr />
<div>__TOC__<br />
<br />
JogAmp now contains support for Maven. From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages are pushed to <br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they are pushed only to [https://jogamp.org/deployment/maven/ the Jogamp Test Repository].<br />
<br />
= Add dependencies on the correct packages =<br />
<br />
If you don't know which packages you want, you almost certainly want to use the<br />
<tt>jogl-all-main</tt> and <tt>gluegen-rt-main</tt> packages, as these automatically<br />
set up the correct dependencies on the native jar files for all platforms.<br />
<br />
As an example, if your project uses JOGL <tt>2.3.1</tt>:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.gluegen</groupId><br />
<artifactId>gluegen-rt-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
Maven will pull all of the dependencies the next time you attempt to build the project.<br />
<br />
Additionally, for <tt>joal</tt> and <tt>jocl</tt> support:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.jocl</groupId><br />
<artifactId>jocl-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.joal</groupId><br />
<artifactId>joal-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
An example project is available in the <tt>maven</tt> subdirectory of the <tt>jogl-demos</tt> project<br />
[http://jogamp.org/git/?p=jogl-demos.git;a=tree;f=maven].<br />
<br />
= Package details =<br />
<br />
For each JogAmp project, there are essentially two packages published: One contains the main compiled<br />
jar files and any associated native library jar files, and the other simply contains <i>dependencies</i><br />
on those files. Using <tt>jogl-all</tt> and <tt>jogl-all-main</tt> as the example, the <tt>jogl-all</tt><br />
package in the jogamp.org test repository:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all/2.3.1/<br />
<br />
Note that there are many native jar files attached to the main package. However, if you were to use<br />
the following dependency in your own project:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</pre><br />
<br />
Maven would download <tt>jogl-all-2.3.1.jar</tt> but would completely ignore all of the other<br />
native jar files. Why? The reason for this is that the native jar files are uploaded as extra artifacts<br />
to the <tt>jogl-all</tt> package and are, in a manner of speaking, not really considered to be part of<br />
the package where dependencies are concerned. The POM for the <tt>jogl-all-main</tt> package adds<br />
explicit dependencies on all of the extra artifacts in the <tt>jogl-all</tt> package:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all-main/2.3.1/jogl-all-main-2.3.1.pom<br />
<br />
So, when you add a dependency on <tt>jogl-all-main</tt> in your own project, the native jar files of<br />
<tt>jogl-all</tt> are brought in as transitive dependencies and everything works as expected.<br />
<br />
= Available packages =<br />
<br />
{|<br />
|Group ID<br />
|Artifact ID<br />
|Since<br />
|Description<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-android<br />
|2.0.2-rc12<br />
|GlueGen runtime code and native libraries (Android)<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for the GlueGen runtime<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt<br />
|2.0-rc11<br />
|GlueGen runtime code and native libraries<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen<br />
|2.0-rc11<br />
|GlueGen non-runtime code and native libraries (and atomic jars)<br />
|-<br />
|org.jogamp.joal<br />
|joal-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOAL<br />
|-<br />
|org.jogamp.joal<br />
|joal<br />
|2.0-rc11<br />
|JOAL code and native libraries<br />
|-<br />
|org.jogamp.joal<br />
|joal-android<br />
|2.2.0<br />
|JOAL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOCL<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-android<br />
|2.2.0<br />
|JOCL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl<br />
|2.0-rc11<br />
|JOCL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all<br />
|2.0-rc11<br />
|JOGL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android<br />
|2.0.2-rc12<br />
|JOGL code and native libraries (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android-main<br />
|2.2.0<br />
|Meta-package for automatic dependency resolution for JOGL (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (mobile)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile<br />
|2.0-rc11<br />
|JOGL mobile code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt<br />
|2.0-rc11<br />
|JOGL code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl<br />
|2.0.2<br />
|JOGL atomic jar files<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow<br />
|2.0.2<br />
|Native window drivers for NEWT (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow-main<br />
|2.2.0<br />
|Native window drivers for NEWT (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|newt<br />
|2.0.2<br />
|NEWT code and native libraries (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|newt-main<br />
|2.2.0<br />
|NEWT code and native libraries (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|occulusvr<br />
|2.2.0<br />
|JOGL code and native libraries (Oculus VR atomic jar files)<br />
|-<br />
|}<br />
<br />
= Atomic jar files (optional) =<br />
<br />
The so-called <i>atomic</i> jar files are provided as attachments to the <tt>jogl</tt>, <tt>newt</tt>,<br />
<tt>nativewindow</tt> and <tt>gluegen</tt> packages. As an example, to depend only on the Linux AMD64<br />
native jar files, on X11, using only the core of <tt>jogl</tt> and the native window toolkit in your<br />
own projects, use the following dependencies:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
</pre><br />
<br />
Note that the choice of which atomic jars are required is really outside of the scope of this<br />
documentation. It's recommended that you browse the packages in question to see which jar<br />
files are available. It's <i>not</i> recommended to depend on platform-specific jar files<br />
in the manner shown above unless there's an extremely good reason to do so; to do otherwise<br />
harms portability for no good reason!<br />
<br />
= The jogamp.org test repository =<br />
<br />
Bleeding edge, experimental packages will continue to be made available from the<br />
[https://jogamp.org/deployment/maven Jogamp Test Repository]. Most users won't need this, but<br />
it can be used by adding a new profile in your <tt>~/.m2/settings.xml</tt> file that specifies<br />
the repository:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<settings<br />
xmlns="http://maven.apache.org/SETTINGS/1.0.0" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <br />
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><br />
<profiles><br />
<profile><br />
<id>jogamp</id><br />
<repositories><br />
<repository><br />
<id>jogamp-remote</id><br />
<name>jogamp test mirror</name><br />
<url>https://www.jogamp.org/deployment/maven/</url><br />
<layout>default</layout><br />
</repository><br />
</repositories><br />
</profile><br />
</profiles><br />
<activeProfiles><br />
<activeProfile>jogamp</activeProfile><br />
</activeProfiles><br />
</settings><br />
</pre><br />
<br />
This repository can be added into the POM file too like in this [https://jogamp.org/cgit/jogl-demos.git/tree/maven/trivial-test/pom.xml very simple example].<br />
<br />
Maven will then check this repository for packages in addition to Maven Central when resolving dependencies.<br />
<br />
'''''Please note that some packages on the Jogamp test repository are subject to unannounced changes at any moment and may break existing code at any time! Do not use for production code!'''''<br />
<br />
Since <tt>2.4.0</tt>, the releases and the release candidates are pushed only to this repository.<br />
<br />
= Android =<br />
<br />
There is a [[Maven_And_Android|separate page]] documenting one method of producing packages that work on both Android and ordinary<br />
desktop Java.<br />
<br />
= Producing a fat jar =<br />
<br />
See [[JogAmp_JAR_File_Handling#Maven_Assembly_Plugin|JAR File Handling]].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Maven&diff=2149Maven2023-05-21T09:45:00Z<p>Gouessej: </p>
<hr />
<div>__TOC__<br />
<br />
JogAmp now contains support for Maven. From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages are pushed to <br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they are pushed only to [https://jogamp.org/deployment/maven/ the Jogamp Test Repository].<br />
<br />
= Add dependencies on the correct packages =<br />
<br />
If you don't know which packages you want, you almost certainly want to use the<br />
<tt>jogl-all-main</tt> and <tt>gluegen-rt-main</tt> packages, as these automatically<br />
set up the correct dependencies on the native jar files for all platforms.<br />
<br />
As an example, if your project uses JOGL <tt>2.3.1</tt>:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.gluegen</groupId><br />
<artifactId>gluegen-rt-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
Maven will pull all of the dependencies the next time you attempt to build the project.<br />
<br />
Additionally, for <tt>joal</tt> and <tt>jocl</tt> support:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.jocl</groupId><br />
<artifactId>jocl-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.joal</groupId><br />
<artifactId>joal-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
An example project is available in the <tt>maven</tt> subdirectory of the <tt>jogl-demos</tt> project<br />
[http://jogamp.org/git/?p=jogl-demos.git;a=tree;f=maven].<br />
<br />
= Package details =<br />
<br />
For each JogAmp project, there are essentially two packages published: One contains the main compiled<br />
jar files and any associated native library jar files, and the other simply contains <i>dependencies</i><br />
on those files. Using <tt>jogl-all</tt> and <tt>jogl-all-main</tt> as the example, the <tt>jogl-all</tt><br />
package in the jogamp.org test repository:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all/2.3.1/<br />
<br />
Note that there are many native jar files attached to the main package. However, if you were to use<br />
the following dependency in your own project:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</pre><br />
<br />
Maven would download <tt>jogl-all-2.3.1.jar</tt> but would completely ignore all of the other<br />
native jar files. Why? The reason for this is that the native jar files are uploaded as extra artifacts<br />
to the <tt>jogl-all</tt> package and are, in a manner of speaking, not really considered to be part of<br />
the package where dependencies are concerned. The POM for the <tt>jogl-all-main</tt> package adds<br />
explicit dependencies on all of the extra artifacts in the <tt>jogl-all</tt> package:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all-main/2.3.1/jogl-all-main-2.3.1.pom<br />
<br />
So, when you add a dependency on <tt>jogl-all-main</tt> in your own project, the native jar files of<br />
<tt>jogl-all</tt> are brought in as transitive dependencies and everything works as expected.<br />
<br />
= Available packages =<br />
<br />
{|<br />
|Group ID<br />
|Artifact ID<br />
|Since<br />
|Description<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-android<br />
|2.0.2-rc12<br />
|GlueGen runtime code and native libraries (Android)<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for the GlueGen runtime<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt<br />
|2.0-rc11<br />
|GlueGen runtime code and native libraries<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen<br />
|2.0-rc11<br />
|GlueGen non-runtime code and native libraries (and atomic jars)<br />
|-<br />
|org.jogamp.joal<br />
|joal-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOAL<br />
|-<br />
|org.jogamp.joal<br />
|joal<br />
|2.0-rc11<br />
|JOAL code and native libraries<br />
|-<br />
|org.jogamp.joal<br />
|joal-android<br />
|2.2.0<br />
|JOAL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOCL<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-android<br />
|2.2.0<br />
|JOCL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl<br />
|2.0-rc11<br />
|JOCL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all<br />
|2.0-rc11<br />
|JOGL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android<br />
|2.0.2-rc12<br />
|JOGL code and native libraries (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android-main<br />
|2.2.0<br />
|Meta-package for automatic dependency resolution for JOGL (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (mobile)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile<br />
|2.0-rc11<br />
|JOGL mobile code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt<br />
|2.0-rc11<br />
|JOGL code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl<br />
|2.0.2<br />
|JOGL atomic jar files<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow<br />
|2.0.2<br />
|Native window drivers for NEWT (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow-main<br />
|2.2.0<br />
|Native window drivers for NEWT (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|newt<br />
|2.0.2<br />
|NEWT code and native libraries (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|newt-main<br />
|2.2.0<br />
|NEWT code and native libraries (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|occulusvr<br />
|2.2.0<br />
|JOGL code and native libraries (Oculus VR atomic jar files)<br />
|-<br />
|}<br />
<br />
= Atomic jar files (optional) =<br />
<br />
The so-called <i>atomic</i> jar files are provided as attachments to the <tt>jogl</tt>, <tt>newt</tt>,<br />
<tt>nativewindow</tt> and <tt>gluegen</tt> packages. As an example, to depend only on the Linux AMD64<br />
native jar files, on X11, using only the core of <tt>jogl</tt> and the native window toolkit in your<br />
own projects, use the following dependencies:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
</pre><br />
<br />
Note that the choice of which atomic jars are required is really outside of the scope of this<br />
documentation. It's recommended that you browse the packages in question to see which jar<br />
files are available. It's <i>not</i> recommended to depend on platform-specific jar files<br />
in the manner shown above unless there's an extremely good reason to do so; to do otherwise<br />
harms portability for no good reason!<br />
<br />
= The jogamp.org test repository (optional) =<br />
<br />
Bleeding edge, experimental packages will continue to be made available from the<br />
[https://jogamp.org/deployment/maven Jogamp Test Repository]. Most users won't need this, but<br />
it can be used by adding a new profile in your <tt>~/.m2/settings.xml</tt> file that specifies<br />
the repository:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<settings<br />
xmlns="http://maven.apache.org/SETTINGS/1.0.0" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <br />
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><br />
<profiles><br />
<profile><br />
<id>jogamp</id><br />
<repositories><br />
<repository><br />
<id>jogamp-remote</id><br />
<name>jogamp test mirror</name><br />
<url>https://www.jogamp.org/deployment/maven/</url><br />
<layout>default</layout><br />
</repository><br />
</repositories><br />
</profile><br />
</profiles><br />
<activeProfiles><br />
<activeProfile>jogamp</activeProfile><br />
</activeProfiles><br />
</settings><br />
</pre><br />
<br />
Maven will then check this repository for packages in addition to Maven Central when resolving dependencies.<br />
<br />
'''''Please note that packages on the jogamp test repository are subject to unannounced changes at any moment and may break existing code at any time! Do not use for production code!'''''<br />
<br />
= Android =<br />
<br />
There is a [[Maven_And_Android|separate page]] documenting one method of producing packages that work on both Android and ordinary<br />
desktop Java.<br />
<br />
= Producing a fat jar =<br />
<br />
See [[JogAmp_JAR_File_Handling#Maven_Assembly_Plugin|JAR File Handling]].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Setting_up_a_JogAmp_project_in_your_favorite_IDE&diff=2148Setting up a JogAmp project in your favorite IDE2023-05-21T09:38:52Z<p>Gouessej: /* Maven */ Adds a link to the JogAmp development repository as it's necessary since JOGL 2.4.0</p>
<hr />
<div>__TOC__<br />
<br />
These instructions assume that you've created a project in your favorite IDE, and now you want your project to be able to use a JogAmp library like JOGL, JOCL, JOAL, or GlueGen. We use JOGL as an example below, but these instructions work equally well for any other JogAmp library.<br />
<br />
= Download a JogAmp library =<br />
<br />
If you haven't done so already, download and extract the JogAmp library you want to use. For example, to download and extract JOGL, see the instructions at [[Downloading and installing JOGL]].<br />
<br />
To use a JogAmp library you'll do three things:<br />
<br />
* Add its JAR files to the Java classpath<br />
* Add its native libraries in one of two ways:<br />
** Either place its native JAR files in the same directory as the library JAR files<br />
** Or add its native library files(the <tt>.dll</tt>,<tt>.so</tt>, and <tt>.jnilib</tt> files) to the Java library path<br />
* Optional: Associate the *-java-src.zip files with the corresponding JAR files.<br />
<br />
Each IDE has a slightly different way to do these things, as we show below. Using the native JAR files is usually slightly easier than using the native library files directly, and native JARs make it possible for all platforms' libraries to coexist in one project, so this is the recommended method.<br />
<br />
Please note that all JogAmp libraries depend on the GlueGen runtime libraries. These are included in every JogAmp library for convenience, but are only required once in the classpath and library path of your project.<br />
<br />
See [[JogAmp JAR File Handling|JogAmp JAR File Handling]], for details on native JAR files and custom JAR bundling.<br />
<br />
= Eclipse IDE project =<br />
<br />
Probably the simplest way to use JOGL in an Eclipse project is to create another Eclipse project to contain the JOGL JARs, then make your project depend on this new JOGL project. In the example below, I include only the 64-bit Windows native JARs, but you can put native JARs for as many platforms as you wish together into the JOGL Eclipse project.<br />
<br />
=== Create a JOGL project ===<br />
<br />
* Put all the JOGL code JARs, native JARs for all platforms you wish to support, and source ZIP files in a directory called "JOGL" in your workspace directory.<br />
* Click "File > New > Java Project". Type "JOGL" as the project name and click "Next".<br />
[[File:Eclipse_project_setup_01_create_project.png|300px|thumb|none|Create JOGL project]]<br />
* Remove the native JARs from the project, leaving only gluegen-rt.jar and jogl-all.jar.<br />
[[File:Eclipse_project_setup_02_remove_native_JARs.png|300px|thumb|none|Remove native JARs]]<br />
NOTE: The gluegen-rt-natives-*-*.jar and jogl-all-natives-*-*.jar are not<br />
required in the classpath by JOGL, but are required by Eclipse to export<br />
your project as a runnable JAR file.<br />
* Expand the jogl-all and gluegen-rt JARs. For each of them, double-click "Source attachment", click "Workspace...", navigate to the corresponding <tt>*-java-src.zip</tt> file in the project, select it, click "OK", and click "OK" again to dismiss the "Source Attachment Configuration" dialog. The JARs should look like this when you're done:<br />
[[File:Eclipse_project_setup_03_JARs_with_source_attached.png|300px|thumb|none|Attach source to JARs]]<br />
* Click the "Order and Export" tab. Check both JOGL JARs, then click "Finish".<br />
[[File:Eclipse_project_setup_04_order_and_export.png|300px|thumb|none|Exporting JOGL JARs]]<br />
<br />
=== Add dependency on the JOGL project ===<br />
<br />
* Right-click your project and click "Properties".<br />
* Select the "Java Build Path" on the left, then click the "Projects" tab on the right.<br />
* Click the "Add..." button, check "JOGL", and click "OK".<br />
* Your dependent project should look like this. Click "OK" to dismiss the "Properties" dialog.<br />
[[File:Eclipse_project_setup_05_project_dependency.png|300px|thumb|none|JOGL project dependency]]<br />
<br />
That's it! Your project can now use the library.<br />
<br />
= Eclipse IDE user library =<br />
<br />
If you don't want to put JOGL in a separate Eclipse project, you can put it in a user library instead. The drawback to this is that the user library is defined in your .metadata directory and contains absolute paths, so it's hard to share with others. But for a non-shared project this works fine.<br />
<br />
=== Create a user library ===<br />
<br />
* Click "Window > Preferences", then select "Java > Build Path > User Libraries" on the left.<br />
* Click the "New..." button, type "JOGL" for the library name, and click "OK".<br />
[[File:Eclipse_setup_01_create_user_library.png|300px|thumb|none|Create user library]]<br />
* Click the "Add JARs..." button, navigate to the directory where you've stored the JARs, select all the non-native JARs, then click "Open".<br />
* If you're using native JAR files:<br />
** Make sure the <tt>gluegen-rt-natives-*-*.jar</tt> and <tt>jogl-all-natives-*-*.jar</tt> files for each platform you want to run on are in the same directory as the other JAR files. The native JAR files don't need to be added to the classpath.<br />
* Expand each non-native JAR in the list<br />
** Double-click "Source attachment", type the module's source zip name, (e.g. <tt>jogl-java-src.zip</tt> for the JAR file <tt>jogl-all.jar</tt>), and click "OK".<br />
** If you're using native library files:<br />
*** Double-click "Native library location", type the directory where native library files are stored, and click "OK".<br />
[[File:Eclipse_setup_02_set_native_library_locations.png|300px|thumb|none|Set native library locations]]<br />
* Click "OK" to exit Preferences dialog.<br />
<br />
=== Add the user library to your project's dependencies ===<br />
<br />
* Right-click your project in the Package Explorer and click "Properties".<br />
* Select "Java Build Path" and click the "Libraries" tab.<br />
[[File:Eclipse_setup_03_add_library_to_project.png|300px|thumb|none|Add library to project]]<br />
* Click "Add Library...", select "User Library", click "Next", check "JOGL", and click "Finish".<br />
[[File:Eclipse_setup_04_add_JOGL_library_to_project.png|300px|thumb|none|Add JOGL library to project]]<br />
* Click "OK" to dismiss the Properties dialog.<br />
<br />
That's it! You can now use the library in your project.<br />
<br />
= IntelliJ IDEA =<br />
=== Add a library dependency to your project ===<br />
<br />
* Click "File > Project Structure".<br />
* Select "Modules" on the left, then click the "Dependencies" tab on the right.<br />
* Click the "+" button on the right, then select "Library... > Java".<br />
[[File:IntelliJ_setup_01_add_library.png|300px|thumb|none|Add library]]<br />
* Navigate to the directory where you extracted the JARs, select it, and click "OK".<br />
[[File:IntelliJ_setup_02_find_library.png|300px|thumb|none|Find library]]<br />
* Click "OK" to dismiss the Configure Library dialog.<br />
[[File:IntelliJ_setup_03_configure_library.png|300px|thumb|none|Configure library]]<br />
* Click "OK" to dismiss the Project Structure dialog. The external libraries in your project should now look like this if you're using native JAR files:<br />
[[File:IntelliJ_setup_04_external_library_native_JARs.png|300px|thumb|none|Native JARs]]<br />
or like this if you're using native library files:<br />
[[File:IntelliJ_setup_04_external_library.png|300px|thumb|none|Native library files]]<br />
<br />
* If you're using native JAR files:<br />
** Make sure the <tt>gluegen-rt-natives-*-*.jar</tt> and <tt>jogl-all-natives-*-*.jar</tt> files for each platform you want to run on are in the same directory as the other JAR files.<br />
* Otherwise, if you're using native library files:<br />
** Click "Run > Edit Configurations".<br />
** Type <tt>-Djava.library.path=your/path/to/native/library/files</tt> in the "VM Parameters" box. Note that paths with spaces must be double-quoted on Windows.<br />
[[File:IntelliJ_setup_05_run_configuration.png|300px|thumb|none|Edit run configuration]]<br />
** Click "OK" to dismiss the Run/Debug Configurations dialog.<br />
<br />
That's it! You can now use the library in your project.<br />
<br />
= NetBeans IDE = <br />
=== Create a library and add it to your project ===<br />
<br />
* Right-click your project and click "Properties".<br />
* Select "Libraries" on the left and click "Add Library...".<br />
* Click the "Create" button, then type "JOGL" for the library name and click "OK".[[File:NetBeans_setup_01_create_library.png|300px|thumb|none|Create library]]<br />
* Click "Add JAR/Folder...", then navigate to the directory you extracted the JAR files, select them and click "Add JAR/Folder".<br />
* Click "OK" to dismiss the Customize Library dialog.<br />
* Click "Add Library" to dismiss the Add Library dialog.[[File:NetBeans_setup_02_add_library.png|300px|thumb|none|Add library]]<br />
* Click "OK" to dismiss the Project Properties dialog. The libraries in your project should look like this.[[File:NetBeans_setup_03_libraries_in_project.png|300px|thumb|none|Libraries in project]]<br />
<br />
* If you're using native JAR files:<br />
** Make sure the <tt>gluegen-rt-natives-*-*.jar</tt> and <tt>jogl-all-natives-*-*.jar</tt> files for each platform you want to run on are in the same directory as the other JAR files. The native JAR files don't need to be added to the classpath.<br />
* Otherwise, if you're using native library files:<br />
** Click "Run > Set Project Configuration > Customize...". Select "Run" on the left if it isn't selected already.<br />
** Type <tt>-Djava.library.path=your/path/to/native/library/files</tt> in the "VM Options" box.<br />
** NOTE: If the library path has spaces in it, you must put quotes around it (at least on Windows) or you may get an odd NoClassDefFoundError when you try to run.[[File:NetBeans_setup_04_native_library_path.png|300px|thumb|none|Native library path]]<br />
** Click "OK" to dismiss the Project Properties dialog.<br />
<br />
That's it! You can now use the library in your project.<br />
<br />
= Maven =<br />
<br />
From <tt>2.0-rc11</tt> to <tt>2.3.2</tt>, packages for all the JogAmp projects have been pushed to<br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central]. Since <tt>2.4.0</tt>, they have been pushed only to [https://jogamp.org/deployment/maven/ the JogAmp development repository]. Please see the<br />
[[Maven]] page for details on how to use them in your projects.<br />
<br />
= vi and other text editors =<br />
=== Create your project with the editor of your choice ===<br />
* For example, to open vi, simply type <tt>vi</tt> and press <return>.<br />
* Type all your code, then save it.<br />
<br />
=== Compile and run your project from the command line ===<br />
* We assume your JOGL JAR files are in a directory called <tt>jar</tt>. If you're using native JARs, we assume they're also in the <tt>jar</tt> directory. If you're using native library files, we assume they're in a directory called <tt>lib</tt>.<br />
<br />
* First compile your program. We assume all your code is in a single file called <tt>name/someone/MyProject.java</tt>.<br />
** Windows: Type <tt>javac -classpath "jar\gluegen-rt.jar;jar\jogl-all.jar" name\someone\MyProject.java</tt><br />
** Linux/MacOS X: Type <tt>javac -classpath "jar/gluegen-rt.jar:jar/jogl-all.jar" name/someone/MyProject.java</tt><br />
<br />
* Then run your project. We assume your main class is <tt>name.someone.MyProject</tt>. If you're using native JARs:<br />
** Windows: Type <tt>java -classpath "jar\gluegen-rt.jar;jar\jogl-all.jar;." name.someone.MyProject</tt><br />
** Linux/MacOS X: Type <tt>java -classpath "jar/gluegen-rt.jar:jar/jogl-all.jar:." name.someone.MyProject</tt><br />
* If you're using native library files:<br />
** Windows: Type <tt>java -classpath "jar\gluegen-rt.jar;jar\jogl-all.jar;." -Djava.library.path=lib -Djogamp.gluegen.UseTempJarCache=false name.someone.MyProject</tt><br />
** Linux/MacOS X: Type <tt>java -classpath "jar/gluegen-rt.jar:jar/jogl-all.jar:." -Djava.library.path=lib -Djogamp.gluegen.UseTempJarCache=false name.someone.MyProject</tt><br />
<br />
That's it! You can now use the library in your project.</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Ardor3D_FAQ&diff=2147Ardor3D FAQ2023-04-10T08:15:09Z<p>Gouessej: </p>
<hr />
<div>* Where can I download Ardor3D?<br />
** http://jogamp.org/deployment/ardor3d/jogamp-ardor3d.7z '''N.B: All JARs except those containing the source code are absolutely necessary'''<br />
* What else do I need to use Ardor3D?<br />
** [https://jogamp.org/deployment/jogamp-current/archive/jogamp-all-platforms.7z JogAmp]<br />
** JInput (optional)<br />
** SWT (optional)<br />
* How can I install Ardor3D?<br />
** Some detailed instructions are [http://gouessej.wordpress.com/2014/11/22/ardor3d-est-mort-vive-jogamps-ardor3d-continuation-ardor3d-is-dead-long-life-to-jogamps-ardor3d-continuation/#installation here]. Just put all JARs except those containing the native libraries into your classpath.<br />
** JogAmp's Ardor3D Continuation 1.0 will never be available on Maven Central but it is available on [https://jogamp.org/deployment/maven-ardor3d/ JogAmp Maven repository]<br />
* Where can I get the source code of Ardor3D?<br />
** [https://jogamp.org/cgit/ardor3d.git/ GIT repository]<br />
** [https://jogamp.org/deployment/ardor3d/ JAR archives]<br />
* How can I build Ardor3D?<br />
** If you use [https://maven.apache.org/ Apache Maven], enter 'mvn install' in command line or run the Maven 'install' goal within your favorite IDE (Eclipse with [http://www.eclipse.org/m2e/ M2Eclipse], Netbeans, ...) <br />
** If you use [http://www.gradle.org Gradle], enter 'gradle build' in command line or run the Gradle 'build' task within your favorite IDE (Eclipse, Netbeans, ...)<br />
** If you use [http://ant.apache.org Ant], use [http://maven.apache.org/plugins/maven-ant-plugin/ Maven Ant plugin], enter 'mvn ant:ant' to generate the Ant build script<br />
* Where can I get any help about Ardor3D?<br />
** You can get some help on [https://forum.jogamp.org our forum]<br />
* Where can I find any examples using Ardor3D?<br />
** [https://jogamp.org/cgit/ardor3d.git/tree/ardor3d-examples Almost one hundred of basic examples within the sub-project ardor3d-examples]<br />
** [https://github.com/Renanse/Ardor3D/wiki/HelloNasaWorldWind Ardor3D with WorldWind Java]<br />
** [https://github.com/Renanse/Ardor3D/wiki/Terrain-based-on-USGS-data A terrain implementation that uses USGS data]<br />
** [https://github.com/Renanse/Ardor3D/wiki/Statistics How to gather scene statistics such as triangle count, framerate, etc]<br />
** [https://github.com/Renanse/Ardor3D/wiki/Terrain The terrain]<br />
** [http://tuer.sourceforge.net A first person shooter]<br />
* Where can I report a bug in Ardor3D?<br />
** https://jogamp.org/bugzilla/describecomponents.cgi?product=Ardor3D</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Ardor3D_Overview&diff=2146Ardor3D Overview2023-04-10T08:08:54Z<p>Gouessej: </p>
<hr />
<div>Ardor3D is a professionally oriented, open source, Java based 3D engine for desktop (GNU Linux, Mac OS X, OpenIndiana, Windows) and mobile (Android) environments. The sub-project ardor3d-android was based on [https://developer.android.com/guide/topics/graphics/opengl.html Android OpenGL ES].<br />
<br />
Ardor3D was created September 23rd, 2008 as a fork of [http://www.jmonkeyengine.org JMonkeyEngine] by [http://blog.renanse.com Joshua Slack (Renanse)] and Rikard Herlitz (MrCoder). It was developed by [http://www.ardorlabs.com Ardor Labs] and some contributors until its version 0.9. Renanse abandoned the project March 11th, 2014. He restarted it some years later.<br />
<br />
The version 1.0 is the first version actively developed and maintained by JogAmp's community and supporting exclusively JOGL 2 (and later). It is designated as a subset of the original engine as it retains the only renderer relevant for JogAmp's community. As a consequence, it supports only desktop environments, the Android backend might be rewritten with JogAmp in another version. This subset is preferably called JogAmp's Ardor3D Continuation in order to avoid any confusion with the "official" unmaintained version.</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Maven&diff=2137Maven2023-02-14T12:09:29Z<p>Gouessej: /* The jogamp.org test repository (optional) */</p>
<hr />
<div>__TOC__<br />
<br />
JogAmp now contains support for Maven. As of <tt>2.0-rc11</tt>, packages are pushed to <br />
[http://search.maven.org/#search|ga|1|jogamp Maven Central].<br />
<br />
= Add dependencies on the correct packages =<br />
<br />
If you don't know which packages you want, you almost certainly want to use the<br />
<tt>jogl-all-main</tt> and <tt>gluegen-rt-main</tt> packages, as these automatically<br />
set up the correct dependencies on the native jar files for all platforms.<br />
<br />
As an example, if your project uses JOGL <tt>2.3.1</tt>:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.gluegen</groupId><br />
<artifactId>gluegen-rt-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
Maven will pull all of the dependencies the next time you attempt to build the project.<br />
<br />
Additionally, for <tt>joal</tt> and <tt>jocl</tt> support:<br />
<br />
<pre><br />
<dependencies><br />
<dependency><br />
<groupId>org.jogamp.jocl</groupId><br />
<artifactId>jocl-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.joal</groupId><br />
<artifactId>joal-main</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</dependencies><br />
</pre><br />
<br />
An example project is available in the <tt>maven</tt> subdirectory of the <tt>jogl-demos</tt> project<br />
[http://jogamp.org/git/?p=jogl-demos.git;a=tree;f=maven].<br />
<br />
= Package details =<br />
<br />
For each JogAmp project, there are essentially two packages published: One contains the main compiled<br />
jar files and any associated native library jar files, and the other simply contains <i>dependencies</i><br />
on those files. Using <tt>jogl-all</tt> and <tt>jogl-all-main</tt> as the example, the <tt>jogl-all</tt><br />
package in the jogamp.org test repository:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all/2.3.1/<br />
<br />
Note that there are many native jar files attached to the main package. However, if you were to use<br />
the following dependency in your own project:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl-all</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
</pre><br />
<br />
Maven would download <tt>jogl-all-2.3.1.jar</tt> but would completely ignore all of the other<br />
native jar files. Why? The reason for this is that the native jar files are uploaded as extra artifacts<br />
to the <tt>jogl-all</tt> package and are, in a manner of speaking, not really considered to be part of<br />
the package where dependencies are concerned. The POM for the <tt>jogl-all-main</tt> package adds<br />
explicit dependencies on all of the extra artifacts in the <tt>jogl-all</tt> package:<br />
<br />
http://jogamp.org/deployment/maven/org/jogamp/jogl/jogl-all-main/2.3.1/jogl-all-main-2.3.1.pom<br />
<br />
So, when you add a dependency on <tt>jogl-all-main</tt> in your own project, the native jar files of<br />
<tt>jogl-all</tt> are brought in as transitive dependencies and everything works as expected.<br />
<br />
= Available packages =<br />
<br />
{|<br />
|Group ID<br />
|Artifact ID<br />
|Since<br />
|Description<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-android<br />
|2.0.2-rc12<br />
|GlueGen runtime code and native libraries (Android)<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for the GlueGen runtime<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen-rt<br />
|2.0-rc11<br />
|GlueGen runtime code and native libraries<br />
|-<br />
|org.jogamp.gluegen<br />
|gluegen<br />
|2.0-rc11<br />
|GlueGen non-runtime code and native libraries (and atomic jars)<br />
|-<br />
|org.jogamp.joal<br />
|joal-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOAL<br />
|-<br />
|org.jogamp.joal<br />
|joal<br />
|2.0-rc11<br />
|JOAL code and native libraries<br />
|-<br />
|org.jogamp.joal<br />
|joal-android<br />
|2.2.0<br />
|JOAL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOCL<br />
|-<br />
|org.jogamp.jocl<br />
|jocl-android<br />
|2.2.0<br />
|JOCL Android runtime<br />
|-<br />
|org.jogamp.jocl<br />
|jocl<br />
|2.0-rc11<br />
|JOCL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-all<br />
|2.0-rc11<br />
|JOGL code and native libraries<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android<br />
|2.0.2-rc12<br />
|JOGL code and native libraries (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-android-main<br />
|2.2.0<br />
|Meta-package for automatic dependency resolution for JOGL (Android)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (mobile)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-mobile<br />
|2.0-rc11<br />
|JOGL mobile code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt-main<br />
|2.0-rc11<br />
|Meta-package for automatic dependency resolution for JOGL (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl-noawt<br />
|2.0-rc11<br />
|JOGL code and native libraries (without AWT)<br />
|-<br />
|org.jogamp.jogl<br />
|jogl<br />
|2.0.2<br />
|JOGL atomic jar files<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow<br />
|2.0.2<br />
|Native window drivers for NEWT (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|nativewindow-main<br />
|2.2.0<br />
|Native window drivers for NEWT (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|newt<br />
|2.0.2<br />
|NEWT code and native libraries (atomic jars)<br />
|-<br />
|org.jogamp.jogl<br />
|newt-main<br />
|2.2.0<br />
|NEWT code and native libraries (atomic frontend)<br />
|-<br />
|org.jogamp.jogl<br />
|occulusvr<br />
|2.2.0<br />
|JOGL code and native libraries (Oculus VR atomic jar files)<br />
|-<br />
|}<br />
<br />
= Atomic jar files (optional) =<br />
<br />
The so-called <i>atomic</i> jar files are provided as attachments to the <tt>jogl</tt>, <tt>newt</tt>,<br />
<tt>nativewindow</tt> and <tt>gluegen</tt> packages. As an example, to depend only on the Linux AMD64<br />
native jar files, on X11, using only the core of <tt>jogl</tt> and the native window toolkit in your<br />
own projects, use the following dependencies:<br />
<br />
<pre><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.gluegen-rt</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>jogl</artifactId><br />
<version>2.3.1</version><br />
<classifier>os-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>newt</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>core</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>natives-linux-amd64</classifier><br />
</dependency><br />
<dependency><br />
<groupId>org.jogamp.jogl</groupId><br />
<artifactId>nativewindow</artifactId><br />
<version>2.3.1</version><br />
<classifier>driver-x11</classifier><br />
</dependency><br />
</pre><br />
<br />
Note that the choice of which atomic jars are required is really outside of the scope of this<br />
documentation. It's recommended that you browse the packages in question to see which jar<br />
files are available. It's <i>not</i> recommended to depend on platform-specific jar files<br />
in the manner shown above unless there's an extremely good reason to do so; to do otherwise<br />
harms portability for no good reason!<br />
<br />
= The jogamp.org test repository (optional) =<br />
<br />
Bleeding edge, experimental packages will continue to be made available from the<br />
[http://jogamp.org/deployment/maven Jogamp Test Repository]. Most users won't need this, but<br />
it can be used by adding a new profile in your <tt>~/.m2/settings.xml</tt> file that specifies<br />
the repository:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<settings<br />
xmlns="http://maven.apache.org/SETTINGS/1.0.0" <br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <br />
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><br />
<profiles><br />
<profile><br />
<id>jogamp</id><br />
<repositories><br />
<repository><br />
<id>jogamp-remote</id><br />
<name>jogamp test mirror</name><br />
<url>https://www.jogamp.org/deployment/maven/</url><br />
<layout>default</layout><br />
</repository><br />
</repositories><br />
</profile><br />
</profiles><br />
<activeProfiles><br />
<activeProfile>jogamp</activeProfile><br />
</activeProfiles><br />
</settings><br />
</pre><br />
<br />
Maven will then check this repository for packages in addition to Maven Central when resolving dependencies.<br />
<br />
'''''Please note that packages on the jogamp test repository are subject to unannounced changes at any moment and may break existing code at any time! Do not use for production code!'''''<br />
<br />
= Android =<br />
<br />
There is a [[Maven_And_Android|separate page]] documenting one method of producing packages that work on both Android and ordinary<br />
desktop Java.<br />
<br />
= Producing a fat jar =<br />
<br />
See [[JogAmp_JAR_File_Handling#Maven_Assembly_Plugin|JAR File Handling]].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Jogl_Tutorial&diff=2116Jogl Tutorial2022-11-08T21:48:29Z<p>Gouessej: /* Hello Triangle and Texture */</p>
<hr />
<div>= JogAmp's Static =<br />
* [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
* [{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
* [{{SERVER}}/jogl/doc/userguide/ Userguide]<br />
* [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html Deployment]<br />
* [{{SERVER}}/deployment/jogamp-current/jogl-test-applets.html JOGL Test Applets]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal.html using Object/Embed tags]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-demos/applet-gears.html using the Applet Tag]<br />
* [{{SERVER}}/jogl/doc/NEWT-Overview.html NEWT - High Performance Native Windowing Toolkit]<br />
* [{{SERVER}}/git/?p=jogl-demos.git;a=blob;f=src/demos/es2/RawGL2ES2demo.java;hb=HEAD OpenGL GL2ES2 GLSL Standalone Example by Xerxes Rånby]<br />
* [https://jogamp.org/wiki/index.php/Rudimentary_standalone_example_using_the_fixed_pipeline_by_Julien_Gouesse Rudimentary standalone example using the fixed pipeline by Julien Gouesse]<br />
* [https://gist.github.com/xranby/ccbcfcaef341f5bd1ba8 Rudimentary standalone example using the fixed pipeline with OpenGL ES 1 by Xerxes Rånby]<br />
<br />
= JogAmp's Wiki =<br />
* [[Downloading and installing JOGL|Downloading and installing JOGL]]<br />
** [[Jogamp_Versioning_and_Releases|Versioning And Release Information]]<br />
* [[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
* Deployment<br />
** [[JogAmp JAR File Handling|JAR File Handling]]<br />
** [[Using JOGL in a Java applet|Using JOGL in a Java Applet]]<br />
** [[Using JOGL in Java Web Start|Using JOGL in Java Web Start]]<br />
** [[Foreign Packaging|Foreign Packaging]]<br />
* JOGL<br />
** [[How to write cross GLProfile compatible shader using JOGL]]<br />
** [[How to use the Debug and Trace GL Pipeline and Debug GL Context]]<br />
** [[Using JOGL in AWT SWT and Swing|Using JOGL in AWT, SWT, and Swing]]<br />
** [[How to use X11 displays]]<br />
* [[Jogl_FAQ|FAQ]]<br />
<br />
= Hello Triangle and Texture =<br />
[https://github.com/elect86/helloTriangle Sample] that features GL4, pure newt, glWindow options, animator, indexed drawing, dynamic attribute and frag data binding, interleaved data, vao, vbo (with normalization on one attribute), ibo (with shorts), uniform, glsl program (with specific suffix) and matrix jogl util, gl error check, key listener and right way to dispose. <br />
<br />
There is also a gl3 version and a Texture sample.<br />
<br />
All the samples are written in Java and [https://en.wikipedia.org/wiki/Kotlin_(programming_language) Kotlin].<br />
<br />
[https://github.com/jvm-graphics-labs/hello-triangle/blob/master/src/main/java/gl4/HelloTriangleSimple.java This example in pure Java] is less difficult to use for newcomers but it requires [https://github.com/jvm-graphics-labs/hello-triangle/blob/master/src/main/java/framework/Semantic.java Semantic.java].<br />
<br />
= Common Mistakes =<br />
I suggest you to take a read to these two pages for a quick overview over the most common problems, it is a very useful reading, legacy sections are carefully signaled.<br />
<br />
[https://www.opengl.org/wiki/Common_Mistakes OpenGL]<br />
[https://www.opengl.org/wiki/GLSL_:_common_mistakes GLSL]<br />
<br />
Another common mistake that may happen if you port code from C/C++ to Java is this one:<br />
<br />
<code><br />
Caused by: com.jogamp.opengl.GLException: unpack pixel_buffer_object must be bound to call this method<br />
at jogamp.opengl.gl4.GL4bcImpl.checkBufferObject(GL4bcImpl.java:40621)<br />
at jogamp.opengl.gl4.GL4bcImpl.checkUnpackPBOBound(GL4bcImpl.java:40707)<br />
at jogamp.opengl.gl4.GL4bcImpl.glTexImage2D(GL4bcImpl.java:5535)<br />
at tests.gl320.Gl_320_fbo_blit.initTexture(Gl_320_fbo_blit.java:199)<br />
</code><br />
<br />
This happens because in C/C++, when you just want to allocate the space for a texture using, for example, ''glTexImage2D'', you should not pass 0 as the last argument, but ''null''.<br />
<br />
<br />
N.B: The use of color picking is '''NOT''' recommended on any hardware whose palette is partially emulated.<br />
<br />
= Java OpenGL Samples Pack =<br />
<br />
The [https://github.com/elect86/jogl-samples Java OpenGL Samples Pack] (called unsurprisingly jogl-samples) is a port of the [http://www.g-truc.net/project-0026.html OpenGL Samples Pack], a collection of OpenGL samples based on the OpenGL "core profile" specifications.<br />
<br />
The project aims to promote the new OpenGL features making easier version transitions for OpenGL programmers with a complementary documentation for the OpenGL specification. Despite the fact that the OpenGL Samples Pack provides as simple (and dumb) as possible samples, it's not a tutorial for beginner but a project for programmers already familiar with OpenGL. The OpenGL Samples Pack is also a good OpenGL drivers feature test.<br />
<br />
These samples illustrate mostly of the OpenGL features from ES 2.0 up to the last GL extenstions, same of them usually also called AZDO (Almost Zero Driver Overhead).<br />
<br />
= Wade's JOGL tutorials =<br />
* [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Cross-platform workbench program using Eclipse and JOGL]<br />
* [http://wadeawalker.wordpress.com/2010/10/17/tutorial-faster-rendering-with-vertex-buffer-objects/ Faster rendering with vertex buffer objects]<br />
* [http://wadeawalker.wordpress.com/2010/10/24/tutorial-creating-native-binary-executables-for-multi-platform-java-apps-with-opengl-and-eclipse-rcp/ Creating native binary executables for multi-platform Java apps with OpenGL and Eclipse RCP]<br />
* [http://wadeawalker.wordpress.com/2010/12/06/tutorial-displaying-java-opengl-in-an-eclipse-editor-with-a-menu-bar-and-a-runpause-button/ Displaying Java OpenGL in an Eclipse RCP editor with a menu bar and a run/pause button]<br />
<br />
= Rami's JOGL tutorials =<br />
* [http://ramisantina.com/blog/?p=8 Rami's Guide how to setup a JOGL Eclipse project]<br />
<br />
= [https://sites.google.com/site/justinscsstuff/jogl-tutorials Justin's Getting Started with JOGL 2 Tutorials] =<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]<br />
<br />
= [http://ecs.csus.edu/~gordonvs/textbook.html Gordon] and Clevenger textbook =<br />
<br />
Shader-based modern OpenGL 3D graphics programming textbook entirely in JOGL. Also works as a JOGL primer. "Computer Graphics Programming in OpenGL with Java" by V. Scott Gordon and John L. Clevenger, published by [http://www.merclearning.com/titles/Computer_Graphics_Programming.html Mercury], available at [https://www.amazon.com/Computer-Graphics-Programming-OpenGL-Java/dp/1683920279/ Amazon].<br />
<br />
= Elect86's modern OpenGL examples =<br />
<br />
* [https://github.com/elect86/modern-jogl-examples Source code on Github]<br />
<br />
= Nils Hoffmann's Netbeans Platform examples =<br />
* [https://github.com/nilshoffmann/netbeans-jogl2 Source code on Github]<br />
<br />
= Courses =<br />
* [http://www3.ntu.edu.sg/home/ehchua/programming/opengl/JOGL2.0.html Yet Another Tutorial on JOGL 2.0 - Including Nehe JOGL Port (Chua Hock-Chuan's notes at Nanyang Tech. University)]<br />
* [http://www.informatik.uni-oldenburg.de/~trigger/opengl_course.html Johannes's Courses at University of Oldenburg (German)]<br />
* [http://www.manuel-carcenac.com/courses/index.html Manuel's Courses at European University of Lefke]<br />
** [http://www.manuel-carcenac.com/courses/Graphics_in_Java/index.htm Graphics in Java incl. 3D/JOGL]<br />
** [http://www.manuel-carcenac.com/courses/Advanced_Graphics_in_Java_and_JOGL/index.htm Advanced 3D Graphics in Java and Java OpenGL (JOGL 2)]<br />
<br />
= [http://leolol.com/tutorials/graphics_tutorials.html LeoLoL.com Tutorials] (Currently unreachable) =<br />
* [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]<br />
* [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]<br />
* [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]<br />
* [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]<br />
<br />
= JOGL 1 tutorials =<br />
* [http://www.felixgers.de/teaching/jogl/ Felix's OpenGL and JOGL]<br />
<br />
== [http://www.sjonesart.com/gl.php Ste3e's JOGL tutorials] ==<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENGE3ZmZkOGItZGYzZC00ZDgzLTg0NTAtMTk1MTAwMzYxYzNk&hl=en Keys and Mouse]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEYTFiMmFiYzQtMDA0MC00ZWI0LWI1NjItODE3ZjM2OGUxOWEw&hl=en First-Person Shooter]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEZGI2NTZhZTMtYWYwNS00NTljLWFiNGQtM2UyNTYyNjAzNDYy&hl=en Vertex Buffer Objects]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENWFhODk0M2UtZDY0Ni00YWM5LWIxZGUtMzM0YzMxMmRlODgx&hl=en Shader Setup]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEMzNjNDBmMjUtNGQzNS00ODY0LWJkYmUtNDM5Y2I5ODc0Y2Nj&hl=en Texture Using Shaders]<br />
<br />
(The old (not quite up-to-date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Jogl_Tutorial&diff=2006Jogl Tutorial2018-06-19T14:06:03Z<p>Gouessej: Replaces the link to a github gist example I'm going to delete to an example stored into our wiki</p>
<hr />
<div>= JogAmp's Static =<br />
* [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
* [{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
* [{{SERVER}}/jogl/doc/userguide/ Userguide]<br />
* [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html Deployment]<br />
* [{{SERVER}}/deployment/jogamp-current/jogl-test-applets.html JOGL Test Applets]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal.html using Object/Embed tags]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-demos/applet-gears.html using the Applet Tag]<br />
* [{{SERVER}}/jogl/doc/NEWT-Overview.html NEWT - High Performance Native Windowing Toolkit]<br />
* [{{SERVER}}/git/?p=jogl-demos.git;a=blob;f=src/demos/es2/RawGL2ES2demo.java;hb=HEAD OpenGL GL2ES2 GLSL Standalone Example by Xerxes Rånby]<br />
* [https://jogamp.org/wiki/index.php/Rudimentary_standalone_example_using_the_fixed_pipeline_by_Julien_Gouesse Rudimentary standalone example using the fixed pipeline by Julien Gouesse]<br />
* [https://gist.github.com/xranby/ccbcfcaef341f5bd1ba8 Rudimentary standalone example using the fixed pipeline with OpenGL ES 1 by Xerxes Rånby]<br />
<br />
= JogAmp's Wiki =<br />
* [[Downloading and installing JOGL|Downloading and installing JOGL]]<br />
** [[Jogamp_Versioning_and_Releases|Versioning And Release Information]]<br />
* [[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
* Deployment<br />
** [[JogAmp JAR File Handling|JAR File Handling]]<br />
** [[Using JOGL in a Java applet|Using JOGL in a Java Applet]]<br />
** [[Using JOGL in Java Web Start|Using JOGL in Java Web Start]]<br />
** [[Foreign Packaging|Foreign Packaging]]<br />
* JOGL<br />
** [[How to write cross GLProfile compatible shader using JOGL]]<br />
** [[How to use the Debug and Trace GL Pipeline and Debug GL Context]]<br />
** [[Using JOGL in AWT SWT and Swing|Using JOGL in AWT, SWT, and Swing]]<br />
** [[How to use X11 displays]]<br />
* [[Jogl_FAQ|FAQ]]<br />
<br />
= Hello Triangle and Texture =<br />
[https://github.com/elect86/helloTriangle Simple sample] that features GL4, pure newt, glWindow options, animator, indexed drawing, dinamic attribute and frag data binding, interleaved data, vao, vbo (with normalization on one attribute), ibo (with shorts), uniform, glsl program (with specific suffix) and matrix jogl util, gl error check, key listener and right way to dispose. <br />
<br />
There is also a gl3 version and a Texture sample.<br />
<br />
All the samples are written in Java and [https://en.wikipedia.org/wiki/Kotlin_(programming_language) Kotlin].<br />
<br />
= Common Mistakes =<br />
I suggest you to take a read to these two pages for a quick overview over the most common problems, it is a very useful reading, legacy sections are carefully signaled.<br />
<br />
[https://www.opengl.org/wiki/Common_Mistakes OpenGL]<br />
[https://www.opengl.org/wiki/GLSL_:_common_mistakes GLSL]<br />
<br />
Another common mistake that may happen if you port code from C/C++ to Java is this one:<br />
<br />
<code><br />
Caused by: com.jogamp.opengl.GLException: unpack pixel_buffer_object must be bound to call this method<br />
at jogamp.opengl.gl4.GL4bcImpl.checkBufferObject(GL4bcImpl.java:40621)<br />
at jogamp.opengl.gl4.GL4bcImpl.checkUnpackPBOBound(GL4bcImpl.java:40707)<br />
at jogamp.opengl.gl4.GL4bcImpl.glTexImage2D(GL4bcImpl.java:5535)<br />
at tests.gl320.Gl_320_fbo_blit.initTexture(Gl_320_fbo_blit.java:199)<br />
</code><br />
<br />
This happens because in C/C++, when you just want to allocate the space for a texture using, for example, ''glTexImage2D'', you should not pass 0 as the last argument, but ''null''.<br />
<br />
<br />
N.B: The use of color picking is '''NOT''' recommended on any hardware whose palette is partially emulated.<br />
<br />
= Java OpenGL Samples Pack =<br />
<br />
The [https://github.com/elect86/jogl-samples Java OpenGL Samples Pack] (called unsurprisingly jogl-samples) is a port of the [http://www.g-truc.net/project-0026.html OpenGL Samples Pack], a collection of OpenGL samples based on the OpenGL "core profile" specifications.<br />
<br />
The project aims to promote the new OpenGL features making easier version transitions for OpenGL programmers with a complementary documentation for the OpenGL specification. Despite the fact that the OpenGL Samples Pack provides as simple (and dumb) as possible samples, it's not a tutorial for beginner but a project for programmers already familiar with OpenGL. The OpenGL Samples Pack is also a good OpenGL drivers feature test.<br />
<br />
These samples illustrate mostly of the OpenGL features from ES 2.0 up to the last GL extenstions, same of them usually also called AZDO (Almost Zero Driver Overhead).<br />
<br />
= Wade's JOGL tutorials =<br />
* [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Cross-platform workbench program using Eclipse and JOGL]<br />
* [http://wadeawalker.wordpress.com/2010/10/17/tutorial-faster-rendering-with-vertex-buffer-objects/ Faster rendering with vertex buffer objects]<br />
* [http://wadeawalker.wordpress.com/2010/10/24/tutorial-creating-native-binary-executables-for-multi-platform-java-apps-with-opengl-and-eclipse-rcp/ Creating native binary executables for multi-platform Java apps with OpenGL and Eclipse RCP]<br />
* [http://wadeawalker.wordpress.com/2010/12/06/tutorial-displaying-java-opengl-in-an-eclipse-editor-with-a-menu-bar-and-a-runpause-button/ Displaying Java OpenGL in an Eclipse RCP editor with a menu bar and a run/pause button]<br />
<br />
= Rami's JOGL tutorials =<br />
* [http://ramisantina.com/blog/?p=8 Rami's Guide how to setup a JOGL Eclipse project]<br />
<br />
= [https://sites.google.com/site/justinscsstuff/jogl-tutorials Justin's Getting Started with JOGL 2 Tutorials] =<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]<br />
<br />
= [http://ecs.csus.edu/~gordonvs/textbook.html Gordon] and Clevenger textbook =<br />
<br />
Shader-based modern OpenGL 3D graphics programming textbook entirely in JOGL. Also works as a JOGL primer. "Computer Graphics Programming in OpenGL with Java" by V. Scott Gordon and John L. Clevenger, published by [http://www.merclearning.com/titles/Computer_Graphics_Programming.html Mercury], available at [https://www.amazon.com/Computer-Graphics-Programming-OpenGL-Java/dp/1683920279/ Amazon].<br />
<br />
= Elect86's modern OpenGL examples =<br />
<br />
* [https://github.com/elect86/modern-jogl-examples Source code on Github]<br />
<br />
= Nils Hoffmann's Netbeans Platform examples =<br />
* [https://github.com/nilshoffmann/netbeans-jogl2 Source code on Github]<br />
<br />
= Courses =<br />
* [http://www3.ntu.edu.sg/home/ehchua/programming/opengl/JOGL2.0.html Yet Another Tutorial on JOGL 2.0 - Including Nehe JOGL Port (Chua Hock-Chuan's notes at Nanyang Tech. University)]<br />
* [http://www.informatik.uni-oldenburg.de/~trigger/opengl_course.html Johannes's Courses at University of Oldenburg (German)]<br />
* [http://www.manuel-carcenac.com/courses/index.html Manuel's Courses at European University of Lefke]<br />
** [http://www.manuel-carcenac.com/courses/Graphics_in_Java/index.htm Graphics in Java incl. 3D/JOGL]<br />
** [http://www.manuel-carcenac.com/courses/Advanced_Graphics_in_Java_and_JOGL/index.htm Advanced 3D Graphics in Java and Java OpenGL (JOGL 2)]<br />
<br />
= [http://leolol.com/tutorials/graphics_tutorials.html LeoLoL.com Tutorials] (Currently unreachable) =<br />
* [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]<br />
* [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]<br />
* [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]<br />
* [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]<br />
<br />
= JOGL 1 tutorials =<br />
* [http://www.felixgers.de/teaching/jogl/ Felix's OpenGL and JOGL]<br />
<br />
== [http://www.sjonesart.com/gl.php Ste3e's JOGL tutorials] ==<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENGE3ZmZkOGItZGYzZC00ZDgzLTg0NTAtMTk1MTAwMzYxYzNk&hl=en Keys and Mouse]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEYTFiMmFiYzQtMDA0MC00ZWI0LWI1NjItODE3ZjM2OGUxOWEw&hl=en First-Person Shooter]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEZGI2NTZhZTMtYWYwNS00NTljLWFiNGQtM2UyNTYyNjAzNDYy&hl=en Vertex Buffer Objects]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENWFhODk0M2UtZDY0Ni00YWM5LWIxZGUtMzM0YzMxMmRlODgx&hl=en Shader Setup]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEMzNjNDBmMjUtNGQzNS00ODY0LWJkYmUtNDM5Y2I5ODc0Y2Nj&hl=en Texture Using Shaders]<br />
<br />
(The old (not quite up-to-date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Rudimentary_standalone_example_using_the_fixed_pipeline_by_Julien_Gouesse&diff=2005Rudimentary standalone example using the fixed pipeline by Julien Gouesse2018-06-19T14:05:11Z<p>Gouessej: Created page with "This program displays a simple 3D rendering of a polygon using JOGL. Please note though that this code is a demonstration of the use of JOGL and as such makes use of immediate..."</p>
<hr />
<div>This program displays a simple 3D rendering of a polygon using JOGL. Please note though that this code is a demonstration of the use of JOGL and as such makes use of immediate mode drawing commands; this serves to show how the conventional C style API is used through JOGL, but it is strongly recommended to make use of modern OpenGL techniques.<br />
<br />
<pre>import java.awt.*;<br />
import java.awt.event.*;<br />
import com.jogamp.opengl.*;<br />
import com.jogamp.opengl.awt.GLCanvas;<br />
import com.jogamp.opengl.fixedfunc.*;<br />
import com.jogamp.opengl.util.Animator;<br />
<br />
/**<br />
* Self-contained example (within a single class only to keep it simple) <br />
* displaying a rotating quad<br />
*/<br />
public class JOGLQuad implements GLEventListener {<br />
<br />
private float rotateT = 0.0f;<br />
<br />
@Override<br />
public void display(GLAutoDrawable gLDrawable) {<br />
final GL2 gl = gLDrawable.getGL().getGL2();<br />
gl.glClear(GL.GL_COLOR_BUFFER_BIT);<br />
gl.glClear(GL.GL_DEPTH_BUFFER_BIT);<br />
gl.glLoadIdentity();<br />
gl.glTranslatef(0.0f, 0.0f, -5.0f);<br />
<br />
// rotate about the three axes<br />
gl.glRotatef(rotateT, 1.0f, 0.0f, 0.0f);<br />
gl.glRotatef(rotateT, 0.0f, 1.0f, 0.0f);<br />
gl.glRotatef(rotateT, 0.0f, 0.0f, 1.0f);<br />
<br />
// Draw A Quad<br />
gl.glBegin(GL2.GL_QUADS); <br />
gl.glColor3f(0.0f, 1.0f, 1.0f); // set the color of the quad<br />
gl.glVertex3f(-1.0f, 1.0f, 0.0f); // Top Left<br />
gl.glVertex3f( 1.0f, 1.0f, 0.0f); // Top Right<br />
gl.glVertex3f( 1.0f,-1.0f, 0.0f); // Bottom Right<br />
gl.glVertex3f(-1.0f,-1.0f, 0.0f); // Bottom Left<br />
// Done Drawing The Quad<br />
gl.glEnd(); <br />
<br />
// increasing rotation for the next iteration <br />
rotateT += 0.2f; <br />
}<br />
<br />
@Override<br />
public void init(GLAutoDrawable glDrawable) {<br />
GL2 gl = glDrawable.getGL().getGL2();<br />
gl.glShadeModel(GLLightingFunc.GL_SMOOTH);<br />
gl.glClearColor(0.0f, 0.0f, 0.0f, 0.0f);<br />
gl.glClearDepth(1.0f);<br />
gl.glEnable(GL.GL_DEPTH_TEST);<br />
gl.glDepthFunc(GL.GL_LEQUAL);<br />
gl.glHint(GL2ES1.GL_PERSPECTIVE_CORRECTION_HINT, GL.GL_NICEST);<br />
}<br />
<br />
@Override<br />
public void reshape(GLAutoDrawable gLDrawable, int x, int y, int width, int height) {<br />
GL2 gl = gLDrawable.getGL().getGL2();<br />
final float aspect = (float) width / (float) height;<br />
gl.glMatrixMode(GLMatrixFunc.GL_PROJECTION);<br />
gl.glLoadIdentity();<br />
final float fh = 0.5f;<br />
final float fw = fh * aspect;<br />
gl.glFrustumf(-fw, fw, -fh, fh, 1.0f, 1000.0f);<br />
gl.glMatrixMode(GLMatrixFunc.GL_MODELVIEW);<br />
gl.glLoadIdentity();<br />
}<br />
<br />
@Override<br />
public void dispose(GLAutoDrawable gLDrawable) {<br />
}<br />
<br />
public static void main(String[] args) {<br />
final GLCanvas canvas = new GLCanvas();<br />
final Frame frame = new Frame("Jogl Quad drawing");<br />
final Animator animator = new Animator(canvas);<br />
canvas.addGLEventListener(new JOGLQuad());<br />
frame.add(canvas);<br />
frame.setSize(640, 480);<br />
frame.setResizable(false);<br />
frame.addWindowListener(new WindowAdapter() {<br />
public void windowClosing(WindowEvent e) {<br />
animator.stop();<br />
frame.dispose();<br />
System.exit(0);<br />
}<br />
});<br />
frame.setVisible(true);<br />
animator.start();<br />
canvas.requestFocus();<br />
}<br />
}<br />
</pre></div>Gouessejhttps://jogamp.org/wiki/index.php?title=Talk:SW_Tracking_Report_Objectives_for_the_release_2.3.3&diff=2004Talk:SW Tracking Report Objectives for the release 2.3.32018-06-19T10:53:19Z<p>Gouessej: </p>
<hr />
<div>I broke something :s I only get a white page... --[[User:Gouessej|Gouessej]] ([[User talk:Gouessej|talk]]) 12:53, 19 June 2018 (CEST)</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Talk:SW_Tracking_Report_Objectives_for_the_release_2.3.3&diff=2003Talk:SW Tracking Report Objectives for the release 2.3.32018-06-19T10:53:07Z<p>Gouessej: Created page with "I broke something :s I only get a white page..."</p>
<hr />
<div>I broke something :s I only get a white page...</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Java3D_FAQ&diff=1992Java3D FAQ2017-12-01T08:55:02Z<p>Gouessej: </p>
<hr />
<div>* Where can I download Java3D?<br />
** http://jogamp.org/deployment/java3d/1.6.0-final/jogamp-java3d.7z<br />
* What else do I need to use Java3D?<br />
** http://jogamp.org/deployment/jogamp-current/archive/jogamp-all-platforms.7z JogAmp<br />
* How can I install Java3D?<br />
** Follow [https://jogamp.org/wiki/index.php/Downloading_and_installing_Java3D these instructions]<br />
* Where can I get the source code of Java3D?<br />
** https://github.com/hharrison/java3d-core - core<br />
** https://github.com/hharrison/java3d-utils - utils<br />
** https://github.com/hharrison/vecmath - vecmath<br />
* Where can I get the Java API Documentation of Java3D?<br />
** https://jogamp.org/wiki/index.php/Java3D_API_Documentation<br />
* Where can I get any help about Java3D?<br />
** You can get some help on [http://forum.jogamp.org/java3d-f3728156.html the subsection dedicated to Java3D on our forum] and on [http://jogamp.org/wiki/index.php/Chatroom#Freenode_IRC_Channel our IRC chatroom]<br />
* Where can I find any examples using Java3D?<br />
** You can find some examples using Java3D 1.7.0 on https://github.com/philjord/java3d-examples and Java3D 1.6.0 on http://www.java3d.org<br />
* Where can I report a bug in Java3D?<br />
** https://github.com/hharrison/java3d-core/issues and https://jogamp.org/bugzilla/</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Jogl_Tutorial&diff=1990Jogl Tutorial2017-07-25T15:24:01Z<p>Gouessej: </p>
<hr />
<div>= JogAmp's Static =<br />
* [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
* [{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
* [{{SERVER}}/jogl/doc/userguide/ Userguide]<br />
* [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html Deployment]<br />
* [{{SERVER}}/deployment/jogamp-current/jogl-test-applets.html JOGL Test Applets]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal.html using Object/Embed tags]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-demos/applet-gears.html using the Applet Tag]<br />
* [{{SERVER}}/jogl/doc/NEWT-Overview.html NEWT - High Performance Native Windowing Toolkit]<br />
* [{{SERVER}}/git/?p=jogl-demos.git;a=blob;f=src/demos/es2/RawGL2ES2demo.java;hb=HEAD OpenGL GL2ES2 GLSL Standalone Example by Xerxes Rånby]<br />
* [https://gist.github.com/gouessej/3420e2b6f632efdddf98 Rudimentary standalone example using the fixed pipeline by Julien Gouesse]<br />
* [https://gist.github.com/xranby/ccbcfcaef341f5bd1ba8 Rudimentary standalone example using the fixed pipeline with OpenGL ES 1 by Xerxes Rånby]<br />
<br />
= JogAmp's Wiki =<br />
* [[Downloading and installing JOGL|Downloading and installing JOGL]]<br />
** [[Jogamp_Versioning_and_Releases|Versioning And Release Information]]<br />
* [[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
* Deployment<br />
** [[JogAmp JAR File Handling|JAR File Handling]]<br />
** [[Using JOGL in a Java applet|Using JOGL in a Java Applet]]<br />
** [[Using JOGL in Java Web Start|Using JOGL in Java Web Start]]<br />
** [[Foreign Packaging|Foreign Packaging]]<br />
* JOGL<br />
** [[How to write cross GLProfile compatible shader using JOGL]]<br />
** [[How to use the Debug and Trace GL Pipeline and Debug GL Context]]<br />
** [[Using JOGL in AWT SWT and Swing|Using JOGL in AWT, SWT, and Swing]]<br />
** [[How to use X11 displays]]<br />
* [[Jogl_FAQ|FAQ]]<br />
<br />
= Hello Triangle and Texture =<br />
[https://github.com/elect86/helloTriangle Simple sample] that features GL4, pure newt, glWindow options, animator, indexed drawing, dinamic attribute and frag data binding, interleaved data, vao, vbo (with normalization on one attribute), ibo (with shorts), uniform, glsl program (with specific suffix) and matrix jogl util, gl error check, key listener and right way to dispose. <br />
<br />
There is also a gl3 version and a Texture sample.<br />
<br />
All the samples are written in Java and [https://en.wikipedia.org/wiki/Kotlin_(programming_language) Kotlin].<br />
<br />
= Common Mistakes =<br />
I suggest you to take a read to these two pages for a quick overview over the most common problems, it is a very useful reading, legacy sections are carefully signaled.<br />
<br />
[https://www.opengl.org/wiki/Common_Mistakes OpenGL]<br />
[https://www.opengl.org/wiki/GLSL_:_common_mistakes GLSL]<br />
<br />
Another common mistake that may happen if you port code from C/C++ to Java is this one:<br />
<br />
<code><br />
Caused by: com.jogamp.opengl.GLException: unpack pixel_buffer_object must be bound to call this method<br />
at jogamp.opengl.gl4.GL4bcImpl.checkBufferObject(GL4bcImpl.java:40621)<br />
at jogamp.opengl.gl4.GL4bcImpl.checkUnpackPBOBound(GL4bcImpl.java:40707)<br />
at jogamp.opengl.gl4.GL4bcImpl.glTexImage2D(GL4bcImpl.java:5535)<br />
at tests.gl320.Gl_320_fbo_blit.initTexture(Gl_320_fbo_blit.java:199)<br />
</code><br />
<br />
This happens because in C/C++, when you just want to allocate the space for a texture using, for example, ''glTexImage2D'', you should not pass 0 as the last argument, but ''null''.<br />
<br />
<br />
N.B: The use of color picking is '''NOT''' recommended on any hardware whose palette is partially emulated.<br />
<br />
= Java OpenGL Samples Pack =<br />
<br />
The [https://github.com/elect86/jogl-samples Java OpenGL Samples Pack] (called unsurprisingly jogl-samples) is a port of the [http://www.g-truc.net/project-0026.html OpenGL Samples Pack], a collection of OpenGL samples based on the OpenGL "core profile" specifications.<br />
<br />
The project aims to promote the new OpenGL features making easier version transitions for OpenGL programmers with a complementary documentation for the OpenGL specification. Despite the fact that the OpenGL Samples Pack provides as simple (and dumb) as possible samples, it's not a tutorial for beginner but a project for programmers already familiar with OpenGL. The OpenGL Samples Pack is also a good OpenGL drivers feature test.<br />
<br />
These samples illustrate mostly of the OpenGL features from ES 2.0 up to the last GL extenstions, same of them usually also called AZDO (Almost Zero Driver Overhead).<br />
<br />
= Wade's JOGL tutorials =<br />
* [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Cross-platform workbench program using Eclipse and JOGL]<br />
* [http://wadeawalker.wordpress.com/2010/10/17/tutorial-faster-rendering-with-vertex-buffer-objects/ Faster rendering with vertex buffer objects]<br />
* [http://wadeawalker.wordpress.com/2010/10/24/tutorial-creating-native-binary-executables-for-multi-platform-java-apps-with-opengl-and-eclipse-rcp/ Creating native binary executables for multi-platform Java apps with OpenGL and Eclipse RCP]<br />
* [http://wadeawalker.wordpress.com/2010/12/06/tutorial-displaying-java-opengl-in-an-eclipse-editor-with-a-menu-bar-and-a-runpause-button/ Displaying Java OpenGL in an Eclipse RCP editor with a menu bar and a run/pause button]<br />
<br />
= Rami's JOGL tutorials =<br />
* [http://ramisantina.com/blog/?p=8 Rami's Guide how to setup a JOGL Eclipse project]<br />
<br />
= [https://sites.google.com/site/justinscsstuff/jogl-tutorials Justin's Getting Started with JOGL 2 Tutorials] =<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]<br />
<br />
= [http://ecs.csus.edu/~gordonvs/textbook.html Gordon] and Clevenger textbook =<br />
<br />
Shader-based modern OpenGL 3D graphics programming textbook entirely in JOGL. Also works as a JOGL primer. "Computer Graphics Programming in OpenGL with Java" by V. Scott Gordon and John L. Clevenger, published by [http://www.merclearning.com/titles/Computer_Graphics_Programming.html Mercury], available at [https://www.amazon.com/Computer-Graphics-Programming-OpenGL-Java/dp/1683920279/ Amazon].<br />
<br />
= Elect86's modern OpenGL examples =<br />
<br />
* [https://github.com/elect86/modern-jogl-examples Source code on Github]<br />
<br />
= Nils Hoffmann's Netbeans Platform examples =<br />
* [https://github.com/nilshoffmann/netbeans-jogl2 Source code on Github]<br />
<br />
= Courses =<br />
* [http://www3.ntu.edu.sg/home/ehchua/programming/opengl/JOGL2.0.html Yet Another Tutorial on JOGL 2.0 - Including Nehe JOGL Port (Chua Hock-Chuan's notes at Nanyang Tech. University)]<br />
* [http://www.informatik.uni-oldenburg.de/~trigger/opengl_course.html Johannes's Courses at University of Oldenburg (German)]<br />
* [http://www.manuel-carcenac.com/courses/index.html Manuel's Courses at European University of Lefke]<br />
** [http://www.manuel-carcenac.com/courses/Graphics_in_Java/index.htm Graphics in Java incl. 3D/JOGL]<br />
** [http://www.manuel-carcenac.com/courses/Advanced_Graphics_in_Java_and_JOGL/index.htm Advanced 3D Graphics in Java and Java OpenGL (JOGL 2)]<br />
<br />
= [http://leolol.com/tutorials/graphics_tutorials.html LeoLoL.com Tutorials] (Currently unreachable) =<br />
* [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]<br />
* [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]<br />
* [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]<br />
* [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]<br />
<br />
= JOGL 1 tutorials =<br />
* [http://www.felixgers.de/teaching/jogl/ Felix's OpenGL and JOGL]<br />
<br />
== [http://www.sjonesart.com/gl.php Ste3e's JOGL tutorials] ==<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENGE3ZmZkOGItZGYzZC00ZDgzLTg0NTAtMTk1MTAwMzYxYzNk&hl=en Keys and Mouse]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEYTFiMmFiYzQtMDA0MC00ZWI0LWI1NjItODE3ZjM2OGUxOWEw&hl=en First-Person Shooter]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEZGI2NTZhZTMtYWYwNS00NTljLWFiNGQtM2UyNTYyNjAzNDYy&hl=en Vertex Buffer Objects]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENWFhODk0M2UtZDY0Ni00YWM5LWIxZGUtMzM0YzMxMmRlODgx&hl=en Shader Setup]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEMzNjNDBmMjUtNGQzNS00ODY0LWJkYmUtNDM5Y2I5ODc0Y2Nj&hl=en Texture Using Shaders]<br />
<br />
(The old (not quite up-to-date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Java3D_FAQ&diff=1983Java3D FAQ2017-05-04T11:21:30Z<p>Gouessej: </p>
<hr />
<div>* Where can I download Java3D?<br />
** http://jogamp.org/deployment/java3d/1.6.0-pre12/jogamp-java3d.7z<br />
* What else do I need to use Java3D?<br />
** http://jogamp.org/deployment/jogamp-current/archive/jogamp-all-platforms.7z JogAmp<br />
* How can I install Java3D?<br />
** Follow [https://jogamp.org/wiki/index.php/Downloading_and_installing_Java3D these instructions]<br />
* Where can I get the source code of Java3D?<br />
** https://github.com/hharrison/java3d-core - core<br />
** https://github.com/hharrison/java3d-utils - utils<br />
** https://github.com/hharrison/vecmath - vecmath<br />
* Where can I get the Java API Documentation of Java3D?<br />
** https://jogamp.org/wiki/index.php/Java3D_API_Documentation<br />
* Where can I get any help about Java3D?<br />
** You can get some help on [http://forum.jogamp.org/java3d-f3728156.html the subsection dedicated to Java3D on our forum] and on [http://jogamp.org/wiki/index.php/Chatroom#Freenode_IRC_Channel our IRC chatroom]<br />
* Where can I find any examples using Java3D?<br />
** You can find some examples using Java3D 1.7.0 on https://github.com/philjord/java3d-examples and Java3D 1.6.0 on http://www.java3d.org<br />
* Where can I report a bug in Java3D?<br />
** https://github.com/hharrison/java3d-core/issues and https://jogamp.org/bugzilla/</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Java3D_API_Documentation&diff=1982Java3D API Documentation2017-05-04T11:17:59Z<p>Gouessej: </p>
<hr />
<div>= Java3D 1.6 =<br />
<br />
The Java3D (all-in-one, i.e core + utils + vecmath) 1.6.0 API Documentation is available here:<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/javadoc/ http://jogamp.org/deployment/java3d/1.6.0-final/javadoc/]<br />
<br />
The Java3D 1.6.0 API Documentation is composed of three parts: <br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/j3dcore/javadoc/ Java3D core API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/j3dutils/javadoc/ Java3D utils API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/vecmath/javadoc/ Java3D vecmath API Documentation]<br />
<br />
= Java3D 1.7 =<br />
<br />
The Java3D (all-in-one, i.e core + utils + vecmath) 1.7.0 API Documentation is available here:<br />
<br />
[http://jogamp.org/deployment/java3d/1.7.0-pre1/javadoc/ http://jogamp.org/deployment/java3d/1.7.0-pre1/javadoc/]<br />
<br />
The Java3D 1.7.0 API Documentation is composed of three parts: <br />
<br />
[http://jogamp.org/deployment/java3d/1.7.0-pre1/j3dcore/javadoc/ Java3D core API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.7.0-pre1/j3dutils/javadoc/ Java3D utils API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.7.0-pre1/vecmath/javadoc/ Java3D vecmath API Documentation]</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Java3D_API_Documentation&diff=1981Java3D API Documentation2017-05-04T11:17:02Z<p>Gouessej: Adds the documentation of Java3D 1.7</p>
<hr />
<div>The Java3D (all-in-one, i.e core + utils + vecmath) 1.6.0 API Documentation is available here:<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/javadoc/ http://jogamp.org/deployment/java3d/1.6.0-final/javadoc/]<br />
<br />
The Java3D 1.6.0 API Documentation is composed of three parts: <br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/j3dcore/javadoc/ Java3D core API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/j3dutils/javadoc/ Java3D utils API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/vecmath/javadoc/ Java3D vecmath API Documentation]<br />
<br />
The Java3D (all-in-one, i.e core + utils + vecmath) 1.7.0 API Documentation is available here:<br />
<br />
[http://jogamp.org/deployment/java3d/1.7.0-pre1/javadoc/ http://jogamp.org/deployment/java3d/1.7.0-pre1/javadoc/]<br />
<br />
The Java3D 1.7.0 API Documentation is composed of three parts: <br />
<br />
[http://jogamp.org/deployment/java3d/1.7.0-pre1/j3dcore/javadoc/ Java3D core API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.7.0-pre1/j3dutils/javadoc/ Java3D utils API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.7.0-pre1/vecmath/javadoc/ Java3D vecmath API Documentation]</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Java3D_API_Documentation&diff=1979Java3D API Documentation2017-04-16T11:52:56Z<p>Gouessej: Provides the all-in-one Java3D API documentation</p>
<hr />
<div>The Java3D (all-in-one, i.e core + utils + vecmath) 1.6.0 API Documentation is available here:<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/javadoc/ http://jogamp.org/deployment/java3d/1.6.0-final/javadoc/]<br />
<br />
The Java3D 1.6.0 API Documentation is composed of three parts: <br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/j3dcore/javadoc/ Java3D core API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/j3dutils/javadoc/ Java3D utils API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/vecmath/javadoc/ Java3D vecmath API Documentation]</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Java3D_FAQ&diff=1978Java3D FAQ2017-04-15T11:59:11Z<p>Gouessej: Mentions the Java API Documentation</p>
<hr />
<div>* Where can I download Java3D?<br />
** http://jogamp.org/deployment/java3d/1.6.0-pre12/jogamp-java3d.7z<br />
* What else do I need to use Java3D?<br />
** http://jogamp.org/deployment/jogamp-current/archive/jogamp-all-platforms.7z JogAmp<br />
* How can I install Java3D?<br />
** Follow [https://jogamp.org/wiki/index.php/Downloading_and_installing_Java3D these instructions]<br />
* Where can I get the source code of Java3D?<br />
** https://github.com/hharrison/java3d-core - core<br />
** https://github.com/hharrison/java3d-utils - utils<br />
** https://github.com/hharrison/vecmath - vecmath<br />
* Where can I get the Java API Documentation of Java3D?<br />
** https://jogamp.org/wiki/index.php/Java3D_API_Documentation<br />
* Where can I get any help about Java3D?<br />
** You can get some help on [http://forum.jogamp.org/java3d-f3728156.html the subsection dedicated to Java3D on our forum] and on [http://jogamp.org/wiki/index.php/Chatroom#Freenode_IRC_Channel our IRC chatroom]<br />
* Where can I find any examples using Java3D?<br />
** You can find some examples using Java3D on http://www.java3d.org<br />
* Where can I report a bug in Java3D?<br />
** https://github.com/hharrison/java3d-core/issues and https://jogamp.org/bugzilla/</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Java3D_API_Documentation&diff=1977Java3D API Documentation2017-04-15T11:55:10Z<p>Gouessej: Created page with "The Java3D 1.6.0 API Documentation is composed of three parts: [http://jogamp.org/deployment/java3d/1.6.0-final/j3dcore/javadoc/ Java3D core API Documentation] [http://joga..."</p>
<hr />
<div>The Java3D 1.6.0 API Documentation is composed of three parts: <br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/j3dcore/javadoc/ Java3D core API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/j3dutils/javadoc/ Java3D utils API Documentation]<br />
<br />
[http://jogamp.org/deployment/java3d/1.6.0-final/vecmath/javadoc/ Java3D vecmath API Documentation]</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Main_Page&diff=1976Main Page2017-04-15T11:51:03Z<p>Gouessej: Adds a link to a dedicated page for the Java3D API Documentation</p>
<hr />
<div>__NOTOC__<br />
{| width="100%"<br />
|-<br />
|<br />
<div><br />
Welcome to the [{{SERVER}}/ JogAmp] wiki. It documents JOGL, JOCL and JOAL, the cross-platform bindings to the OpenGL, OpenCL, and OpenAL APIs.<br />
</div><br />
|-<br />
|<br />
{| style="width: 100%;"<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Getting Started</h3><br />
*[[Downloading and installing JOGL|Downloading and installing]]<br />
**[[Jogamp Versioning and Releases|Versioning and Releases]]<br />
*[[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
*[[Jogamp SCM Repositories|Source Code Repositories]]<br />
*[[SW Tracking|Tracking Reports]]<br />
*[{{SERVER}}/chuck/ Build and Test Server]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Community</h3><br />
*[[How to Contribute|Contribute to JogAmp]]<br />
*[[How to Build|Build JogAmp]]<br />
*[[Maintainer and Contacts]]<br />
*[[Jogl FAQ#Bugreports & Testing|Report a bug]]<br />
**[{{SERVER}}/bugzilla/ Bugzilla]<br />
*[http://forum.jogamp.org/ Ask a question in the forum]<br />
*[[chatroom|JogAmp IRC]]<br />
|}<br />
|-<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>JogAmp Modules</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Roadmaps</h3><br />
* [[SW Tracking Report Objectives for the release 2.4.0|2.4.0]]<br />
* [[SW Tracking Report Objectives for the release 2.3.3|2.3.3]], [[SW Tracking Report Objectives for the release 2.3.2|2.3.2]], [[SW Tracking Report Objectives for the release 2.3.1|2.3.1]], [[SW Tracking Report Objectives for the release 2.3.0|2.3.0]]<br />
* [[SW Tracking Report Objectives for the release 2.2.4|2.2.4]], [[SW Tracking Report Objectives for the release 2.2.3|2.2.3]], [[SW Tracking Report Objectives for the release 2.2.2|2.2.2]], [[SW Tracking Report Objectives for the release 2.2.1|2.2.1]], [[SW Tracking Report Objectives for the release 2.2.0|2.2.0]]<br />
* [[SW Tracking Report Objectives for the release 2.1.5|2.1.5]], [[SW Tracking Report Objectives for the release 2.1.4|2.1.4]], [[SW Tracking Report Objectives for the release 2.1.3|2.1.3]], [[SW Tracking Report Objectives for the release 2.1.2|2.1.2]], [[SW Tracking Report Objectives for the release 2.1.1|2.1.1]], [[SW Tracking Report Objectives for the release 2.1.0|2.1.0]]<br />
* [[SW Tracking Report Objectives for the release 2.0.2 of JOGL|2.0.2]]<br />
|-<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOGL</h3><br />
*[[Jogl Overview|Overview]] [ [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL] ]<br />
*[[Why Instance Design|Why Instance Design]]<br />
*[[Jogl Tutorial|Tutorial]]<br />
*[[Jogl FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jogl.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
*[[Jogl API Overview|API Overview]]<br />
**[[GL Debug Output|GL Debug Output]]<br />
*[{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOCL</h3><br />
*[[JOCL Overview|Overview]]<br />
*[[JOCL Tutorial|Tutorial]]<br />
*[[JOCL FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jocl.git;a=blob;f=LICENSE License]<br />
*[{{SERVER}}/deployment/jogamp-next/javadoc/jocl/javadoc/ API Doc]<br />
*[{{SERVER}}/jocl/doc/HowToBuild.html How to Build JOCL]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOAL</h3><br />
*[[Joal Overview|Overview]]<br />
*[[Joal Tutorial|Tutorial]]<br />
*[[Joal FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=joal.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc/ Public], [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc_dev/ Internal] ]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>GlueGen</h3><br />
* [[GlueGen_Wiki|Overview]]<br />
* [{{SERVER}}/git/?p=gluegen.git;a=blob;f=LICENSE.txt License]<br />
* [{{SERVER}}/deployment/jogamp-next/javadoc/gluegen/javadoc/ API Doc]<br />
|}<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>Related Projects</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Java3D</h3><br />
*[[Java3D Overview|Overview]]<br />
*[[Downloading and installing Java3D|Downloading and installing]]<br />
*[[Java3D Tutorial|Tutorial]]<br />
*[[Java3D API Documentation|API Documentation]]<br />
*[[Java3D FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ji Gong</h3><br />
*[[Ji Gong Overview|Overview]]<br />
*[[Ji Gong Motivation|Motivation]]<br />
*[[Ji Gong FAQ|FAQ]]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Source Certification Contract (SCC)</h3><br />
*[[SCC Overview|Overview]]<br />
*[[SCC FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ardor3D</h3><br />
*[[Ardor3D Overview|Overview]]<br />
*[[Ardor3D Tutorial|Tutorial]]<br />
*[http://jogamp.org/deployment/ardor3d/javadoc/ API Documentation]<br />
*[[Ardor3D FAQ|FAQ]]<br />
|}</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Downloading_and_installing_Java3D&diff=1975Downloading and installing Java3D2017-04-13T13:47:38Z<p>Gouessej: Updates the Java3D version from pre12 to final</p>
<hr />
<div>= Downloading the latest stable version =<br />
<br />
Go to [{{SERVER}}/deployment/java3d/1.6.0-final/ this page] and download the 7z archive file:<br />
<br />
: [{{SERVER}}/deployment/java3d/1.6.0-final/jogamp-java3d.7z jogamp-java3d.7z]<br />
<br />
Do the same for JogAmp as it is indicated [https://jogamp.org/wiki/index.php/Downloading_and_installing_JOGL#Downloading_the_latest_stable_version here].<br />
<br />
== Using the 7z jogamp-java3d archive ==<br />
<br />
After inflating the file with [http://www.7-zip.org/ 7zip], you will have the general directory structure:<br />
<br />
<pre><br />
&lt;jogamp-java3d&gt;/<br />
&lt;jogamp-java3d&gt;/jar/&lt;module&gt;.jar<br />
</pre><br />
<br />
While keeping the above directory structure as-is, you can go ahead and<br />
* add the JAR files to your CLASSPATH (IDE, manual, ..)<br />
* do the same for JogAmp as it is indicated [https://jogamp.org/wiki/index.php/Downloading_and_installing_JOGL#Using_the_7z_jogamp-all-platforms_archive here]<br />
<br />
.. now you are set to start using Java 3D in your project.<br />
<br />
= More information =<br />
<br />
Some very detailed instructions are available [http://gouessej.wordpress.com/2012/08/01/java-3d-est-de-retour-java-3d-is-back/ here].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=SW_Tracking_Report_Objectives_for_the_release_2.4.0&diff=1954SW Tracking Report Objectives for the release 2.4.02017-01-16T15:40:38Z<p>Gouessej: </p>
<hr />
<div>= Bugs =<br />
<br />
List started on 2015-03-06, concluding [[SW Tracking Report Objectives for the release 2.3.3|Release 2.3.3]] - '''In Progress''' - continuation @ [[SW Tracking Report Objectives for the release 2.4.1|Release 2.4.1]].<br />
<br />
Warning: WIP<br />
<br />
* [{{SERVER}}/bugzilla/buglist.cgi?cmdtype=runnamed&list_id=2214&namedcmd=Release%202.4.0 Total]<br />
* [{{SERVER}}/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=IN_PROGRESS&classification=Unclassified&classification=JogAmp&classification=Ji_Gong&known_name=Release%202.4.0%20Open%20Bugs&list_id=2228&query_based_on=Release%202.4.0%20Open%20Bugs&query_format=advanced&resolution=---&resolution=FIXED&resolution=INVALID&resolution=WONTFIX&resolution=DUPLICATE&resolution=WORKSFORME&resolution=MOVED&version=2.4.0 Open]<br />
<br />
== Features ==<br />
<br />
Please note that most features below might not get into release 2.4.0,<br />
but will be pushed back to the next release.<br />
<br />
After finalizing release 2.4.0 .. such entries will be moved to the next version's page,<br />
removed from here .. etc.<br />
<br />
=== Graph ===<br />
<br />
==== Graph UI ====<br />
<br />
[{{SERVER}}/bugzilla/showdependencytree.cgi?id=803&hide_resolved=0 Dependency Tree]<br />
<br />
[{{SERVER}}/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=IN_PROGRESS&bug_status=RESOLVED&bug_status=VERIFIED&columnlist=product%2Ccomponent%2Cassigned_to%2Cbug_status%2Cresolution%2Cversion%2Cshort_desc%2Cchangeddate&component=core&component=Plugin&list_id=2265&product=GraphUI&query_format=advanced&resolution=---&resolution=FIXED&resolution=INVALID&resolution=WONTFIX&resolution=DUPLICATE&resolution=WORKSFORME&resolution=MOVED&version=2.4.0 All GraphUI 2.4.0]<br />
<br />
{{#bugzilla:<br />
|disablecache=1<br />
|version=2.4.0<br />
|product=graphui <br />
|columns=id,product,component,priority,severity,status,resolution,summary,votes<br />
|sort=id<br />
|order=desc<br />
|noresultsmessage=We have no bugs quickly fixable to fix for this release}}<br />
<br />
==== Jogl / Graph ====<br />
<br />
[{{SERVER}}/bugzilla/showdependencytree.cgi?id=1064&hide_resolved=0 Dependency Tree Graph Font Issues]<br />
<br />
[{{SERVER}}/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=IN_PROGRESS&bug_status=RESOLVED&bug_status=VERIFIED&columnlist=product%2Ccomponent%2Cassigned_to%2Cbug_status%2Cresolution%2Cversion%2Cshort_desc%2Cchangeddate&component=graph&list_id=2264&product=Jogl&query_format=advanced&resolution=---&resolution=FIXED&resolution=INVALID&resolution=WONTFIX&resolution=DUPLICATE&resolution=WORKSFORME&resolution=MOVED&version=2.4.0 All Jogl Graph 2.4.0]<br />
<br />
{{#bugzilla:<br />
|disablecache=1<br />
|version=2.4.0<br />
|product=jogl<br />
|component=graph<br />
|columns=id,product,component,priority,severity,status,resolution,summary,votes<br />
|sort=id<br />
|order=desc<br />
|noresultsmessage=We have no bugs quickly fixable to fix for this release}}<br />
<br />
=== Vulkan ===<br />
<br />
{{#bugzilla:<br />
|disablecache=1<br />
|version=2.4.0<br />
|component=vulkan <br />
|columns=id,product,component,priority,severity,status,resolution,summary,votes<br />
|sort=id<br />
|order=desc<br />
|noresultsmessage=We have no bugs quickly fixable to fix for this release}}<br />
<br />
=== NEWT ===<br />
<br />
* [{{SERVER}}/bugzilla/showdependencytree.cgi?id=807&hide_resolved=0 Dependency Tree NEWT Input Devices]<br />
* [{{SERVER}}/bugzilla/showdependencytree.cgi?id=814&hide_resolved=0 Dependency Tree NEWT Pointer Event]<br />
<br />
{{#bugzilla:<br />
|disablecache=1<br />
|version=2.4.0<br />
|product=newt,jinput<br />
|filters=cf_type%3Dfeature<br />
|columns=id,product,component,priority,severity,status,resolution,summary,votes<br />
|sort=id<br />
|order=desc<br />
|noresultsmessage=We have no bugs quickly fixable to fix for this release}}<br />
<br />
=== Misc ===<br />
<br />
{{#bugzilla:<br />
|disablecache=1<br />
|version=2.4.0<br />
|product=!(graphui,newt)<br />
|component=!(graph,vulkan)<br />
|filters=cf_type%3Dfeature<br />
|columns=id,product,component,priority,severity,status,resolution,summary,votes<br />
|sort=id<br />
|order=desc<br />
|noresultsmessage=We have no bugs quickly fixable to fix for this release}}<br />
<br />
== Non Features ==<br />
<br />
=== Bugs to fix for this release ===<br />
<br />
{{#bugzilla:<br />
|disablecache=1<br />
|status=unconfirmed,in_progress,confirmed<br />
|version=2.4.0<br />
|filters=cf_type%3D!feature<br />
|columns=id,product,component,priority,severity,status,resolution,summary,votes<br />
|sort=id<br />
|order=desc<br />
|noresultsmessage=Lazy devs}}<br />
<br />
=== Bugs already fixed for this release ===<br />
<br />
{{#bugzilla:<br />
|disablecache=1<br />
|status=resolved,verified<br />
|version=2.4.0<br />
|filters=cf_type%3D!feature<br />
|columns=id,product,component,priority,severity,status,resolution,summary,votes<br />
|sort=id<br />
|order=desc<br />
|noresultsmessage=Lazy devs}}</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Main_Page&diff=1952Main Page2017-01-16T15:29:45Z<p>Gouessej: </p>
<hr />
<div>__NOTOC__<br />
{| width="100%"<br />
|-<br />
|<br />
<div><br />
Welcome to the [{{SERVER}}/ JogAmp] wiki. It documents JOGL, JOCL and JOAL, the cross-platform bindings to the OpenGL, OpenCL, and OpenAL APIs.<br />
</div><br />
|-<br />
|<br />
{| style="width: 100%;"<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Getting Started</h3><br />
*[[Downloading and installing JOGL|Downloading and installing]]<br />
**[[Jogamp Versioning and Releases|Versioning and Releases]]<br />
*[[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
*[[Jogamp SCM Repositories|Source Code Repositories]]<br />
*[[SW Tracking|Tracking Reports]]<br />
*[{{SERVER}}/chuck/ Build and Test Server]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Community</h3><br />
*[[How to Contribute|Contribute to JogAmp]]<br />
*[[How to Build|Build JogAmp]]<br />
*[[Maintainer and Contacts]]<br />
*[[Jogl FAQ#Bugreports & Testing|Report a bug]]<br />
**[{{SERVER}}/bugzilla/ Bugzilla]<br />
*[http://forum.jogamp.org/ Ask a question in the forum]<br />
*[[chatroom|JogAmp IRC]]<br />
|}<br />
|-<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>JogAmp Modules</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Roadmaps</h3><br />
* [[SW Tracking Report Objectives for the release 2.4.0|2.4.0]]<br />
* [[SW Tracking Report Objectives for the release 2.3.3|2.3.3]], [[SW Tracking Report Objectives for the release 2.3.2|2.3.2]], [[SW Tracking Report Objectives for the release 2.3.1|2.3.1]], [[SW Tracking Report Objectives for the release 2.3.0|2.3.0]]<br />
* [[SW Tracking Report Objectives for the release 2.2.4|2.2.4]], [[SW Tracking Report Objectives for the release 2.2.3|2.2.3]], [[SW Tracking Report Objectives for the release 2.2.2|2.2.2]], [[SW Tracking Report Objectives for the release 2.2.1|2.2.1]], [[SW Tracking Report Objectives for the release 2.2.0|2.2.0]]<br />
* [[SW Tracking Report Objectives for the release 2.1.5|2.1.5]], [[SW Tracking Report Objectives for the release 2.1.4|2.1.4]], [[SW Tracking Report Objectives for the release 2.1.3|2.1.3]], [[SW Tracking Report Objectives for the release 2.1.2|2.1.2]], [[SW Tracking Report Objectives for the release 2.1.1|2.1.1]], [[SW Tracking Report Objectives for the release 2.1.0|2.1.0]]<br />
* [[SW Tracking Report Objectives for the release 2.0.2 of JOGL|2.0.2]]<br />
|-<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOGL</h3><br />
*[[Jogl Overview|Overview]] [ [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL] ]<br />
*[[Why Instance Design|Why Instance Design]]<br />
*[[Jogl Tutorial|Tutorial]]<br />
*[[Jogl FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jogl.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
*[[Jogl API Overview|API Overview]]<br />
**[[GL Debug Output|GL Debug Output]]<br />
*[{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOCL</h3><br />
*[[JOCL Overview|Overview]]<br />
*[[JOCL Tutorial|Tutorial]]<br />
*[[JOCL FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jocl.git;a=blob;f=LICENSE License]<br />
*[{{SERVER}}/deployment/jogamp-next/javadoc/jocl/javadoc/ API Doc]<br />
*[{{SERVER}}/jocl/doc/HowToBuild.html How to Build JOCL]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOAL</h3><br />
*[[Joal Overview|Overview]]<br />
*[[Joal Tutorial|Tutorial]]<br />
*[[Joal FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=joal.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc/ Public], [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc_dev/ Internal] ]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>GlueGen</h3><br />
* [[GlueGen_Wiki|Overview]]<br />
* [{{SERVER}}/git/?p=gluegen.git;a=blob;f=LICENSE.txt License]<br />
* [{{SERVER}}/deployment/jogamp-next/javadoc/gluegen/javadoc/ API Doc]<br />
|}<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>Related Projects</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Java3D</h3><br />
*[[Java3D Overview|Overview]]<br />
*[[Downloading and installing Java3D|Downloading and installing]]<br />
*[[Java3D Tutorial|Tutorial]]<br />
*[[Java3D FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ji Gong</h3><br />
*[[Ji Gong Overview|Overview]]<br />
*[[Ji Gong Motivation|Motivation]]<br />
*[[Ji Gong FAQ|FAQ]]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Source Certification Contract (SCC)</h3><br />
*[[SCC Overview|Overview]]<br />
*[[SCC FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ardor3D</h3><br />
*[[Ardor3D Overview|Overview]]<br />
*[[Ardor3D Tutorial|Tutorial]]<br />
*[http://jogamp.org/deployment/ardor3d/javadoc/ API Documentation]<br />
*[[Ardor3D FAQ|FAQ]]<br />
|}</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Using_JOGL_in_a_Java_applet&diff=1950Using JOGL in a Java applet2016-02-04T13:42:26Z<p>Gouessej: </p>
<hr />
<div>N.B: [https://blogs.oracle.com/java-platform-group/entry/moving_to_a_plugin_free The Java Plugin is deprecated in Oracle Java 1.9], it will be removed from future JavaSE releases and it won't be supported in the major web browsers at the end of 2016. As a consequence, you are highly encouraged to stop developing Java applets.<br />
<br />
= Preface =<br />
You can use JOGL in a [http://java.sun.com/applets/ Java applet], which lets you run a Java program embedded in a web page. This page shows an example of how to do this. The example program just draws one triangle that fills a fixed-size frame in a web page.<br />
<br />
You can see online examples here: [{{SERVER}}/deployment/jogamp-current/jogl-test-applets.html JOGL Test Applets]<br />
<br />
Documented Examples using the Object/Embed tags:<br />
* Normal-Applet using native-JAR lib loading<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal-napplet.html ''Demo and modules on jogamp.org'']<br />
** [http://jausoft.com/jogamp/jogl-applet-runner-newt-gears-normal-napplet.html ''Demo on jausoft.com and modules on jogamp.org'']<br />
* JNLP-Applet w/ JNLPLauncher fallback<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal.html ''Demo and modules on jogamp.org'']<br />
** [http://jausoft.com/jogamp/jogl-applet-runner-newt-gears-normal.html ''Demo on jausoft.com and modules on jogamp.org'']<br />
* JNLPLauncher only<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal-launcheronly.html ''Demo and modules on jogamp.org'']<br />
** [http://jausoft.com/jogamp/jogl-applet-runner-newt-gears-normal-launcheronly.html ''Demo on jausoft.com and modules on jogamp.org'']<br />
<br />
A short ''copy'' is included in the static page [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NApplets JOGL Deployment as a New Applet].<br />
<br />
= Base class =<br />
<br />
We'll use the same triangle-drawing base class for this example that we did in the [https://jogamp.org/wiki/index.php/Using_JOGL_in_Java_Web_Start#Base_class Java Web Start example]. Copy the code to a file called <tt>OneTriangle.java</tt>.<br />
<br />
= Applet class =<br />
<br />
Now we need a simple class that extends <tt>java.applet.Applet</tt> to form the top level of our program. Copy this code to a file called <tt>OneTriangleAWTApplet.java</tt>.<br />
<br />
<pre><br />
package name.wadewalker.jogl2tests.onetriangle;<br />
<br />
import java.applet.*;<br />
import java.awt.*;<br />
<br />
import javax.media.opengl.GLAnimatorControl;<br />
import javax.media.opengl.GLAutoDrawable;<br />
import javax.media.opengl.GLCapabilities;<br />
import javax.media.opengl.GLEventListener;<br />
import javax.media.opengl.GLProfile;<br />
import javax.media.opengl.awt.GLCanvas;<br />
<br />
import com.jogamp.opengl.util.FPSAnimator;<br />
<br />
/**<br />
* A minimal applet that draws with JOGL in a browser window.<br />
*<br />
* @author Wade Walker<br />
*/<br />
@SuppressWarnings("serial")<br />
public class OneTriangleAWTApplet extends Applet {<br />
<br />
private GLAnimatorControl glanimatorcontrol;<br />
<br />
public void init() {<br />
GLProfile.initSingleton();<br />
setLayout( new BorderLayout() );<br />
<br />
final GLCanvas glcanvas = new GLCanvas();<br />
glcanvas.addGLEventListener( new GLEventListener() {<br />
<br />
@Override<br />
public void reshape( GLAutoDrawable glautodrawable, int x, int y, int width, int height ) {<br />
OneTriangle.setup( glautodrawable.getGL().getGL2(), width, height );<br />
}<br />
<br />
@Override<br />
public void init( GLAutoDrawable glautodrawable ) {<br />
}<br />
<br />
@Override<br />
public void dispose( GLAutoDrawable glautodrawable ) {<br />
}<br />
<br />
@Override<br />
public void display( GLAutoDrawable glautodrawable ) {<br />
OneTriangle.render( glautodrawable.getGL().getGL2(), glautodrawable.getWidth(), glautodrawable.getHeight() );<br />
}<br />
});<br />
<br />
glcanvas.setSize( getSize() );<br />
add( glcanvas, BorderLayout.CENTER );<br />
glanimatorcontrol = new FPSAnimator( glcanvas, 30 );<br />
}<br />
<br />
public void start() {<br />
glanimatorcontrol.start();<br />
}<br />
<br />
public void stop() {<br />
glanimatorcontrol.stop();<br />
}<br />
<br />
public void destroy() {<br />
}<br />
}<br />
</pre><br />
<br />
= Applet web page =<br />
<br />
Finally, the applet needs a web page to display in. Note that this file sets the fixed size of the applet window. Copy this code to a file called <tt>OneTriangleApplet.html</tt>.<br />
<br />
== Using JogAmp's Signed Jar and Jnlp Files ==<br />
<br />
The URL <code>http://jogamp.org/deployment/jogamp-current/</code> specifies<br />
JogAmp's location of released signed Jar and JNLP files.<br />
Currently supported locations are:<br />
<br />
* http://jogamp.org/deployment/jogamp-current/ - Current Release<br />
* http://jogamp.org/deployment/jogamp-next/ - Next Release<br />
* http://jogamp.org/deployment/v2.0-rc10/ - Specific Version<br />
<br />
=== [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NApplets NApplet] using native-JAR lib loading ===<br />
<br />
The html snippet, for <tt>OneTriangleNApplet.html</tt>:<br />
<pre><br />
<object classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"<br />
width="200" height="200"><br />
<param name="code" value="name.wadewalker.jogl2tests.onetriangle.OneTriangleAWTApplet"><br />
<param name="archive" value="http://jogamp.org/deployment/jogamp-current/jar/gluegen-rt.jar,<br />
http://jogamp.org/deployment/jogamp-current/jar/jogl-all.jar,<br />
onetriangle.jar"><br />
<comment><br />
<embed code="name.wadewalker.jogl2tests.onetriangle.OneTriangleAWTApplet"<br />
width="200" height="200"<br />
type="application/x-java-applet;version=1.6"<br />
pluginspage="http://java.sun.com/javase/downloads/ea.jsp"<br />
archive="http://jogamp.org/deployment/jogamp-current/jar/gluegen-rt.jar,<br />
http://jogamp.org/deployment/jogamp-current/jar/jogl-all.jar,<br />
onetriangle.jar"><br />
<noembed>Sorry, no Java support detected.</noembed><br />
</embed><br />
</comment><br />
</object><br />
</pre><br />
<br />
Examples:<br />
* [http://jausoft.com/jogamp/jogl-applet-runner-newt-gears-normal-napplet.html ''Demo on jausoft.com and modules on jogamp.org'']<br />
* [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal-napplet.html ''Demo and modules on jogamp.org'']<br />
<br />
=== JNLP-Applet w/ [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NApplets NApplet] fallback ===<br />
<br />
The html snippet, for <tt>OneTriangleApplet.html</tt>:<br />
<pre><br />
<object classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"<br />
width="200" height="200"><br />
<param name="code" value="name.wadewalker.jogl2tests.onetriangle.OneTriangleAWTApplet"><br />
<param name="archive" value="http://jogamp.org/deployment/jogamp-current/jar/gluegen-rt.jar,<br />
http://jogamp.org/deployment/jogamp-current/jar/jogl-all.jar,<br />
onetriangle.jar"><br />
<param name="jnlp_href" value="OneTriangleApplet.jnlp"><br />
<comment><br />
<embed code="name.wadewalker.jogl2tests.onetriangle.OneTriangleAWTApplet"<br />
width="200" height="200"<br />
type="application/x-java-applet;version=1.6"<br />
pluginspage="http://java.sun.com/javase/downloads/ea.jsp"<br />
archive="http://jogamp.org/deployment/jogamp-current/jar/gluegen-rt.jar,<br />
http://jogamp.org/deployment/jogamp-current/jar/jogl-all.jar,<br />
onetriangle.jar"<br />
jnlp_href="OneTriangleApplet.jnlp"><br />
<noembed>Sorry, no Java support detected.</noembed><br />
</embed><br />
</comment><br />
</object><br />
</pre><br />
<br />
<tt>OneTriangleApplet.jnlp</tt>:<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<jnlp spec="1.0+" codebase="./"<br />
href="OneTriangleApplet.jnlp"><br />
<br />
<information><br />
<title>OneTriangle Demo</title><br />
<vendor>JogAmp Community</vendor><br />
<homepage href="http://jogamp.org/"/><br />
<description>OneTriangle Java Web Start Demo</description><br />
<description kind="short">The simplest possible JOGL Java Web Start demo - draws one triangle.</description><br />
<offline-allowed/><br />
</information><br />
<update check="background" policy="always"/><br />
<br />
<resources><br />
<j2se href="http://java.sun.com/products/autodl/j2se" version="1.4+"/><br />
<extension name="jogl-all-awt" href="http://jogamp.org/deployment/jogamp-current/jogl-all-awt.jnlp" /><br />
<jar href="onetriangle.jar" main="true"/><br />
</resources><br />
<br />
<applet-desc <br />
name="OneTriangle Applet"<br />
main-class="name.wadewalker.jogl2tests.onetriangle.OneTriangleAWTApplet"<br />
width="200" <br />
height="200"><br />
</applet-desc><br />
</jnlp><br />
</pre><br />
<br />
Examples:<br />
** [http://jausoft.com/jogamp/jogl-applet-runner-newt-gears-normal.html ''Demo on jausoft.com and modules on jogamp.org'']<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal.html ''Demo and modules on jogamp.org'']<br />
<br />
If you decide to use our JogAmp signed Jar and Jnlp files you can skip the next chapter.<br />
<br />
== Using Your own Signed Jar and Jnlp Files ==<br />
<br />
In case you prefer to use your own JogAmp files, just replace the above JogAmp URL <br />
with your own and sign the Jar files of your JogAmp files with your own valid key, or test key as described below.<br />
Don't sign your own applet code's JAR file(s).<br />
<br />
= Setting up the applet directory =<br />
<br />
Note that none of your applet Jar files needs to be signed. Only the Jogamp files (GlueGen, JOGL, ..) require code signing.<br />
<br />
* Create a directory to hold your applet.<br />
* Put your <tt>OneTriangleApplet.html</tt> file in that new directory.<br />
* Create a subdirectory <tt>name/wadewalker/jogl2tests/onetriangle</tt> inside your applet directory. Or if you changed the packages of the files above, create a subdirectory that matches your package names.<br />
* Put your <tt>OneTriangle.java</tt> and <tt>OneTriangleAWT.java</tt> files inside the subdirectory.<br />
<br />
If you decide to use our JogAmp signed Jar and Jnlp files you can skip the next chapter.<br />
<br />
== Using Your own Signed Jar and Jnlp Files ==<br />
* Copy all the JogAmp Jar files ([[{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#GluegenJARs|GlueGen]] and [[{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#JOGLAllInOneJARs|JOGL]]) into the applet directory as described [https://jogamp.org/wiki/index.php/Using_JOGL_in_Java_Web_Start#Setting_up_the_application_directory here] and sign them (see below).<br />
* Copy <tt>applet-launcher.jar</tt> into the applet directory and sign it (see below). Currently this file is not part of the JOGL distribution. I built it from source I downloaded from [https://github.com/sgothel/applet-launcher Sven's repository].<br />
* Copy the JogAmp [[{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#JNLPFiles|Jnlp files]] into that applet directory<br />
<br />
=== Signing the JogAmp Jar Files ===<br />
<br />
All the JogAmp Jar files your applet uses must be signed to work correctly in a web browser. Do this just as in the [https://jogamp.org/wiki/index.php/Using_JOGL_in_Java_Web_Start#Signing_your_JARs Java Web Start case], with one addition for the applet launcher JAR:<br />
<br />
<pre><br />
jarsigner -keystore testKeys applet-launcher.jar ww<br />
</pre><br />
<br />
= Compiling and JARing your program =<br />
<br />
You can compile and JAR the program exactly as we did for the [https://jogamp.org/wiki/index.php/Using_JOGL_in_Java_Web_Start#Compiling_and_JARing_your_program Java Web Start case].<br />
<br />
= Writing the JNLP files =<br />
<br />
New-style Java applets use two [http://download.oracle.com/javase/1,5.0/docs/guide/javaws/developersguide/syntax.html Java Network Launching Protocol (JNLP)] files to find the JAR files that make up the applet. Create both JNLP files exactly as in the [https://jogamp.org/wiki/index.php/Using_JOGL_in_Java_Web_Start#Writing_the_JNLP_files Java Web Start case].<br />
<br />
= Running the applet in a browser =<br />
<br />
To run the applet in a browser on Windows, right-click the <tt>OneTriangleApplet.html</tt> file and click "Open with > Internet Explorer|Chrome|Firefox|Safari". The result should look like this:<br />
<br />
[[File:Applet-browser-test.png|300px|thumb|none|Applet OneTriangle in IE 9]]<br />
<br />
= Clearing the applet cache =<br />
<br />
Java caches applet JAR and JNLP files to reduce load time. Unfortunately, if you edit one of these files and re-launch, sometimes you won't see your changes because Java is still using the cached copy.<br />
<br />
* To clear the cache on Windows:<br />
** From the control panel: click <tt>Start > Control Panel > Java</tt>, then click <tt>Temporary Internet Files</tt>, click <tt> Settings...</tt>, click <tt>Delete Files...</tt>, and click <tt>OK</tt>.<br />
** From the command line: delete <tt>%USERPROFILE%\AppData\LocalLow\Sun\Java\Deployment\cache</tt>.<br />
<br />
* To clear the cache on Mac OS X:<br />
** From the control panel: click <tt>Dock > Applications > Utilities > Java Preferences.app</tt>, then click the <tt>Network tab</tt>, click <tt>Delete Files...</tt>, and click <tt>OK</tt>.<br />
** From the command line: delete <tt>~/Library/Caches/Java/cache</tt><br />
<br />
The JNLPAppletLauncher (if it's used) may also cache files. You can clear its cache on Windows by deleting <tt>%USERPROFILE%\.jnlp-applet</tt>, and on Mac OS X by deleting <tt>~/.jnlp-applet</tt>.<br />
<br />
= Running the applet with the Java applet viewer =<br />
<br />
The Java JDK comes with a program called <tt>appletviewer</tt>, which you can use to launch your applet from the command line without the use of a browser. This viewer works the way that older Java browser plugins used to work (and the way Safari's plugin still works), so it can help test compatibility.<br />
<br />
When you launch with <tt>appletviewer</tt>, it also uses the <tt>JNLPAppletLauncher</tt> class that we specified in <tt>OneTriangleApplet.html</tt>, which the newer Java plugins seem to ignore.<br />
<br />
The downside of that is the <tt>JNLPAppletLauncher</tt> doesn't yet support relative paths, so you'll need to change the value of <tt>jnlpExtension1</tt> in <tt>OneTriangleApplet.html</tt> from <tt>"./"</tt> to an absolute path like <tt>"file://localhost/C:/Users/my/applet/dir/JOGL.jnlp"</tt>, and the value of <tt>codebase</tt> in <tt>JOGL.jnlp</tt> from <tt>"./"</tt> to an absolute path like <tt>"file://localhost/C:/Users/my/applet/dir/"</tt>.<br />
<br />
Then, to give the applet the permissions it needs to run outside the browser, create a file named <tt>all.policy</tt> in your applet directory, and put this text in it:<br />
<br />
<pre><br />
grant {<br />
permission java.security.AllPermission;<br />
};<br />
</pre><br />
<br />
Then finally you can launch the applet from the command line like this:<br />
<br />
<tt>appletviewer -J-Djava.security.policy=all.policy OneTriangleApplet.html</tt><br />
<br />
The result should look like this:<br />
<br />
[[File:applet-viewer-test.png|300px|thumb|none|Applet OneTriangle in appletviewer]]<br />
<br />
You can also use the applet viewer to remotely debug your code like this:<br />
<br />
<tt>appletviewer -J-Djava.security.policy=all.policy -J-Xdebug -J-Djava.compiler=NONE -J-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 OneTriangleApplet.html</tt><br />
<br />
When you hit return, the applet will suspend on startup, so you can connect to the applet process with your debugger of choice.<br />
<br />
= Running the applet from inside Eclipse =<br />
<br />
'''*This section is unfinished*'''<br />
<br />
If you set up your applet as an Eclipse project, you can run it in the applet viewer by right-clicking the applet project and clicking "Run As > Java Applet". This is similar to running the applet via <tt>appletviewer</tt> on the command line, but allows local instead of remote debugging.<br />
<br />
= Running the applet from a web server =<br />
<br />
'''*This section is unfinished*'''<br />
<br />
Once you're sure that the applet launches correctly from the local file system, you're ready to deploy it to a web server.<br />
<br />
* Create or choose an applet directory on your web server.<br />
* Change the <tt>codebase</tt> entries in the JNLP from directory names to URLs that refer to the applet directory on your web server.<br />
* Copy all the HTML, JAR, and JNLP files from your local applet directory to the applet directory on your web server.<br />
* Put a link to the <tt>OneTriangleApplet.html</tt> file on a page on your web server so users can find your applet page.</div>Gouessejhttps://jogamp.org/wiki/index.php?title=JogAmp_JAR_File_Handling&diff=1930JogAmp JAR File Handling2015-11-04T09:09:53Z<p>Gouessej: /* Ant */ Adds the missing inclusion filters into the zip fileset in order to repair Windows support as it relies on these executables</p>
<hr />
<div>= Native JAR Files =<br />
<br />
See [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NativeJARFiles Native JAR Files] explained.<br />
<br />
Native JAR files are loaded [{{SERVER}}/jogl/doc/userguide/index.html#automatednativelibraryloading automatically].<br />
<br />
= Applet / JNLP Usage =<br />
<br />
* [[Using JOGL in a Java applet|Using JOGL in a Java Applet]]<br />
* [[Using JOGL in Java Web Start|Using JOGL in Java Web Start]]<br />
<br />
A short ''copy'' is included in the static page [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NApplets JOGL Deployment using NApplet].<br />
<br />
= Custom Bundling =<br />
<br />
== Multi-Jar ==<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=843 Multi-Jar]<br />
<br />
This configuration is discouraged, since such deployment removes our artifacts as stored in<br />
the jar's manifest file, which helps identifying the jogamp modules for bug reports etc.<br />
<br />
However, since we don't want to patronize our user base, we support this feature with our native JAR lib loading mechanism. <br />
<br />
It is possible to merge all modules together, i.e.<br />
<br />
multi.jar:<br />
gluegen-rt.jar<br />
jogl-all.jar<br />
user-app.jar<br />
<br />
multi-natives-<os.and.arch>.jar:<br />
gluegen-rt-natives-<os.and.arch>.jar<br />
jogl-all-natives-<os.and.arch>.jar<br />
<br />
A combination with Fat-Jar is possible.<br />
<br />
== Fat-Jar ==<br />
<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=845 Discouraged Fat-Jar]<br />
<br />
This configuration is discouraged, since such deployment removes our artifacts as stored in<br />
the jar's manifest file, which helps identifying the jogamp modules for bug reports etc.<br />
<br />
Furthermore, adding all native library files for all supported platforms<br />
will add-up to +3M of _compressed_ jar data!<br />
<br />
However, since we don't want to patronize our user base, <br />
we support this feature with our native JAR lib loading mechanism.<br />
<br />
=== Usage ===<br />
<br />
If the modules's jar file contains the folder 'natives/<os.and.arch>/'<br />
we assume a fat-jar and attempt to load all native libraries from the same.<br />
<br />
If we don't have a fat-jar or if fat-jar loading doesn't result in extracted native libraries,<br />
we assume a regular slim jar file.<br />
<br />
Layout:<br />
<br />
/com/lala1/Lala1.class<br />
/com/lala2/Lala2.class<br />
/natives/<os.and.arch>/libLala1.so<br />
/natives/<os.and.arch>/libLala2.so<br />
<br />
A combination w/ Multi-Jar is of course possible.<br />
<br />
=== Creation ===<br />
<br />
==== Ant ====<br />
You can use the [http://ant.apache.org/manual/Tasks/jar.html Ant jar task] to create a fat JAR. You must avoid file names collision, i.e you must exclude the file(s) with the same name(s) in multiple JARs. You can use [https://ant.apache.org/manual/Tasks/manifest.html Ant manifest task] to create a manifest file. The following line just keeps the strict minimum to make JogAmp work and should be used with the [http://ant.apache.org/manual/Tasks/jar.html Ant jar task]:<br />
<br />
<zipfileset src="jogamp-fat.jar" includes="**/*.class,**/*.png,**/*.glsl,**/*.vp,**/*.fp,**/*.bvp,**/*.bfp,**/*.so,**/*.jnilib,**/*.dylib,**/*.dll,**/*.bin,**/*.defl"/><br />
<br />
==== Maven ====<br />
[http://maven.apache.org/plugins/maven-shade-plugin/index.html Maven Shade Plugin] is the recommended plugin to use to create fat JARs with [http://maven.apache.org Maven]. [http://maven.apache.org/plugins/maven-shade-plugin/examples/executable-jar.html This example] shows how to set some entries in the manifest file.<br />
<br />
==== Maven Assembly Plugin ====<br />
<br />
An example descriptor file that produces a fat jar containing all of the calling project's dependencies, and the JOGL/GlueGen native jar files placed into the correct directory inside the jar:<br />
<br />
<pre><br />
<assembly<br />
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"<br />
xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0"<br />
xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 http://maven.apache.org/xsd/assembly-1.1.0.xsd"><br />
<br />
<id>with-dependencies</id><br />
<includeBaseDirectory>false</includeBaseDirectory><br />
<br />
<formats><br />
<format>jar</format><br />
</formats><br />
<br />
<dependencySets><br />
<br />
<!-- Unpack everything that isn't a JOGL or GlueGen library --><br />
<dependencySet><br />
<outputDirectory>/</outputDirectory><br />
<useProjectArtifact>true</useProjectArtifact><br />
<scope>runtime</scope><br />
<unpack>true</unpack><br />
<unpackOptions><br />
<excludes><br />
<exclude>libgluegen-rt*</exclude><br />
<exclude>libjogl_desktop.*</exclude><br />
<exclude>libjogl_mobile.*</exclude><br />
<exclude>libnativewindow_awt.*</exclude><br />
<exclude>libnativewindow_macosx.*</exclude><br />
<exclude>libnativewindow_x11.*</exclude><br />
<exclude>libnewt.*</exclude><br />
</excludes><br />
</unpackOptions><br />
</dependencySet><br />
<br />
<!-- Place the natives for the popular platforms into the correct place --><br />
<!-- in the resulting jar file. --><br />
<br />
<dependencySet><br />
<outputDirectory>/natives/linux-amd64/</outputDirectory><br />
<useProjectArtifact>true</useProjectArtifact><br />
<scope>runtime</scope><br />
<unpack>true</unpack><br />
<includes><br />
<include>org.jogamp.gluegen:gluegen-rt:jar:natives-linux-amd64</include><br />
<include>org.jogamp.jogl:jogl-all:jar:natives-linux-amd64</include><br />
</includes><br />
<unpackOptions><br />
<includes><include>*.so</include></includes><br />
</unpackOptions><br />
</dependencySet><br />
<br />
<dependencySet><br />
<outputDirectory>/natives/linux-i586/</outputDirectory><br />
<useProjectArtifact>true</useProjectArtifact><br />
<scope>runtime</scope><br />
<unpack>true</unpack><br />
<includes><br />
<include>org.jogamp.gluegen:gluegen-rt:jar:natives-linux-i586</include><br />
<include>org.jogamp.jogl:jogl-all:jar:natives-linux-i586</include><br />
</includes><br />
<unpackOptions><br />
<includes><include>*.so</include></includes><br />
</unpackOptions><br />
</dependencySet><br />
<br />
<dependencySet><br />
<outputDirectory>/natives/windows-amd64/</outputDirectory><br />
<useProjectArtifact>true</useProjectArtifact><br />
<scope>runtime</scope><br />
<unpack>true</unpack><br />
<includes><br />
<include>org.jogamp.gluegen:gluegen-rt:jar:natives-windows-amd64</include><br />
<include>org.jogamp.jogl:jogl-all:jar:natives-windows-amd64</include><br />
</includes><br />
<unpackOptions><br />
<includes><include>*.dll</include></includes><br />
</unpackOptions><br />
</dependencySet><br />
<br />
<dependencySet><br />
<outputDirectory>/natives/windows-i586/</outputDirectory><br />
<useProjectArtifact>true</useProjectArtifact><br />
<scope>runtime</scope><br />
<unpack>true</unpack><br />
<includes><br />
<include>org.jogamp.gluegen:gluegen-rt:jar:natives-windows-i586</include><br />
<include>org.jogamp.jogl:jogl-all:jar:natives-windows-i586</include><br />
</includes><br />
<unpackOptions><br />
<includes><include>*.dll</include></includes><br />
</unpackOptions><br />
</dependencySet><br />
<br />
<dependencySet><br />
<outputDirectory>/natives/macosx-universal/</outputDirectory><br />
<useProjectArtifact>true</useProjectArtifact><br />
<scope>runtime</scope><br />
<unpack>true</unpack><br />
<includes><br />
<include>org.jogamp.gluegen:gluegen-rt:jar:natives-macosx-universal</include><br />
<include>org.jogamp.jogl:jogl-all:jar:natives-macosx-universal</include><br />
</includes><br />
<unpackOptions><br />
<includes><include>*.jnilib</include></includes><br />
</unpackOptions><br />
</dependencySet><br />
</dependencySets><br />
</assembly><br />
</pre><br />
<br />
This can be called in the usual manner (assuming that the descriptor file is in <tt>src/main/assembly/application.xml</tt>):<br />
<br />
<pre><br />
<plugin><br />
<artifactId>maven-assembly-plugin</artifactId><br />
<configuration><br />
<archive><br />
<manifest><br />
<mainClass>com.example.main.SomeMainClassHere</mainClass><br />
</manifest><br />
</archive><br />
<descriptors><br />
<descriptor>src/main/assembly/application.xml</descriptor><br />
</descriptors><br />
</configuration><br />
<executions><br />
<execution><br />
<id>make-assembly</id><br />
<phase>package</phase><br />
<goals><br />
<goal>single</goal><br />
</goals><br />
</execution><br />
</executions><br />
</plugin><br />
</pre><br />
<br />
The result is an executable jar file, suffixed with <tt>-with-dependencies.jar</tt> that will execute <tt>com.example.main.SomeMainClassHere</tt> and that will correctly find all of the native libraries at run-time.<br />
<br />
== One-Jar ==<br />
<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=846 One-Jar]<br />
<br />
One-Jar is incomplete, i.e. it does not provide a URL handler for <br />
it's jar-in-jar resources - hence we would need to implement this functionality manually.<br />
<br />
See [{{SERVER}}/bugzilla/show_bug.cgi?id=846#c1 One-Jar lacks of URLHandler ...]<br />
<br />
For now, one can use Eclipse working jar-in-jar feature (see below).<br />
Since Eclipse is under an open source license, one should be able<br />
to locate the source code and include in a standalone toolkit, if so required.<br />
<br />
== JarMatey ==<br />
<br />
[http://staticvoidgames.com/JarMatey/ JarMatey] is an [https://github.com/KevinWorkman/JarMatey open source] tool for creating standalone self-executing JARs, similar to One-Jar but with a graphical user interface and no support for build tools (Ant, Maven). You can find a detailed tutorial about it [http://staticvoidgames.com/tutorials/deployment/joglExample here].<br />
<br />
== Eclipse ==<br />
<br />
Native JAR files and their respective base JAR files can be bundled in [{{SERVER}}/bugzilla/show_bug.cgi?id=522#c7 custom ways, e.g. eclipse Jar-In-Jar etc].<br />
<br />
Manual tested w/ Eclipse:<br />
<br />
Preparations:<br />
===============<br />
<br />
1) Set up a vanilla eclipse (3.7.0) workspace<br />
<br />
2) Add the JOGL User Library:<br />
- Window.Preference<br />
- Java.Build_Path.User_Libraries:<br />
+ JOGL<br />
+ gluegen-rt.jar<br />
+ jogl-all.jar<br />
+ gluegen-rt-natives-linux-amd64.jar<br />
+ jogl-all-natives-linux-amd64.jar<br />
<br />
You may add all other native JARs here.<br />
Note that these are not required in the CLASSPATH by JOGL,<br />
however, they are required by Eclipse to export your project as a Runnable JAR File.<br />
<br />
3) New test project<br />
- Right-click your project in the Package Explorer and click "Properties".<br />
- Select "Java Build Path" and click the "Libraries" tab.<br />
+ JOGL<br />
- Add some simple code ..<br />
- Run as Java Application ..<br />
<br />
Test-1:<br />
=========<br />
<br />
Export<br />
- Right-click your project in the Package Explorer and click "Export"<br />
- Select Java.Runnable_JAR_file<br />
+ Launch configuration<br />
+ some destination path<br />
+ Library handling:<br />
Copy required libraries into a sub-folder next to the generated JAR<br />
<br />
Result: Works!<br />
<br />
./lala01.jar<br />
./lala01_lib/jogl-all.jar<br />
./lala01_lib/jogl-all-natives-linux-amd64.jar<br />
./lala01_lib/... etc ..<br />
<br />
Test-2:<br />
=========<br />
<br />
Export<br />
- Right-click your project in the Package Explorer and click "Export"<br />
- Select Java.Runnable_JAR_file<br />
+ Launch configuration<br />
+ some destination path<br />
+ Library handling:<br />
Package required libraries into generated JAR<br />
<br />
Result: Works!<br />
<br />
./lala02.jar:<br />
Manifest-Version: 1.0<br />
Rsrc-Class-Path: ./ gluegen-rt-natives-linux-amd64.jar gluegen-rt.jar<br />
jogl-all-natives-linux-amd64.jar jogl-all.jar<br />
Class-Path: .<br />
Rsrc-Main-Class: Test01<br />
Main-Class: org.eclipse.jdt.internal.jarinjarloader.JarRsrcLoader</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Downloading_and_installing_Java3D&diff=1923Downloading and installing Java3D2015-10-24T21:55:34Z<p>Gouessej: /* Downloading the latest stable version */</p>
<hr />
<div>= Downloading the latest stable version =<br />
<br />
Go to [{{SERVER}}/deployment/java3d/1.6.0-pre12/ this page] and download the 7z archive file:<br />
<br />
: [{{SERVER}}/deployment/java3d/1.6.0-pre12/jogamp-java3d.7z jogamp-java3d.7z]<br />
<br />
Do the same for JogAmp as it is indicated [https://jogamp.org/wiki/index.php/Downloading_and_installing_JOGL#Downloading_the_latest_stable_version here].<br />
<br />
== Using the 7z jogamp-java3d archive ==<br />
<br />
After inflating the file with [http://www.7-zip.org/ 7zip], you will have the general directory structure:<br />
<br />
<pre><br />
&lt;jogamp-java3d&gt;/<br />
&lt;jogamp-java3d&gt;/jar/&lt;module&gt;.jar<br />
</pre><br />
<br />
While keeping the above directory structure as-is, you can go ahead and<br />
* add the JAR files to your CLASSPATH (IDE, manual, ..)<br />
* do the same for JogAmp as it is indicated [https://jogamp.org/wiki/index.php/Downloading_and_installing_JOGL#Using_the_7z_jogamp-all-platforms_archive here]<br />
<br />
.. now you are set to start using Java 3D in your project.<br />
<br />
= More information =<br />
<br />
Some very detailed instructions are available [http://gouessej.wordpress.com/2012/08/01/java-3d-est-de-retour-java-3d-is-back/ here].</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Java3D_FAQ&diff=1922Java3D FAQ2015-10-16T23:34:40Z<p>Gouessej: </p>
<hr />
<div>* Where can I download Java3D?<br />
** http://jogamp.org/deployment/java3d/1.6.0-pre12/jogamp-java3d.7z<br />
* What else do I need to use Java3D?<br />
** http://jogamp.org/deployment/jogamp-current/archive/jogamp-all-platforms.7z JogAmp<br />
* How can I install Java3D?<br />
** Follow [https://jogamp.org/wiki/index.php/Downloading_and_installing_Java3D these instructions]<br />
* Where can I get the source code of Java3D?<br />
** https://github.com/hharrison/java3d-core - core<br />
** https://github.com/hharrison/java3d-utils - utils<br />
** https://github.com/hharrison/vecmath - vecmath<br />
* Where can I get any help about Java3D?<br />
** You can get some help on [http://forum.jogamp.org/java3d-f3728156.html the subsection dedicated to Java3D on our forum] and on [http://jogamp.org/wiki/index.php/Chatroom#Freenode_IRC_Channel our IRC chatroom]<br />
* Where can I find any examples using Java3D?<br />
** You can find some examples using Java3D on http://www.java3d.org<br />
* Where can I report a bug in Java3D?<br />
** https://github.com/hharrison/java3d-core/issues and https://jogamp.org/bugzilla/</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Jogl_Tutorial&diff=1860Jogl Tutorial2015-09-23T10:59:32Z<p>Gouessej: /* JogAmp's Static */</p>
<hr />
<div>= JogAmp's Static =<br />
* [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
* [{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
* [{{SERVER}}/jogl/doc/userguide/ Userguide]<br />
* [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html Deployment]<br />
* [{{SERVER}}/deployment/jogamp-current/jogl-test-applets.html JOGL Test Applets]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal.html using Object/Embed tags]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-demos/applet-gears.html using the Applet Tag]<br />
* [{{SERVER}}/jogl/doc/NEWT-Overview.html NEWT - High Performance Native Windowing Toolkit]<br />
* [{{SERVER}}/git/?p=jogl-demos.git;a=blob;f=src/demos/es2/RawGL2ES2demo.java;hb=HEAD OpenGL GL2ES2 GLSL Standalone Example by Xerxes Rånby]<br />
* [https://gist.github.com/gouessej/3420e2b6f632efdddf98 Rudimentary standalone example using the fixed pipeline by Julien Gouesse]<br />
* [https://gist.github.com/xranby/ccbcfcaef341f5bd1ba8 Rudimentary standalone example using the fixed pipeline with OpenGL ES 1 by Xerxes Rånby]<br />
<br />
= JogAmp's Wiki =<br />
* [[Downloading and installing JOGL|Downloading and installing JOGL]]<br />
** [[Jogamp_Versioning_and_Releases|Versioning And Release Information]]<br />
* [[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
* Deployment<br />
** [[JogAmp JAR File Handling|JAR File Handling]]<br />
** [[Using JOGL in a Java applet|Using JOGL in a Java Applet]]<br />
** [[Using JOGL in Java Web Start|Using JOGL in Java Web Start]]<br />
** [[Foreign Packaging|Foreign Packaging]]<br />
* JOGL<br />
** [[How to write cross GLProfile compatible shader using JOGL]]<br />
** [[How to use the Debug and Trace GL Pipeline and Debug GL Context]]<br />
** [[Using JOGL in AWT SWT and Swing|Using JOGL in AWT, SWT, and Swing]]<br />
** [[How to use X11 displays]]<br />
* [[Jogl_FAQ|FAQ]]<br />
<br />
= Hello Triangle =<br />
[https://github.com/elect86/jogl-samples/blob/master/jogl-samples/src/helloTriangle/HelloTriangle.java Simple sample] that features GL4, pure newt, glWindow options, animator, indexed drawing, dinamic attribute and frag data binding, interleaved data, vao, vbo (with normalization on one attribute), ibo (with shorts), uniform, glsl program (with specific suffix) and matrix jogl util, gl error check, key listener and right way to dispose.<br />
<br />
= Common Mistakes =<br />
I suggest you to take a read to these two pages for a quick overview over the most common problems, it is a very useful reading, legacy sections are carefully signaled.<br />
<br />
[https://www.opengl.org/wiki/Common_Mistakes OpenGL]<br />
[https://www.opengl.org/wiki/GLSL_:_common_mistakes GLSL]<br />
<br />
N.B: The use of color picking is '''NOT''' recommended on any hardware whose palette is partially emulated.<br />
<br />
= Wade's JOGL tutorials =<br />
* [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Cross-platform workbench program using Eclipse and JOGL]<br />
* [http://wadeawalker.wordpress.com/2010/10/17/tutorial-faster-rendering-with-vertex-buffer-objects/ Faster rendering with vertex buffer objects]<br />
* [http://wadeawalker.wordpress.com/2010/10/24/tutorial-creating-native-binary-executables-for-multi-platform-java-apps-with-opengl-and-eclipse-rcp/ Creating native binary executables for multi-platform Java apps with OpenGL and Eclipse RCP]<br />
* [http://wadeawalker.wordpress.com/2010/12/06/tutorial-displaying-java-opengl-in-an-eclipse-editor-with-a-menu-bar-and-a-runpause-button/ Displaying Java OpenGL in an Eclipse RCP editor with a menu bar and a run/pause button]<br />
<br />
= Rami's JOGL tutorials =<br />
* [http://ramisantina.com/blog/?p=8 Rami's Guide how to setup a JOGL Eclipse project]<br />
<br />
= [https://sites.google.com/site/justinscsstuff/jogl-tutorials Justin's Getting Started with JOGL 2 Tutorials] =<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]<br />
<br />
= Elect86's modern OpenGL examples =<br />
<br />
* [https://github.com/elect86/modern-jogl-examples Source code on Github]<br />
<br />
= Nils Hoffmann's Netbeans Platform examples =<br />
* [https://github.com/nilshoffmann/netbeans-jogl2 Source code on Github]<br />
<br />
= Courses =<br />
* [http://www3.ntu.edu.sg/home/ehchua/programming/opengl/JOGL2.0.html Yet Another Tutorial on JOGL 2.0 - Including Nehe JOGL Port (Chua Hock-Chuan's notes at Nanyang Tech. University)]<br />
* [http://www.informatik.uni-oldenburg.de/~trigger/opengl_course.html Johannes's Courses at University of Oldenburg (German)]<br />
* [http://www.manuel-carcenac.com/courses/index.html Manuel's Courses at European University of Lefke]<br />
** [http://www.manuel-carcenac.com/courses/Graphics_in_Java/index.htm Graphics in Java incl. 3D/JOGL]<br />
** [http://www.manuel-carcenac.com/courses/Advanced_Graphics_in_Java_and_JOGL/index.htm Advanced 3D Graphics in Java and Java OpenGL (JOGL 2)]<br />
<br />
= [http://leolol.com/tutorials/graphics_tutorials.html LeoLoL.com Tutorials] (Currently unreachable) =<br />
* [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]<br />
* [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]<br />
* [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]<br />
* [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]<br />
<br />
= JOGL 1 tutorials =<br />
* [http://www.felixgers.de/teaching/jogl/ Felix's OpenGL and JOGL]<br />
<br />
== [http://www.sjonesart.com/gl.php Ste3e's JOGL tutorials] ==<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENGE3ZmZkOGItZGYzZC00ZDgzLTg0NTAtMTk1MTAwMzYxYzNk&hl=en Keys and Mouse]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEYTFiMmFiYzQtMDA0MC00ZWI0LWI1NjItODE3ZjM2OGUxOWEw&hl=en First-Person Shooter]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEZGI2NTZhZTMtYWYwNS00NTljLWFiNGQtM2UyNTYyNjAzNDYy&hl=en Vertex Buffer Objects]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENWFhODk0M2UtZDY0Ni00YWM5LWIxZGUtMzM0YzMxMmRlODgx&hl=en Shader Setup]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEMzNjNDBmMjUtNGQzNS00ODY0LWJkYmUtNDM5Y2I5ODc0Y2Nj&hl=en Texture Using Shaders]<br />
<br />
(The old (not quite up-to-date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Foreign_Packaging&diff=1857Foreign Packaging2015-09-16T11:11:34Z<p>Gouessej: Redline with Maven</p>
<hr />
<div>'''N.B: This article is subject to changes and is incomplete.'''<br />
<br />
We assume that the application is packaged as a [http://jogamp.org/wiki/index.php/JogAmp_JAR_File_Handling#Fat-Jar fat JAR] called "user-app.jar" for the sake of simplicity.<br />
<br />
= Red Hat Package Manager =<br />
<br />
[http://www.rpm.org RPM] (Red Hat Package Manager) is the default package management system under Red Hat, Fedora, Mageia, Mandriva, OpenSUSE, Oracle Linux, ...<br />
<br />
== Platform dependent tools ==<br />
<br />
The following tools only work under GNU Linux or other Unix platforms with native rpm support.<br />
<br />
[http://www.rpm.org/max-rpm-snapshot/rpmbuild.8.html rpmbuild] can be used to build RPMs. You can find more information about RPM packaging in the [http://www.rpm.org/wiki/Docs#PackagerDocumentation official documentation].<br />
<br />
The build tool [http://ant.apache.org Ant] can call this command when you use its [http://ant.apache.org/manual/Tasks/rpm.html RPM task]. The build system [http://maven.apache.org Maven] does the same with its [http://mojo.codehaus.org/rpm-maven-plugin/ RPM plugin].<br />
<br />
== Cross-platform tools ==<br />
<br />
=== jRPM ===<br />
<br />
[http://jrpm.sourceforge.net jRPM] is a pure Java library for manipulating RPM packages.<br />
<br />
=== Redline ===<br />
[http://redline-rpm.org Redline RPM] is a pure Java library for manipulating RPM packages. It can be use in command line, with [http://ant.apache.org Ant] and with [http://maven.apache.org Maven].<br />
<br />
Redline requires [http://commons.apache.org/proper/commons-compress/download_compress.cgi Apache Commons Compress], [http://www.bouncycastle.org/latest_releases.html Bounty Castle], [http://www.slf4j.org/download.html SLF4J] and [http://repo1.maven.org/maven2/org/tukaani/xz/1.4/ XZ].<br />
<br />
==== Redline with Ant ====<br />
Using a distinct name space or a different task name for the Redline RPM task is necessary to avoid any conflict with the build-in Ant [http://ant.apache.org/manual/Tasks/rpm.html RPM task]:<br />
<br />
<code lang="xml"><br />
<taskdef name="pure-java-rpm" classname="org.redline_rpm.ant.RedlineTask"><br />
<classpath><br />
<pathelement path="bcpg-jdk15on-151.jar"/><br />
<pathelement path="commons-compress-1.8.1.jar"/><br />
<pathelement path="slf4j-api-1.7.7.jar"/><br />
<pathelement path="slf4j-simple-1.7.7.jar"/><br />
<pathelement path="xz-1.4.jar"/><br />
<pathelement path="redline-1.1.16.jar"/><br />
</classpath><br />
</taskdef><br />
</code><br />
<br />
Then, you can call this Ant task:<br />
<code lang="xml"><br />
<pure-java-rpm group="Games" name="mygame" version="0" release="0" destination="rpms"><br />
<zipfileset prefix="/usr/share/games/mygame" file="user-app.jar"/><br />
<depends name="java" version=">= 1.6"/><br />
</pure-java-rpm><br />
</code><br />
<br />
The created RPM will use the JRE installed on the operating system.<br />
<br />
==== Redline with Maven ====<br />
[http://ronanquillevere.github.io/2015/06/18/redline-rpm-generation.html This tutorial] explains how to use Redline with Maven.<br />
<br />
= Debian Package Manager =<br />
<br />
[http://wiki.debian.org/Teams/Dpkg Dpkg] (Debian packager) is the default management system under Debian, Ubuntu, Knoppix, Mint, ...<br />
<br />
== Platform dependent tools ==<br />
<br />
The following tools only work under GNU Linux or other Unix platforms with native deb support.<br />
<br />
[http://manpages.ubuntu.com/manpages/lucid/fr/man1/dpkg-buildpackage.1.htmldpkg-buildpackage dpkg-buildpackage] can be used to build DEBs. You can find more information about DEB packaging in the [http://wiki.debian.org/Packaging official documentation].<br />
<br />
The build system [http://maven.apache.org Maven] can call this command when you use its [http://debian-maven.sourceforge.net Debian Maven plugin].<br />
<br />
== Cross-platform tools ==<br />
<br />
=== Jpkg ===<br />
<br />
[http://leplastrier.com/projects/jpkg/ Jpkg] is a pure Java library for manipulating DEB packages. It provides an Ant task. You can find an example of use in its [http://github.com/leplastrier/jpkg-library/blob/master/README.md readme file].<br />
<br />
=== JDeb ===<br />
<br />
[http://github.com/tcurdt/jdeb JDeb] is a pure Java library for manipulating DEB packages. It can be use in command line, with [http://ant.apache.org Ant] and with [http://maven.apache.org Maven].<br />
<br />
JDeb requires [http://commons.apache.org/proper/commons-compress/download_compress.cgi Apache Commons Compress], [http://www.bouncycastle.org/latest_releases.html Bounty Castle] and [http://commons.apache.org/proper/commons-io/download_io.cgi Apache Commons IO].<br />
<br />
Using a distinct name space or a different task name for the JDeb deb task is necessary to avoid any conflict with any other library used for the same purpose:<br />
<br />
<code lang="xml"><br />
<taskdef name="pure-java-deb" classname="org.vafer.jdeb.ant.DebAntTask"><br />
<classpath><br />
<pathelement path="bcpg-jdk15on-151.jar"/><br />
<pathelement path="commons-compress-1.8.1.jar"/><br />
<pathelement path="commons-io-2.4.jar"/><br />
<pathelement path="jdeb-1.3.jar"/><br />
</classpath><br />
</taskdef><br />
</code><br />
<br />
Then, you can call this Ant task:<br />
<code lang="xml"><br />
<pure-java-deb destfile="debs" control="controlDir" verbose="true"><br />
<data src="user-app.jar" type="file"><br />
<mapper type="perm" prefix="/usr/share/games/mygame"/><br />
</data><br />
</pure-java-deb><br />
</code><br />
<br />
The attribute "control" must be a directory and the control filename must be named "control" in order to be found by JDeb. You can find an example of control file [http://github.com/tcurdt/jdeb/blob/master/src/examples/ant/src/deb/control/control here].<br />
<br />
= Cross-platform tools supporting several package managers =<br />
<br />
== JNDT ==<br />
[http://gouessej.wordpress.com/2014/11/22/ardor3d-est-mort-vive-jogamps-ardor3d-continuation-ardor3d-is-dead-long-life-to-jogamps-ardor3d-continuation/#jndt JNDT] is a pure Java library that provides several Ant targets to create some self-contained native application bundles for GNU Linux, Mac OS X and Windows. It supports several package formats under GNU Linux and as it is cross-platform, it doesn't require any support of native build tools, i.e it allows to create a DEB package with a GNU Linux distribution that doesn't support the native DEB build tools, it allows to create a Mac application bundle under Windows, ...</div>Gouessejhttps://jogamp.org/wiki/index.php?title=JogAmp_JAR_File_Handling&diff=1829JogAmp JAR File Handling2015-08-20T09:50:12Z<p>Gouessej: /* Creation */</p>
<hr />
<div>= Native JAR Files =<br />
<br />
See [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NativeJARFiles Native JAR Files] explained.<br />
<br />
Native JAR files are loaded [{{SERVER}}/jogl/doc/userguide/index.html#automatednativelibraryloading automatically].<br />
<br />
= Applet / JNLP Usage =<br />
<br />
* [[Using JOGL in a Java applet|Using JOGL in a Java Applet]]<br />
* [[Using JOGL in Java Web Start|Using JOGL in Java Web Start]]<br />
<br />
A short ''copy'' is included in the static page [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NApplets JOGL Deployment using NApplet].<br />
<br />
= Custom Bundling =<br />
<br />
== Multi-Jar ==<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=843 Multi-Jar]<br />
<br />
This configuration is discouraged, since such deployment removes our artifacts as stored in<br />
the jar's manifest file, which helps identifying the jogamp modules for bug reports etc.<br />
<br />
However, since we don't want to patronize our user base, we support this feature with our native JAR lib loading mechanism. <br />
<br />
It is possible to merge all modules together, i.e.<br />
<br />
multi.jar:<br />
gluegen-rt.jar<br />
jogl-all.jar<br />
user-app.jar<br />
<br />
multi-natives-<os.and.arch>.jar:<br />
gluegen-rt-natives-<os.and.arch>.jar<br />
jogl-all-natives-<os.and.arch>.jar<br />
<br />
A combination with Fat-Jar is possible.<br />
<br />
== Fat-Jar ==<br />
<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=845 Discouraged Fat-Jar]<br />
<br />
This configuration is discouraged, since such deployment removes our artifacts as stored in<br />
the jar's manifest file, which helps identifying the jogamp modules for bug reports etc.<br />
<br />
Furthermore, adding all native library files for all supported platforms<br />
will add-up to +3M of _compressed_ jar data!<br />
<br />
However, since we don't want to patronize our user base, <br />
we support this feature with our native JAR lib loading mechanism.<br />
<br />
=== Usage ===<br />
<br />
If the modules's jar file contains the folder 'natives/<os.and.arch>/'<br />
we assume a fat-jar and attempt to load all native libraries from the same.<br />
<br />
If we don't have a fat-jar or if fat-jar loading doesn't result in extracted native libraries,<br />
we assume a regular slim jar file.<br />
<br />
Layout:<br />
<br />
/com/lala1/Lala1.class<br />
/com/lala2/Lala2.class<br />
/natives/<os.and.arch>/libLala1.so<br />
/natives/<os.and.arch>/libLala2.so<br />
<br />
A combination w/ Multi-Jar is of course possible.<br />
<br />
=== Creation ===<br />
<br />
==== Ant ====<br />
You can use the [http://ant.apache.org/manual/Tasks/jar.html Ant jar task] to create a fat JAR. You must avoid file names collision, i.e you must exclude the file(s) with the same name(s) in multiple JARs. You can use [https://ant.apache.org/manual/Tasks/manifest.html Ant manifest task] to create a manifest file. The following line just keeps the strict minimum to make JogAmp work and should be used with the [http://ant.apache.org/manual/Tasks/jar.html Ant jar task]:<br />
<br />
<zipfileset src="jogamp-fat.jar" includes="**/*.class,**/*.png,**/*.glsl,**/*.vp,**/*.fp,**/*.bvp,**/*.bfp,**/*.so,**/*.jnilib,**/*.dylib,**/*.dll,**/.bin"/><br />
<br />
==== Maven ====<br />
[http://maven.apache.org/plugins/maven-shade-plugin/index.html Maven Shade Plugin] is the recommended plugin to use to create fat JARs with [http://maven.apache.org Maven]. [http://maven.apache.org/plugins/maven-shade-plugin/examples/executable-jar.html This example] shows how to set some entries in the manifest file.<br />
<br />
== One-Jar ==<br />
<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=846 One-Jar]<br />
<br />
One-Jar is incomplete, i.e. it does not provide a URL handler for <br />
it's jar-in-jar resources - hence we would need to implement this functionality manually.<br />
<br />
See [{{SERVER}}/bugzilla/show_bug.cgi?id=846#c1 One-Jar lacks of URLHandler ...]<br />
<br />
For now, one can use Eclipse working jar-in-jar feature (see below).<br />
Since Eclipse is under an open source license, one should be able<br />
to locate the source code and include in a standalone toolkit, if so required.<br />
<br />
== JarMatey ==<br />
<br />
[http://staticvoidgames.com/JarMatey/ JarMatey] is an [https://github.com/KevinWorkman/JarMatey open source] tool for creating standalone self-executing JARs, similar to One-Jar but with a graphical user interface and no support for build tools (Ant, Maven). You can find a detailed tutorial about it [http://staticvoidgames.com/tutorials/deployment/joglExample here].<br />
<br />
== Eclipse ==<br />
<br />
Native JAR files and their respective base JAR files can be bundled in [{{SERVER}}/bugzilla/show_bug.cgi?id=522#c7 custom ways, e.g. eclipse Jar-In-Jar etc].<br />
<br />
Manual tested w/ Eclipse:<br />
<br />
Preparations:<br />
===============<br />
<br />
1) Set up a vanilla eclipse (3.7.0) workspace<br />
<br />
2) Add the JOGL User Library:<br />
- Window.Preference<br />
- Java.Build_Path.User_Libraries:<br />
+ JOGL<br />
+ gluegen-rt.jar<br />
+ jogl-all.jar<br />
+ gluegen-rt-natives-linux-amd64.jar<br />
+ jogl-all-natives-linux-amd64.jar<br />
<br />
You may add all other native JARs here.<br />
Note that these are not required in the CLASSPATH by JOGL,<br />
however, they are required by Eclipse to export your project as a Runnable JAR File.<br />
<br />
3) New test project<br />
- Right-click your project in the Package Explorer and click "Properties".<br />
- Select "Java Build Path" and click the "Libraries" tab.<br />
+ JOGL<br />
- Add some simple code ..<br />
- Run as Java Application ..<br />
<br />
Test-1:<br />
=========<br />
<br />
Export<br />
- Right-click your project in the Package Explorer and click "Export"<br />
- Select Java.Runnable_JAR_file<br />
+ Launch configuration<br />
+ some destination path<br />
+ Library handling:<br />
Copy required libraries into a sub-folder next to the generated JAR<br />
<br />
Result: Works!<br />
<br />
./lala01.jar<br />
./lala01_lib/jogl-all.jar<br />
./lala01_lib/jogl-all-natives-linux-amd64.jar<br />
./lala01_lib/... etc ..<br />
<br />
Test-2:<br />
=========<br />
<br />
Export<br />
- Right-click your project in the Package Explorer and click "Export"<br />
- Select Java.Runnable_JAR_file<br />
+ Launch configuration<br />
+ some destination path<br />
+ Library handling:<br />
Package required libraries into generated JAR<br />
<br />
Result: Works!<br />
<br />
./lala02.jar:<br />
Manifest-Version: 1.0<br />
Rsrc-Class-Path: ./ gluegen-rt-natives-linux-amd64.jar gluegen-rt.jar<br />
jogl-all-natives-linux-amd64.jar jogl-all.jar<br />
Class-Path: .<br />
Rsrc-Main-Class: Test01<br />
Main-Class: org.eclipse.jdt.internal.jarinjarloader.JarRsrcLoader</div>Gouessejhttps://jogamp.org/wiki/index.php?title=JogAmp_JAR_File_Handling&diff=1828JogAmp JAR File Handling2015-08-20T09:44:10Z<p>Gouessej: </p>
<hr />
<div>= Native JAR Files =<br />
<br />
See [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NativeJARFiles Native JAR Files] explained.<br />
<br />
Native JAR files are loaded [{{SERVER}}/jogl/doc/userguide/index.html#automatednativelibraryloading automatically].<br />
<br />
= Applet / JNLP Usage =<br />
<br />
* [[Using JOGL in a Java applet|Using JOGL in a Java Applet]]<br />
* [[Using JOGL in Java Web Start|Using JOGL in Java Web Start]]<br />
<br />
A short ''copy'' is included in the static page [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NApplets JOGL Deployment using NApplet].<br />
<br />
= Custom Bundling =<br />
<br />
== Multi-Jar ==<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=843 Multi-Jar]<br />
<br />
This configuration is discouraged, since such deployment removes our artifacts as stored in<br />
the jar's manifest file, which helps identifying the jogamp modules for bug reports etc.<br />
<br />
However, since we don't want to patronize our user base, we support this feature with our native JAR lib loading mechanism. <br />
<br />
It is possible to merge all modules together, i.e.<br />
<br />
multi.jar:<br />
gluegen-rt.jar<br />
jogl-all.jar<br />
user-app.jar<br />
<br />
multi-natives-<os.and.arch>.jar:<br />
gluegen-rt-natives-<os.and.arch>.jar<br />
jogl-all-natives-<os.and.arch>.jar<br />
<br />
A combination with Fat-Jar is possible.<br />
<br />
== Fat-Jar ==<br />
<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=845 Discouraged Fat-Jar]<br />
<br />
This configuration is discouraged, since such deployment removes our artifacts as stored in<br />
the jar's manifest file, which helps identifying the jogamp modules for bug reports etc.<br />
<br />
Furthermore, adding all native library files for all supported platforms<br />
will add-up to +3M of _compressed_ jar data!<br />
<br />
However, since we don't want to patronize our user base, <br />
we support this feature with our native JAR lib loading mechanism.<br />
<br />
=== Usage ===<br />
<br />
If the modules's jar file contains the folder 'natives/<os.and.arch>/'<br />
we assume a fat-jar and attempt to load all native libraries from the same.<br />
<br />
If we don't have a fat-jar or if fat-jar loading doesn't result in extracted native libraries,<br />
we assume a regular slim jar file.<br />
<br />
Layout:<br />
<br />
/com/lala1/Lala1.class<br />
/com/lala2/Lala2.class<br />
/natives/<os.and.arch>/libLala1.so<br />
/natives/<os.and.arch>/libLala2.so<br />
<br />
A combination w/ Multi-Jar is of course possible.<br />
<br />
=== Creation ===<br />
<br />
==== Ant ====<br />
You can use the [http://ant.apache.org/manual/Tasks/jar.html Ant jar task] to create a fat JAR. You must avoid file names collision, i.e you must exclude the file(s) with the same name(s) in multiple JARs. The following line just keeps the strict minimum to make JogAmp work and should be used with the [http://ant.apache.org/manual/Tasks/jar.html Ant jar task]:<br />
<br />
<zipfileset src="jogamp-fat.jar" includes="**/*.class,**/*.png,**/*.glsl,**/*.vp,**/*.fp,**/*.bvp,**/*.bfp,**/*.so,**/*.jnilib,**/*.dylib,**/*.dll,**/.bin"/><br />
<br />
== One-Jar ==<br />
<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=846 One-Jar]<br />
<br />
One-Jar is incomplete, i.e. it does not provide a URL handler for <br />
it's jar-in-jar resources - hence we would need to implement this functionality manually.<br />
<br />
See [{{SERVER}}/bugzilla/show_bug.cgi?id=846#c1 One-Jar lacks of URLHandler ...]<br />
<br />
For now, one can use Eclipse working jar-in-jar feature (see below).<br />
Since Eclipse is under an open source license, one should be able<br />
to locate the source code and include in a standalone toolkit, if so required.<br />
<br />
== JarMatey ==<br />
<br />
[http://staticvoidgames.com/JarMatey/ JarMatey] is an [https://github.com/KevinWorkman/JarMatey open source] tool for creating standalone self-executing JARs, similar to One-Jar but with a graphical user interface and no support for build tools (Ant, Maven). You can find a detailed tutorial about it [http://staticvoidgames.com/tutorials/deployment/joglExample here].<br />
<br />
== Eclipse ==<br />
<br />
Native JAR files and their respective base JAR files can be bundled in [{{SERVER}}/bugzilla/show_bug.cgi?id=522#c7 custom ways, e.g. eclipse Jar-In-Jar etc].<br />
<br />
Manual tested w/ Eclipse:<br />
<br />
Preparations:<br />
===============<br />
<br />
1) Set up a vanilla eclipse (3.7.0) workspace<br />
<br />
2) Add the JOGL User Library:<br />
- Window.Preference<br />
- Java.Build_Path.User_Libraries:<br />
+ JOGL<br />
+ gluegen-rt.jar<br />
+ jogl-all.jar<br />
+ gluegen-rt-natives-linux-amd64.jar<br />
+ jogl-all-natives-linux-amd64.jar<br />
<br />
You may add all other native JARs here.<br />
Note that these are not required in the CLASSPATH by JOGL,<br />
however, they are required by Eclipse to export your project as a Runnable JAR File.<br />
<br />
3) New test project<br />
- Right-click your project in the Package Explorer and click "Properties".<br />
- Select "Java Build Path" and click the "Libraries" tab.<br />
+ JOGL<br />
- Add some simple code ..<br />
- Run as Java Application ..<br />
<br />
Test-1:<br />
=========<br />
<br />
Export<br />
- Right-click your project in the Package Explorer and click "Export"<br />
- Select Java.Runnable_JAR_file<br />
+ Launch configuration<br />
+ some destination path<br />
+ Library handling:<br />
Copy required libraries into a sub-folder next to the generated JAR<br />
<br />
Result: Works!<br />
<br />
./lala01.jar<br />
./lala01_lib/jogl-all.jar<br />
./lala01_lib/jogl-all-natives-linux-amd64.jar<br />
./lala01_lib/... etc ..<br />
<br />
Test-2:<br />
=========<br />
<br />
Export<br />
- Right-click your project in the Package Explorer and click "Export"<br />
- Select Java.Runnable_JAR_file<br />
+ Launch configuration<br />
+ some destination path<br />
+ Library handling:<br />
Package required libraries into generated JAR<br />
<br />
Result: Works!<br />
<br />
./lala02.jar:<br />
Manifest-Version: 1.0<br />
Rsrc-Class-Path: ./ gluegen-rt-natives-linux-amd64.jar gluegen-rt.jar<br />
jogl-all-natives-linux-amd64.jar jogl-all.jar<br />
Class-Path: .<br />
Rsrc-Main-Class: Test01<br />
Main-Class: org.eclipse.jdt.internal.jarinjarloader.JarRsrcLoader</div>Gouessejhttps://jogamp.org/wiki/index.php?title=JogAmp_JAR_File_Handling&diff=1827JogAmp JAR File Handling2015-08-20T09:42:25Z<p>Gouessej: /* Fat-Jar */ creation with Ant</p>
<hr />
<div>= Native JAR Files =<br />
<br />
See [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NativeJARFiles Native JAR Files] explained.<br />
<br />
Native JAR files are loaded [{{SERVER}}/jogl/doc/userguide/index.html#automatednativelibraryloading automatically].<br />
<br />
= Applet / JNLP Usage =<br />
<br />
* [[Using JOGL in a Java applet|Using JOGL in a Java Applet]]<br />
* [[Using JOGL in Java Web Start|Using JOGL in Java Web Start]]<br />
<br />
A short ''copy'' is included in the static page [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html#NApplets JOGL Deployment using NApplet].<br />
<br />
= Custom Bundling =<br />
<br />
== Multi-Jar ==<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=843 Multi-Jar]<br />
<br />
This configuration is discouraged, since such deployment removes our artifacts as stored in<br />
the jar's manifest file, which helps identifying the jogamp modules for bug reports etc.<br />
<br />
However, since we don't want to patronize our user base, we support this feature with our native JAR lib loading mechanism. <br />
<br />
It is possible to merge all modules together, i.e.<br />
<br />
multi.jar:<br />
gluegen-rt.jar<br />
jogl-all.jar<br />
user-app.jar<br />
<br />
multi-natives-<os.and.arch>.jar:<br />
gluegen-rt-natives-<os.and.arch>.jar<br />
jogl-all-natives-<os.and.arch>.jar<br />
<br />
A combination with Fat-Jar is possible.<br />
<br />
== Fat-Jar ==<br />
<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=845 Discouraged Fat-Jar]<br />
<br />
This configuration is discouraged, since such deployment removes our artifacts as stored in<br />
the jar's manifest file, which helps identifying the jogamp modules for bug reports etc.<br />
<br />
Furthermore, adding all native library files for all supported platforms<br />
will add-up to +3M of _compressed_ jar data!<br />
<br />
However, since we don't want to patronize our user base, <br />
we support this feature with our native JAR lib loading mechanism.<br />
<br />
=== Usage ===<br />
<br />
If the modules's jar file contains the folder 'natives/<os.and.arch>/'<br />
we assume a fat-jar and attempt to load all native libraries from the same.<br />
<br />
If we don't have a fat-jar or if fat-jar loading doesn't result in extracted native libraries,<br />
we assume a regular slim jar file.<br />
<br />
Layout:<br />
<br />
/com/lala1/Lala1.class<br />
/com/lala2/Lala2.class<br />
/natives/<os.and.arch>/libLala1.so<br />
/natives/<os.and.arch>/libLala2.so<br />
<br />
A combination w/ Multi-Jar is of course possible.<br />
<br />
=== Creation ===<br />
<br />
== Ant ==<br />
You can use the [http://ant.apache.org/manual/Tasks/jar.html Ant jar task] to create a fat JAR. You must avoid file names collision, i.e you must exclude the file(s) with the same name(s) in multiple JARs. The following line just keeps the strict minimum to make JogAmp work and should be used with the [http://ant.apache.org/manual/Tasks/jar.html Ant jar task]:<br />
<br />
<zipfileset src="jogamp-fat.jar" includes="**/*.class,**/*.png,**/*.glsl,**/*.vp,**/*.fp,**/*.bvp,**/*.bfp,**/*.so,**/*.jnilib,**/*.dylib,**/*.dll,**/.bin"/><br />
<br />
== One-Jar ==<br />
<br />
[{{SERVER}}/bugzilla/show_bug.cgi?id=846 One-Jar]<br />
<br />
One-Jar is incomplete, i.e. it does not provide a URL handler for <br />
it's jar-in-jar resources - hence we would need to implement this functionality manually.<br />
<br />
See [{{SERVER}}/bugzilla/show_bug.cgi?id=846#c1 One-Jar lacks of URLHandler ...]<br />
<br />
For now, one can use Eclipse working jar-in-jar feature (see below).<br />
Since Eclipse is under an open source license, one should be able<br />
to locate the source code and include in a standalone toolkit, if so required.<br />
<br />
== JarMatey ==<br />
<br />
[http://staticvoidgames.com/JarMatey/ JarMatey] is an [https://github.com/KevinWorkman/JarMatey open source] tool for creating standalone self-executing JARs, similar to One-Jar but with a graphical user interface and no support for build tools (Ant, Maven). You can find a detailed tutorial about it [http://staticvoidgames.com/tutorials/deployment/joglExample here].<br />
<br />
== Eclipse ==<br />
<br />
Native JAR files and their respective base JAR files can be bundled in [{{SERVER}}/bugzilla/show_bug.cgi?id=522#c7 custom ways, e.g. eclipse Jar-In-Jar etc].<br />
<br />
Manual tested w/ Eclipse:<br />
<br />
Preparations:<br />
===============<br />
<br />
1) Set up a vanilla eclipse (3.7.0) workspace<br />
<br />
2) Add the JOGL User Library:<br />
- Window.Preference<br />
- Java.Build_Path.User_Libraries:<br />
+ JOGL<br />
+ gluegen-rt.jar<br />
+ jogl-all.jar<br />
+ gluegen-rt-natives-linux-amd64.jar<br />
+ jogl-all-natives-linux-amd64.jar<br />
<br />
You may add all other native JARs here.<br />
Note that these are not required in the CLASSPATH by JOGL,<br />
however, they are required by Eclipse to export your project as a Runnable JAR File.<br />
<br />
3) New test project<br />
- Right-click your project in the Package Explorer and click "Properties".<br />
- Select "Java Build Path" and click the "Libraries" tab.<br />
+ JOGL<br />
- Add some simple code ..<br />
- Run as Java Application ..<br />
<br />
Test-1:<br />
=========<br />
<br />
Export<br />
- Right-click your project in the Package Explorer and click "Export"<br />
- Select Java.Runnable_JAR_file<br />
+ Launch configuration<br />
+ some destination path<br />
+ Library handling:<br />
Copy required libraries into a sub-folder next to the generated JAR<br />
<br />
Result: Works!<br />
<br />
./lala01.jar<br />
./lala01_lib/jogl-all.jar<br />
./lala01_lib/jogl-all-natives-linux-amd64.jar<br />
./lala01_lib/... etc ..<br />
<br />
Test-2:<br />
=========<br />
<br />
Export<br />
- Right-click your project in the Package Explorer and click "Export"<br />
- Select Java.Runnable_JAR_file<br />
+ Launch configuration<br />
+ some destination path<br />
+ Library handling:<br />
Package required libraries into generated JAR<br />
<br />
Result: Works!<br />
<br />
./lala02.jar:<br />
Manifest-Version: 1.0<br />
Rsrc-Class-Path: ./ gluegen-rt-natives-linux-amd64.jar gluegen-rt.jar<br />
jogl-all-natives-linux-amd64.jar jogl-all.jar<br />
Class-Path: .<br />
Rsrc-Main-Class: Test01<br />
Main-Class: org.eclipse.jdt.internal.jarinjarloader.JarRsrcLoader</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Foreign_Packaging&diff=1826Foreign Packaging2015-08-20T08:49:32Z<p>Gouessej: JNDT</p>
<hr />
<div>'''N.B: This article is subject to changes and is incomplete.'''<br />
<br />
We assume that the application is packaged as a [http://jogamp.org/wiki/index.php/JogAmp_JAR_File_Handling#Fat-Jar fat JAR] called "user-app.jar" for the sake of simplicity.<br />
<br />
= Red Hat Package Manager =<br />
<br />
[http://www.rpm.org RPM] (Red Hat Package Manager) is the default package management system under Red Hat, Fedora, Mageia, Mandriva, OpenSUSE, Oracle Linux, ...<br />
<br />
== Platform dependent tools ==<br />
<br />
The following tools only work under GNU Linux or other Unix platforms with native rpm support.<br />
<br />
[http://www.rpm.org/max-rpm-snapshot/rpmbuild.8.html rpmbuild] can be used to build RPMs. You can find more information about RPM packaging in the [http://www.rpm.org/wiki/Docs#PackagerDocumentation official documentation].<br />
<br />
The build tool [http://ant.apache.org Ant] can call this command when you use its [http://ant.apache.org/manual/Tasks/rpm.html RPM task]. The build system [http://maven.apache.org Maven] does the same with its [http://mojo.codehaus.org/rpm-maven-plugin/ RPM plugin].<br />
<br />
== Cross-platform tools ==<br />
<br />
=== jRPM ===<br />
<br />
[http://jrpm.sourceforge.net jRPM] is a pure Java library for manipulating RPM packages.<br />
<br />
=== Redline ===<br />
[http://redline-rpm.org Redline RPM] is a pure Java library for manipulating RPM packages. It can be use in command line, with [http://ant.apache.org Ant] and with [http://maven.apache.org Maven].<br />
<br />
Redline requires [http://commons.apache.org/proper/commons-compress/download_compress.cgi Apache Commons Compress], [http://www.bouncycastle.org/latest_releases.html Bounty Castle], [http://www.slf4j.org/download.html SLF4J] and [http://repo1.maven.org/maven2/org/tukaani/xz/1.4/ XZ].<br />
<br />
Using a distinct name space or a different task name for the Redline RPM task is necessary to avoid any conflict with the build-in Ant [http://ant.apache.org/manual/Tasks/rpm.html RPM task]:<br />
<br />
<code lang="xml"><br />
<taskdef name="pure-java-rpm" classname="org.redline_rpm.ant.RedlineTask"><br />
<classpath><br />
<pathelement path="bcpg-jdk15on-151.jar"/><br />
<pathelement path="commons-compress-1.8.1.jar"/><br />
<pathelement path="slf4j-api-1.7.7.jar"/><br />
<pathelement path="slf4j-simple-1.7.7.jar"/><br />
<pathelement path="xz-1.4.jar"/><br />
<pathelement path="redline-1.1.16.jar"/><br />
</classpath><br />
</taskdef><br />
</code><br />
<br />
Then, you can call this Ant task:<br />
<code lang="xml"><br />
<pure-java-rpm group="Games" name="mygame" version="0" release="0" destination="rpms"><br />
<zipfileset prefix="/usr/share/games/mygame" file="user-app.jar"/><br />
<depends name="java" version=">= 1.6"/><br />
</pure-java-rpm><br />
</code><br />
<br />
The created RPM will use the JRE installed on the operating system.<br />
<br />
= Debian Package Manager =<br />
<br />
[http://wiki.debian.org/Teams/Dpkg Dpkg] (Debian packager) is the default management system under Debian, Ubuntu, Knoppix, Mint, ...<br />
<br />
== Platform dependent tools ==<br />
<br />
The following tools only work under GNU Linux or other Unix platforms with native deb support.<br />
<br />
[http://manpages.ubuntu.com/manpages/lucid/fr/man1/dpkg-buildpackage.1.htmldpkg-buildpackage dpkg-buildpackage] can be used to build DEBs. You can find more information about DEB packaging in the [http://wiki.debian.org/Packaging official documentation].<br />
<br />
The build system [http://maven.apache.org Maven] can call this command when you use its [http://debian-maven.sourceforge.net Debian Maven plugin].<br />
<br />
== Cross-platform tools ==<br />
<br />
=== Jpkg ===<br />
<br />
[http://leplastrier.com/projects/jpkg/ Jpkg] is a pure Java library for manipulating DEB packages. It provides an Ant task. You can find an example of use in its [http://github.com/leplastrier/jpkg-library/blob/master/README.md readme file].<br />
<br />
=== JDeb ===<br />
<br />
[http://github.com/tcurdt/jdeb JDeb] is a pure Java library for manipulating DEB packages. It can be use in command line, with [http://ant.apache.org Ant] and with [http://maven.apache.org Maven].<br />
<br />
JDeb requires [http://commons.apache.org/proper/commons-compress/download_compress.cgi Apache Commons Compress], [http://www.bouncycastle.org/latest_releases.html Bounty Castle] and [http://commons.apache.org/proper/commons-io/download_io.cgi Apache Commons IO].<br />
<br />
Using a distinct name space or a different task name for the JDeb deb task is necessary to avoid any conflict with any other library used for the same purpose:<br />
<br />
<code lang="xml"><br />
<taskdef name="pure-java-deb" classname="org.vafer.jdeb.ant.DebAntTask"><br />
<classpath><br />
<pathelement path="bcpg-jdk15on-151.jar"/><br />
<pathelement path="commons-compress-1.8.1.jar"/><br />
<pathelement path="commons-io-2.4.jar"/><br />
<pathelement path="jdeb-1.3.jar"/><br />
</classpath><br />
</taskdef><br />
</code><br />
<br />
Then, you can call this Ant task:<br />
<code lang="xml"><br />
<pure-java-deb destfile="debs" control="controlDir" verbose="true"><br />
<data src="user-app.jar" type="file"><br />
<mapper type="perm" prefix="/usr/share/games/mygame"/><br />
</data><br />
</pure-java-deb><br />
</code><br />
<br />
The attribute "control" must be a directory and the control filename must be named "control" in order to be found by JDeb. You can find an example of control file [http://github.com/tcurdt/jdeb/blob/master/src/examples/ant/src/deb/control/control here].<br />
<br />
= Cross-platform tools supporting several package managers =<br />
<br />
== JNDT ==<br />
[http://gouessej.wordpress.com/2014/11/22/ardor3d-est-mort-vive-jogamps-ardor3d-continuation-ardor3d-is-dead-long-life-to-jogamps-ardor3d-continuation/#jndt JNDT] is a pure Java library that provides several Ant targets to create some self-contained native application bundles for GNU Linux, Mac OS X and Windows. It supports several package formats under GNU Linux and as it is cross-platform, it doesn't require any support of native build tools, i.e it allows to create a DEB package with a GNU Linux distribution that doesn't support the native DEB build tools, it allows to create a Mac application bundle under Windows, ...</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Jogl_Tutorial&diff=1818Jogl Tutorial2015-08-07T13:07:15Z<p>Gouessej: /* Common Mistakes */</p>
<hr />
<div>= JogAmp's Static =<br />
* [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
* [{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
* [{{SERVER}}/jogl/doc/userguide/ Userguide]<br />
* [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html Deployment]<br />
* [{{SERVER}}/deployment/jogamp-current/jogl-test-applets.html JOGL Test Applets]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-applet-runner-newt-gears-normal.html using Object/Embed tags]<br />
** [{{SERVER}}/deployment/jogamp-current/jogl-demos/applet-gears.html using the Applet Tag]<br />
* [{{SERVER}}/jogl/doc/NEWT-Overview.html NEWT - High Performance Native Windowing Toolkit]<br />
* [{{SERVER}}/git/?p=jogl-demos.git;a=blob;f=src/demos/es2/RawGL2ES2demo.java;hb=HEAD OpenGL GL2ES2 GLSL Standalone Example by Xerxes Rånby ]<br />
* [https://gist.github.com/gouessej/3420e2b6f632efdddf98 Rudimentary standalone example using the fixed pipeline by Julien Gouesse]<br />
<br />
= JogAmp's Wiki =<br />
* [[Downloading and installing JOGL|Downloading and installing JOGL]]<br />
** [[Jogamp_Versioning_and_Releases|Versioning And Release Information]]<br />
* [[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
* Deployment<br />
** [[JogAmp JAR File Handling|JAR File Handling]]<br />
** [[Using JOGL in a Java applet|Using JOGL in a Java Applet]]<br />
** [[Using JOGL in Java Web Start|Using JOGL in Java Web Start]]<br />
** [[Foreign Packaging|Foreign Packaging]]<br />
* JOGL<br />
** [[How to write cross GLProfile compatible shader using JOGL]]<br />
** [[How to use the Debug and Trace GL Pipeline and Debug GL Context]]<br />
** [[Using JOGL in AWT SWT and Swing|Using JOGL in AWT, SWT, and Swing]]<br />
** [[How to use X11 displays]]<br />
* [[Jogl_FAQ|FAQ]]<br />
<br />
= Hello Triangle =<br />
[https://github.com/elect86/jogl-samples/blob/master/jogl-samples/src/helloTriangle/HelloTriangle.java Simple sample] that features GL4, pure newt, glWindow options, animator, indexed drawing, dinamic attribute and frag data binding, interleaved data, vao, vbo (with normalization on one attribute), ibo (with shorts), uniform, glsl program (with specific suffix) and matrix jogl util, gl error check, key listener and right way to dispose.<br />
<br />
= Common Mistakes =<br />
I suggest you to take a read to these two pages for a quick overview over the most common problems, it is a very useful reading, legacy sections are carefully signaled.<br />
<br />
[https://www.opengl.org/wiki/Common_Mistakes OpenGL]<br />
[https://www.opengl.org/wiki/GLSL_:_common_mistakes GLSL]<br />
<br />
N.B: The use of color picking is '''NOT''' recommended on any hardware whose palette is partially emulated.<br />
<br />
= Wade's JOGL tutorials =<br />
* [http://wadeawalker.wordpress.com/2010/10/09/tutorial-a-cross-platform-workbench-program-using-java-opengl-and-eclipse/ Cross-platform workbench program using Eclipse and JOGL]<br />
* [http://wadeawalker.wordpress.com/2010/10/17/tutorial-faster-rendering-with-vertex-buffer-objects/ Faster rendering with vertex buffer objects]<br />
* [http://wadeawalker.wordpress.com/2010/10/24/tutorial-creating-native-binary-executables-for-multi-platform-java-apps-with-opengl-and-eclipse-rcp/ Creating native binary executables for multi-platform Java apps with OpenGL and Eclipse RCP]<br />
* [http://wadeawalker.wordpress.com/2010/12/06/tutorial-displaying-java-opengl-in-an-eclipse-editor-with-a-menu-bar-and-a-runpause-button/ Displaying Java OpenGL in an Eclipse RCP editor with a menu bar and a run/pause button]<br />
<br />
= Rami's JOGL tutorials =<br />
* [http://ramisantina.com/blog/?p=8 Rami's Guide how to setup a JOGL Eclipse project]<br />
<br />
= [https://sites.google.com/site/justinscsstuff/jogl-tutorials Justin's Getting Started with JOGL 2 Tutorials] =<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-1 JOGL Tutorial 1 - Environment Setup]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-2 JOGL Tutorial 2 - Creating a Window]<br />
* [https://sites.google.com/site/justinscsstuff/jogl-tutorial-3 JOGL Tutorial 3 - Creating a Render Loop]<br />
<br />
= Elect86's modern OpenGL examples =<br />
<br />
* [https://github.com/elect86/modern-jogl-examples Source code on Github]<br />
<br />
= Nils Hoffmann's Netbeans Platform examples =<br />
* [https://github.com/nilshoffmann/netbeans-jogl2 Source code on Github]<br />
<br />
= Courses =<br />
* [http://www3.ntu.edu.sg/home/ehchua/programming/opengl/JOGL2.0.html Yet Another Tutorial on JOGL 2.0 - Including Nehe JOGL Port (Chua Hock-Chuan's notes at Nanyang Tech. University)]<br />
* [http://www.informatik.uni-oldenburg.de/~trigger/opengl_course.html Johannes's Courses at University of Oldenburg (German)]<br />
* [http://www.manuel-carcenac.com/courses/index.html Manuel's Courses at European University of Lefke]<br />
** [http://www.manuel-carcenac.com/courses/Graphics_in_Java/index.htm Graphics in Java incl. 3D/JOGL]<br />
** [http://www.manuel-carcenac.com/courses/Advanced_Graphics_in_Java_and_JOGL/index.htm Advanced 3D Graphics in Java and Java OpenGL (JOGL 2)]<br />
<br />
= [http://leolol.com/tutorials/graphics_tutorials.html LeoLoL.com Tutorials] (Currently unreachable) =<br />
* [http://leolol.com/tutorials/graphics/lesson01.html Lesson 1 - Setting up a JOGL Template]<br />
* [http://leolol.com/tutorials/graphics/lesson02.html Lesson 2 - Drawing basic 2D shapes]<br />
* [http://leolol.com/tutorials/graphics/lesson03.html Lesson 3 - Adding colour]<br />
* [http://leolol.com/tutorials/graphics/lesson04.html Lesson 4 - 3D Shapes and Rotation]<br />
<br />
= JOGL 1 tutorials =<br />
* [http://www.felixgers.de/teaching/jogl/ Felix's OpenGL and JOGL]<br />
<br />
== [http://www.sjonesart.com/gl.php Ste3e's JOGL tutorials] ==<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENGE3ZmZkOGItZGYzZC00ZDgzLTg0NTAtMTk1MTAwMzYxYzNk&hl=en Keys and Mouse]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEYTFiMmFiYzQtMDA0MC00ZWI0LWI1NjItODE3ZjM2OGUxOWEw&hl=en First-Person Shooter]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEZGI2NTZhZTMtYWYwNS00NTljLWFiNGQtM2UyNTYyNjAzNDYy&hl=en Vertex Buffer Objects]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fENWFhODk0M2UtZDY0Ni00YWM5LWIxZGUtMzM0YzMxMmRlODgx&hl=en Shader Setup]<br />
* [https://docs.google.com/viewer?a=v&pid=explorer&chrome=true&srcid=0B9hhZie2D-fEMzNjNDBmMjUtNGQzNS00ODY0LWJkYmUtNDM5Y2I5ODc0Y2Nj&hl=en Texture Using Shaders]<br />
<br />
(The old (not quite up-to-date) JOGL Userguide is currently available [http://jogamp.org/jogl/doc/userguide/ here])</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Main_Page&diff=1759Main Page2015-07-16T18:13:00Z<p>Gouessej: </p>
<hr />
<div>__NOTOC__<br />
{| width="100%"<br />
|-<br />
|<br />
<div><br />
Welcome to the [{{SERVER}}/ JogAmp] wiki. It documents JOGL, JOCL and JOAL, the cross-platform bindings to the OpenGL, OpenCL, and OpenAL APIs.<br />
</div><br />
|-<br />
|<br />
{| style="width: 100%;"<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Getting Started</h3><br />
*[[Downloading and installing JOGL|Downloading and installing]]<br />
**[[Jogamp Versioning and Releases|Versioning and Releases]]<br />
*[[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
*[[Jogamp SCM Repositories|Source Code Repositories]]<br />
*[[SW Tracking|Tracking Reports]]<br />
*[{{SERVER}}/chuck/ Build and Test Server]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Community</h3><br />
*[[How to Contribute|Contribute to JogAmp]]<br />
*[[How to Build|Build JogAmp]]<br />
*[[Maintainer and Contacts]]<br />
*[[Jogl FAQ#Bugreports & Testing|Report a bug]]<br />
**[{{SERVER}}/bugzilla/ Bugzilla]<br />
*[http://forum.jogamp.org/ Ask a question in the forum]<br />
*[[chatroom|JogAmp IRC]]<br />
|}<br />
|-<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>JogAmp Modules</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Roadmaps</h3><br />
* [[SW Tracking Report Objectives for the release 2.3.3|2.3.3]], [[SW Tracking Report Objectives for the release 2.3.2|2.3.2]], [[SW Tracking Report Objectives for the release 2.3.1|2.3.1]], [[SW Tracking Report Objectives for the release 2.3.0|2.3.0]]<br />
* [[SW Tracking Report Objectives for the release 2.2.4|2.2.4]], [[SW Tracking Report Objectives for the release 2.2.3|2.2.3]], [[SW Tracking Report Objectives for the release 2.2.2|2.2.2]], [[SW Tracking Report Objectives for the release 2.2.1|2.2.1]], [[SW Tracking Report Objectives for the release 2.2.0|2.2.0]]<br />
* [[SW Tracking Report Objectives for the release 2.1.5|2.1.5]], [[SW Tracking Report Objectives for the release 2.1.4|2.1.4]], [[SW Tracking Report Objectives for the release 2.1.3|2.1.3]], [[SW Tracking Report Objectives for the release 2.1.2|2.1.2]], [[SW Tracking Report Objectives for the release 2.1.1|2.1.1]], [[SW Tracking Report Objectives for the release 2.1.0|2.1.0]]<br />
* [[SW Tracking Report Objectives for the release 2.0.2 of JOGL|2.0.2]]<br />
|-<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOGL</h3><br />
*[[Jogl Overview|Overview]] [ [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL] ]<br />
*[[Jogl Tutorial|Tutorial]]<br />
*[[Jogl FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jogl.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
*[{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOCL</h3><br />
*[[JOCL Overview|Overview]]<br />
*[[JOCL Tutorial|Tutorial]]<br />
*[[JOCL FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jocl.git;a=blob;f=LICENSE License]<br />
*[{{SERVER}}/deployment/jogamp-next/javadoc/jocl/javadoc/ API Doc]<br />
*[{{SERVER}}/jocl/doc/HowToBuild.html How to Build JOCL]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOAL</h3><br />
*[[Joal Overview|Overview]]<br />
*[[Joal Tutorial|Tutorial]]<br />
*[[Joal FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=joal.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc/ Public], [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc_dev/ Internal] ]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>GlueGen</h3><br />
* [[GlueGen_Wiki|Overview]]<br />
* [{{SERVER}}/git/?p=gluegen.git;a=blob;f=LICENSE.txt License]<br />
* [{{SERVER}}/deployment/jogamp-next/javadoc/gluegen/javadoc/ API Doc]<br />
|}<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>Related Projects</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Java3D</h3><br />
*[[Java3D Overview|Overview]]<br />
*[[Downloading and installing Java3D|Downloading and installing]]<br />
*[[Java3D Tutorial|Tutorial]]<br />
*[[Java3D FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ji Gong</h3><br />
*[[Ji Gong Overview|Overview]]<br />
*[[Ji Gong Motivation|Motivation]]<br />
*[[Ji Gong FAQ|FAQ]]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Source Certification Contract (SCC)</h3><br />
*[[SCC Overview|Overview]]<br />
*[[SCC FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ardor3D</h3><br />
*[[Ardor3D Overview|Overview]]<br />
*[[Ardor3D Tutorial|Tutorial]]<br />
*[http://jogamp.org/deployment/ardor3d/javadoc/ API Documentation]<br />
*[[Ardor3D FAQ|FAQ]]<br />
|}</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Main_Page&diff=1758Main Page2015-07-16T18:12:19Z<p>Gouessej: </p>
<hr />
<div>__NOTOC__<br />
{| width="100%"<br />
|-<br />
|<br />
<div><br />
Welcome to the [{{SERVER}}/ JogAmp] wiki. It documents JOGL, JOCL and JOAL, the cross-platform bindings to the OpenGL, OpenCL, and OpenAL APIs.<br />
</div><br />
|-<br />
|<br />
{| style="width: 100%;"<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Getting Started</h3><br />
*[[Downloading and installing JOGL|Downloading and installing]]<br />
**[[Jogamp Versioning and Releases|Versioning and Releases]]<br />
*[[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
*[[Jogamp SCM Repositories|Source Code Repositories]]<br />
*[[SW Tracking|Tracking Reports]]<br />
*[{{SERVER}}/chuck/ Build and Test Server]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Community</h3><br />
*[[How to Contribute|Contribute to JogAmp]]<br />
*[[How to Build|Build JogAmp]]<br />
*[[Maintainer and Contacts]]<br />
*[[Jogl FAQ#Bugreports & Testing|Report a bug]]<br />
**[{{SERVER}}/bugzilla/ Bugzilla]<br />
*[http://forum.jogamp.org/ Ask a question in the forum]<br />
*[[chatroom|JogAmp IRC]]<br />
|}<br />
|-<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>JogAmp Modules</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Roadmaps</h3><br />
* [[SW Tracking Report Objectives for the release 2.3.3|2.3.3]], [[SW Tracking Report Objectives for the release 2.3.2|2.3.2]], [[SW Tracking Report Objectives for the release 2.3.1|2.3.1]], [[SW Tracking Report Objectives for the release 2.3.0|2.3.0]]<br />
* [[SW Tracking Report Objectives for the release 2.2.4|2.2.4]], [[SW Tracking Report Objectives for the release 2.2.3|2.2.3]], [[SW Tracking Report Objectives for the release 2.2.2|2.2.2]], [[SW Tracking Report Objectives for the release 2.2.1|2.2.1]], [[SW Tracking Report Objectives for the release 2.2.0|2.2.0]]<br />
* [[SW Tracking Report Objectives for the release 2.1.5|2.1.5]], [[SW Tracking Report Objectives for the release 2.1.4|2.1.4]], [[SW Tracking Report Objectives for the release 2.1.3|2.1.3]], [[SW Tracking Report Objectives for the release 2.1.2|2.1.2]], [[SW Tracking Report Objectives for the release 2.1.1|2.1.1]], [[SW Tracking Report Objectives for the release 2.1.0|2.1.0]]<br />
* [[SW Tracking Report Objectives for the release 2.0.2 of JOGL|2.0.2]]<br />
|-<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOGL</h3><br />
*[[Jogl Overview|Overview]] [ [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL] ]<br />
*[[Jogl Tutorial|Tutorial]]<br />
*[[Jogl FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jogl.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
*[{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOCL</h3><br />
*[[JOCL Overview|Overview]]<br />
*[[JOCL Tutorial|Tutorial]]<br />
*[[JOCL FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jocl.git;a=blob;f=LICENSE License]<br />
*[{{SERVER}}/deployment/jogamp-next/javadoc/jocl/javadoc/ API Doc]<br />
*[{{SERVER}}/jocl/doc/HowToBuild.html How to Build JOCL]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOAL</h3><br />
*[[Joal Overview|Overview]]<br />
*[[Joal Tutorial|Tutorial]]<br />
*[[Joal FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=joal.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc/ Public], [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc_dev/ Internal] ]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>GlueGen</h3><br />
* [[GlueGen_Wiki|Overview]]<br />
* [{{SERVER}}/git/?p=gluegen.git;a=blob;f=LICENSE.txt License]<br />
* [{{SERVER}}/deployment/jogamp-next/javadoc/gluegen/javadoc/ API Doc]<br />
|}<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>Related Projects</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Java3D</h3><br />
*[[Java3D Overview|Overview]]<br />
*[[Downloading and installing Java3D|Downloading and installing]]<br />
*[[Java3D Tutorial|Tutorial]]<br />
*[[Java3D FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ji Gong</h3><br />
*[[Ji Gong Overview|Overview]]<br />
*[[Ji Gong Motivation|Motivation]]<br />
*[[Ji Gong FAQ|FAQ]]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Source Certification Contract (SCC)</h3><br />
*[[SCC Overview|Overview]]<br />
*[[SCC FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ardor3D</h3><br />
*[[Ardor3D Overview|Overview]]<br />
*[[Ardor3D Tutorial|Tutorial]]<br />
*[http://jogamp.org/deployment/ardor3d/javadoc/|API Documentation]<br />
*[[Ardor3D FAQ|FAQ]]<br />
|}</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Main_Page&diff=1757Main Page2015-07-16T18:12:00Z<p>Gouessej: </p>
<hr />
<div>__NOTOC__<br />
{| width="100%"<br />
|-<br />
|<br />
<div><br />
Welcome to the [{{SERVER}}/ JogAmp] wiki. It documents JOGL, JOCL and JOAL, the cross-platform bindings to the OpenGL, OpenCL, and OpenAL APIs.<br />
</div><br />
|-<br />
|<br />
{| style="width: 100%;"<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Getting Started</h3><br />
*[[Downloading and installing JOGL|Downloading and installing]]<br />
**[[Jogamp Versioning and Releases|Versioning and Releases]]<br />
*[[Setting up a JogAmp project in your favorite IDE|Setting up a JogAmp project in your favorite IDE]]<br />
*[[Jogamp SCM Repositories|Source Code Repositories]]<br />
*[[SW Tracking|Tracking Reports]]<br />
*[{{SERVER}}/chuck/ Build and Test Server]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Community</h3><br />
*[[How to Contribute|Contribute to JogAmp]]<br />
*[[How to Build|Build JogAmp]]<br />
*[[Maintainer and Contacts]]<br />
*[[Jogl FAQ#Bugreports & Testing|Report a bug]]<br />
**[{{SERVER}}/bugzilla/ Bugzilla]<br />
*[http://forum.jogamp.org/ Ask a question in the forum]<br />
*[[chatroom|JogAmp IRC]]<br />
|}<br />
|-<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>JogAmp Modules</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Roadmaps</h3><br />
* [[SW Tracking Report Objectives for the release 2.3.3|2.3.3]], [[SW Tracking Report Objectives for the release 2.3.2|2.3.2]], [[SW Tracking Report Objectives for the release 2.3.1|2.3.1]], [[SW Tracking Report Objectives for the release 2.3.0|2.3.0]]<br />
* [[SW Tracking Report Objectives for the release 2.2.4|2.2.4]], [[SW Tracking Report Objectives for the release 2.2.3|2.2.3]], [[SW Tracking Report Objectives for the release 2.2.2|2.2.2]], [[SW Tracking Report Objectives for the release 2.2.1|2.2.1]], [[SW Tracking Report Objectives for the release 2.2.0|2.2.0]]<br />
* [[SW Tracking Report Objectives for the release 2.1.5|2.1.5]], [[SW Tracking Report Objectives for the release 2.1.4|2.1.4]], [[SW Tracking Report Objectives for the release 2.1.3|2.1.3]], [[SW Tracking Report Objectives for the release 2.1.2|2.1.2]], [[SW Tracking Report Objectives for the release 2.1.1|2.1.1]], [[SW Tracking Report Objectives for the release 2.1.0|2.1.0]]<br />
* [[SW Tracking Report Objectives for the release 2.0.2 of JOGL|2.0.2]]<br />
|-<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOGL</h3><br />
*[[Jogl Overview|Overview]] [ [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL] ]<br />
*[[Jogl Tutorial|Tutorial]]<br />
*[[Jogl FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jogl.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc/ Public], Specs [ [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_nativewindow_spec/ Nativewindow], [{{SERVER}}/deployment/jogamp-next/javadoc/jogl/javadoc_jogl_spec/ JOGL] ] ]<br />
*[{{SERVER}}/jogl/doc/HowToBuild.html How to Build JOGL]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOCL</h3><br />
*[[JOCL Overview|Overview]]<br />
*[[JOCL Tutorial|Tutorial]]<br />
*[[JOCL FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=jocl.git;a=blob;f=LICENSE License]<br />
*[{{SERVER}}/deployment/jogamp-next/javadoc/jocl/javadoc/ API Doc]<br />
*[{{SERVER}}/jocl/doc/HowToBuild.html How to Build JOCL]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>JOAL</h3><br />
*[[Joal Overview|Overview]]<br />
*[[Joal Tutorial|Tutorial]]<br />
*[[Joal FAQ|FAQ]]<br />
*[{{SERVER}}/git/?p=joal.git;a=blob;f=LICENSE.txt License]<br />
*API Doc [ [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc/ Public], [{{SERVER}}/deployment/jogamp-next/javadoc/joal/javadoc_dev/ Internal] ]<br />
<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>GlueGen</h3><br />
* [[GlueGen_Wiki|Overview]]<br />
* [{{SERVER}}/git/?p=gluegen.git;a=blob;f=LICENSE.txt License]<br />
* [{{SERVER}}/deployment/jogamp-next/javadoc/gluegen/javadoc/ API Doc]<br />
|}<br />
<br />
{| style=" width: 100%;"<br />
|-<br />
|colspan="2"|<h1>Related Projects</h1><br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Java3D</h3><br />
*[[Java3D Overview|Overview]]<br />
*[[Downloading and installing Java3D|Downloading and installing]]<br />
*[[Java3D Tutorial|Tutorial]]<br />
*[[Java3D FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ji Gong</h3><br />
*[[Ji Gong Overview|Overview]]<br />
*[[Ji Gong Motivation|Motivation]]<br />
*[[Ji Gong FAQ|FAQ]]<br />
|-<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Source Certification Contract (SCC)</h3><br />
*[[SCC Overview|Overview]]<br />
*[[SCC FAQ|FAQ]]<br />
|style="vertical-align: top; padding: 5px; width: 50%"|<h3>Ardor3D</h3><br />
*[[Ardor3D Overview|Overview]]<br />
*[[Ardor3D Tutorial|Tutorial]]<br />
*[[http://jogamp.org/deployment/ardor3d/javadoc/|API Documentation]]<br />
*[[Ardor3D FAQ|FAQ]]<br />
|}</div>Gouessejhttps://jogamp.org/wiki/index.php?title=Jogl_Overview&diff=1747Jogl Overview2015-04-24T09:45:43Z<p>Gouessej: /* OpenGL Profiles explained */</p>
<hr />
<div>A more detailed document is available: [{{SERVER}}/jogl/doc/Overview-OpenGL-Evolution-And-JOGL.html OpenGL Evolution &amp; JOGL]<br />
<br />
<br />
__TOC__<br />
<br />
== OpenGL Profiles explained ==<br />
<br />
[http://jogamp.org/jogl/doc/uml/html-svg/ JOGL 2 supports several OpenGL Profiles]. This entry explains what profiles are and why they are needed.<br />
<br />
<h5> History </h5><br />
SGI released the first OpenGL specification 1992. Since this point OpenGL 1.x constantly evolved (under the ARB and later Khronos Group) by adding new functions to the core API. This went well until programmable graphics hardware became mainstream and shaders became suddenly more flexible and efficient as the generic fixed function pipeline.<br />
<br />
<h5>OpenGL 2.x </h5><br />
It was the last version in which you could freely mix the fixed function pipeline with the programmable pipeline (as a core feature).<br />
<br />
With the release of OpenGL 3.0 the whole fixed function pipeline has been deprecated but you could still use it if you haven't requested a forward compatible context.<br />
<br />
<h5>OpenGL ES 1.x and ES 2.x</h5><br />
It specifies a subset of OpenGL intended to be used on embedded devices.<br />
ES 1.x is a subset of the OpenGL fixed function pipeline, where ES 2.x is a subset of the<br />
programmable shader hardware only.<br />
<br />
<h5>OpenGL 3.1 and 3.2 </h5><br />
It removed most deprecated functionality from core specification, however some implementations (e.g. Nvidia drivers) still allow to get them back via an optional compatibility extension. Since 3.1 was the first release which broke compatibility, it is often seen as major OpenGL 3 release.<br />
<br />
<h5>JOGL 2</h5><br />
<br />
JOGL 1.1.1 lived in the timeframe up to OpenGL 2.1 which made it easy to stay in sync with the spec. To be able to solve the issue with the deprecation of functionality,<br />
<br />
JOGL 2 [http://jogamp.org/jogl/doc/bouml/html-svg/ introduces an abstraction] of the original OpenGL versioning called Profile. Profiles allow Java applications to be written in a way which allows compatibility with multiple OpenGL versions at the same time. Since OpenGL ES (GL for embedded systems) has overlapping functionality with OpenGL itself it opened the opportunity to add even Profiles which bridge desktop and embedded implementations. The class diagram below shows the dependencies between all available Profiles.</div>Gouessej