__  __    __    ___             __  __
\ \/ /__ / /_  / _ | ___  ___  / /_/ /  ___ ____
 \  / o_) __/ / __ |/ _ \/ O \/ __/ _ \/ o_) __/
 /_/\__/\__/\/_/ |_/_//_/\___/\__/_//_/\__/_/
     | |___) )____  ____ ____  _____ ____    Author: Nadir Boussoukaia
     |  ____(____ |/ ___)    \(____ |  _ \   Contact: nad4reg@gmail.com
     | |    / ___ ( (___| | | / ___ | | | |  Version: 1.1
     |_|    \_____|\____)_|_|_\_____|_| |_|  Home: http://nadir.is.online.fr

License: GNU LGPL (http://www.gnu.org/copyleft/lesser.html)

\-----------------------------------------------------------------------------/
|  I quick doc                                                               |
/-----------------------------------------------------------------------------\
YAP stands for Yet Another Pacman.
It was created on june 1993/and ported to SDL in 2006.

This game is FREEWARE.

General keys:
=============
      P        => pause
      esc      => exit
      arrows   => controls pacman
      pgup pgdn => music volume

Game Window:
============
You can resize the Game window as you like.

or you can use the "fullscreen" mode.
Just edit YAP.CFG with a text editor, and set true to the "fullscreen" line.

Other Configuration:
====================
For configuration look at the file YAP.CFG (parameters are described within).

\-----------------------------------------------------------------------------/
|  II  changing the tunes                                                    |
/-----------------------------------------------------------------------------\

To extend/replace the default ingame music tunes, you can place whatever you 
like in the "tunes" folder. Then update the YAP.CFG file accordingly.

The files could be with extension ".mod"/".s3m"/".it"/".xm" (sorry, no mp3).
These are good old Amiga tunes (amazingly tiny files).
MP3 are not supported as they are unstable with SDL Mixer library.


\-----------------------------------------------------------------------------/
|  III News in 1.1 version                                                      |
/-----------------------------------------------------------------------------\

- Added scale factor 
	A new config parameter that scales the game with a dot value 
	between 1.0 and 5.0. Can be 1.0(fastest), 1.5, 2.0..
	But the scale option only works with 32 bits screen depth.	
	Notice: value 1.0 is the least CPU consuming (same as a simple screensaver)

- Game window is resizable anytime (when in 32 bits)

- Reviewed gameplay progression for whole 17 defined levels and levels design
 
\-----------------------------------------------------------------------------/
|  IV  licence                                                                |
/-----------------------------------------------------------------------------\

Game graphics:
 - The bonus & fruits icons where given by a classmate 
   I think they were coming from an old Amiga game (don't know which)
 - The rest are my creation in 1993
 - Gfx were suitable for the 320x240x8bits screen of old MS-DOS.
 
Game sound:
 - I decided to use Amiga tunes coming from demos I liked 
   They are all in public domain nowadays

\-----------------------------------------------------------------------------/
|  V  for you who are still reading                                          |
/-----------------------------------------------------------------------------\

This is the original game I wrote on 1993, directly adapted du SDL including 
assembly just to play.
I did not take the time to resize the game graphics. No Gfx rework too!

This game was my first game with 'C' language, it was on 1993.
At that time, I achieved this in two weeks, on MS-DOS, the Ghosts mini-IA and
learning C code had mainly motivated me. And the fun.
Indeed I learnt programming on 68k assembly, so I was only using assembly before 
this project. And I did find C code really simplifying the coding process ;-)

Nowadays 2006, I was wondering if ten years after, I was still able to code 
old C code. say like we used to do, counting bits & bytes.

The challenge was to port it to Windows & Linux using SDL.
So it is done.. 
I added sound and converted assembly code to plain C code in 18 hours.

I played a lot doing it, during rainy holidays. And had fun.

Greetings to Olivier Pons who designed most of the levels included in this game.

