|
|
| Line 46: |
Line 46: |
| === Installation === | | === Installation === |
|
| |
|
| - Copy the relevant game datafiles to your memory stick (location doesn't matter).
| | * Copy the relevant game datafiles to your memory stick (location doesn't matter). |
| - Install ScummVM like any other homebrew.
| | * Install ScummVM like any other homebrew. |
| - Run ScummVM and use the launcher to add games and run them.
| | * Run ScummVM and use the launcher to add games and run them. |
| - Press Start to return to the launcher and play another game.
| | * Press Start to return to the launcher and play another game. |
| | |
| === Controls ===
| |
| | |
| Right trigger - Modifier key (see below for uses)
| |
| Left trigger - ESC (Usually skips cutscenes. Depends on game)
| |
| Analog - Mouse movement
| |
| Right trigger + Analog - Fine mouse movement
| |
| D-Pad - Arrow keys (useful mostly in SCI and AGI games)
| |
| D-Pad + Right Trigger - Diagonal arrow keys (it's hard to input diagonals on some PSPs)
| |
| Triangle - Enter (useful for some dialogs)
| |
| Cross - Left Mouse Button (usually the main button)
| |
| Circle - Right Mouse Button (secondary button in some games)
| |
| Square - '.' (skip dialogue in some games e.g. Scumm)
| |
| Right trigger + Square - Spacebar (useful in Gobli*ns and SCI games)
| |
| Right trigger + Start - F5 (Main Menu in some games)
| |
| Select - Show/Hide Virtual Keyboard. Hold down to move keyboard onscreen (with D-Pad).
| |
| Right trigger + Select - Show Image Viewer (see below)
| |
| Start - Global Menu. Allows you to 'Return To Launcher' to play another game
| |
| | |
| === Virtual Keyboard Mode ===
| |
| Start - Enter key. Also exits virtual keyboard mode
| |
| Select - Exit the virtual keyboard mode
| |
| Right trigger - Input letters: lowercase/uppercase (press to toggle)
| |
| Left trigger - Input numbers/symbols (press to toggle)
| |
| D-Pad - Select square of characters (up, down, left or right)
| |
| Buttons/Triggers - Choose a specific character in the square. The four center characters are chosen
| |
| by the button in the corresponding position. The 2 top characters are chosen by the
| |
| triggers.
| |
| Analog - Moves in a direction (left/right/up/down) (Useful to keep moving
| |
| while typing in AGI games among other things)
| |
|
| |
|
| | = Controls = |
| | {{PSPControls}} |
|
| |
|
| === Image Viewer === | | === Image Viewer === |
| Line 87: |
Line 59: |
| There are a few simple rules to follow: | | There are a few simple rules to follow: |
|
| |
|
| - Images must be of PNG format. If you have images in another format, many
| | * Images must be of PNG format. If you have images in another format, many |
| graphics utilities will convert them for you.
| | graphics utilities will convert them for you. |
| - Images must be named psp_image1.png, psp_image2.png etc. This is to make
| | * Images must be named psp_image1.png, psp_image2.png etc. This is to make |
| sure there's no possible conflict between image files and game files.
| | sure there's no possible conflict between image files and game files. |
| - Images must be placed in the game directories. When using the image viewer,
| | * Images must be placed in the game directories. When using the image viewer, |
| only the images of the particular game being played will be available for viewing.
| | only the images of the particular game being played will be available for viewing. |
| - Don't place any images in the ScummVM directory, or you won't be able to see
| | * Don't place any images in the ScummVM directory, or you won't be able to see |
| the images in the game directories.
| | the images in the game directories. |
| - There's no guarantee that you'll be able to view your image. This is because
| | * There's no guarantee that you'll be able to view your image. This is because |
| big images take a lot of memory (more than the size of the image on disk). If there
| | big images take a lot of memory (more than the size of the image on disk). If there |
| isn't enough memory left to show the image, ScummVM will tell you so. Try to make the
| | isn't enough memory left to show the image, ScummVM will tell you so. Try to make the |
| image smaller by either shrinking it or reducing the colors to 256 color palette mode.
| | image smaller by either shrinking it or reducing the colors to 256 color palette mode. |
| | |
| === Image Viewer Controls: ===
| |
| | |
| Left/Right - previous/next image (e.g. go from psp_image1.png to psp_image2.png)
| |
| Up/down - zoom in/out
| |
| Analog - move around the image
| |
| Triggers, Start: - exit image viewer
| |
| | |
| | |
| === 1st Person Game Mode (Can be ignored by most users) ===
| |
| This is a special mode built for 1st person games like Lands of Lore. If you don't have these games you can
| |
| safely ignore this mode. To enter or leave this mode, use the combo:
| |
| | |
| Right Trigger + Left Trigger + Square
| |
| | |
| Some buttons have been switched around to make these games more playable:
| |
| Square - Is the modifier key instead of Right Trigger.
| |
| Left/Right Trigger - Strafe left/right
| |
| D-Pad Left/Right - Turn left/right
| |
| Square + D-Pad - F1/F2/F3/F4
| |
| Square + Select - Image Viewer
| |
| Square + Start - Esc (shows game menu)
| |
| | |
|
| |
|
| === Notes === | | === Notes === |
|
| |
|
| - Notice that you can switch between games! This is much faster than quitting
| | * Notice that you can switch between games! This is much faster than quitting |
| and having to start ScummVM all over again. Go to the global menu and choose 'Return To Launcher'.
| | and having to start ScummVM all over again. Go to the global menu and choose 'Return To Launcher'. |
| (Some games may not have the Return To Launcher option available yet.)
| | (Some games may not have the Return To Launcher option available yet.) |
| | |
| - The PSP version of ScummVM uses the Media Engine to accelerate decoding of MP3 files. This means
| |
| that if you have the choice of compressing using Ogg files or MP3 files, choose MP3 -- the game
| |
| will generally run faster.
| |
|
| |
|
| - Plugin files are NOT interchangeable between ScummVM versions! You must copy ALL the
| | * The PSP version of ScummVM uses the Media Engine to accelerate decoding of MP3 files. This means |
| plugin files that come with every version of ScummVM. They sit in the /plugin
| | that if you have the choice of compressing using Ogg files or MP3 files, choose MP3 -- the game |
| subdirectory. If you get a crash upon startup, try deleting all the existing
| | will generally run faster. |
| plugin files in the plugin directory and copying the new ones over again.
| |
|
| |
|
| - This README may be outdated, for more up-to-date instructions and notes see
| | * Plugin files are NOT interchangeable between ScummVM versions! You must copy ALL the |
| the PSP Port Wiki: http://wiki.scummvm.org/index.php/PlayStation_Portable
| | plugin files that come with every version of ScummVM. They sit in the /plugin |
| | subdirectory. If you get a crash upon startup, try deleting all the existing |
| | plugin files in the plugin directory and copying the new ones over again. |
|
| |
|
| === Frequently Asked Questions === | | === Frequently Asked Questions === |
|
| |
|
| Q: Scummvm crashes upon starting up! | | '''Q''': Scummvm crashes upon starting up! |
| A: See the first note above. | | '''A''': See the first note above. |
|
| |
|
| Q: Pressing select doesn't make the virtual keyboard show up on screen! | | '''Q''': Pressing select doesn't make the virtual keyboard show up on screen! |
| A: You need to make sure that the kbd.zip file is in the same directory as the ScummVM executable. | | '''A''': You need to make sure that the kbd.zip file is in the same directory as the ScummVM executable. |
|
| |
|
| Q: What do I need to run the games? | | '''Q''': What do I need to run the games? |
| A: A PSP that can run homebrew and the necessary datafiles for the game you want to play. | | '''A''': A PSP that can run homebrew and the necessary datafiles for the game you want to play. |
|
| |
|
| Q: Can I run game X with this? | | '''Q''': Can I run game X with this? |
| A: You can find the list of supported games on the compatibility page | | '''A''': You can find the list of supported games on the compatibility page |
| at http://www.scummvm.org | | at http://www.scummvm.org |
| Note that ScummVM is NOT an emulator. The supported games engines have been painstakingly rewritten. | | Note that ScummVM is NOT an emulator. The supported games engines have been painstakingly rewritten. |
| It's not easy to add support for a game you want that currently isn't supported. | | It's not easy to add support for a game you want that currently isn't supported. |
|
| |
|
| Q: My Monkey Island 1 doesn't have any music, what gives? | | '''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 | | '''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 (MP3 is preferred), naming them track1.mp3 track2.mp3 | | as CD Audio tracks. You need to rip those to MP3/Ogg (MP3 is preferred), naming them track1.mp3 track2.mp3 |
| etc. and copy them to the same directory as the game datafiles for music to work. | | etc. 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? | | '''Q''': Game X crashes, or feature Y doesn't work. Can you fix this? |
| A: Possibly. | | '''A''': Possibly. |
| Because of the large amount of games ScummVM supports we obviously haven't | | 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 | | played them all start-to-finish on the PSP, so it's possible there |
| Line 179: |
Line 125: |
| To build ScummVM for PSP you need: | | To build ScummVM for PSP you need: |
|
| |
|
| - ScummVM source code (svn co https://scummvm.svn.sourceforge.net/svnroot/scummvm/scummvm/trunk)
| | * ScummVM source code (svn co https://scummvm.svn.sourceforge.net/svnroot/scummvm/scummvm/trunk) |
|
| |
|
| - PSP toolchain (svn co svn://svn.pspdev.org/psp/trunk/psptoolchain)
| | * PSP toolchain (svn co svn://svn.pspdev.org/psp/trunk/psptoolchain) |
|
| |
|
| - PSPSDK (svn co svn://svn.pspdev.org/psp/trunk/pspsdk)
| | * 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. |
| Note: This usually gets installed by the PSP toolchain,
| |
| so you don't have to do it manually.
| |
|
| |
|
| - zlib (svn co svn://svn.pspdev.org/psp/trunk/zlib)
| | * zlib (svn co svn://svn.pspdev.org/psp/trunk/zlib) |
|
| |
|
| - libPNG (svn co svn://svn.pspdev.org/psp/trunk/libpng)
| | * libPNG (svn co svn://svn.pspdev.org/psp/trunk/libpng) |
|
| |
|
| - libmad(*) (svn co svn://svn.pspdev.org/psp/trunk/libmad)
| | * libmad(x) (svn co svn://svn.pspdev.org/psp/trunk/libmad) |
|
| |
|
| - libTremor(*) (svn co svn://svn.pspdev.org/psp/trunk/libTremor)
| | * libTremor(x) (svn co svn://svn.pspdev.org/psp/trunk/libTremor) |
|
| |
|
| (*) = optional | | (x) = optional |
|
| |
|
| Once you've installed these libraries (read their README.PSP for instructions), | | Once you've installed these libraries (read their README.PSP for instructions), |
| Line 205: |
Line 149: |
|
| |
|
| Joost Peters (joostp@scummvm.org) | | Joost Peters (joostp@scummvm.org) |
| | |
| Paolo Costabel (paoloc@pacbell.net) | | Paolo Costabel (paoloc@pacbell.net) |
| | |
| Thomas Mayer (tommybear@internode.on.net) | | Thomas Mayer (tommybear@internode.on.net) |
| | |
| Yotam Barnoy (yotambarnoy@gmail.com) | | Yotam Barnoy (yotambarnoy@gmail.com) |
|
| |
| = Controls =
| |
| {{PSPControls}}
| |
|
| |
| = Notes =
| |
| * While it is possible to compress certain game resources to reduce their size, this can (and usually will) cause games (especially animations) to be choppy sometimes, as it requires extra CPU power to decode these files. As such, it is recommended to play games in their original, uncompressed, form whenever possible.
| |
|
| |
| = Frequently Asked Questions =
| |
| '''Q''': What do I need to run the games?<br/>
| |
| '''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 ScummVM.
| |
|
| |
| '''Q''': Can I run <Game XXX> with this?<br/>
| |
| '''A''': See the [http://www.scummvm.org/compatibility.php?version=0.13.0 list of supported games].
| |
|
| |
| '''Q''': My Monkey Island 1 doesn't have any music, what gives?<br/>
| |
| '''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 data files for music to work.
| |
|
| |
| '''Q''': <Game XXX> crashes, or <Feature YYY> doesn't work. Can you fix this?<br/>
| |
| '''A''': Possibly.<br/>
| |
| Because of the large amount of games ScummVM supports we obviously haven't played them all start-to-finish on the PSP, so it is possible there are bugs or issues that we are not aware of.<br/>
| |
| When you encounter such a bug, please use the [http://sourceforge.net/tracker/?group_id=37116&atid=418820 ScummVM bug tracker], and mention all relevant info (i.e. that you're using the PSP version, which ScummVM version it is, if the problem also exists in a recent development daily build for your desktop OS, a detailed description of the problem, and if possible a nearby savegame). This will make it much easier for us to understand, reproduce and hopefully fix the problem.
| |
|
| |
|
| = External links = | | = External links = |
| * [http://forums.scummvm.org/viewforum.php?f=3 ScummVM PSP forum] | | * [http://forums.scummvm.org/viewforum.php?f=3 ScummVM PSP forum] |