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


    Contents⊕
  
  
  GlueGen,
  Native Binding Generator for Java™
  
  Git Repository
  Overview
  
  License
  
  Documentation
  Build Requirements
  Directory Organization:
  Contact Us
  History
  
  
GlueGen, Native
Binding Generator for Java™
Original
document location
Git Repository
This project's canonical repositories is hosted on JogAmp.
Overview
GlueGen is a compiler
for function and data-structure declarations, generating Java™ and JNI C
code offline at compile time and allows using native libraries within
your Java™ application.
GlueGen also provides a comprehensive runtime
library offering

Support for multi-arch and java code fat-jar deployment

Native library including JNI bundle handling and Jar file cache
Platform architecture information retrieval, ELF parser, alignment
etc

Enhanced NIO buffer handling for pointer, arrays, DMA mapping
etc
Network Uri RFC 2396, connection and resource handler to simplify
asset loading
Bitstream, hash maps, ringbuffer, sha cumulator, reflection and
threading utils
Abstract AudioFormat and AudioSink interfaces, concurrent locks ..
and more

GlueGen's compiler reads ANSI C header files and separate
configuration files which provide control over many aspects of the glue
code generation. GlueGen uses a complete ANSI C parser and an internal
representation (IR) capable of representing all C types to represent the
APIs for which it generates interfaces. It has the ability to perform
significant transformations on the IR before glue code emission.
GlueGen can produce native foreign function bindings to Java™ as well
as map native data
structures to be fully accessible from Java™ including potential
calls to embedded
function pointer.
GlueGen supports registering
Java™ callback methods to receive asynchronous and off-thread native
toolkit events, where a generated native callback function dispatches
the events to Java™.
GlueGen also supports producing
an OO-Style API mapping like JOGL's
incremental OpenGL Profile API levels.
GlueGen is capable to bind low-level APIs such as the Java™ Native
Interface (JNI) and the AWT Native Interface (JAWT) back up to the Java
programming language.
Further, GlueGen supports generating
JNI_OnLoad*(..) for dynamic and static libraries, also
resolving off-thread JNIEnv* lookup.
GlueGen utilizes JCPP, migrated C
preprocessor written in Java™.
GlueGen is used for the JogAmp
projects JOAL, JOGL and JOCL.
GlueGen is part of the JogAmp
project.
The JogAmp project needs funding and we offer commercial
support!
 Please contact Göthel Software (Jausoft).
License
See LICENSE.txt.
Documentation

GlueGen
Java™ API-Doc
GlueGen Native Data & Function
Mapping for Java™
GlueGen Manual
JogAmp's MacOS Version
Support
How To
Build

Build Requirements
Check GlueGen's
HowToBuild.
Directory Organization:
make/           Build-related files and the main build.xml
doc/            Documentation
jcpp/           JCPP (git sub-module), migrated C preprocessor written in Java
src/            The actual source for the JOAL APIs.
src/junit/      Unit tests
test/           Standalone manual tests
build/          (generated directory) Where the Jar and DLL files get built to
www/            JOAL project webpage files
Contact Us

JogAmp http://jogamp.org/
JOAL Web http://jogamp.org/
Forum/Mailinglist http://forum.jogamp.org/
Repository http://jogamp.org/git/
Wiki https://jogamp.org/wiki/
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

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