aboutsummaryrefslogtreecommitdiffstats
path: root/www/index.html
blob: c99a8190baf7edb2027b6c1b208ec455d02be2f3 (plain)
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
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
        <link href="../../style.css" rel="stylesheet" type="text/css"/>
        <link href="../../style-alt1.css" rel="alternate stylesheet" title="default sans-serif font" type="text/css"/>
        <title>Gluegen</title>
    </head>
    <body>
        <div id="container">
            <div id="header">
                <div id="slogan">Native Binding Generator for Java™</div>
                <div id="logo"><a href="http://jogamp.org/">Gluegen</a></div>
            </div>
            <div id="menu">
                <ul>
                    <li><a href="http://jogamp.org/">Home</a></li>
                    <li><a href="../../joal/www/">JOAL</a></li>
                    <li><a href="../../jocl/www/">JOCL</a></li>
                    <li><a href="../../jogl/www/">JOGL</a></li>
                    <li><a href="../../demos/www/">Demos</a></li>
                    <li><a href="../../wiki/">Wiki</a></li>
                    <li><a href="../../deployment/jogamp-next/javadoc/gluegen/javadoc/">JavaDoc</a></li>
                    <li><a href="../../blog/">Blogs</a></li>
                    <li><a href="../../forum.html">Forums</a></li>
                </ul>
            </div>
            <div id="main">
                <div id="sidebar">
                    <h3>Useful Links</h3>
                    <ul>
                        <li><a href="https://jogamp.org/cgit/gluegen.git/about/">GlueGen Git Repo</a></li>
                        <li><a href="../../deployment/jogamp-next/javadoc/gluegen/javadoc/">GlueGen API-Doc</a></li>
                        <li><a href="../doc/GlueGen_Mapping.html">GlueGen Native Data & Function Mapping</a></li>
                        <li><a href="../doc/manual/">GlueGen Manual</a></li>
                        <li><a href="../doc/HowToBuild.html">How To Build</a></li>
                        <li><a href="../doc/JogAmpMacOSVersions.html">JogAmp's MacOS Version Support</a></li>
                    </ul>

                </div>
                <div id="text" class="fill">
                    <p>
                        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.
                    </p>
                    <p>
                        It 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. 
                    </p>
                    <p>
                        GlueGen can produce native foreign function bindings to Java™ as well as
                        <a href="../doc/GlueGen_Mapping.html#struct-mapping">map native data structures</a> to be fully accessible from Java™ including 
                        potential calls to <a href="../doc/GlueGen_Mapping.html#struct-function-pointer-support">embedded function pointer</a>.
                    </p>
                    <p>
                        GlueGen supports <a href="../doc/GlueGen_Mapping.html#java-callback-from-native-c-api-support">registering Java™ callback methods</a>
                        to receive asynchronous and off-thread native toolkit events,
                        where a generated native callback function dispatches the events to Java™.
                    </p>
                    <p>
                        GlueGen also supports <a href="../doc/GlueGen_Mapping.html#oo-style-api-interface-mapping">producing an OO-Style API mapping</a> like <a href="../../jogl/doc/uml/html/index.html">JOGL's incremental OpenGL Profile API levels</a>.
                    </p>
                    <p>
                        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.
                    </p>
                    <p>
                        Further, GlueGen supports generating `JNI_OnLoad(..)` for dynamic and `JNI_OnLoad_{LibraryBasename}(..)` for static libraries via <a href="../doc/GlueGen_Mapping.html#libraryonload-librarybasename-for-jni_onload-">`LibraryOnLoad Bindingtest2`</a>, which also provides `JVMUtil_GetJNIEnv(..)` to resolve the `JNIEnv*` as used by <a href="../doc/GlueGen_Mapping.html#java-callback-from-native-c-api-support">Java™ callback methods</a>.
                    </p>
                    <p>
                        GlueGen utilizes <a href="https://jogamp.org/cgit/jcpp.git/about/">JCPP</a>, migrated C preprocessor written in Java™.
                    </p>
                    <p>
                        GlueGen is used for the JogAmp projects
                        <a href="../../joal/www/">JOAL</a>,
                        <a href="../../jogl/www/">JOGL</a> and
                        <a href="../../jocl/www/">JOCL</a>.
                    </p>
                    <p>
                        <h3>Documentation</h3>
                        <ul>
                        <li><a href="https://jogamp.org/cgit/gluegen.git/about/">GlueGen Git Repo</a></li>
                        <li><a href="../../deployment/jogamp-next/javadoc/gluegen/javadoc/">GlueGen API-Doc</a></li>
                        <li><a href="../doc/GlueGen_Mapping.html">GlueGen Native Data & Function Mapping</a></li>
                        <li><a href="../doc/manual/">GlueGen Manual</a></li>
                        <li><a href="../doc/HowToBuild.html">How To Build</a></li>
                        <li><a href="../doc/JogAmpMacOSVersions.html">JogAmp's MacOS Version Support</a></li>
                        </ul>
                    </p>

                </div>
            </div>
            <div id="footer">
                <div id="footer_left">
                    <span>JogAmp.org</span>
                    by <a href="http://jogamp.org">http://jogamp.org</a>
                    is licensed under a <br/>
                    <a href="http://creativecommons.org/licenses/by/3.0/us/">Creative Commons Attribution 3.0 License</a>.
                </div>
            </div>
        </div>
    </body>
</html>