scummvm/backends/platform/psp
Joost Peters c5bc18e070 fix warning
svn-id: r40204
2009-04-29 15:54:35 +00:00
..
icon0.png move psp backend to backends/platforms/psp 2006-06-30 21:00:39 +00:00
kbd_l_c.cpp Removed trailing spaces. 2008-01-27 19:47:41 +00:00
kbd_ls_c.cpp Removed trailing spaces. 2008-01-27 19:47:41 +00:00
kbd_s_c.cpp Removed trailing spaces. 2008-01-27 19:47:41 +00:00
kbd_ss_c.cpp Removed trailing spaces. 2008-01-27 19:47:41 +00:00
Makefile add -DDISABLE_TEXT_CONSOLE and -DDISABLE_COMMAND_LINE 2009-02-18 16:11:54 +00:00
module.mk Allow building of psp backend via configure (Part 1 - Still need to add the fixup + EBOOT packing steps). 2009-03-25 21:58:16 +00:00
osys_psp_gu.cpp Allow building of psp backend via configure (Part 1 - Still need to add the fixup + EBOOT packing steps). 2009-03-25 21:58:16 +00:00
osys_psp_gu.h Removed trailing spaces. 2008-01-27 19:47:41 +00:00
osys_psp.cpp Allow building of psp backend via configure (Part 1 - Still need to add the fixup + EBOOT packing steps). 2009-03-25 21:58:16 +00:00
osys_psp.h Allow building of psp backend via configure (Part 1 - Still need to add the fixup + EBOOT packing steps). 2009-03-25 21:58:16 +00:00
pic0.png move psp backend to backends/platforms/psp 2006-06-30 21:00:39 +00:00
pic1.png move psp backend to backends/platforms/psp 2006-06-30 21:00:39 +00:00
portdefs.h disable BREAKPOINT macro and remove exit() macro, as they conflict with SCI building (and aren't used anymore anyway) 2009-02-21 12:08:52 +00:00
psp_main.cpp fix warning 2009-04-29 15:54:35 +00:00
psp.mk run psp-fixup-imports after linking 2009-04-21 10:50:30 +00:00
psp.spec Allow building of psp backend via configure (Part 1 - Still need to add the fixup + EBOOT packing steps). 2009-03-25 21:58:16 +00:00
README.PSP.in commit slightly modified version of #2759353 - GSoC 2009: Correction in README.PSP 2009-04-13 20:41:16 +00:00
trace.cpp Code formatting fixes 2008-10-19 21:06:26 +00:00
trace.h Updated legal headers in source files, based on what Pidgin (the IM client formerly knowns as Gaim) does; added new (incomplete) COPYRIGHT file; updated copyright dates in a few spots 2007-05-30 21:56:52 +00:00

ScummVM-PSP @VERSION@ README
==============================================================================

Installation
============
 - Copy the relevant game datafiles to your memory stick (location
   doesn't matter).
 - Install ScummVM like any other homebrew
 - Run ScummVM and use the launcher to add games and run them


Controls
========

Left trigger		- ESC
Right trigger		- Enter
Analog			- Mouse movement
Directionals		- Mouse movement
Analog + triangle	- Fine control mouse
Cross			- Mouse button 1
Circle			- Mouse button 2
Square			- '.' (skip dialogue in some games)
Select			- Show/Hide Virtual Keyboard
Start			- F5

Notes
=====

- While it's possible to compress certain game resources to reduce their size,
  this can (and usually will) cause games (especially animation) to be choppy
  sometimes, as it ofcourse needs extra CPU power to decode these files.
  As such, it is recommended to play games in their original, uncompressed,
  form whenever possible.

- Sleep/Suspend mode currently isn't supported, so don't use it when
  running ScummVM.

- This README may be outdated, for more up-to-date instructions and notes see
  the PSP Port Wiki: http://wiki.scummvm.org/index.php/PlayStation_Portable

Frequently Asked Questions
==========================

Q:  What do I need to run the games?
A:  A 1.00 or 1.50 firmware PSP (or an EBOOT loader on firmware 2.00 or
    higher), and the necessary datafiles for the game you want to play and
    obviously this ScummVM port.

Q:  Can I run game X with this?
A:  You can find the list of supported games on the compatibility page
    on http://www.scummvm.org.
    Note that ScummVM is NOT a 'DOS (game) emulator', but written
    specifically for certain games/engines.

Q:  My Monkey Island 1 doesn't have any music, what gives?
A:  If your version of Monkey Island came on a CD then it has the music
    as CD Audio tracks. You need to rip those to MP3/Ogg and copy them
    to the same directory as the game datafiles for music to work.

Q:  Game X crashes, or feature Y doesn't work. Can you fix this?
A:  Possibly.
    Because of the large amount of games ScummVM supports we obviously haven't
    played them all start-to-finish on the PSP, so it's possible there
    are bugs or issues that we're not aware of.
    When you encounter such a bug, please use the "Bug Tracker" you find linked
    on the ScummVM website, and mention all relevant info (i.e. that you're
    using the PSP version, which ScummVM version it is, if the problem exists
    in a recent PC SVN version, a detailed description of the problem,
    and if at all possible a nearby savegame), this will make it much easier
    for us to reproduce (and hopefully fix) the problem.


Building the source code
========================
To build ScummVM for PSP you need:

- PSP toolchain	(svn co svn://svn.pspdev.org/psp/trunk/psptoolchain)

- PSPSDK	(svn co svn://svn.pspdev.org/psp/trunk/pspsdk)
		Note: This usually gets installed by the PSP toolchain,
		so you don't have to do it manually.

- SDL		(svn co svn://svn.pspdev.org/psp/trunk/SDL)

- zlib		(svn co svn://svn.pspdev.org/psp/trunk/zlib)

- libmad(*)	(svn co svn://svn.pspdev.org/psp/trunk/libmad)

- libTremor(*)	(svn co svn://svn.pspdev.org/psp/trunk/libTremor)

(*) = optional

When you've installed these libraries (read their README.PSP for instructions),
type "make" in the backends/platform/psp directory to build a 1.00 firmware
EBOOT.PBP, or "make kxploit" to build the 1.50/kxploit EBOOT.PBPs

You can control most of the build process (engines and libraries used) from
the Makefile.


Port Authors
============

Joost Peters   (joostp@scummvm.org)
Paolo Costabel (paoloc@pacbell.net)
Thomas Mayer   (tommybear@internode.on.net)