sgothel / jogl

Java™ Binding for the OpenGL® API

JOGL, High-Performance Graphics Binding for Java™

Original document location

Git Repository

This project's canonical repositories is hosted on JogAmp.

Overview

The JOGL project hosts the development of high-performance graphics binding for Java™, and is designed to provide hardware-supported 3D graphics and multimedia to applications written in Java™.

JOGL provides full access to the APIs in the OpenGL® [ 1.0 .. 4.5 ], ES [ 1.0 .. 3.2 ] and EGL [ 1.0 .. 1.5 ] specification as well as nearly all vendor extensions. OpenGL Evolution & JOGL and this API Specification may give you a brief overview.

JOGL also embraces multimedia technology and binds to FFMpeg as well as to other media libraries providing a unified access API with JOAL. Further, stereo devices are supported in a generic fashion as well as for early OculusVR.

JOGL integrates with the AWT, Swing, OpenJFX and SWT widget sets, as well as with custom windowing toolkits using the NativeWindow API.

JOGL also provides its own native windowing toolkit, NEWT, running on top of X11, Windows, MacOS and even on bare-metal console mode without a windowing system.

JOGL contains Graph, a resolution-independent GPU NURBS curve renderer suitable for desktop and embedded devices and supporting text type rendering [ paper, slides ]. Graph is used in the contained GraphUI, enabling immersive UI within the 3D scene.

JOGL is part of the JogAmp project.

List of proposed work items & use-cases and current blog entries.

The JogAmp project needs funding and we offer commercial support!
Please contact Göthel Software (Jausoft).

Organization of the JOGL source tree

doc/                Build and user documentation
make/               Ant build scripts
make/config         Configuration files for glue code generation
make/stub_includes  Header files for glue code generation
src/                Java and native source code for:
src/jogl            - JOGL
src/nativewindow    - NativeWindow Interface
src/newt            - NEWT
src/graphui         - GraphUI
src/demos           - Demos
src/test            - Unit tests
www/                Web pages

NativeWindow, NEWT and GraphUI might be build seperately.

Contact Us

• Forum/Mailinglist http://forum.jogamp.org/
• Maintainer https://jogamp.org/wiki/index.php/Maintainer_and_Contacts
• Sven's Blog https://jausoft.com/blog/tag/jogamp/
• Email sgothel at jausoft dot com

References

• JogAmp Home
• JOGL Home
• Git Repository
• OpenGL Evolution & JOGL
• Mapping of OpenGL Profiles to Interfaces
  • OpenGL API Inclusion Criteria
  • UML Diagram
• JOGL and OpenGL Divergence
• How To Build
• Wiki

JogAmp History & Milestones

Bottom line, too much work has been performed to be listed here.
However, let's have a few sentimental points listed and we may add a few more as we go.

OpenGL™ for Java™ (GL4Java)

OpenGL™ for Java™ (GL4Java) was developed from March 1997 until March 2003.
Its concepts were reused in the subsequently launched JOGL project
initially lead by Sun Microsystems and later by the JogAmp community,
rendering GL4Java effectively JOGL's predecessor. A few of the concepts reused were:

• C-Header Compiler to JNI glue code: C2J -> GlueGen
• AWT integration: GLCanvas, GLJPanel (swing)
• WinHandleAccess -> NativeWindow
• GLDrawableFactory, GLDrawable, GLContext, GLEvenListener

GlueGen, JOAL and JOGL at Sun Microsystems & Co

• 2003-06-06 Initial JOGL code commit
• 2003-06-07 Initial JOAL code commit
• 2004-02-18 JOGL version 1.0.0-b01
• 2006-01-15 GlueGen separation from JOGL, own project + repo
• 2007-03-13 JSR-231 1st Maintencance Release
• 2007-04-19 JOGL Version 1.1.0
• 2008-04-29 JSR-231 2nd Maintencance Release
• 2008-04-30 JOGL Version 1.1.1
• 2008-05-22 JOGL on an embedded Nvidia APX 2500 (Tegra1), JavaOne 2008
• 2008-06-01 JOGL 2 Start: NEWT, NativeWindow abstraction, OpenGL profiles, ...
• 2008-12-xx OpenMAX and JOGL GL ES2 on embedded Nvidia APX 2500 (Tegra1)
• 2009-06-16 Merged JOGL 2 Branch: NEWT, NativeWindow abstraction, OpenGL profiles, ...
• 2009-07-09 completed git migration, see also this blog
• 2009-07-24 JOCL initiation, independent from Sun
• 2009-10-02 Adding embedded Intel-GDL support (NEWT, EGL, ES2) to JOGL
• 2009-10-10 JOGL Plugin3 Integration

JogAmp Period

• 2009-11-10 Away from Sun Microsystems, see also this blog
• 2010-05-07 JogAmp launch ...
• 2010-10-01 NEWT/AWT Reparenting
• 2010-11-23 JogAmp RC v2.0-rc1
• 2011-02-20 JogAmp Production Home in Germany
• Resolution Independent NURBS @ GPU (the essential GraphUI toolkit)
  • 2011-04-01 First artifacts
  • 2011-10-05 Paper and software release
