From bd10b27e89c4818a4f46220e9288321cdaecc70a Mon Sep 17 00:00:00 2001
From: gferg <>
Date: Wed, 6 Dec 2000 23:40:12 +0000
Subject: [PATCH] updated
---
...vidia-OpenGL-Configuration-mini-HOWTO.sgml | 177 +++++++++++++++++-
1 file changed, 167 insertions(+), 10 deletions(-)
diff --git a/LDP/howto/docbook/Nvidia-OpenGL-Configuration-mini-HOWTO.sgml b/LDP/howto/docbook/Nvidia-OpenGL-Configuration-mini-HOWTO.sgml
index 1661cd93..a6dda5f8 100644
--- a/LDP/howto/docbook/Nvidia-OpenGL-Configuration-mini-HOWTO.sgml
+++ b/LDP/howto/docbook/Nvidia-OpenGL-Configuration-mini-HOWTO.sgml
@@ -19,8 +19,8 @@
- v1.3
- Nov 26, 2000
+ v1.4
+ Dec 6, 2000
rbe
@@ -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.
@@ -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.
@@ -329,6 +329,35 @@
are Nvidia's own hardware accelerated OpenGL implementation.
+
+ Java 2 SDK, Java 3D extension, and Java PlugIn for Netscape (optional)
+
+
+
+ The following files are available at http://www.blackdown.org/:
+
+
+
+ j2sdk-1.2.2-FCS-linux-i386-glibc-2.1.3.tar.bz2
+ java3d1_2-FCS-linux-i386-sdk.tar.bz2
+ JavaPlugIn-1.2.2-FCS-linux-i386-glibc-2.1.3.run
+
+
+
+ Note that to install these Java files, your system needs to have glibc 2.1.3 or better.
+ To check your version of glibc:
+
+
+ ls -l /lib/libc*
+
+
+
+
+ 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!
+
@@ -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
@@ -419,9 +450,32 @@
/etc/ld.so.cache so the libraries will be visible.
+
+ The GL/GLX/GLU HTML documentation is located at /usr/src/release/xc/doc/hardcopy/GL.
+ This directory can be copied as follows:
+
+
+ cd /usr/src/release/xc/doc/hardcopy
+ cp -r GL /usr/X11R6/lib/X11/doc/html
+
+ 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.
+
+
+ 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;
+
+ Hopefully this HTML doc problem will be fixed soon!
+
+
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.
@@ -709,6 +763,109 @@
-- and add the -l needed.
+
+
+
+
+
+ Install Java 3D (optional)
+
+
+ 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!
+
+
+
+ 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.
+
+
+
+ Assuming your are logged in as root and have downloaded the Java packages from
+ blackdown.org into the root home directory, /root, do:
+
+
+
+ Install the Java 2 SDK (1.2.2) and Java 3D (1.2) extension:
+
+
+ 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
+
+
+
+
+ Edit /etc/profile, add:
+
+
+ JAVA_HOME=/usr/local/jdk
+ PATH=$PATH:$JAVA_HOME/bin
+ export JAVA_HOME PATH
+
+ This completes the installation of the Java 2 SDK, which includes the JRE, and the
+ Java 3D 1.2 extension.
+
+
+
+ Install the Java PlugIn for netscape:
+
+ -- 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 &
+
+ When netscape loads, go to Edit/Preferences/Advanced and Enable Java and Enable Java Plugin, then
+ exit netscape.
+
+
+
+ The next step is to configure the Java PlugIn. It comes with a configuration applet.
+
+
+ netscape ~/.netscape/java/ControlPanel.html &
+ -- the Control Panel for JavaPlugIn should load
+
+ Again, netscape will load. Click the "Advanced" tab, select "Other ..." and type for Path:
+
+
+ /usr/local/jdk1.2.2/jre
+
+ 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.
+
+
+
+ Test Java 3D demos:
+
+
+ cd $JAVA_HOME/demo/java3d/GearTest
+ java GearBox &
+ -- runs as normal java application
+ netscape GearBox_plugin.html &
+ -- runs in netscape as an applet
+
+
+
+
+ If all works well, you should have a complete Java Developement and Runtime Environment for
+ both normal apps and high-performance 3D apps.
+ See http://java.sun.com/ for further information
+ about Java and the Java 3D extension.
+