home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 6 / AACD06.ISO / AACD / Emulation / V2600PPC / v2600.doc < prev    next >
Text File  |  1998-05-19  |  10KB  |  255 lines
  1. Virtual 2600 Amiga (v2600), An Atari 2600 Emulator
  2. ==================================================
  3.  
  4. Amiga version 0.83. This is BETA software. Please report any bugs.
  5. This is the PPC Port of Mathew Stroups Amiga-Version, done by me,
  6. Steffen Haeuser. A new 68k version with some small changes is also
  7. provided.
  8.  
  9. Before you ask: PPC Version runs at around 2x 68k Version, in speed.
  10.  
  11. DESCRIPTION
  12. ===========
  13.  
  14. Virtual 2600 Amiga is an emulation of the Atari 2600 video game system,
  15. otherwise known as the Atari VCS, or Video Computer System.  It can read
  16. ROM files of the following types:  .bin binary images, Commodore .prg
  17. format files, Activision Action Pack .bin files, and the new .c26 Common
  18. 2600 file format files.  It uses regular Amiga joysticks, and can use the
  19. mouse to emulate paddles.  Many existing Atari 2600 cartridges can be used
  20. with this emulator.  Even sound is supported, more or less...
  21.  
  22.  
  23.  
  24. REQUIREMENTS
  25. ============
  26.  
  27. Any fast Amiga, 020 or better, OS 3.0 or better.
  28. Fast RAM recommended.
  29. The faster the Amiga, the better.
  30. Atari 2600 ROMs (one included: Okie-Dokie)
  31.  
  32.  
  33.  
  34. USAGE
  35. =====
  36.  
  37. Double-click on the v2600 icon to bring up the window.  The Command Line
  38. Interface has been removed.  Too bad, eh?  ;^)
  39.  
  40.  
  41. Load ROM
  42.  
  43. Click on the "Load ROM" button to bring up a file requester.  It will only
  44. display files that are valid with v2600.  When you select a ROM, the
  45. filename and path will be shown in the box next to the "Load ROM" button.
  46. You can just type in the name of a ROM you want to load in this box if you
  47. don't care to use the file requester.  Be careful what you load, since
  48. there is no way to thoroughly check that you are using a real Atari ROM.
  49. Loading other files could crash your computer.
  50.  
  51.  
  52. Refresh Rate
  53.  
  54. This will set how often the screen will be updated.  For example, if you
  55. set the Refresh Rate to 2, it will only refresh every-other-frame.  This
  56. can speed up the graphics rendering, but can also cause some games to look
  57. pretty bad.
  58.  
  59.  
  60. System Type
  61.  
  62. This will allow you to emulate either a PAL or NTSC Atari.
  63.  
  64.  
  65. Left Controller
  66. Right Controller
  67. Paddle Control
  68.  
  69. This allows you to select what type of controller the left and right
  70. players will use.  If you select "Joystick", then a standard Amiga joystick
  71. may be used.  In case you didn't already know, Amiga joysticks are
  72. compatible with Atari joysticks, so you can use the original Atari
  73. joysticks for a really authentic (not to mention uncomfortable) experience.
  74. The "Left Controller", which is used by "Player 1" in most games, uses the
  75. joystick port (Port 1) on your Amiga.  To use the "Right Controller", you
  76. must remove your mouse from the mouse port (Port 0), and replace it with a
  77. joystick.  If you want to play a paddle game, you can change to "Paddle".
  78. The Amiga mouse is used to emulate an Atari paddle.  Real Atari paddles are
  79. not supported at this time.  If you set the "Paddle Control" to "Use Mouse
  80. X", then you can move the mouse left and right (along the X-axis) to
  81. emulate a paddle.  If you change the "Paddle Control" to "Use Mouse Y",
  82. then you can move the mouse up and down (along the Y-axis) to emulate a
  83. paddle.  Atari racing paddles and keyboard controllers are not supported at
  84. this time.
  85.  
  86.  
  87. Bank Switching
  88.  
  89. The Atari could only address about 6k from a cartridge ROM, so for games
  90. requiring more memory, special hardware is used to "switch banks" of ROM
  91. memory.  Since this is done with hardware, emulating this can be tricky,
  92. because there is no way to determine if a ROM requires this.  It was up to
  93. the game manufacturer to decide what type of bank switching hardware they
  94. wanted to use.  Thankfully there were a few companies that stuck with a
  95. standard chip.  The bank switching schemes emulated are Atari 8k, for most
  96. 8k Atari-manufactured ROMs, Atari 16k for most 16k Atari-manufactured ROMs,
  97. Parker 8k for most 8k Parker-Brothers-manufactured ROMs, CBS for most
  98. CBS-manufactured ROMs, and Atari Super Chip for Atari-manufactured ROMs
  99. that use it.  If the ROM you want to play is 6k or less, you can most
  100. likely choose NONE for no banking, since it's not necessary for small ROMs.
  101. It's a guessing game for other ROMs, though.  Unfortunately, large
  102. Activision ROMs are not yet supported.  Currently, bank switching is fairly
  103. unstable.  Choosing the wrong bank switching method could lock-up or crash
  104. your computer.
  105.  
  106.  
  107. Video Output
  108.  
  109. This allows you to select the video output mode of the emulator.
  110. "Workbench Screen" opens a window on the Workbench.  The more colors your
  111. Workbench can display, the better.  "Custom Screen" opens a separate screen
  112. for output.  Both of these modes use the WritePixelArray8()
  113. chunky-to-planar routine.  "Fast & Ugly" uses a custom screen, and uses a
  114. custom c2p routine.  It's the fastest method, but it can be flickery.
  115.  
  116.  
  117. Sound Output
  118.  
  119. If you check this box, Atari sound will be emulated.  This will slow down
  120. the emulator considerably, so only use it if you have a really beefy
  121. machine.  Only pure sounds are supported.  White noise, which is used in
  122. explosions and other sound effects, is not emulated.  This will make some
  123. games sound bad. Sorry.
  124.  
  125.  
  126. Start
  127.  
  128. Press the "Start" button to play the selected ROM.  If you haven't selected
  129. a ROM, the "Start" button will be "greyed-out", and won't function.  When
  130. you press "Start", all the current settings are saved to a file called
  131. "v2600.opts" in the directory that v2600 resides in.
  132.  
  133.  
  134.  
  135. KEYBOARD CONTROL
  136. ================
  137.  
  138. For the sake of faster emulation and cleaner code, keyboard emulation of
  139. the joystick has been removed.  It will only be added if there is a big
  140. demand for it.
  141.  
  142.  
  143.  
  144. CONSOLE SWITCHES
  145. ================
  146.  
  147. The Atari 2600 has several switches on the console which perform various
  148. functions.  The keyboard equivalents are:
  149.  
  150. F1 or R    Reset
  151. F2 or S    Select
  152. F3 or B    Color/BW
  153. F4         Left Player Amateur (B on some Ataris)
  154. F5         Left Player Pro (A on some Ataris)
  155. F6         Right Player Amateur (B on some Ataris)
  156. F7         Right Player Pro (A on some Ataris)
  157. ESC or F10 Quit
  158.  
  159.  
  160.  
  161. COPY POLICY
  162. ===========
  163.  
  164. The original Virtual 2600 is copyright 1995/96 Alex Hornby.
  165. Virtual 2600 Amiga is copyright 1998 Matthew Stroup.
  166.  
  167. Virtual 2600 is free software distributed under the terms of the GNU
  168. General Public License.  This means that the source code needs to be
  169. available.  To cut down on archive size, I will make the source available
  170. on my web page in a separate archive.
  171.  
  172.  
  173.  
  174. AUTHORS
  175. =======
  176.  
  177. Virtual 2600 Amiga:
  178. Matthew Stroup
  179. stroupm@jps.net
  180. http://www.jps.net/stroupm/v2600.htm
  181.  
  182. When I saw that the Virtual 2600 code was available to be ported, I thought
  183. it would be a challenging project.  Unfortunately, it runs about 4-5 fps on
  184. my 50MHz 68030.  Most of the speed problems stem from the fact that Virtual
  185. 2600 was intended to run on PC hardware.  A great deal of time is spent
  186. emulating PC hardware, not an Atari 2600.  Both my code and Alex Hornby's
  187. original code are in beta stages.  Later versions will hopefully be faster.
  188. Amiga v2600 was compiled using SAS/C 6.58.  The source code for the Amiga
  189. version is available on my web page, as per the GNU public license.  To get
  190. the original source code, or source code for other platforms, check the
  191. Virtual 2600 home page.
  192.  
  193. Virtual 2600:
  194. Alex Hornby
  195. ahornby@zetnet.co.uk
  196. http://www.users.zetnet.co.uk/ahornby/v2600.html
  197.  
  198. The original Virtual 2600 is the result of Alex Hornby's 3rd year
  199. university project.  His aim is to preserve old computer games that would
  200. otherwise be lost to the world.
  201.  
  202. PPC Version:
  203.  
  204. Contact MagicSN@Birdland.es.bawue.de (Steffen Haeuser) in case questions
  205. or problems appear, or for anything else :) Also i would be very interested
  206. how to make "Reactor" running on Virtual 2600. It always complains about
  207. a read 0x2c6 !!! And it was at the times i owned a 2600 my favourite game !!!
  208.  
  209.  
  210. IMPORTANT NOTES
  211. ===============
  212.  
  213. Please don't e-mail me asking for ROMs, because I won't give them to you.
  214. Someone has uploaded a file to Aminet that includes nearly every Atari 2600
  215. ROM in existence.  I will put a link to that file on my web page.  I highly
  216. recommend only using the ROMs that you actually own.  Doing otherwise can
  217. be copyright infringement, although some of the copyrights for Atari 2600
  218. software have expired long ago.  I have included a freeware game,
  219. OkieDokie, with the permission of Bob Colbert and Retroware.
  220.  
  221. If you have any comments, suggestions, or bug reports, please send me
  222. e-mail at stroupm@jps.net.  I'll try to get back to you as soon as
  223. possible.  I no longer receive e-mail at stroupm@inreach.com or
  224. stroupm@csus.edu.
  225.  
  226.  
  227.  
  228. TROUBLESHOOTING
  229. ===============
  230.  
  231. If a game doesn't seem to be working, it's probably because you selected
  232. the wrong banking type.  It is possible that your memory is getting
  233. trashed, and v2600 may freeze up, requiring a reset.  This is apparently
  234. caused by faulty bank switching, which has been noted by the original
  235. author.  I have not, however, had any Enforcer hits.  It would be a good
  236. idea to reset your Amiga after using v2600, though, and don't do anything
  237. important in the background.  You've been warned!  ;^)
  238.  
  239. Some games, such as Activision's Pitfall II, had custom hardware in the
  240. cartridge, which makes emulation impossible.  Although many games work,
  241. there are quite a few that won't.  Your best bet is to just experiment.
  242. Have fun!
  243.  
  244.  
  245.  
  246. THINGS TO COME (MAYBE)
  247. ======================
  248.  
  249. * Support for real Atari paddles.
  250. * Support (real or emulated) for Atari racing controllers.
  251. * Support (real or emulated) for Atari keyboard controllers.
  252. * Make it faster.
  253. * Improve sound emulation.
  254. * Eliminate hardware banging for compatibility with future Amigas.
  255.