ScratchPsx for MS-DOS
=====================

A PlayStation 1 emulator for MS-DOS, from the 486 to the Pentium II, with
hardware rendering on 3dfx Voodoo cards.

Freeware - see LICENCE.TXT.


Which executable?
-----------------

  SCRPSX.EXE    VGA / VESA (any video card)
  SCRPSXV1.EXE  + 3dfx Voodoo Graphics (Voodoo 1) renderer, light sound (486)
  SCRPSXV2.EXE  + 3dfx Voodoo 2 renderer (SLI supported)

The Voodoo versions can still use VGA / VESA.


Requirements
------------

  Minimum      486DX4-100, 32 MB, VGA card
  Recommended  Pentium 200+ or Pentium II, 32 MB or more, VESA 2.0 or 3dfx
  Sound        Sound Blaster 2.0 / Pro / 16 (BLASTER variable)
  Mouse        Microsoft compatible driver (MOUSE.COM, CTMOUSE) for the menus


Installation
------------

1. Copy all the files into a directory (C:\SCRPSX for example).
2. Add the BIOS of YOUR console, named PSXBIOS.BIN, to that directory.
   No BIOS is included.
3. Run:

     SCRPSX GAME.CUE      the game directly (.cue / .bin image)
     SCRPSX               the menus and the file browser

DOS4GW.EXE must stay next to the executable (or be in the PATH).
DOS file names are 8.3 characters: rename your images if needed (CRASH.CUE,
CRASH.BIN, and the name of the .bin inside the .cue).


Video
-----

View menu, or the SCRATCHPSX_VIDEO variable before starting:

  1  320x200 VGA        256 colors, cropped picture     SET SCRATCHPSX_VIDEO=200
  2  320x240 mode X     256 colors (default)            SET SCRATCHPSX_VIDEO=240
  3  640x480 VESA       65536 colors                    SET SCRATCHPSX_VIDEO=640
  4  640x480 Voodoo     3dfx renderer (SCRPSXV1/V2)     SET SCRATCHPSX_VIDEO=glide

With a 3dfx card, the VGA cable goes through the card, as for games.
Brightness: SET SST_GAMMA=1.3 (Voodoo 1) or SET SSTV2_GAMMA=1.3 (Voodoo 2).


Sound
-----

BLASTER variable, for example:  SET BLASTER=A220 I5 D1 H5 T6

  SB16              44100 Hz, 16 bit, stereo (high DMA channel H)
  SB 2.0 / Pro      22050 Hz, 8 bit, mono (DMA channel D)


Keys
----

  Escape            show / hide the menus (the game is paused)
  Arrows            d-pad
  Enter / Space     Start / Select
  I  J  K  L        Triangle  Square  Cross  Circle
  T  G              L1  R1
  R  F              L2  R2
  E  D              L3  R3
  Tab (held)        fast forward

Keys can be changed in Settings > Keyboard... Menu shortcuts are shown next
to each command.


Messages
--------

The emulator messages go to SCRPSX.LOG.


Under DOSBox
------------

DOSBox-X emulates a Voodoo 1: see DOSBOXX.CNF (to adapt).
