home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #3 / amigamamagazinepolishissue1998.iso / amigadoom / amidoom / readme.amiga < prev    next >
Text File  |  1998-01-06  |  6KB  |  196 lines
  1.  
  2.                                AmiDoom v0.5
  3.  
  4.                                 1998-01-06
  5.  
  6.                          ported by Marcus Geelnard
  7.  
  8. What's new since v0.4?
  9. ======================
  10.  
  11.  * 64 colors in ECS-mode (I got many requests for this, so I decided to
  12.    release this version as quickly as possible).
  13.  
  14.  
  15. Requirements
  16. ============
  17.  
  18. The minimum required system for running AmiDoom is:
  19.  
  20.  * 68020 (no FPU needed)
  21.  * 6MB of FAST ram (or you can use VMM)
  22.  * OCS/ECS/AGA or a graphics-card
  23.  * AmigaOS 2.0+ (or 3.1+ for best gfx-card support)
  24.  * ixemul.library v45 or later
  25.  * A proper wad-file (I have tested Doom I shareware and Doom II registered)
  26.  
  27. However, I recommend at least:
  28.  
  29.  * 68030-50MHz
  30.  * 8MB of 32-bit FAST memory
  31.  * A graphics card
  32.  
  33.  
  34.  
  35. Running AmiDoom
  36. ===============
  37.  
  38. It couldn't be much simpler... Just place the AmiDoom executable in a
  39. directory together with a Doom wad-file (where all the game data is stored,
  40. like maps, pictures, textures, sounds etc). Then run it. Voila!
  41.  
  42. I have made a small script called StartDoom, that launches AmiDoom (either
  43. from Workbench or from Shell). You can edit this script, and add your
  44. favourite parameters to AmiDoom (e.g. how many audio-channels to use).
  45.  
  46.  
  47.  
  48. Graphics
  49. ========
  50.  
  51. AmiDoom opens its own screen. This screen will have 256 colors, if your
  52. system supports it, or it will use 64 colors, if you only have an OCS/ECS
  53. graphics chipset.
  54.  
  55.  
  56.  
  57. Sound
  58. =====
  59.  
  60. AmiDoom has full sound-support with real stereo panning. It is implemented
  61. with a very fast double-buffered 16-bit mixing-routine and 8-bit stereo
  62. sound output. Everything goes through audio.device, so no hardware banging
  63. is done, and no extra drivers are required (like AHI). Although AmiDoom can
  64. play up to 16 channels of sound, you rarely need more than 3 channels, which
  65. is the default.
  66.  
  67. However, it uses up quite some memory (for loading all sounds from the wad-
  68. file), and if you use many channels, it is bound to eat some CPU-time. On a
  69. fast Amiga with much memory (like a 68040 with 8MB FAST memory), this is not
  70. really a problem, but on a slow machine (like mine), it can be wise to play
  71. around with the sound-parameters (see flag descriptions below) to get the
  72. best result.
  73.  
  74.  
  75.  
  76. Keyboard
  77. ========
  78.  
  79. I used an Amierican layout of the keyboard (like in the original PC Doom-
  80. version). There are two differences between the PC layout and the Amiga
  81. layout however: F11 is mapped to Del on the Amiga (which changes the gamma
  82. level), and Pause is mapped to Help on the Amiga.
  83.  
  84.  
  85.  
  86. Stack
  87. =====
  88.  
  89. It seems that you need a stack of about 40000 bytes to run AmiDoom. To set
  90. the stack-size, use the command 'stack 40000' from the shell that you are
  91. running AmiDoom from. This is automatically done in the startup-script
  92. "StartDoom", which can be run from the Workbench.
  93.  
  94.  
  95.  
  96. Slow hard-disk loading
  97. ======================
  98.  
  99. You might notice that it takes (nearly) forever to load wad-data from your
  100. hard-disk. The remedy is (if you have enough memory for it) to add some
  101. buffers to the disk that you have installed AmiDoom on, with 'addbuffers'.
  102. Adding about 300-800 buffers (150-400 KB) has a tremendous impact on loading
  103. aswell as playing (loading is done during game-play too).
  104.  
  105.  
  106.  
  107. Networking
  108. ==========
  109.  
  110. I have not been able to test the network support, but I have gotten reports
  111. from users saying that they have had success running network-games with
  112. AmiDoom. Ridwan Hughes said this in a letter to me:
  113.  
  114. "Just to let you know, the networking side of it does work, I tested it on
  115. a serial TCP link between my A1200 and A2000, have to set a high baud rate
  116. and low MTU (as low as 128) to make the updating of both displays smooth
  117. enough to be almost playable (plus I need something better than an 030 in
  118. both machines ;)"
  119.  
  120.  
  121.  
  122. Switches
  123. ========
  124.  
  125. You can use the following Amiga-specific switches when starting AmiDoom:
  126.  
  127.  Graphics:
  128.  
  129.  -aga          Forces AGA optimized c2p routine to be used. This is default
  130.                on AGA systems without a graphics-card.
  131.  -ecs          Forces ECS modes to be used. This is default on ECS systems
  132.                without a graphics-card.
  133.  -noehb        When ECS is used, use a grayscale display instead of the
  134.                default 64-color display.
  135.  
  136.  Sound:
  137.  
  138.  -nosound      Turns of sound output.
  139.  -channels n   Use n audio-channels, where n is between 2 and 16 (default 3).
  140.  
  141.  
  142.  
  143. Background
  144. ==========
  145.  
  146. AmiDoom is based on the free source-code for Doom v1.10 (for Linux), which
  147. was released on 24-Dec-1997. I got interested in porting it when someone on
  148. a bulletin-board mentioned that the source had been released, and asked if
  149. there were any efforts being made to port it to the Amiga.
  150.  
  151. It took about one day to make it work on my Amiga 3000, and one more to fix
  152. faster and better graphic support (of which about 6 hours went to tracking
  153. down a stupid bug - I had commented out one source-line too many). For me
  154. this was a challenge, as I had never really written complex code like this
  155. in a system-friendly manner: multitasking, AmigaOS screen and window, timers,
  156. keyboard and mouse input etc. However, it turned out to be very nice. Almost
  157. everything worked after the first compilation (!).
  158.  
  159.  
  160.  
  161. What is implemented?
  162. ====================
  163.  
  164.  * Fast native CyberGraphics, AGA and ECS/OCS support.
  165.  * Full sound-support, with real stereo-panning.
  166.  * Keyboard and mouse control.
  167.  * Support for several Doom wad-files (Doom I shareware and Doom II
  168.    registered version have been tested, and work fine).
  169.  * Networking.
  170.  
  171.  
  172.  
  173. Todo
  174. ====
  175.  
  176.  * More speed-ups.
  177.  * Verify that more wad-files work with AmiDoom.
  178.  * Joystick support.
  179.  * Fix more bugs (I do not currently know of any).
  180.  * ...suggestions?
  181.  
  182.  
  183.  
  184. Contacting me (bugs etc)
  185. ========================
  186.  
  187. First of all: AmiDoom is freeware! (you do not have to pay a penny for it)
  188.  
  189. For bug-reports (or success-reports) and comments, I can be reached at:
  190.  
  191.  e-mail:  e4geeln@etek.chalmers.se
  192.  
  193. Updates and support can be found at:
  194.  
  195.  WWW:   http://www.etek.chalmers.se/~e4geeln/amidoom/
  196.