Short:    Yet another DOOM port
Uploader: psilon@xgw.fi (Kalle Sandström)
Author:   psilon@xgw.fi (Kalle Sandström)
Type:     game/shoot
Version:  0.8
Requires: OS V39+, 020+, AGA
Replaces: psidoom-0.7.lha


PsiDOOM 0.8 (DOOM 1.10) (released on 16. February 1997)
=======================================================
""""""" """ """"" """"" """"""""" "" ""  """""""" """""


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

This is the DOOM port by Kalle Sandström (or psilon, @ IRCNet).
Requires an AGA Amiga, a 68030 processor or better (might run on a 020 too,
haven't tested but it's probably damn slow), a DOOM WAD file in PROGDIR:, a
properly configured AHI installation and lots and lots of patience. An
excessive-sized addbuffers command is also recommended as the WAD read/write
functions aren't buffered properly.

You need to set the stack to at least 65536 or the program will complain.


Controls
========

 Forward:		Arrow up / numpad 8
 Backward:		Arrow down / numpad 5
 Turn left:		Arrow left / numpad 4
 Turn right:		Arrow right / numpad 6
 Choose weapons:	1-8
 Pause:			<
 Map:			Tab
 Fire:			Control
 Run:			Shift
 Strafe (sidestep):	Alt
 Enlarge screen:	+ / numpad +
 Shrink screen:		= / numpad -
 F11(gamma correction):	Del
 F12(spy mode?):	Help

As the Amiga keyboard has only 10 F-keys, I had to do an ugly kludge and map
del and help to F11 and F12.


Configuration
=============

If you're not happy with the default 4-channel sound, you can change the
number of channels the sound effects are played on from the file doom.cfg
in the same directory psidoom resides in. Just set the number on the line
that says snd_channels to whatever you please. 8 channels should be enough,
tho.

Setting the default music unit in the AHI preferences program to use the
Paula DMA mode isn't very wise as PsiDoom needs a channel effect hook which
the DMA mode does not seem to support.

PsiDoom will autodetect your processor and try to use routines specifically
optimised for your configuration. I can't be sure if everything works though,
as I have only a lowly 68030.


Tested on
======-==

PsiDoom has been tested with the shareware DOOM1.WAD, the registered DOOM.WAD
and DOOM2.WAD from Doom II. They worked fine, at least for the first
few levels.


The author
===-======

Compliments are accepted by e-mail to psilon@xgw.fi. Don't send me requests for
the WAD files however; I simply don't have the bandwidth (or motivation) to
distribute them. And no, I can't put them up at my website either; it doesn't
have the required bandwidth either. There is, IIRC, a DOOM1.WAD at
<http://www.pluk.com/> (where you can get the other Doom ports for the
Amiga too), so go download it there. Thank you.


World Wide Wait
=====-====-====

The PsiDOOM web page is at http://www.xgw.fi/~psilon/doom.html. It contains
the latest version of PsiDOOM and some other stuff when I get around to put
it there.


Future
======

  * A 1x2 c2p to go with the low detail graphics mode.
  * Graphics card support.
  * Mouse & joystick control.
  * A preferences window accessable from the menu bar.
  * TCP/IP networking support.
  * Possible modem-play kludge.
  * Convert this file to an amigaguide or HTML document? Naah.

I've lost a big lot of interest to continue with this project since I'm
typing this from a PC keyboard connected to my Miggy with a somewhat crappy
PC-keyboard-adapter that simply does not do multiple keypresses. Grr.

So don't be disappointed if this is the last version of PsiDoom.


Update History
======-=======

  0.5: First release. Keyboard & graphics work OK. No optimizations.
  0.6: Second release. AHI support. Graphics sped up by an another
       c2p routine. Quit works. Slight hand-optimizations in the
       graphics engine. Hacked the music system to use 8 channels with AHI
       instead of 3.
  0.7: Third release. Optimised the DrawColumn and DrawSpan functions and the
       fixed-point math routines (those got a 060 routine too). Mucho speed
       gain.
  0.8: Fourth release. Optimised loads of other game-related stuff.
       Fixed the low-detail graphics mode (and optimised that, too :).
       Inlined the fixed-point multiplication routine. This version sucks
       on a 060 now. :(
       Recompiled with -funroll-loops and -fomit-frame-pointer.


Thanks
======

Lots of thanks to the following people:

  * Jesse Livengood for the big load of optimisation hints he sent me.
  * All the people on the IRC channel #amigafin. You know who you are.
  * All those people who sent me E-mail.
  * The makers of DOOM for one of the best games ever written.

Legal crapazola
=====-=========

All registered trademarks are blah blah blah by their respective owners. So
don't come and threaten me with a lawsuit or I'll bite your head off on the
spot :)