plib/doc/examples.html

192 lines
7.5 KiB
HTML

<!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: A Portable Games Library.</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>PLIB: Example Programs and Demonstrations.</H1>
PLIB has three sources of sample programs to learn from.
<ul>
<li> EXAMPLES: There is a bundle of small programs that each show
off one or two small aspects of PLIB and which are
not generally all that useful by themselves.
<li> DEMOS: These are fully worked out demonstration programs
that use a wide range of PLIB features to create complete
and useful programs that are still small enough to understand
quite easily.
<li> APPLICATIONS: Because many PLIB applications are OpenSourced,
there are a large number of complex programs that you can
look at to see how large games, simulations and interactive
tools can be built using this technology.
</ul>
<H2> EXAMPLES </H2>
The PLIB example programs are distributed in <A HREF="download.html#EXAMPLES">
a separate tarball</A> from the main PLIB distribution - and generally, it
is updated less often - but following the same version numbers as the
main PLIB library.
<p>
When you install that package, you'll see that the 'src' directory is
split into sections for each PLIB component library - with one or two
different examples for each library.
<p>
All of the examples are licensed under GPL as bundle and are maintained
under the PLIB SVN archive.
<ul>
<li>FNT:<ul>
<li> fnt_test - a basic TXF font browser.
<li> slideshow - a way to present a simple slide-show driven
from an ASCII text file. Who needs PowerPoint
when you have 'vi'? :-)
<li> data - this directory contains 20 different TXF fonts.
</ul>
<li>JS:<ul>
<li> js_demo - a program that shows the current output from
whatever joysticks it can detect. Useful for
testing out which buttons set which bits and
which axes are which.
</ul>
<li>NET:<ul>
<li> client-server -
<li> http_get -
<li> net_echo -
</ul>
<li>PUI:<ul>
<li> simple - the "Hello World" of PUI programs.
<li> complex - a fairly pointless program that shows how
to control a spinning OpenGL cube, and use
a variety of PUI widgets.
<li> widget_list - draws every kind of PUI widget each
in a separate window. This is what we used
to make the screenshots for the PUI manual.
</ul>
<li>SG:<ul>
<li> sg_quat_test - tests the SG quaternions...unsuccessfully
I think!
</ul>
<li>SL:<ul>
<li> example - plays a number of annoying sounds.
<li> mod_demo - plays a MOD format music file.
</ul>
<li>SSG:<ul>
<li> load_save - Load a 3D model - then just save it again.
<li> majik - A test (originally written to help the Majik3D
project) that shows Tux walking around on some
auto-generated terrain.
<li> state_test - Exercises some ssgSimpleState settings.
<li> tux - A model of Tux the Penguin spins around on a
pedestal encrusted in golden Herring.
<li> tween_test - Demonstrated the 'tween' effect.
<li> water - Demonstrates the ssgAux library - water/fire/lensflare/particles plus basic shapes, cube, teapot.
<li> viewer - A program to allow you to view any 3D model
and spin it around using the mouse.
</ul>
<li>UTIL:<ul>
<li> test_dir - tests some of the directory handling features.
</ul>
</ul>
<H2> DEMONSTRATIONS </H2>
The PLIB demonstration programs are distributed in <A HREF="download.html#DEMOS">
their own separate tarballs</A> - each has it's own version number and it's
own license conditions (although all of them must fall within the SourceForge
definition for OpenSourced software in order to reside on the SourceForge
server). All of the demonstrations are maintained under the PLIB SVN
archive.
<ul>
<li> ExPoser - A program to allow you to animate characters for your
games using 'Skin and Bones' animation techniques.
ExPoser needs PLIB 1.5.1 or later.
<li> TTT3D - A complete 3D TicTacToe game played on a 4x4x4 board.
It's theoretically possible to beat it - <b>theoretically</b>.
TTT3D needs PLIB 1.4.0 or later.
</ul>
<H2> APPLICATIONS </H2>
PLIB applications do not reside on the PLIB web site - but you can find
links to many of them in <A HREF="gallery.html">our image gallery</A>.
</TD>
</TR>
</TABLE>
<hr>
<ADDRESS>
<A HREF="http://www.sjbaker.org">
Steve J. Baker.</A>
&lt;<A HREF="mailto:sjbaker1@airmail.net">sjbaker1@airmail.net</A>&gt;
</ADDRESS>
</BODY>
</HTML>