home *** CD-ROM | disk | FTP | other *** search
/ Emulator Universe CD / emulatoruniversecd1998.iso / PC-Engine / Emus / Vpce / README < prev    next >
Encoding:
Text File  |  1997-11-23  |  6.5 KB  |  188 lines
  1. Documentation for VPCE v0.3 (Virtual PC-Engine) 
  2. ===============================================
  3.  
  4. Starting:
  5.         vpce [<filename>] [parameters]
  6.  
  7. filename:
  8.         Without a filename VPCE tries to load "CART.PCE".
  9.  
  10. parameters:
  11.         -us : country protection set to US (default, and mostly US-games
  12.               check it !) (set it for "military madness")
  13.         -jp : country protection set to Japan (set it for "nectaris")
  14.         -swap: swap bitorder, for images, that have been dumped with the
  15.                 "wrong" order.
  16.         -run : bypass the debugger and run the game [default]
  17.         -debug: run the debugger 
  18.  
  19.         -bench n : render n frames and exit
  20.         -frameskip n : skip n frames between updates
  21.  
  22.         -joypad: enable analog ibm-joystick/pad
  23.         -nojoypad: disable analog ibm-joystick/pad
  24.  
  25.         -bm <name>: filename for backup-memory
  26.         >> Attention: The default filename for the backup-memory changed <<
  27.         >> from "bram.bin" to "backup.ram" !                             <<
  28.  
  29.         -sound: enable sound 
  30.         -nosound: disable sound [default]
  31.         >> The MS-DOS version has no sound-driver, yet. It will be added    <<
  32.         >> to version v0.4. If you enable sound, a file called "output.snd" <<
  33.         >> will be written into the current directory, it's raw audio,      <<
  34.         >> stereo, 8-bit, 22050 Hz, unsigned.                               <<
  35.  
  36. (Only in the unix-version:)
  37.         -townspad: enable the FM-Towns joypad
  38.         -notownspad: disable the FM-Towns joypad [default]
  39.  
  40.         -xshm: enable X-shared memory extensions [default]
  41.         -noxshm: disable X-shared memory extensions
  42. (Only in the msdos-version:)
  43.         -videomode 0..2
  44.                 0: 320x200
  45.                 1: 256x240
  46.                 2: 256x256
  47.  
  48. The msdos version needs the cwspmi protected-mode server, if it isn't
  49. started from windows. Look at www.delorie.com for the cwsdpmi package,
  50. or look, if another of your programs has the necessary file. It's called
  51. "CWSDPMI.EXE". Just copy it into the same directory as vpce.exe, or copy
  52. it into one of the directorys in the PATH.
  53.  
  54. game keys:
  55. ESC:                    quit the emulator, or drop back to the debugger in
  56.                         debug-mode
  57. Joypad/Joystick/Cursor: Move
  58. S                       Save screenshot to disk
  59.  
  60. Ctrl/Shift/Space/Return: I, II, select, run
  61.  
  62. Debug-Mode
  63.  
  64. Press 'R' to start emulation ! The game is controlled by a 4-button analog
  65. joypad or the keyboard.
  66.  
  67.  
  68. debugger keys:
  69.  
  70. Keys:
  71. ESC     exit
  72. TAB     change display-mode (disassembly, memory, VRAM)
  73. DEL     nop opcode at cursor position
  74. X       place a 'RET' at cursor position
  75. Y       place a 'RTI' at cursor position
  76. T       single-step current opcode
  77. R       start program
  78. S       step over current opcode 
  79. H       go to cursor position
  80. V       browse VRAM:
  81.         1       select bg-mode 
  82.         2       select sprite-mode 
  83.         3       select map-mode 
  84.         4       select map-mode, but don't decode the palette information
  85.         +/- = selects the 16-color palette to use */
  86.         up/down/left/right: move
  87.  
  88. M       save virtual "map". Can be handy for creating maps for RPGs ...
  89.         (This function saves only the background, without sprites)
  90. P       save screenshot
  91.  
  92. The keys 'M' and 'P' do now prompt for a filename.
  93.  
  94. 1       trigger irq at $FFFC
  95. 2       trigger irq at $FFFA
  96. 3       trigger irq at $FFF8
  97. 4       trigger irq at $FFF6
  98. up/down/left/right: move
  99.  
  100. History:
  101. Version VPCE_PRE
  102. - first version (16-Bit real-mode)
  103. - some Hu6502 instructions
  104. - visual debugger/disassembler
  105.  
  106. Version VPCE PRE-2
  107. - 32-Bit version
  108. - integrated most of the memory/cpu stuff
  109. - removed MSCDEX-driver, CD-ROM stuff temporarily disabled !
  110. - loads HuCards
  111. - added lot's of debugger functions
  112.  
  113. Version VPCE PRE-3
  114. - graphics, sprite, line-by-line update
  115. - (experimental GUS-driver, removed for this preview)
  116.  
  117. Version VPCE PRE-4
  118. - fixed a few bugs in CPU-emulation. Thanks go to David Shadoff for
  119.   releasing his code !
  120. - completely rewrote the sprite-clipping method.
  121. - rewrote the joypad code slightly.
  122.  
  123. Version VPCE v0.1
  124. - rewrote the video-engine
  125. - fixed some bugs and added some new...
  126. - rewrote timing and irq
  127.  
  128. Version VPCE v0.2
  129. - rewrote the sprite-engine: sprite/sprite and sprite/background priority
  130.   seems to work correctly.
  131. - fixed some bugs and added some new...
  132. - modified timing. Bomberman works a little better ...
  133.  
  134. Version VPCE v0.3
  135. - added new video-modes: 256x256, 256x240
  136. - fixed a stupid bug in vram-emulation. Thanks go to Paul Clifford for
  137.   reporting it !
  138. - fixed some bugs all over the place
  139. - improved timing
  140. - keyboard control
  141.  
  142.             Jens Ch. Restemeier
  143.  
  144. Many thanks go to ...
  145. - David Shadoff
  146. - David Woodford
  147. - David Michel
  148. - Joe LoCicero,IV
  149. - The Riddler
  150. - Videoman
  151. - Stephane DUBON
  152.  
  153. ... for their great help !
  154.  
  155. And a very lot of thanks go to:
  156. - Edward Massey for the Win-32 version
  157. - Jonathan Lane for the MacOS/BeOS version
  158. - Paul Clifford for the RiscOS version, and for finding new information
  159. - Osamu KURATI for the Unix/X version
  160. - Steven Fuller for the Linux/SVGAlib version
  161.  
  162. ------------------------------------------------------------------------------
  163. e-mail: Jens Ch. Restemeier <jchrr@hrz.uni-bielefeld.de>
  164.  
  165. ------------------------------------------------------------------------------
  166. IMPORTANT ! IMPORTANT ! IMPORTANT ! IMPORTANT ! IMPORTANT ! IMPORTANT ! IMPORT
  167. ------------------------------------------------------------------------------
  168. Use VPCE at your own risk.  There is no warranty for the  program  of any kind.
  169. I don't  take  responsibility  for  any  damage  caused by the program, either
  170. direct or indirect, physical or psychical,  to your hardware, software or soul.
  171. ------------------------------------------------------------------------------
  172.  
  173. VPCE/MSDOS v0.2 Copyright 1997 Jens Ch. Restemeier
  174. VPCE/WIN32 v0.15 additional code Copyright 1997 Edward Massey
  175. VPCE/MacOS v0.2 additional code Copyright 1997 Jonathan Lane
  176. VPCE/RiscOS v0.2 additional code Copyright 1997 Paul Clifford
  177. VPCE/Unix v0.2 additional code Copyright 1997 Osamu KURATI and Steven Fuller
  178.  
  179. None of the above authors is affiliated with NEC or Hudson nor advocate the
  180.  piracy of PC-Engine games !
  181.  
  182. VPCE is freeware and can be distributed freely as long as it is not modified
  183.  and ROMs are not packaged with the program !
  184.  
  185. "NEC", "PC-Engine" and "Turbo Grafx 16" are trademarks of NEC and Hudson.
  186.  
  187.    --- If you do not agree with these terms delete this software now ! ---
  188.