README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247


    Contents⊕
  
  
  JOGL,
  High-Performance Graphics Binding for Java™
  
  Git Repository
  Overview
  Organization of
  the JOGL source tree
  Contact Us
  References
  JogAmp History &
  Milestones
  
  OpenGL™ for Java™
  (GL4Java)
  GlueGen,
  JOAL and JOGL at Sun Microsystems & Co
  JogAmp Period
  Conferences
  Papers
  
  Acknowledgments
  
  Chronological
  
  
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 launched JOGL @ Sun
Microsystems in 2003 having authored the first version.
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.