RuMSX - MSX-Emulator, V0.40:
============================

This free MSX-Emulator has following improvements:
- Emulation of MSX, MSX 2, MSX 2+ and MSX Turbo-R machines
- Full V9958 emulation
  (including Screen 10-12, vertical and horizontal scroll-registers)
  vertical scanline-interrupts are not working perfectly at this time
- Integrated Z80-Debugger
- Support for
  + multiple Joysticks
    (running well with Salamander and Super Laydock 2)
  + mouse, requires DirectInput
  + TouchPad (planned)
- Usage of several configuartions and memory-layouts
- support for DSK-, DDI- and IMG-files
- support for real MSX floppy-disks in disk-drive
- support for Tape-files
- support for ROM-changes (also during runtime)
- Disk- and Tape-images can be write-protected
  (media-change supports write-protect tab emulation)
- Disk- and Tape-images can be directly run from CD-ROM archives
  (as long as you don't need to save data on disk)
- Disk-images are allowed to contain errors
- Support for printers (not fully implemented yet)
  you can send your raw-data or emulate an MSX-Printer
- Support for RS232 (not implemented yet)
- Support of all MSX disk-formats
- Support for Window- and FullScreen (requires DirectDraw2) -Mode
- Emulation of PSG and SCC
  other sound-devices will be added in the future
- Supports japanese Kanji-ROM's (level 1 and 2)
- Integrated Emulator-Help and MSX-Documentation
- Performance fine-tuning to get best speed
  and/or quality on your Win32-machine
  (CPU-Load, Video- and Sound-emulation)
- Run's on Windows 95/98, Windows NT 4.0 and Windows 2000
  (to take advantage of all features DirectX3 for Windows 95
  or Windows NT 4.0 ServicePack 3 is recommended)
- Different CMOS settings for each Windows-user
  (because user-dependent values are stored in the registry)
- possibility to localize MSX ROM's
  (font, system-information, ...   keyboard layout is still a
  problem because of different implementations for different
  countries: International, Japanese, Korean, ...)
- fMSX images are compatible with RuMSX,
  but the always created & loaded CMOS.ROM file is only supported
  if stored within the "My MSX" folder.
  Refer to the "My MSX folder setup" for more details about this feature.

The emulation should run properly on a P166,
but after tuning it should also run well on a P90


C-BIOS:
-------
If using C-BIOS please read the license agreement in
SYSTEM\CBIOS\cbios.en.txt.
C-BIOS is a free BIOS compatible to the MSX BIOS. The
homepage of C-BIOS is on http://cbios.sourceforge.net/


Known bugs & problems:
----------------------
For a list of known bugs, problems and possible workarounds refer to
the RuMSX help (topic: "Known Problems").


Trouble shooting:
-----------------
- DirectX
  RuMSX automatically uses DirectX, if installed on the system.
  If some Windows-drivers are not compatible with DirectX this
  may cause problems during startup or execution of RuMSX!
  To locate/fix the problem(s) start in this way: MSX /SOS
  For more informations refer to the MSX-Help
  (topics: Trouble-shooting, Command-line arguments)


Developers:
-----------
Normally system-files are located in the correspondig subdirectories
of the started emulator. Developers can use SET RUMSX_DIR= to
specify another base-directory to test debug-, nodebug- and other
modified binaries.


Directories:
------------
.          contains MSX.EXE and SETUP.EXE
.\Config   contains configurations and memory-layouts
.\Help     contains the help-files (including generated text-indices)
.\Locale   contains fonts to patch system-ROM's for other countrys
.\Patch    contains image-informations (ROM-types, ...)
.\SRAM     contains SRAM-images (alternative: SET RUMSX_SRAMDIR)
.\System   contains the MSX ROM-images
.\Util     useful utilities for RuMSX
.\ROM      ROM-images (optional: XBasic, MSX-DOS 2.20, ...)
.\DSK      Disk-images (MSX-DOS, ...)
.\CAS      for tape-images
Since RuMSX V0.29 also a "My MSX" folder is supported, even if it need
to be activated explicitly. For information about the "My MSX" folder
structure refer to the RuMSX help manual (MSX.CHM).


Testing:
--------
The code is tested on various configurations:
- Windows 2000, SP4
- Windows 98SE, DirectX 9.0
- Windows XP, SP2

Each significant code-change is tested with typical MSX-Software
to find possible side effects:
- ZanacEx
  (scanline-interrupts, horz/vert scrollregister)
- Aleste 2
  (scanline-interrupts, horz/vert scrollregister)
- Super Laydock 2
  (scanline-interrupts, horz/vert scrollregister, Joysticks, Screen 12)
- F1 Spirit 3D Special
  (scanline-interrupts, horz/vert scrollregister, Screen 12)
  ScanLine-interrupts during game are not working correctly at this time
- SpaceManbow
  (scanline-interrupts, horz adjust-register, SCC)
- Metal Gear 2
  (MegaROM, SCC)
- Tetris
  (Screen 7)
- Metal Gear
  (Tape)
- F-nano2
  (Screen 2, 5, 3 using scanlines and horz/vert scrollregister, Turbo-R)
- Breaker
  (Mouse, vert scrollregister, VRAM-layout)

************ END OF FILE *********** http://www.lexlechz.at ************
