Professional Documents
Culture Documents
Readme
Readme
-=-=-=-=-=
Introduction
============
One thing that should be noted is that pSX DOES NOT use plugins.
The emulator is completely self contained.
Installation
============
Extract all files from the .rar (or .tar.bz2 file under Linux) including
folders.
The emulator requires a PS1 BIOS file which should be placed in the
bios directory. By default the emulator will look for scph1001.bin
- this version is highly recommend because it is the only well tested
one although other bioses should work.
Once the emulator is running you can change the BIOS from the
configuration menu. In the event that you only have a different bios
file you can edit psx.ini to get the emulator running (run psx.exe
once, you will get an error message, now look for psx.ini).
OpenGL
ALSA
GTK
GTKGLEXT
libxml2
pSX will store its settings in ~/.pSX (the memcards, saves and screenshots
dirctories will also be created here). If psx.ini is present in the
application directory it will be read from there instead (for backwards
compatibility with verions before v1.13 - you can also move psx.ini here if
you don't want per-user settings, remember to make it world writable though
otherwise users will be unable to save any settings).
Running games
=============
or under Linux :
pSX /usr/psxgames/mygame.bin
Note that you will get best performance running in full-screen mode.
Press ALT+ENTER to switch between full-screen and windowed.
CDZ images
==========
pSX supports compressed CD images which are called .CDZ files. They can
either be created using the built in converted (File/Convert .BIN to/from
.CDZ) or by using the cdztool.exe command line utility.
.CDZ files can be created from all image formats that pSX supports.
You can also convert a cdz back to .cue/.bin by reversing the order of
the parameters, eg:
Configuration
=============
Paths
-----
This tab allows you to set the default paths for state saves, memory
cards and cd images.
BIOS
----
This tab allows you to set the BIOS image used by the emulator.
Memory cards
------------
This tab configures the memory cards inserted into the Playstations
slots. To create a memory card click ..., navigate to where you want
the file to be saved, and enter a filename (eg. "mycard").
Graphics
--------
Pause when not focused - when enabled the emulator will pause when its
main window does not have focus (note: sound is always disabled when
not focused).
Full screen mode: can be configured separately for PAL and NTSC. In
most cases these should be left on Default which will use the most
appropriate mode for the PS1 (Note: setting a mode that does not have
a refresh rate of 60hz for NTSC, or 100hz for PAL will result in less
smooth emulation). You can select which monitor fullscreen mode will use
(default = use whichever monitor the window is on). Aspect ratio correction
can also be forced in this dialog (the default setting is Auto which will
apply aspect ratio correction based on the resolution of your desktop - this
should do the correct thing for 99% of people).
Controllers
-----------
This tab allows you to configure joystick and keyboard mappings for
the Playstations controllers.
Note that you MUST configure the gamepad controls if you want to use
a joystick or gamepad (by default only keys are set up). Also note
that you must configure the analog axes if you want to use an analog
controller (eg. dualshock).
Up Cursor up
Left Cursor left
Down Cursor down
Right Cursor right
Triangle A
Square X
Cross Z
Circle S
Start Return
Select Space
L1 Left shift
L2 Left ctrl
R1 Right shift
R2 Right ctrl
Sound
-----
Device: set the device used for sound output, in most cases this should
be set to "Primary Sound Driver"
Frequency: normally you should leave "Same as emulated machine" checked
which will cause the emulator to use the same frequency as the PS1. To
change the output frequency untick the option and select from the combo
box.
Latency: This option controls how much delay there is in the sound output
in most cases the default setting will be fine, but if you experience
dropouts or choppy sound you can try increasing this.
Sync sound: When enabled the emulator will try to keep the sound in sync
with the graphics (this should normally be enabled).
Misc
----
CDROM
-----
To see what pSX thinks the mappings are run the emulator with the -x option:
psxfin -x
This will show a list of drives with the corresponding drive letter on the
left. If this is incorrect you can add entries to the [CDROM] section in the
.ini file to override it, for example :
[CDROM]
Driver=-1
SCSI4:1=x:
If the emulator crashes it will ask if you want to save a crash dump.
There are two types of crash dump, mini dump and full dump - a dialog
box will ask you if you want to save a full dump. In most cases you
will want to say no to this because full dumps can be very large - a
mini dump is usually enough to debug problems.
Dump files can be included in a bug report (see email address below).
NOTE: crash dump saving is only supported if you have dgbhelp.dll installed
History
=======
v1.4 Added final icon and controller dialog graphcs from TheCloudOfSmoke
Fixed bug where joystick device selection was not kept after restarting
Implemented PPF patch support (command line only for now)
Added option to disable bilinear filtering
Added L3 and R3 buttons for dualshock controller
Added reverse axis option for controller analog axes
Option to disable controller rumble now works
Second controller now works
Fixed keys that did not work in controller config dialog (eg. cursors)
Integrated CDZ converter into main program
Added gamma, brightness and contrast controls (fullscreen only)
Added quicksave/load functionality
Fast forward now temporarily turns off vsync
ASPI DLL is no longer required if using IOControl
Fixed state save dialog (now uses save type instead of open)
Fixed window painting when paused (or in modal dialogs)
Removed log menu option in release version
Editing code in debugger memory window works even when using recompiler
Fixed some other debugger problems
Implemented breakpoint editing
Fixed save state loading bug
v1.8 Various GTE fixes (fixes Wipeout, Tony Hawk Pro Skater 2, amongst others)
Fixed bug where self-modifying code was incorrectly detected
Save/restore debugger window layout
Debugger font can now be configured
Fixed crash when memory card file did not exist but was referred to by ini
Implemented CCD parsing
Improved CUE file handling (pre/post gaps and indexes now supported)
Fixed CD play command and report mode (fixes BIOS cd player)
Ignore non mode1 sub-q sectors (required when playing audio CDs)
Corrected sub-q faking when subcode reading is not enabled
Fixed bug where CDDA playing would stop when fast forwarding
Fixed crash when ejecting CD while game is reading it
Fixed crash when frame buffer is bigger than display mode (VibRibbon PAL)
All combo boxes in config menu are now read-only
Improved emulation of SPU CD and reverb buffer (VibRibbon)
Support SPU IRQs in CD buffer (VibRibbon)
Fixed crash after recovering from Ctrl-Alt-Del
Fixed bug where gamma settings did not update until pressing adjust key
v1.10 Allow ADSR changes while voice keyed on (fixes sounds in FF7 and others)
Localisation for various languages
Added internal manifest file (dialogs now support XP theme correctly)
Sound device can now be set to disabled
Fixed bug where sound was muted when reverb was disabled
Fixed Chrono Cross hangs introduced in v1.9
Breakpoints can now be added/removed in debugger while CPU is running
Added check for valid BIOS
Credits
=======
Contact
=======