aboutsummaryrefslogtreecommitdiffstats
path: root/INSTALL.txt
blob: 279e30b80ed219118688d6002abc55bdf07b32af (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
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
\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
	
  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/.

        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 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
10th April 2001


---------------------

\end{verbatim}