|Stable release||2.3.2 / October 10, 2015|
|Preview release||2.3.2 / October 10, 2015|
|Written in||Java, C|
|Type||3D computer graphics software (library/API)|
Java OpenGL (JOGL) is a wrapper library that allows OpenGL to be used in the Java programming language. It was originally developed by Kenneth Bradley Russell and Christopher John Kline, and was further developed by the Sun Microsystems Game Technology Group. Since 2010, it has been an independent open source project under a BSD license. It is the reference implementation for Java Bindings for OpenGL (JSR-231).
JOGL allows access to most OpenGL features available to C language programs through the use of the Java Native Interface (JNI). It offers access to both the standard GL* functions along with the GLU* functions; however the OpenGL Utility Toolkit (GLUT) library is not available for window-system related calls, as Java has its own windowing systems: Abstract Window Toolkit (AWT), Swing, and some extensions.
JOGL differs from some other Java OpenGL wrapper libraries in that it merely exposes the procedural OpenGL API via methods on a few classes, rather than trying to map OpenGL functionality onto the object-oriented programming paradigm. Indeed, most of the JOGL code is autogenerated from the OpenGL C header files via a conversion tool named GlueGen, which was programmed specifically to facilitate the creation of JOGL.
This design decision has both its advantages and disadvantages. The procedural and state machine nature of OpenGL is inconsistent with the typical method of programming under Java, which is bothersome to many programmers. However, the straightforward mapping of the OpenGL C API to Java methods makes conversion of existing C applications and example code much simpler. The thin layer of abstraction provided by JOGL makes runtime execution quite efficient, but accordingly is more difficult to code compared to higher-level abstraction libraries like Java3D. Because most of the code is autogenerated, changes to OpenGL can be rapidly added to JOGL.
Status and standardization
As of 2015[update], JOGL provides full access to the OpenGL 4.5 specification as well as almost all vendor extensions (and OpenCL, OpenMAX and OpenAL). The 1.1.0 version is the reference implementation for JSR-231 (Java Bindings for OpenGL). The 1.1.1 release gave limited access to GLU NURBS, providing rendering of curved lines and surfaces via the traditional GLU APIs. The 2.3.2 release added support for OpenGL versions up to 4.5, and OpenGL ES versions up to 3.2.
Wayland support is planned.
- Overlay Swing components (lightweight menus, tooltips, and other widgets) on top of OpenGL rendering.
- Draw 3D OpenGL graphics on top of Java2D rendering (see here for a button with an OpenGL icon).
- Use 3D graphics anywhere where ordinarily a Swing widget would be used. (Inside a JTable, JTree, ...)
- Draw Java2D graphics on top of 3D OpenGL rendering.
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 (like in this much more complicated example).
- Java Bindings for OpenGL, The Java Community Specification Request for which JOGL provides an implementation
- Ardor3D, a high performance, professionally oriented scene graph using several bindings for OpenGL and OpenGL-ES including JOGL
- Elflight Engine, a high performance 3D game engine optimised for the web
- JMonkey Engine, a high performance scene graph based graphics API using several bindings for OpenGL and OpenGL-ES including JOGL
- Poxnora, an online multiplayer game using JOGL
- RuneScape, a MMORPG using JOGL
- Jake2, a Java port of Quake II using several bindings for OpenGL including JOGL for its low-level graphic API
- Scilab, a numerical computing program using JOGL for 2D, 3D rendering
- Jreality, a mathematical visualization package
- ClearVolume, a JOGL powered real-time live 3D visualization library designed for high-end volumetric light sheet microscopes.
- LWJGL, an alternative open-source OpenGL wrapper library
- "Open source Java projects: Java Binding for OpenGL (JOGL)". JavaWorld. 2008-09-18. Retrieved 2011-02-06.
JOGL originated as a project named Jungle, which was created by 3D graphics experts Ken Russell (of Sun Microsystems) and Chris Kline (of Irrational Games).
- "Hello JOGL". JavaWorld. 2005-02-21. Retrieved 2011-02-06.
- "3D & Multimedia Across Platforms and Devices Using JOGL" (PDF). SIGGRAPH. 2010-07-27. Retrieved 2011-02-06.
- "JSR-000231 Java Bindings for the OpenGL API". Java Community Process. Retrieved 2011-02-06.
In order to facilitate maximum community participation for the Java Binding for the OpenGL API, we use the JOGL project on java.net found at https://jogl.dev.java.net. The JOGL source code can be found there, licensed under a liberal source code license (mostly licensed as BSD except where we use other parties' licensed code). We take a snapshot of the code from this project every few months, run the Technology Compatibility Kit on the source code, and then officially make it the Reference Implementation for each formal Java Binding for the OpenGL API release.
- "Bug 794 - Add Wayland Windowing/Surface Interoperability". 2013-08-05.
- Official website
- JOGL 2.3.x Specification
- JSR-231 Java Bindings for OpenGL website
- tool kiet, The OpenGL Programming Guide examples using JOGL
- NeHe's tutorials and sample code
- Setting up a JogAmp JOGL project in your favorite IDE
- Viewer3D, an applet to display interactive 3D content with JOGL
- Eclipse OpenGL Pack OpenGL plugin for the Eclipse IDE