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