summaryrefslogtreecommitdiffstats
path: root/doc/deployment/JOGL-JAR-BUNDELING.txt
blob: cf4edd7a31774f9eb3deed1ded97832a6fe8d79a (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
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

+++++++++++++++++++++++++++++
+++ Native Libraries ++++++++
+++++++++++++++++++++++++++++

Gluegen native libraries
    libgluegen-rt.so

NativeWindow native libraries
    libnativewindow_awt.so
    libnativewindow_jvm.so
    libnativewindow_x11.so


JOGL native libraries
    libjogl_desktop.so  
    libjogl_gl2es12.so
    libjogl_es1.so  
    libjogl_es2.so  
    libjogl_cg.so  

NEWT native libraries
    libnewt.so

+++++++++++++++++++++++++++++
+++ Gluegen - Mandatory +++++
+++++++++++++++++++++++++++++

Gluegen JAR - Always

    Core [pick 1]
        gluegen-rt.jar

+++++++++++++++++++++++++++++
+++ All In One Deployment +++
+++++++++++++++++++++++++++++

This might be the best solution
for desktop (maybe webstart).

It is much faster to download
a (maybe bigger) file once and cache 
it for most purposes, than to download
tens of files where its cache might not 
be reuseable.


With AWT:
    nativewindow.all.jar
    jogl.all.jar
    newt.all.jar (optional, if AWT is used only)


Without AWT
    nativewindow.all-noawt.jar
    jogl.all-noawt.jar
    newt.all-noawt.jar


+++++++++++++++++++++++++++++
+++ Atomic Deployment +++++++
+++++++++++++++++++++++++++++

This is a fine tuned solution 
where every byte counts.

It is also possible to use this 
strategy as a starting point for
efficient manual deployment.

Cores:
    nativewindow.core.jar
    jogl.core.jar

    Newt (optional):
        newt.core.jar
        newt.ogl.jar  (to use NEWT with JOGL)


Platform (x11/win/osx/embedded)

    Chose the same platform for all picks :)

    NativeWindow [pick 0..1]:
        nativewindow.os.x11.jar

    Jogl [pick 1]:
        jogl.egl.jar
        jogl.os.x11.jar
        jogl.os.win.jar
        jogl.os.osx.jar

    Newt [pick 0..1] (optional):
        newt.os.x11.jar
        newt.os.win.jar
        newt.os.osx.jar


Jogl GL [pick 1..n]
    jogl.gles1.jar
    jogl.gles1.dbg.jar
    jogl.gles2.jar
    jogl.gles2.dbg.jar

    jogl.gl2es12.jar

    jogl.gl2.jar
    jogl.gl2.dbg.jar

    jogl.gl3.jar
    jogl.gl3.dbg.jar

    jogl.gl4.jar
    jogl.gl4.dbg.jar


Jogl Toolkits/Misc [pick n] (optional):
    jogl.util.jar
    jogl.util.gl2.jar
    jogl.util.fixedfuncemu.jar


AWT [pick n] (optional):
    nativewindow.awt.jar

    jogl.awt.jar
    jogl.util.awt.jar (if using jogl.util)

    newt.awt.jar

GLU [pick n] (optional):
    jogl.glutess.jar
    jogl.glumipmap.jar
    jogl.glugl2.jar