This commit is contained in:
gferg 2000-12-06 23:40:12 +00:00
parent 33e40d0e80
commit bd10b27e89
1 changed files with 167 additions and 10 deletions

View File

@ -19,8 +19,8 @@
<revhistory>
<revision>
<revnumber>v1.3</revnumber>
<date>Nov 26, 2000</date>
<revnumber>v1.4</revnumber>
<date>Dec 6, 2000</date>
<authorinitials>rbe</authorinitials>
</revision>
</revhistory>
@ -31,9 +31,9 @@
Nvidia graphics cards on Linux. In addition to just installing the
Nvidia drivers, this mini-HOWTO also explains how to install XFree86, the
OpenGL Utility library (part of Mesa), the OpenGL Utility Toolkit (glut),
the full set of OpenGL manpages, and Qt and its OpenGL extension so
that a user can have a complete runtime and development environment
for OpenGL applications on Linux.
the full set of OpenGL manpages, Qt and its OpenGL extension, and Java and
its Java 3D extension so that a user can have a complete runtime and
development environment for OpenGL applications on Linux.
</para>
</abstract>
@ -47,9 +47,9 @@
Nvidia graphics cards on Linux. In addition to just installing the
Nvidia drivers, this mini-HOWTO also explains how to install XFree86, the
OpenGL Utility library (part of Mesa), the OpenGL Utility Toolkit (glut),
the full set of OpenGL manpages, and Qt and its OpenGL extension so
that a user can have a complete runtime and development environment
for OpenGL applications on Linux.
the full set of OpenGL manpages, Qt and its OpenGL extension, and Java and
its Java 3D extension so that a user can have a complete runtime and
development environment for OpenGL applications on Linux.
</para>
<sect2>
@ -329,6 +329,35 @@
are Nvidia's own hardware accelerated OpenGL implementation.
</para>
<para>
Java 2 SDK, Java 3D extension, and Java PlugIn for Netscape (optional)
</para>
<para>
The following files are available at <ulink url="http://www.blackdown.org/">http://www.blackdown.org/</ulink>:
</para>
<itemizedlist>
<listitem><para>j2sdk-1.2.2-FCS-linux-i386-glibc-2.1.3.tar.bz2</para></listitem>
<listitem><para>java3d1_2-FCS-linux-i386-sdk.tar.bz2</para></listitem>
<listitem><para>JavaPlugIn-1.2.2-FCS-linux-i386-glibc-2.1.3.run</para></listitem>
</itemizedlist>
<para>
Note that to install these Java files, your system needs to have glibc 2.1.3 or better.
To check your version of glibc:
<screen>
ls -l /lib/libc*
</screen>
</para>
<para>
The Java 3D media extension contains many 3D demo programs/applets and takes advantage of the
OpenGL hardware acceleration on the system. The Java 3D API uses the OpenGL API or, on Windows,
the DirectX/3D API internally. The demos run as normal java applications and also as applets
inside netscape (4.7x) via the Java PlugIn!
</para>
</sect1>
<sect1 id="instx">
@ -405,12 +434,14 @@
make install
make install.man
-- make symlinks for include files
-- make symlinks
cd /usr/include
ln -s ../X11R6/include/DPS DPS
ln -s ../X11R6/include/GL GL
ln -s ../X11R6/include/X11 X11
ln -s ../X11R6/include/bitmaps bitmaps
cd ..
ls -s X11R6 X11
</screen>
</para>
@ -419,9 +450,32 @@
/etc/ld.so.cache so the libraries will be visible.
</para>
<para>
The GL/GLX/GLU HTML documentation is located at /usr/src/release/xc/doc/hardcopy/GL.
This directory can be copied as follows:
<screen>
cd /usr/src/release/xc/doc/hardcopy
cp -r GL /usr/X11R6/lib/X11/doc/html
</screen>
You might notice broken symlinks in /usr/X11R6/lib/X11/doc/html. This seems to be a bug in
the XFree86 build/install. The manindex3.html file is also corrupted. The broken symlinks
can simply be deleted.
<screen>
cd /usr/X11R6/lib/X11/doc/html
rm *3x.html
-- if you want to play with mass renaming files, you can
-- use a command like the following:
for afile in *3.html; do export afile; mv "$afile" "`awk 'BEGIN {print gensub("3.html","3x.html","G",ENVIRON["afile"]) }'`"; done;
</screen>
Hopefully this HTML doc problem will be fixed soon!
</para>
<para>
When X is up and running (later), try using the xman program to see that the gl,glx,glu
and glut man pages are in section 3.
and glut man pages are in section 3. If you have KDE2, khelpcenter allows manpage browsing.
</para>
</sect1>
@ -709,6 +763,109 @@
-- and add the -l needed.
</screen>
</para>
</sect1>
<sect1 id="instjava">
<title>Install Java 3D (optional)</title>
<para>
If you already have a Java JDK/SDK or JRE, that is, a Java/Software Development Kit
or Java Runtime Environment, installed, then you may have to take care to uninstall them
or leave them alone!
</para>
<para>
It is recommended that you have the lastest version of Netscape 4.7x, which at this time of
writing, is 4.76, if you plan to install the Java PlugIn for netscape. It works, but you
may (or may not) experience Segmentation Faults when leaving a page that contained a Java 3D applet.
</para>
<para>
Assuming your are logged in as root and have downloaded the Java packages from
blackdown.org into the root home directory, /root, do:
</para>
<para>
Install the Java 2 SDK (1.2.2) and Java 3D (1.2) extension:
<screen>
cd /usr/local
tar -xvyf ~/j2sdk-1.2.2-FCS-linux-i386-glibc-2.1.3.tar.bz2
ln -s jdk1.2.2 jdk
cd jdk
tar -xvyf ~/java3d1_2-FCS-linux-i386-sdk.tar.bz2
cd jre/lib/ext
cp j3d* ..
cp vecmath.jar ..
cd /usr/local
chown -R root:root jdk1.2.2
</screen>
</para>
<para>
Edit /etc/profile, add:
<screen>
JAVA_HOME=/usr/local/jdk
PATH=$PATH:$JAVA_HOME/bin
export JAVA_HOME PATH
</screen>
This completes the installation of the Java 2 SDK, which includes the JRE, and the
Java 3D 1.2 extension.
</para>
<para>
Install the Java PlugIn for netscape:
<screen>
-- source profile to set JAVA_HOME and PATH
source /etc/profile
cd
chmod u+x JavaPlugIn-1.2.2-FCS-linux-i386-glibc-2.1.3.run
./JavaPlugIn-1.2.2-FCS-linux-i386-glibc-2.1.3.run
-- each user has to run this file to install the plugin - it is per user, not global
netscape &
</screen>
When netscape loads, go to Edit/Preferences/Advanced and Enable Java and Enable Java Plugin, then
exit netscape.
</para>
<para>
The next step is to configure the Java PlugIn. It comes with a configuration applet.
<screen>
netscape ~/.netscape/java/ControlPanel.html &
-- the Control Panel for JavaPlugIn should load
</screen>
Again, netscape will load. Click the "Advanced" tab, select "Other ..." and type for Path:
<screen>
/usr/local/jdk1.2.2/jre
</screen>
Then click "Apply" and exit Netscape. By changing this, it tells the Plugin to use the system
Java Runtime Environment instead of the JRE it installed under ~/.netscape. The system JRE
is where the Java 3D API extension is installed.
</para>
<para>
Test Java 3D demos:
<screen>
cd $JAVA_HOME/demo/java3d/GearTest
java GearBox &
-- runs as normal java application
netscape GearBox_plugin.html &
-- runs in netscape as an applet
</screen>
</para>
<para>
If all works well, you should have a complete Java Developement and Runtime Environment for
both normal apps and high-performance 3D apps.
See <ulink url="http://java.sun.com/">http://java.sun.com/</ulink> for further information
about Java and the Java 3D extension.
</para>
</sect1>
<sect1 id="fincomm">