STEVE'S PORTABLE GAME LIBRARY PAGE.

Portable Software using Portable Libraries.

I have been using my spare time to build a set of OpenSource (LGPL) libraries that will permit programmers to write games and other realtime interactive applications that are 100% portable across a wide range of hardware and operating systems. Here is what you need - it's all free and available with LGPL'ed source code on the web. All of it works well together.

PLIB is also used by many projects, here are some of the more prominent ones:

Tux the Penguin - A Quest for herring.			FlightGear
Majik3D

The PUI library is in use in a hundred or more other applications, the SL library in several more.

All of these libraries are now bundled together into a single tarball called 'PLIB' (pronounced 'plib' to rhyme with glib and nib - not 'pee-lib' or 'pee-lybe').

If you are reading this document from the source distribution on your local disk, you can find the most up to date version of PLIB here:

http://www.woodsoup.org/projs/plib

Licensing.

PLIB is OpenSource software, issued under the terms of the Library varient GNU Public License (LGPL).

Download

You can get PLIB from here:

Mailing Lists

There are three PLIB mailing lists:

A very low traffic, read-only list where I'll announce new versions of PLIB: <plib-announce@woodsoup.org>
A list for PLIB users - this would be the correct place to ask questions, report bugs and generally hang out with fellow sufferers: <plib-users@woodsoup.org>
A list for people who wish to contribute to the development of PLIB - this list will have a high technical content and we'll try to keep discussions there focussed and on-topic: <plib-devel@woodsoup.org>

In order to keep the spam off the list, it's set up so you have to subscribe in order to send mail. To do that, email <majordomo@woodsoup.org> with the BODY of the message (NOT the subject line) containing:

  subscribe plib-{whatever}@woodsoup.org {your-email-address}
  end

Where {whatever} is announce, devel or users and {your-email-address} is something like joe@joes_diner.com (don't type the {}'s )!

If you wish to sign up to multiple lists, you can put multiple 'subscribe' lines in the same email and finish it with just one 'end' command. Shortly after you email is delivered, you should get an automatic reply email asking you to confirm your request. Just do what it says and you'll be in touch.

Please do not send me personal mail in situations when one of the public mailing lists would be an appropriate forum - I hate it when people do that.

Requirements for PLIB

To do good 3D graphics, you'll need an OpenGL-compatible 3D graphics accellerator - and if you want to hear sounds, you'll obviously need a sound card.

In addition, you'll need the following other libraries:

3D/2D Graphics: OpenGL. If you aren't already set up to run OpenGL, you should check:
- The OpenGL ARB site.
- Or download Mesa (which is an excellent OpenGL clone by Brian Paul).
- If you are a Linux user, you may wish to check the Linux3D Site.
Windowing: GLUT (The OpenGL Utility Toolkit by Mark Kilgard) - fully portable windowing library with support for mouse and keyboard.

What's In PLIB?

The contents of PLIB are:

GUI Widgets	Picoscopic User Interface Library (PUI)	A fully portable GUI interface that needs only GLUT, OpenGL and C++.
Sound Replay	Sound Library (SL)	A fully portable Audio driver suited to C++, GLUT and realtime applications that need low latency. Includes a simple 'MOD' music loader/player.
Matrix/Vector math	Simple Geometry Library(SG)	A set of matrix and vector math functions that was specifically written to simplify the writing of efficient OpenGL programs. You need to include this code into any SSG applications.
Scene Graph	Simple Scene Graph Library (SSG)	A scene graph library layered on top of OpenGL.
Joystick	JS	Supports more Joysticks with more axes and buttons than GLUT.
Fonts/Text	Fonts'n'Text Library (FNT)	Supports text output in OpenGL using texture mapped fonts. These are much faster to render than GLUT's fonts.

Portability.

All flavors of Win32 (WinNT, Win95 and Win98) are supported, using either MSVC++ or CygWin for compilation. Theoretically you could use Borland too, but I have no project files to help you build.
All flavors Linux (presuming a 2.x.x series kernel) - on all platforms, although some problems have been reported on Alpha-Linux.
Most other UNIX-like systems (at least BSD, IRIX, Solaris).
MacOS now runs everything except the joystick library. I have yet to hear of anyone who has a Mac with a joystick - so this isn't a great loss.
Support for BeOS is problematic - for some reason, people who are prepared to help out with porting PLIB to BeOS are hard to find. However, since BeOS (I'm told) runs X, OpenGL and OSS, it should be easy to port to.

Documentation.

All documentation is both available online (click on the package name in the section above) and distributed with PLIB in HTML.

Installation.

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 and typing:


   ./configure
   make
   make install

Depending on the file permissions in /usr/local, you may 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/local/plib/include and a set of corresponding libraries in /usr/local/plib/lib. There are some example programs in the 'plib-x.y.z/examples' subdirectory.

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.a (or .so) and /usr/lib/libGLU.a (or .so) to their Mesa equivelents.

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!

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.

If you have all the Cygnus (CygWin) compiler/tools, then use the UNIX build instructions.

I have not been given build instructions for MacOS - so you'll have to wing it for now!

Steve J. Baker. <sjbaker1@airmail.net>