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. +