MMmmmmmmMM
       MM
    xxxxxxxxxxxx
    xxxxxxxxxxxxxxxxxxx
   xxxxxxxxx
   ZZZZZ....        %%%%%%%%%  %%%        %%%  %%%%%%%%%
  @@@@......        %%%%%%%%%. %%%....... %%%. %%%%%%%%%....
  @@@@....o.   .....%%%   %%%  %%%   %%%  %%%  %%%   %%%
 @@@@@@@....        %%%   %%%  %%%   %%%  %%%  %%%   %%%
 @@@@@@@@@@@        %%%%  %%%  %%%   %%%  %%%  %%%%  %%%
 @@@@@@@@@@@@@      %%%%  %%%  %%%   %%%  %%%  %%%%  %%%
 @@@@@@@@@@@@@@@    %%%%%%%%%  %%%   %%%  %%%  %%%%%%%%%
  @@@@              %%%%%%%%%  %%%   %%%  %%%  %%%%%%%%%
  @@@@@@            %%%        %%%%% %%%  %%%  %%%
  @@@@@@@@@@  xx    %%%        %%%%% %%%  %%%  %%%
  @@@@@@@@@@@@@@    %%%        %%%%% %%%% %%%  %%%
   @@@@@@@@@@@      %%%        %%%%% %%%% %%%  %%%
   @@@@@@@@@   .....%%%....... %%%%%%%%%%%%%%. %%%..........
     @@@@@          %%%        %%%%%%%%%%%%%%  %%%
     @@@@

                     libSDL-enhanced pwplib v1.97

                   in the year 2010 of our lameness


Original pwplib 1.90 and everything else
  by viznut/pwp

SDL-support, cleanups, bugfixes and new buildsystem
  by ccr/TNSP^pwp <ccr@tnsp.org>


About
=====
The product at your fingertips is a cleaned up, slightly fixed
version of pwplib and everything else that came in pwpunix-1.90
package. It has been enhanced with libSDL support for video and
audio.

Why, some may ask -- the reason is simple: most of terminal-based
output methods provided by original pwplib do not work very well
in current UNIX systems, and adding support for graphical output
via libSDL seemed to be the easiest way to fix this.

Additionally sound support via SDL was introduced, and it is
possible to cross-compile the whole thing for Win32 via MinGW
hosted on Linux or other UNIX-ish platform.


Usage
=====
Information about available options can be viewed via:

> peluce help

Unfortunately (or fortunately) SDL for Windows redirects stdout and
stderr by default, thus the help output goes to file "stdout.txt".

By default the SDL target runs in a window of 640x480, but this
can be changed via commandline parameters. For example:

> peluce xres 1024 yres 768

Or run in full screen:

> peluce xres 1024 yres 768 fs


Requirements
============

* libSDL for the SDL version.

* A working C compiler (preferably GCC3 or later)

* Make (GNU Make 3.81 or later works at least)

* POSIX-ish platform for building. Windows targets
  can be built via cross-compilation.

Quick and dirty guide to make it:  Just type 'make'
and follow the instructions.

The Windows cross-compilation targets most likely require
manual intervention, e.g. editing of the Makefile as this
has only been tested on one system.


Known bugs
==========
* While there is a "final_isi" directory, the code there is mostly
  a dirty half-working hack, as Final Isi was not originally using
  pwplib. It should compile and run, but will not work correctly.

* Big resolutions (1600 x 1200 for example) seem to cause some prods
  partially malfunction, apparently due to some integer overflows.
  As a workaround, use 1024 x 768 or so at most or experiment.

* Sound might be slightly off-sync in some prods, but this is possibly
  due to the reason that it wasn't ever properly synced to begin with.