home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 June / PCWorld_1999-06_cd.bin / software / temacd / vcoleco / VColeco.txt < prev   
Text File  |  1997-10-14  |  16KB  |  366 lines
  1. -------------------------------------------------------------------------------
  2.                              The Virtual ColecoVision
  3.                  A ColecoVision Emulator for Windows 95 and NT 4.0
  4.           Copyright (C) 1996, 1997 by Neal Danner (neald@geocities.com)
  5.                               All rights reserved.
  6.  
  7.                     ColecoVision (tm) is a trademark of Coleco.
  8.                DirectX(tm) is a trademark of Microsoft Corporation.
  9.           TMS9928A emulation based on original work by Marat Fayzullin.
  10.  
  11.                       Comso Fighter 2 (the included game ROM)
  12.                      Copyright (C) 1996, 1997 Marcel de Kogel
  13.                                All rights reserved.
  14.                          http://www.komkon.org/~dekogel
  15.  
  16.         All other product names mentioned here-in are either registered
  17.              trademarks or copyrighted by their respective holders.
  18. -------------------------------------------------------------------------------
  19.  
  20. The Virtual ColecoVision is a non-profit emulator created for those individuals
  21. who were and still are fans of the Coleco gaming era who wish to play their
  22. ColecoVision games under Windows 95 and NT 4.0.
  23.  
  24. For more information on the ColecoVision and it's history check out these
  25. web sites.
  26.  
  27. The Virtual ColecoVision Homepage:
  28. http://www.geocities.com/SiliconValley/Vista/8640/VColeco.html
  29.  
  30. Norman G. Sippel's ColecoVision Homepage:
  31. http://www.infinet.com/~ngsippel/cv.html
  32.  
  33. This History of Home Video Games Homepage:
  34. http://www.sponsor.net/~gchance/
  35.  
  36. The ColecoVision FAQ:
  37. http://www.infinet.com/~ngsippel/cv/cv-faq.html
  38.  
  39. Marcel de Kogel's Homepage (author of Comso Figher 2 and AdamEm):
  40. http://www.komkon.org/~dekogel
  41.  
  42. Marat Fayzullin's ColEm Homepage:
  43. http://www.komkon.org/fms/ColEm
  44.  
  45. -------------------------------------------------------------------------------
  46. Features in The Virtual ColecoVision
  47. -------------------------------------------------------------------------------
  48.    o  Full emulation of the ColecoVision game console hardware
  49.       including:
  50.       o   The primary and secondary hand controllers
  51.       o   Sound
  52.  
  53.    o  TMS9928A video emulation uses Microsoft's DirectX API for sprite
  54.       handling and screen refresh.
  55.  
  56.    o  Play full-screen or Windowed. A Full-screen scale factor setting is
  57.       also provided.
  58.  
  59.    o  Custom keyboard/joystick mappings of the ColecoVision hand
  60.       controller emulation.
  61.  
  62.    o  Both manual and automatic pausing of the emulation
  63.  
  64.    o  A bunch of ColecoVision hardware emulation settings to control
  65.       pretty much every aspect of the ColecoVision emulation core.
  66.  
  67.    o  Multithreaded so that Z80 CPU emulation runs on one thread while
  68.       Video/Input are ran from the primary thread.
  69.    
  70.    o  ColecoCheat! Provides a mechanism to cheat in *some* games.
  71.  
  72. -------------------------------------------------------------------------------
  73.                              Table of Contents
  74. -------------------------------------------------------------------------------
  75. 1.0 - Introduction
  76.  
  77. 1.1 - System Requirements
  78.  
  79. 1.2 - Revision History
  80.  
  81. 1.3 - Getting started
  82.  
  83. 2.0 - Feature Wish List
  84.  
  85. 2.1 - Known Problems/Bugs
  86.  
  87. 2.2 - Where to find Virtual ColecoVision Updates
  88.  
  89. 2.3 - General Questions and Answer
  90.  
  91. 4.0 - Special thanks
  92.  
  93. -------------------------------------------------------------------------------
  94. 1.0 - Introduction
  95. -------------------------------------------------------------------------------
  96. Thank you for using The Virtual ColecoVision.  After putting many hours into
  97. developing the core emulation, I hope you get as much enjoyment playing your
  98. ColecoVision games on The Virtual ColecoVision as I did developing it.
  99.  
  100.  
  101. A little history...
  102. The Virtual ColecoVision used to be called ColEm 97 until 10/06/97.  Most of
  103. you reading this may wonder why this happened. Well, it is a long story, so
  104. I'll attempt to make it short.
  105.  
  106. The Virtual ColecoVision is the result of a development project started by me
  107. back in October of '94. The project originated as The Virtual ColecoVision,
  108. but was later renamed to ColEm due to partial usage of Marat Fayzullin's
  109. TMS9918A emulation code. I did this as a courtesy to Marat for using his
  110. TMS9918A code. The rest of the the Virtual ColecoVision emulation code was and
  111. still is a combination of my development efforts. After speaking with Marat, it
  112. became apparent that since ColEm 97 was not a full port of his original ColEm
  113. UNIX source code, it should be given a new name. So, after reading many e-mails
  114. from users, a new name, "The Virtual ColecoVision", was chosen.
  115.  
  116. As a side note, the only Windows version of ColEm that was completely based on
  117. Marat's ColEm source was ColEmWin 0.1.2, which was originally ported by me but
  118. is no longer being developed.
  119.  
  120.  
  121. Additional contributions to this documentation are always welcome.  Please
  122. mail additional information, opinions, and/or comments to:
  123.  
  124. Neal Danner
  125. neald@geocities.com
  126.  
  127. Enjoy!!
  128.  
  129. -------------------------------------------------------------------------------
  130. 1.1 - System Requirements
  131. -------------------------------------------------------------------------------
  132.  
  133. Minimum system configuration:
  134.  
  135.    486-DX100/Pentium 75 or faster running Windows 95/NT4.0 with the
  136.       DirectX binaries installed.
  137.    8MB ram (16MB for NT4.0)
  138.    VLB video card
  139.  
  140.    Note: The DirectX binaries can be downloaded from:
  141.    http://www.microsoft.com/directx
  142.  
  143.  
  144. Recommended system configuration:
  145.  
  146.    Pentium 100Mhz or faster running Windows 95/NT4.0 with the
  147.       DirectX binaries installed.
  148.    16MB ram
  149.    PCI based video card
  150.    Joystick
  151.  
  152.    Note: The DirectX binaries can be downloaded from:
  153.    http://www.microsoft.com/directx
  154.  
  155. -------------------------------------------------------------------------------
  156. 1.2 - Revision History
  157. -------------------------------------------------------------------------------
  158.  
  159. 2.00a:
  160.    - First public release of ColEmWin 97.
  161.    - Initial release with OO emulation core design.
  162.  
  163. 2.00b:
  164.    - Fixed Video Mode 2 bug.
  165.  
  166. 2.00c:
  167.    - Fixed "Fatal Exception" crash caused when running ColEmWin 97 in color
  168.      depths greater than 16 bits per pixel.  This bug just goes to show you
  169.      that you shouldn't drink beer and code at the same time! =)
  170.  
  171. 2.10a:
  172.    - Added support for some undocumented Z80 opcodes
  173.    - Added ColecoCheat! feature which allows you to cheat on some games!
  174.    - Added ability to save/restore game progress!
  175.    - Added a Display tab to the ColEmWin 97 Properties dialog which
  176.      provides many new features:
  177.       - Video mode to use for full-screen mode can now be chosen from a
  178.         list of modes supported by your DirectDraw drivers.
  179.       - A "Scaling" factor for full-screen modes can now be specified
  180.         which allows the display output to be enlarged for high-resolution
  181.         video modes.
  182.       - There are now two independent frame skip rate settings.  One for the
  183.         full-screen mode frame skip rate and one for the Windowed mode frame
  184.         skip rate.
  185.    - Added button to invoke Joystick Configuration applet in the Control
  186.      Panel.  This was added for convienence only.
  187.    - Added button to invoke Display properties applet in the Control Panel to
  188.      help switch video settings for playing in Windowed mode.
  189.      This was added for convienence only.
  190.    - Added a menu item to the help menu which points your web browser to the
  191.      ColEm 97 Homepage.
  192.  
  193. 2.10b:
  194.    - Renamed ColEm 97 to "The Virtual ColecoVision".
  195.    - Fixed full-screen scale bug which caused no output under some video
  196.      resolutions.
  197.    - Added logo screen.
  198.    - Modified order of calls to DirectDraw's SetPalette() function.  This
  199.      fixes a bug where SetPalette() was failing.
  200.    - Added a "Message(s)" option to the Emulation menu where users can view
  201.      normal, warning, and error messages generated by the core emulation.  A
  202.      very useful tool for determining emulation problems.
  203.  
  204. 2.11a:
  205.    - Marcel de Kogel's Comso Fighter 2 game ROM is now included!
  206.  
  207.    - Fixed TMS9928A video mode 3 bug in TMS9928A emulation.  Now games like
  208.      Smurf Paint'n Play work (and possibly others as well).
  209.  
  210.    - Fixed TMS9928A video mode 2 pattern generator and color table problems
  211.      (in VMode 2, VDP registers 3 & 4 have a different function).
  212.       
  213.    - Rewrote the speed synchronization core.  It now uses the Win32
  214.      performance counting API since it provides a finer granularity for
  215.      profiling emulation speed than does the Win32 GetTickCount()
  216.      function.
  217.  
  218.    - Added system registry manipulation command line options:
  219.       
  220.      "/unregister" - Pass this argument to remove all references to
  221.                      The Virtual ColecoVision from the system registry,
  222.                      including setup information and file associations.
  223.  
  224.      "/register" - Pass this argument to register VColecoWin in the
  225.                    system registry.  This also allows you to specify
  226.                    other cartridge file extensions to associate with
  227.                    The Virtual ColecoVision.
  228.  
  229.    - TMS9928A emulation now dumps video mode switch information into
  230.      the Emulation -> Message(s) dialog.
  231.  
  232.    - Fixed bug where the previous display mode isn't restored if a
  233.      user exits VColecoWin with ALT+F4 while running in Fullscreen mode.
  234.  
  235.    - Added drag-n-drop support.  Now you can drag ROM files directly onto
  236.      The Virtual ColecoVision to load them.  If you drag more than one ROM
  237.      file, multiple Virtual ColecoVision instances will be spawned.
  238.  
  239.    - Fixed duplicate menubar accelerators.  Added accelerators for some
  240.      options previously only available by traversing the menu.
  241.  
  242.    - Fixed textual errors in ColecoCheat! (mainly for BurgerTime).
  243.  
  244. -------------------------------------------------------------------------------
  245. 1.3 - Getting started
  246. -------------------------------------------------------------------------------
  247. Your on your own until I get this section written.  =)
  248.  
  249. -------------------------------------------------------------------------------
  250. 2.0 - Feature Wish List
  251. -------------------------------------------------------------------------------
  252.    - Debugger/assembler (including a ROM/tile editor).
  253.    - Add network play using DirectPlay.
  254.  
  255. -------------------------------------------------------------------------------
  256. 2.1 - Known Problems/Bugs
  257. -------------------------------------------------------------------------------
  258. 2.10c:
  259.    - BeamRider, Bump'n Jump, and The Heist still don't load or run correctly.
  260.      Bump'n Jump caused emulator to hang.  Possibly caused by a bug in the
  261.      Z80CPU or TMS9928A emulation.  After I get the Z80CPU execution
  262.      profiler/cache working I hope to quickly resolve this problem.
  263.  
  264.    - Pitfall, Dukes of Hazzard, and Frogger don't accept hand controller input.
  265.      Appears to be something in the hand controller emulation...
  266.  
  267.    - The "Add/Remove Joystick(s).." button in the Input Devices tab doesn't
  268.      work under Windows NT 4.0 if no Joystick devices are attached.
  269.  
  270. -------------------------------------------------------------------------------
  271. 2.2 - Where to find Virtual ColecoVision Updates
  272. -------------------------------------------------------------------------------
  273.  
  274. The latest version as well as all previous versions of the Virtual ColecoVision
  275. can be found at The Virtual ColecoVision Homepage:
  276. http://www.geocities.com/SiliconValley/Vista/8640/VColeco.html
  277.  
  278. ***********************************************************************
  279. PLEASE NOTE:  No catridge ROM images are included with The Virtual ColecoVision
  280. due to the fact that some of the ColecoVision games are still under copyright
  281. by their respective holders.
  282. ***********************************************************************
  283.  
  284. -------------------------------------------------------------------------------
  285. 2.3 - General Questions and Answers
  286. -------------------------------------------------------------------------------
  287. Q1: Where can I get some Game Cartridge ROM images?
  288.  
  289.     A1: The cartridge ROM images are still under copyright by their respective
  290.         holders.  Owning a copying of a cartridges ROM is illegal unless
  291.         you actual own the corresponding ColecoVision catridge.  There are
  292.         numerous sites on the Internet where you can download copies of
  293.         ColecoVision game ROMs.  I will list them here for your
  294.         reference only.  I am not involved with nor do I endorse or
  295.         otherwise support any of these sites.
  296.  
  297.         Dave's Video Game Classics - Coleco ROMs:
  298.         http://www.davesclassics.com/colecoroms.html
  299.  
  300.         The History of Home Video Games Homepage - ColecoVision Archive:
  301.         http://www.sponsor.net/~gchance/ColecovisionStuff/Docs/docs.html
  302.  
  303.         Coleco Corner:
  304.         http://www.pce.net/anthony/colcorner/
  305.  
  306.         PLEASE DO NOT send me e-mail asking for game ROM images!
  307.  
  308. Q2: When I try and run VCOLECO.EXE, Windows just tosses up a dialog 
  309.     box with an error message dealing with DDRAW.DLL or DSOUND.DLL.
  310.     What is the problem and how do I fix it?
  311.  
  312.     A2: The DirectX libraries must be installed for The Virtual ColecoVision
  313.         to function.  You can get the DirectX libraries by downloading and
  314.         running the following program:
  315.  
  316.         http://www.microsoft.com/DirectX/Resources/Downloads/dx5eng.exe
  317.  
  318. Q3: I can successfully run The Virtual ColecoVision, but when I get to a
  319.     game select screen I cannot get any further.  It's like the emulator
  320.     isn't getting input from my keyboard.  How do I fix this problem?
  321.  
  322.     A3: There are two things here.  First, some games don't work well
  323.         with the hand controller emulation in The Virtual ColecoVision.
  324.         Check out the "Known Problems/Bugs" section of this file for
  325.         a know list of these types of games.
  326.  
  327.         Second.  On some computers, the default keyboard mapping doesn't
  328.         work.  So, if you simply remap every hand controller emulation
  329.         key for each controller in the Input Devices setup tab, it might
  330.         start working.
  331.         
  332.         How to get to the Input Devices setup tab:
  333.         1.   Press Alt+I on your keyboard OR click on the"Emulation ->
  334.             Input Devices..." menu item.
  335.  
  336.         2.  Now, click on the "Defaults" button.
  337.  
  338.         3.  Then choose a key in the "ColecoVision Key" combo box and the
  339.             "Mapped As" location will display the key or joystick button
  340.             that it's mapped to on your machine.  Now, go through each
  341.             key in the "ColecoVision Key" list, and then click on the
  342.             button/combo box under the "Mapped As" label to map it to a
  343.             different key.  Note that you can remap it to the same keyboard
  344.             key it was set to by default, thus resetting the mapping layer.
  345.  
  346.             I'm assuming that problem comes from the fact that the binary
  347.             key state that The Virtual   ColecoVision defaults to isn't
  348.             matching your keyboard's bit pattern for the same key.
  349.  
  350. -------------------------------------------------------------------------------
  351. 4.0 - Special Thanks
  352. -------------------------------------------------------------------------------
  353.  - My wife, for putting up with me during development of the Virtual
  354.    ColecoVision!
  355.  - Thomas Jacobs and John Maier (for providing me with their
  356.    Coleco-ADAM computers!)
  357.  - Marat Fayzullin (for his TMS9918A emulation source)
  358.  - Marcel de Kogel for allowing me to distribute his Comso Fighter 2 game
  359.    ROM with the Virtual ColecoVision!! (http://www.komkon.org/~dekogel)
  360.  
  361. -------------------------------------------------------------------------------
  362. Unanswer Questions and/or Comments
  363. -------------------------------------------------------------------------------
  364. Do you have any questions that aren't answered above?  Send your question(s) 
  365. to Neal Danner at neald@geocities.com with a subject line of
  366. "The Virtual ColecoVision".