home *** CD-ROM | disk | FTP | other *** search
/ Computer Installation Guide - Dragon Clan Series / CD2.iso / GAME / GEN14 / README.TXT < prev   
Encoding:
Text File  |  1997-07-14  |  11.4 KB  |  327 lines
  1. =================================================================
  2.  genecyst                                 Version 0.14 (7/15/97)
  3.  by Bloodlust Software
  4. =================================================================
  5.  
  6. Do not send any files without asking first.
  7.  
  8. ---------------------
  9.      What it is
  10. ---------------------
  11.  
  12. genecyst is a DOS based emulator for the Sega Genesis.
  13.  
  14. The 68K emulation and graphics rendering were both
  15. written from scratch in assembly. The rest is in C++.
  16.  
  17. It is freeware and it is not to be distributed with game
  18. ROMs and it is not to be modified or sold.
  19.  
  20. Currently it only runs roms in the BIN or SMD file formats.
  21. You will need a converter to convert files from the other file formats.
  22.  
  23. OS/2 users: -disablelfn
  24.  
  25.  
  26. ---------------------
  27.      Revisions
  28. ---------------------
  29.  
  30. Version 0.14:
  31.  -Unchained modeX modes added (320x240 and 320x224)
  32.   These modes are considerably slower than VESA modes so don't use them
  33.  -6 button joystick inputs (almost)
  34.  -Stop intruction fixed
  35.  -Fixed MOVE->CCR data size
  36.  -Sped up 68k branching
  37.  -Funky Z-flag implemented
  38.  -Improved waitvsync
  39.  -Pattern table viewer
  40.  -Layer enabling dialog
  41.  -Fixed DOS hardware error handler
  42.  -Readjusted window priority
  43.  
  44. Version 0.13:
  45.  -PCX palette saving fixed
  46.  -Fixed MOVEM wraparound bug
  47.  -Fixed 68k flag bugs
  48.  -Added primitive Z80 faking
  49.  -Altered Window priority
  50.  -ROM checksum fixer (fixes games that "red screen")
  51.  
  52. Version 0.12:
  53.  -Initial release
  54.  
  55. ---------------------
  56.     What it does
  57. ---------------------
  58.  
  59. What is emulated:
  60.  
  61.    -68000 CPU
  62.    -VDP
  63.    -DMA (RAM->VRAM and VRAM fill)
  64.    -ScrollA/ScrollB/Sprites/Window
  65.    -H/V interrupts
  66.    -Dual 4-button/7-button joypad emulation
  67.    -US/Japan/Europe variants
  68.  
  69. Other neat features:
  70.  
  71.    -Multiple save states and battery backed ram
  72.    -Joystick/GrIP support
  73.    -VESA support
  74.    -Save .pcx snapshots
  75.    -Game genie codes
  76.    -Rom checksum fixer
  77.  
  78. ---------------------
  79.    What it lacks
  80. ---------------------
  81.  
  82. 68000 emulation is still buggy
  83. Z80 emulation
  84. Sound emulation
  85. Raster-based effects
  86. Cell based v-scrolling
  87. Sprite masking
  88. Shadow/highlighting effects
  89. Interlaced modes
  90.  
  91. Pentium MMX support
  92.  
  93. Many games do not work correctly (or at all).
  94. Dont bother me if a ROM doesn't work.
  95.  
  96. ---------------------
  97.   What you need
  98. ---------------------
  99.  
  100. A Pentium with at least 8MB of RAM.
  101.  
  102. genecyst can take advantage of VESA 2.0 support if it exists.
  103. If it does not exist, genecyst will resort to only the
  104. video modes 320x200, 256x224, 256x240, 256x256, 320x224, 320x240.
  105. The last 2 modes are planar (unchained) ModeX modes, meaning that
  106. they are not linear and are very SLOW. Get a VESA extender such as Scitech
  107. Display Doctor (www.scitechsoft.com) and use 320x240 instead.
  108.  
  109. ---------------------
  110.   Work it baby
  111. ---------------------
  112.  
  113. Use alt-<key> to access the menu options (ie alt-l loads)
  114.  
  115. The default keys for the first controller are ABC='zxc', Start='v', XYZ='asd',
  116. and the arrow keys. They can be remapped from the Settings/Input device menu.
  117. Enter/Tab will simulate Start/C on controller 1 if you have a 2 button joystick,
  118. ONLY when the GUI is disabled or the game window has input focus (click on it)
  119.  
  120. 6-button Genesis controllers can be enabled from the Settings menu. Having a
  121. 6-button controller enabled on older games will most likely cause them to go
  122. haywire. The emulation of the 6-button controllers is only a guess, but it
  123. seems to work for most games.
  124.  
  125. Some carts check to see what version of hardware they are running
  126. on (US/Japan/Europe), and they'll bitch if played on the wrong system.
  127. You can change the system version from the settings menu and then reset
  128. the CPU.
  129.  
  130. Some games contain battery backed RAM. This RAM is automatically
  131. loaded and saved to "xxxx.GSV" files.
  132.  
  133. F5/F7 saves and loads states. Pressing the keyboard keys 0-9 (not the numeric
  134. keypad ones) will change the current state slot for subsequent saves/loads.
  135. The state filename follows the form "xxxx.GS?" where 'xxxx' is the romname
  136. and ? is the current save slot (0-9).
  137.  
  138. Know that the battery backed RAM is saved in each state file. The
  139. battery RAM from any state file that is loaded will overwrite
  140. the ROM's .GSV file.
  141.  
  142. There might be some bugs in the state and battery saving.
  143.  
  144.  
  145.  
  146. ---------------------
  147.       Input
  148. ---------------------
  149.  
  150. genecyst supports analog joysticks, 4-button gamepads,
  151. 6-button PC Fighter pad (Capcom), the Gravis GrIP gameport
  152. and keyboard input.
  153.  
  154.  - There are two input devices, one each for controller 1 and 2.
  155.  - Change the input devices with Settings/RedefineInput
  156.  - Enter/Tab will simulate Start/C on controller 1, ONLY when
  157.     the GUI is disabled or the game window has input focus (click on it)
  158.  - You can remap the buttons for a joystick input device with the
  159.     command line option '-remapbut' or from the "Remap buttons" dialog...
  160.     Simply click on the button type and then press the joystick button
  161.     you wish to use. Pressing any key will set the NES button to "None".
  162.  - You can redefine the keys for a Keyboard input device with the
  163.     Redefine Keys dialog, or with the '-setkey' command line option
  164.  - Joystick 1 or 2 refer to 2-button analog joysticks only!
  165.  - "Gamepad" refers to a 4-button analog joypad (or joystick)
  166.  - PC Fighter refers to a 6-button analog joypad with buttons 5 and 6
  167.     read through the analog input lines of the second joystick port
  168.  - You can interactively calibrate the joystick with the "Calibrate"
  169.     button. Just center and swirl. The joystick thresholds can be also
  170.     set with the '-joythresh' command line option.
  171.  - The '-analogjoyres' command line option sets the maximum number of
  172.     times that the joystick port is polled (usually this need not be changed)
  173.  - In order to enable GrIP support, you MUST copy the "grip.gll" file
  174.     to the startup directory. genecyst will load the driver
  175.     if it finds it and the GrIP devices in slot 1 or 2 can be used.
  176.     Note that if you have Win95 GrIP drivers installed it may not be
  177.     possible for a DOS application to access the GrIP port.
  178.  
  179.  
  180.  
  181. ---------------------
  182.       Timing
  183. ---------------------
  184.  
  185. You can adjust the timing from the Settings menu.
  186.  
  187. HBlank inst is the number of instructions per scanline (224 lines per frame).
  188. VBlank inst is the number of instructions per vertical retrace (vblank).
  189. Vfps is the number of emulated frames per second.
  190.  
  191. Some games require more instructions per frame in order to not slowdown. In
  192. other words some games need more CPU power. Other games may need less.
  193.  
  194. The more time spent emulating the 68k, the less time available to render
  195. frames and vice versa.
  196.  
  197.  
  198. ---------------------
  199.    ROM patching
  200. ---------------------
  201.  
  202.  
  203. genecyst supports GameGenie codes and general patching of the
  204. CPU ROM address space (0-3FFFFF).
  205.  
  206. Bring up the ROM patching dialog with F6 or from the CPU menu.
  207. There are two edit fields in the dialog, the Name and the Code.
  208. The Code field is where the actual code goes (eg SCRA-BJX0).
  209. The Name field lets you type in a description of the code (eg "Rings worth 2"),
  210. if no name is entered then the code string is used as the name.
  211. Once you've filled these in, clicking "Add" (or pressing enter) will
  212. add it to the list of patches. To activate or deactivate the patch,
  213. doubleclick on the code name in the listbox or click on "Toggle".
  214. "Remove" deletes the patch completely. "Save" writes all the patches
  215. to the text file <romname>.pat, this file is decribed below.
  216.  
  217. genecyst accepts either GameGenie codes or raw patches.
  218. GameGenie codes are 8 digits long and use the symbols:
  219.      ABCDEFGHJKLMNPRSTVWXYZ0123456789
  220. The use of a '-' is optional.
  221.  
  222. The raw patches are in the format:
  223.         <$addr>:<$val>
  224. <$addr> is the 24-bit hex address (must be even)
  225. <$val> is the 16-bit hex value to be patched at that address.
  226.  
  227. genecyst can save a .pat file that contains all the patches
  228. created during a game. This file can be modified using a
  229. text editor. Each line of the .pat file looks like this:
  230.             <code> [<name>]
  231. <code> is the patch itself (GG or raw format).
  232. <name> is the text description of the code, if no name is supplied
  233.         then the code is used as the name
  234.  
  235. Note: If more than one patch modifies the same address then only one
  236. can be active at once. Activating one will deactivate the others.
  237.  
  238. Another Note: Most Genesis games do a rom checksum in order to verify
  239. their integrity. Therefore, having a patch active during the ROM's startup
  240. code could in most cases cause the ROM to crash itself. (Hence the use
  241. of so called 'master codes')
  242.  
  243.  
  244. ---------------------
  245. Command line options
  246. ---------------------
  247.  
  248.  
  249. @<filename>     : Parses the file <filename> for command line options
  250.  
  251. -res <xw> <yw>  : Sets the resolution to xw,yw on startup.
  252.  
  253. -setinput <num> <type>
  254.                 : Sets input device <num> to <type>
  255. -remapbut <device> <a> <b> <c> <start> <x> <y> <z>
  256.                 : Remaps buttons for <device>
  257.                 : <device> can be JOY1, JOY2, GRAVIS, GRIP1, GRIP2, 6BUTTON
  258. -setkey <device> <ul> <u> <ur> <l> <r> <dl> <d> <dr> <a> <b> <c> <start> <x> <y> <z>
  259.                 : Sets the keyboard scancodes for <device>
  260.                 : <device> can be KEY1 or KEY2
  261. -setjoythresh <num>  <left> <right> <up> <down>
  262.                 : Sets the joystick threshold for analog joystick <num>
  263.                 : left,right,up,down define the joystick's "dead-zone"
  264. -analogjoyres <num>
  265.                 : Sets the maximum number of times the joystick port
  266.                 : is polled. Increase this number if the calibration values
  267.                 : seem to max out.
  268.  
  269. -waitvsync      : Wait for the vertical sync to draw frames
  270. -hidegui        : Hide GUI on startup
  271. -nomsgpopup     : Disables the last message from being shown on screen
  272.  
  273. -load <rom>     : Load <rom>
  274. -run <rom>      : Load & Run <rom>
  275.  
  276. -romdir <dir>   : Sets the startup dir for roms
  277. -savedir <dir>  : Sets the directory for .GS? files
  278. -pcxdir <dir>   : Sets the directory for saving snapshots
  279.  
  280. -? or -h        : Display command line help
  281. -disablelfn     : Disables long file name support
  282. -novesa         : Don't use VESA extensions
  283. -linear         : Force linear video mode
  284. -banked         : Force banked video mode
  285.  
  286.  
  287. ---------------------
  288.      Contact
  289. ---------------------
  290.  
  291. Bloodlust Software
  292. bldlust@southwind.net
  293. http://www2.southwind.net/~bldlust/genecyst.html
  294.  
  295. Don't email me about ROMs.
  296.  
  297. Information on the NeoGeo or Capcom arcade units would be appreciated.
  298.  
  299. ---------------------
  300.   Acknowledgements
  301. ---------------------
  302.  
  303. The authors and contributors to the Sega Programming Faq
  304.  
  305. Neill Corlett for general 68K information
  306. Get MGE now: http://www4.ncsu.edu/eos/users/n/nscorlet/mge/
  307.  
  308. Merlyn LeRoy for the Sega Game Genie decoding
  309.  
  310. Special thanks to Loaded
  311.  
  312. ---------------------
  313.      Disclaimer
  314. ---------------------
  315.  
  316. genecyst Copyright 1997 Bloodlust Software
  317. Sega and Genesis are trademarks of Sega Enterprises, Ltd.
  318. Neither Bloodlust Software nor the author are affiliated with Sega
  319.  nor advocate the piracy of Genesis games.
  320. genecyst is freeware and can be distributed freely as long as it is not
  321.  modified and ROMs are not packaged with the program.
  322. When you use this software you do so at your own risk. The author is
  323.  not responsible for any loss or damage resulting from the use or
  324.  misuse of this software.
  325. If you do not agree with these terms delete this software now.
  326.  
  327.