PLIB 1.8.5+ r2173 from http://plib.svn.sourceforge.net/svnroot/plib/trunk
This commit is contained in:
Alexander Deynichenko
225
doc/download.html
Normal file
225
doc/download.html
Normal file
@@ -0,0 +1,225 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
||||
<TITLE>PLIB: Downloading and Installing PLIB.</TITLE>
|
||||
</HEAD>
|
||||
<BODY text="#B5A642" link="#8FFF8F" vlink="#18A515" alink="#20336B"
|
||||
bgcolor="#005000" background="marble.png">
|
||||
|
||||
<TABLE>
|
||||
<TR>
|
||||
<TD>
|
||||
<IMG SRC="plib_logo.png" ALT="PLIB Logo" width=256 height=245>
|
||||
<br>
|
||||
</TD>
|
||||
<TD>
|
||||
<center>
|
||||
<H1>
|
||||
<FONT SIZE=9>S</FONT><FONT SIZE=5>TEVE'S</FONT>
|
||||
<FONT SIZE=9>P</FONT><FONT SIZE=5>ORTABLE</FONT>
|
||||
<FONT SIZE=9>G</FONT><FONT SIZE=5>AME</FONT>
|
||||
<FONT SIZE=9>L</FONT><FONT SIZE=5>IBRARY.</FONT>
|
||||
</H1>
|
||||
</center>
|
||||
</TD>
|
||||
<TD>
|
||||
<ul>
|
||||
And Lo, the Lion and the Sheep shall lie down together - but the Sheep won't
|
||||
get much Sleep.
|
||||
<br>
|
||||
-- Woody Allen
|
||||
</ul>
|
||||
<center>
|
||||
<A href="http://sf.net">
|
||||
<IMG src="http://sf.net/sflogo.php?group_id=382&type=1" width="88" height="31" border="0" ALT="Sourceforge Logo"></A>
|
||||
</center>
|
||||
</TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
|
||||
<TABLE>
|
||||
<TR>
|
||||
<TD valign=top align=left>
|
||||
<A HREF="index.html"><IMG SRC="home.png" ALT="HOME" BORDER="0" width=150 height=50></A><br>
|
||||
<A HREF="whats_inside.html"><IMG SRC="whats_inside.png" ALT="WHAT'S INSIDE" BORDER="0" width=150 height=50></A><br>
|
||||
<A HREF="license.html"><IMG SRC="license.png" ALT="LICENSE" BORDER="0" width=150 height=50></A><br>
|
||||
<A HREF="contacts.html"><IMG SRC="contacts.png" ALT="CONTACTS" BORDER="0" width=150 height=50></A><br>
|
||||
<A HREF="requirements.html"><IMG SRC="requirements.png" ALT="REQUIREMENTS" BORDER="0" width=150 height=50></A><br>
|
||||
<A HREF="gallery.html"><IMG SRC="gallery.png" ALT="GALLERY" BORDER="0" width=150 height=50></A><br>
|
||||
<A HREF="download.html"><IMG SRC="download.png" ALT="DOWNLOAD & INSTALL" BORDER="0" width=150 height=50></A><br>
|
||||
<A HREF="examples.html"><IMG SRC="examples.png" ALT="EXAMPLES" BORDER="0" width=150 height=50></A><br>
|
||||
|
||||
<A HREF="sg/index.html"><IMG SRC="SG.png" ALT="SG" BORDER="0" width=75 height=25></A>
|
||||
<A HREF="ssg/index.html"><IMG SRC="SSG.png" ALT="SSG" BORDER="0" width=75 height=25></A><br>
|
||||
|
||||
<A HREF="ssgAux/index.html"><IMG SRC="ssgAux.png" ALT="SSGAUX" BORDER="0" width=75 height=25></A>
|
||||
<A HREF="fnt/index.html"><IMG SRC="FNT.png" ALT="FNT" BORDER="0" width=75 height=25></A><br>
|
||||
|
||||
<A HREF="pui/index.html"><IMG SRC="PUI.png" ALT="PUI" BORDER="0" width=75 height=25></A>
|
||||
<A HREF="psl/index.html"><IMG SRC="PSL.png" ALT="PSL" BORDER="0" width=75 height=25></A>
|
||||
|
||||
<A HREF="util/index.html"><IMG SRC="UL.png" ALT="UL" BORDER="0" width=75 height=25></A>
|
||||
<A HREF="js/index.html"><IMG SRC="JS.png" ALT="JS" BORDER="0" width=75 height=25></A><br>
|
||||
|
||||
<A HREF="net/index.html"><IMG SRC="NET.png" ALT="NET" BORDER="0" width=75 height=25></A>
|
||||
<A HREF="sl/index.html"><IMG SRC="SL.png" ALT="SL" BORDER="0" width=75 height=25></A><br>
|
||||
|
||||
<A HREF="pw/index.html"><IMG SRC="PW.png" ALT="PW" BORDER="0" width=75 height=25></A>
|
||||
<A HREF="puAux/index.html"><IMG SRC="puAux.png" ALT="PUAUX" BORDER="0" width=75 height=25></A><br>
|
||||
|
||||
</TD>
|
||||
<TD>
|
||||
<H1>Downloading and Installing PLIB.</H1>
|
||||
<H2>The Short Answer (for Linux and CygWin users):</H2>
|
||||
Make sure you have OpenGL installed.<br>
|
||||
Download this: <A HREF="dist/plib-1.8.4.tar.gz"> PLIB - Version 1.8.4</A>
|
||||
<br>
|
||||
Run this (as 'root'):
|
||||
<pre>
|
||||
tar xzf plib-1.8.4.tar.gz
|
||||
cd plib-1.8.4
|
||||
./configure ; make install
|
||||
</pre>
|
||||
Tadaaaa!
|
||||
<p>
|
||||
<H2>The Long Answer: Downloading PLIB.</H2>
|
||||
You can get PLIB in various versions here. We follow the common Linux
|
||||
convention where the second digit in the version number is EVEN for
|
||||
stable versions and ODD for unstable and/or experimental versions.
|
||||
<p>
|
||||
End users should generally download the latest stable version but
|
||||
application developers may wish to periodically compile their code
|
||||
against the odd-numbered version so as to keep abreast of developments
|
||||
in PLIB.
|
||||
<p>
|
||||
<ul>
|
||||
<li><A HREF="dist/plib-1.8.4.tar.gz"> PLIB - Version 1.8.4 -- Current Stable</A>
|
||||
<li><A HREF="dist/"> PLIB - Other versions</A>
|
||||
<li><A HREF="http://sf.net/project/?group_id=382"> PLIB - Latest development version (from SVN)</A>
|
||||
<li><A HREF="dist/current.tgz"> PLIB - Latest development version (tarball)</A>
|
||||
</ul>
|
||||
Download this using your browser by right-clicking on the name. If you
|
||||
have InternetExplorer, you'll probably fall victim to it's stupid bug
|
||||
where it unzips the file automatically - but forgets to
|
||||
rename it to lose the '.gz' off the end. Just rename it yourself
|
||||
before you try to un-tar it and all will be well.
|
||||
<p>
|
||||
PLIB documentation, example programs, fonts, etc are separated from
|
||||
PLIB itself to minimise your download time.
|
||||
<p>
|
||||
The <b>online</b> documentation attempts to always track the latest stable
|
||||
version of PLIB. If you are using some other version, you may want to
|
||||
download the documentation appropriate to that release which comes with
|
||||
the plib_examples tarball.
|
||||
|
||||
<A NAME="EXAMPLES"></A>
|
||||
<ul>
|
||||
<li><A HREF="dist/plib_examples-1.8.4.tar.gz">
|
||||
Example programs and Documentation for PLIB-1.8.4 or later.</A>
|
||||
<li><A HREF="dist/">PLIB_examples - Older versions</A>
|
||||
</ul>
|
||||
Un-tar this into a separate directory from PLIB itself - or else
|
||||
all the configuration and makefiles will clash. Many of the example programs
|
||||
require the GLUT library (or 'freeglut') - some other use SDL and FLTK.
|
||||
<p>
|
||||
<A NAME="DEMOS"></A>
|
||||
More extensive PLIB demonstration programs are also separated from
|
||||
PLIB itself and are individually tarballed with their own version
|
||||
numbers. Generally, they'll run with the most recent stable version
|
||||
of PLIB - but occasionally they'll rely on something in the latest
|
||||
PLIB beta.
|
||||
<p>
|
||||
<ul>
|
||||
<li><A HREF="dist/exposer-0.2.0.tar.gz">
|
||||
A character animation tool.</A>
|
||||
<li><A HREF="dist/p-guide-0.0.1.tar.gz">
|
||||
A tool for designing PUI interface panels.</A>
|
||||
<li><A HREF="dist/ttt3d-0.2.0.tar.gz">
|
||||
A complete TicTacToe game - played in 3 dimensions!</A>
|
||||
<li><A HREF="dist/">PLIB Demos - Older versions</A>
|
||||
</ul>
|
||||
Un-tar these into a separate directory from PLIB itself - or else
|
||||
all the configuration and makefiles will clash.
|
||||
|
||||
<H2>The Long Answer: Installing PLIB.</H2>
|
||||
On most Linux and other UNIX-like OS's, it's simply a matter of
|
||||
unpacking the tar-ball, changing directory into the plib_x.y.z
|
||||
directory that this creates and typing:
|
||||
<pre>
|
||||
|
||||
./configure
|
||||
make install
|
||||
|
||||
</pre>
|
||||
You'll need to
|
||||
be 'root' to perform the last step. At the end of that process,
|
||||
you should have a set of header files in /usr/include/plib
|
||||
and a set of corresponding libraries in /usr/lib. There
|
||||
are some example programs in the 'plib-x.y.z/examples' subdirectory.
|
||||
<p>
|
||||
WARNING: If you are using 'Mesa' instead of an 'Official' OpenGL,
|
||||
please make sure you followed the instructions in the Mesa installation
|
||||
notes that tell you to symbolically link /usr/lib/libGL.so
|
||||
and /usr/lib/libGLU.so to their Mesa equivelents. More modern
|
||||
versions of Mesa may install directly into that location - but
|
||||
make sure that one way or another, /usr/lib/libGL.so points to your
|
||||
current OpenGL/Mesa library.
|
||||
<p>
|
||||
Some Linux distro's install OpenGL/Mesa in /usr/X11R6/lib - that
|
||||
is now officially deprecated - if your OpenGL/Mesa is installed
|
||||
there then I suggest you add symbolic links to make the
|
||||
files appear to be in /usr/lib.
|
||||
<p>
|
||||
If you are running some non-UNIX OS, (eg MS-Windows) there may be
|
||||
instructions on how to build PLIB in README.{OS name}. If you
|
||||
have problems - or can offer to streamline the
|
||||
process, then please pass on your knowledge via the mailing list.
|
||||
In general, it isn't complicated to install - you usually just have
|
||||
to compile all of the source files in each directory and link
|
||||
each subdirectory into a separate library. Don't try to make
|
||||
PLIB into a M$ '.DLL' - it's not worth the effort!
|
||||
<p>
|
||||
If you have the Microsoft Visual C++ suite, you'll find a set
|
||||
of project files - one in each source directory - plus a master
|
||||
workspace at the top of the tree.
|
||||
<p>
|
||||
If you have all the Cygnus (CygWin) compiler/tools, then use
|
||||
the UNIX build instructions.
|
||||
<p>
|
||||
There is now a README.mac for Macintosh users.
|
||||
|
||||
<H2> Where Does PLIB Install Itself? </H2>
|
||||
This is always a controversial topic. In order to maintain
|
||||
our own sanity, we expect PLIB to be installed in one place
|
||||
and in one place only.
|
||||
<pre>
|
||||
|
||||
Libraries are in: /usr/lib/libplibXXX.a
|
||||
|
||||
Headers are in: /usr/include/plib/XXX.h
|
||||
|
||||
</pre>
|
||||
(Where 'XXX' is the short acronym for the PLIB library in question -
|
||||
in lowercase).
|
||||
<p>
|
||||
The now *VERY* obsolete PLIB 1.0.* used to install itself
|
||||
into /usr/local/plib, but from version 1.1.0 onwards, the
|
||||
modern location was adopted following discussions with
|
||||
several Linux distributors.
|
||||
<p>
|
||||
Please don't even <b>think</b> about arguing about this decision,
|
||||
it has been the topic of long and arduous discussion and it's
|
||||
NEVER going to change!
|
||||
|
||||
</TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
<hr>
|
||||
<ADDRESS>
|
||||
<A HREF="http://www.sjbaker.org">
|
||||
Steve J. Baker.</A>
|
||||
<<A HREF="mailto:sjbaker1@airmail.net">sjbaker1@airmail.net</A>>
|
||||
</ADDRESS>
|
||||
</BODY>
|
||||
</HTML>
|
||||
Reference in New Issue
Block a user