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
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
|
\begin{verbatim}
WHERE DO YOU GET the current version of GL4Java ?
================================================
Installer
==========
http://www.jausoft.com/Files/Java/1.1.X/GL4Java/Installer
If you use the JRE >= 1.3 plugin
within you Web-Browser or appletviewer to:
- Install GL4Java
- Run the demo's from the GL4Java Website
you must add privileges to your
jre/lib/security/java.policy
file.
Here are the privileges for this purpose:
http://www.jausoft.com/Files/Java/1.1.X/GL4Java/demos/gl4java.policy
or from this directory:
demos/gl4java.policy
Manually for Unix, Windows, ...
================================
http://www.jausoft.com/Files/Java/1.1.X/GL4Java/
binpkg/png-1.0a-jar.zip (the PNG-JAR file)
binpkg/gl4javaX.Y.Z.R-jar.zip (the JAR file)
binpkg/gl4javaX.Y.Z.R-glutfonts-jar.zip (the JAR file)
binpkg/gl4javaX.Y.Z.R-classes.zip (the classes in a ZIP)
binpkg/gl4javaX.Y.Z.R-glutfonts-classes.zip (the classes in a ZIP)
binpkg/libGL4JavaX.Y.Z.R-<UNIX-TYPE>.tar.gz (the native libs - unix)
binpkg/libGL4JavaX.Y.Z.R-<WIN32-TYPE>.zip (the native libs - win32)
archive/GL4JavaX.Y.Z.R-demos.zip (demos - for users :-)
archive/GL4JavaX.Y.Z.R-src.tgz (sources no demos - for developers :-)
archive/GL4JavaX.Y.Z.R-doc.tgz (everything - for the patiente :-)
(where X is the major, Y the minor, Z the bugfix and R the release
library version number !
Take a look at VERSIONS.txt for a closer description !
)
The Documentation
=================
It is recommended to check the documentation (so much work on it ;-).
Just download the file 'GL4JavaX.Y.Z-doc.tgz' and un-gzip and un-tar it
(Windows users may use WinZip here :-)
Now you can read the HTML-Documentation with:
<YourHtmlBrowser> GL4Java/docs/index.html
Or you can read the Postscript version with:
<YourPostScriptViewer> GL4Java/docs/GL4Java.ps
Special Java2 Installation file:
Java2.txt
Special Netscape Installation file:
Netscape.txt
Special MS-JVM Installation file:
MS-JVM.txt
YOU MUST ALLREADY HAVE THE FOLLOWING INSTALLED:
===============================================
COMMON:
=======
o >= jdk 1.1.5 (for using)
o >= jdk 1.2 (for developing)
tested:
jdk1.1.7 (win32 (plus jit), linux (plus jit (tya v3.0)))
jdk1.2 (win32, linux (Pre-V1,native,no-jit))
Java2 (Java1.2) Plug-In on Netscape 4.5 (Win32)
Netscape 4.5 (Win32)
UNIX / X11 :
============
o ( GL + GLU ) or ( MesaGL + MesaGLU Version 3.0 or higher)
AND glut (only for c-demos yet)
We are looking for libGL.so AND libGLU.so in your library PATH,
so please create a symbolic link from the Mesa libs,
to the abstract one's !!
o X11R6 (XFree86 works fine ;-)
o Unix standard file-utilities (tar, gzip, ...)
WINDOWS 32 (NT & 95)
====================
o M$ OpenGL and GLU library - !!!! MUST !!!!
see if you have opengl32.dll AND glu32.dll
installed in your library path
(c:/winnt/system32 OR c:/windows/system)
o For running GL4Java within MS-JVM:
Be sure you have the new MS-JVM machine (build 3186) installed:
Microsoft (R) VM for Java, 5.0 Release 5.0.0.3186
o Unix standard file-utilities (tar, gzip, ...)
OR WinZip (can extract tar-files ;-)
Manual Installation procedure for UNIX/WINDOWs BINARY DISTRIBUTION:
===================================================================
UNICE and WINDOWs USERS JAVA ARCHIVE
=====================================
o Choose a version number X.Y.Z.R !
Be shure that the version numbers X.Y are the same
for the gl4java.jar file and the native libraries !
The closest version number match provides the best compatibility !
o download the gl4java.jar files, which is zipped in
binpkg/gl4javaX.Y.Z.R-jar.zip (the JAR file)
binpkg/gl4javaX.Y.Z.R-glutfonts-jar.zip (the JAR file)
o unzip the downloaded gl4javaX.Y.Z.R*-jar.zip files,
this will result a file called gl4java.jar and gl4java-glutfonts.jar !
o download the png.jar file, which is zipped in
binpkg/png-1.0a-jar.zip (the PNG-JAR file)
o unzip the downloaded png-1.0a-jar.zip file,
this will result a file called png.jar !
o Add gl4java.jar AND png.jar to your CLASSPATH (echo \$CLASSPATH)
if you use Java 1.1.X !
o If you use JAVA2 or JRE - copy gl4java.jar AND png.jar to :
./jre/lib/ext/.
o If you use JAVA2 Plug-In copy gl4java.jar AND png.jar to :
./jre/lib/.
(looks like a bug, because the Java2-PlugIn does not find
the gl4java.jar file in the ./jre/lib/ext directory )
UNICE USERS NATIVE LIBRARY
============================
o download the native libraries, which is zipped in
binpkg/libGL4JavaX.Y.Z.R-<UNIX-TYPE>.tar.gz (the native libs - unix)
o change to a directory which is within your LD_LIBRARY_PATH
environment variable !
(Look at 'echo $LD_LIBRARY_PATH').
Usual /usr/lib !
o unpack the downloaded libGL4JavaX.Y.Z.R-<UNIX-TYPE>.tar.gz,
this will result some files called libGL4Java*.so* !
If you want to copy the extracted library files,
be sure to use 'cp -a' to keep the symbolic links alive !
o If you use JAVA2, JAVA2-Plug-In or JRE - you _can_ copy the libs to :
./jre/lib/<machine>/.
e.g. linux:
./jre/lib/i386/.
or
./jre/lib/i386/green-threads/.
Be sure to use 'cp -a' to keep the symbolic links alive !
o If you want to use Netscape 4.5 or above,
please read Netscape.txt
WINDOWs USERS NATIVE LIBRARY
============================
o download the native libraries, which is zipped in
binpkg/libGL4JavaX.Y.Z.R-<WIN32-TYPE>.zip (the native libs - win32)
o unzip the downloaded libGL4JavaX.Y.Z.R-<WIN32-TYPE>.zip,
this will result some files called GL4Java*.dll !
o Then copy the libraries
to c:/winnt/system32 (WINNT), c:/windows/system (WIN9X)
or where the other's *.dll files exits !
You can also copy the files (better) to /java2/jre/bin if using java2 !
o If you use JAVA2, JAVA2-Plug-In or JRE - you _can_ copy the libs also to :
./jre/bin/.
o If you want to use Netscape 4.5 or above,
please read Netscape.txt
o If you use MS-JVM (MS-InternetExplorer >=4.0)
please read MS-JVM.txt
UNICE and WINDOWs USERS
=======================
o You can check the installation and the used library versions with:
java gl4java.GLContext
o You can now download the demos-archive GL4JavaX.Y.Z.R-demos.zip
This will create the directory GL4Java/demos !
Just try the demos while typing:
cd demos
java glDemosCvs
This will invoke the demo-manager !
o To allow JAVA2's appletviewer using JNI native libs,
just look at GL4Java/demo/Java2Applet.bat
(You have to change the gl4java.policy file) !
You can - of course - use your 'policytool',
which is shipped with JAVA2 !
To use the demo Applets for Java2-Plug-In from www.jausoft.com,
please add the following lines to your java.policy file:
grant codeBase "http://www.jausoft.com/Files/Java/1.1.X/GL4Java/demos/-" {
permission java.security.AllPermission;
};
o You can check JAVA2-Plug-In with the Java-Applets-Html-File's
demos/glLogoCvsAppletJ2P.html
demos/glOlympicCvsAppletJ2P.html
demos/testTextPPM1J2P.html
o You can check Netscape Win32-JVM with the Java-Applets-Html-File's
demos/glLogoCvsApplet.html
demos/glOlympicCvsApplet.html
demos/testTextPPM1.html (copy swingall.jar of Swing1.1 to
./Netcape/Communicator/Program/Java/classes )
o You can check MS-InternetExplorer >= 4.0 with the Java-Applets-Html-File's
demos/glLogoCvsApplet.html
demos/glOlympicCvsApplet.html
demos/testTextPPM1.html (extract swingall.jar of Swing1.1 to
C:\WINDOWS\Java\TRUSTLIB - and delete
C:\WINDOWS\Java\TRUSTLIB\META-INF !)
o you will find further documentations in docs/html/GL4Java.html
or docs/GL4Java.ps !
(Download GL4JavaX.Y.Z.R-doc.tgz,
or check it online - search for it at www.jausoft.com :-)
have a lot of fun, responses and ideas are welcome !
Sven Goethel
6th July 1998
22 April 1999
1st June 1999
2nd September 1999
16th Novemeber 1999
7th March 2000
---------------------
\end{verbatim}
|