• 2011-08-17 Work on embedded devices and Android
• 2012-04-19 Added streaming audio/video player, JOGL on desktop & mobile status
• 2013-02-20 Java3D Continuation and its git repo
• 2013-07-24 First JogAmp Release 2.0.2
• 2015-03-11 JogAmp Release 2.3.0
• 2015-10-10 JogAmp Release 2.3.2
• 2015-11-08 JOCL: OpenCL 2.0 Support
• 2018-01-28 Ardor3D Continuation and its git repo
• JogAmp on iOS
  • 2019-06-23 First iOS Visuals, running on my own custom OpenJDK build
  • 2019-07-08 Fully working NEWT + JOGL on iOS
• 2019-11-30 Java11, support for DRM/GBM and iOS etc
• 2023-01-15 Added MacOS aarch64 support
• 2023-01-22 Added SWT 4.26 support (JOGL)
• 2023-01-31 Added NEWT Windows/X11 (Soft) PixelScale support (JOGL)
• 2023-02-01 JogAmp Release 2.4.0
• 2023-02-24 FFmpeg Binding Update
• Revamp Graph Type Rendering and Graph UI
  • 2023-02-22 Reimagine Java on Desktop & Bare-Metal Devices
  • 2023-04-10 Type Animation Update 2
  • 2023-04-14 FontView App (Micro FontForge)
  • 2023-05-23 JOAL/OpenAL + GraphUI
• 2023-05-06 Supported MacOS Version
• 2023-05-15 Fixed DPI Scaling with AWT and AWT+NEWT (JOGL)
• 2023-05-20 JOAL: OpenAL-Soft v1.23.1, git about, www face.
• 2023-06-16 GlueGen Updates
  • 2023-06-16 GlueGen Revised Struct Mapping
  • 2023-06-16 Added GlueGen git-about and updated www face
  • 2023-07-10 Added GlueGen JavaCallback w/ AL_SOFT_events support in JOAL

Conferences

• JavaOne 2002 (GL4Java), 2003, 2004, 2006, 2007, 2008
• Siggraph 2010, 2011, 2012, 2013, 2014
• Fosdem 2013, 2014

Papers

Santina, Rami. Resolution Independent NURBS Curve Rendering using Programmable Graphics Pipeline. GraphiCon'2011. Paper, Slides, Initial Blog, Blog Series

Acknowledgments

The JogAmp Community is grateful for all the contributions of all of the individuals who have advanced the project. For sure we are not able to list all of them here. Please contact us if you like to be added to this list.

This list can hardly cover all contributors and their contributions.

Since roughly 2010, JOGL development has been continued by individuals of the JogAmp community, see git log for details.

Chronological

Sven Gothel created OpenGL™ for Java™ (GL4Java) in March 1997 and maintained it up until March 2003.

Kenneth Bradley Russell and Christopher John Kline developed JOGL, acquired by Sun Microsystems and released the first public version in 2003.

Gerard Ziemski contributed the original port of JOGL to Mac OS X.

Rob Grzywinski and Artur Biesiadowski contributed the Ant build support. Alex Radeski contributed the cpptasks support in the build process.

Pepijn Van Eeckhoudt and Nathan Parker Burg contributed the Java port of the GLU tessellator. Pepijn also contributed the initial version of the FPSAnimator utility class.

James Walsh (GKW) contributed the substantial port of the GLU mipmap generation code to Java, as well as robustness fixes in the Windows implementation and other areas.

The JSR-231 expert group as a whole provided valuable discussions and guidance in the design of the current APIs. In particular, Kevin Rushforth, Daniel Rice and Travis Bryson were instrumental in the design of the current APIs.

Travis Bryson did extensive work on the GlueGen tool to make it conform to the desired API design. He also shepherded JSR-231 through the standardization process, doing extensive cross-validation of the APIs and implementation along the way, and authored JOGL's nightly build system.

Lilian Chamontin contributed the JOGLAppletLauncher, opening new ways of deploying 3D over the web.

Christopher Campbell collaborated closely with the JOGL development team to enable interoperability between Sun's OpenGL pipeline for Java2D and JOGL in Java SE 6, and also co-authored the TextureIO subsystem.

Sven Gothel refactored the windowing subsystem layer to be generic, introduced the support for multiple GL profiles, realized NEWT etc. He teamed up with Rami Santina, realizing the new graph package exposing generic curve, text and UI support.

Rami Santina researched and implemented the math behind the new graph package RSantina, etc.

The following individuals made significant contributions to various areas of the project (Alphabetical):

• Michael Bien
• Artur Biesiadowski
• Travis Bryson
• Nathan Parker Burg
• Lilian Chamontin
• Alban Cousinié
• Pepijn Van Eeckhoudt
• Mathieu Féry
• Athomas Goldberg
• Sven Gothel
• Julien Gouesse
• Rob Grzywinski
• Yuri Vladimir Gushchin
• Harvey Harrison
• Christopher John Kline
• Martin Pernollet
• Gregory Pierce
• Emmanuel Puybaret
• Xerxes Rånby
• Alex Radeski
• Daniel Rice
• Kevin Rushforth
• Kenneth Bradley Russell
• Rami Santina
• Dominik Ströhlein (DemoscenePassivist)
• Dmitri Trembovetski
• Wade Walker
• James Walsh (GKW)
• Carsten Weisse
• Gerard Ziemski

The JogAmp Community is grateful for the support of the javagaming.org community and it's own JogAmp forum, from where dozens, if not hundreds, of individuals have contributed discussions, bug reports, bug fixes, and other forms of support.