Difference between revisions of "PlayStation Portable"

From ScummVM :: Wiki
Jump to navigation Jump to search
m (Added the “About” heading for consistency with other wiki platform pages)
 
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== About ==
{{PortFeatures|
{{PortFeatures|
name=PlayStation Portable|
name=PlayStation Portable|
backend=psp|
backend=psp|
version=2.0.0|
version={{StableVersion}}|
status=Maintained|
status=Maintained|
mp3=yes|
mp3=yes|
Line 42: Line 43:
}}
}}


ScummVM has been ported to the [[Sony]] PlayStation Portable.  The information contained on this page is based on [https://raw.githubusercontent.com/scummvm/scummvm/master/backends/platform/psp/README.PSP README.PSP] and [http://forums.scummvm.org/viewtopic.php?t=2626&highlight= jak66's forum post].
ScummVM has been ported to the [[Sony]] PlayStation Portable.  


=== Installation ===
For more information, including how to install and use ScummVM, see the [https://docs.scummvm.org/en/latest/other_platforms/playstation_portable.html PlayStation Portable page] in the [https://docs.scummvm.org/ ScummVM user documentation]


* Copy the relevant game datafiles to your memory stick (location doesn't matter).
== Image viewer ==
* Install ScummVM like any other homebrew.
* Run ScummVM and use the launcher to add games and run them.
* Press Start to return to the launcher and play another game.
 
= Controls =
{{PSPControls}}
 
=== Image Viewer ===
For your convenience, I've included a simple image viewer in the PSP port.  
For your convenience, I've included a simple image viewer in the PSP port.  
You can view anything you want while playing a game.
You can view anything you want while playing a game.
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
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,
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
the images in the game directories.
* 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
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.
 
=== Notes ===
 
* 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'.
(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
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 ===
* 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.


'''Q''':  Scummvm crashes upon starting up!
* 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.
'''A''':  See the first note above.


'''Q''':  Pressing select doesn't make the virtual keyboard show up on screen!
* Don't place any images in the ScummVM directory, or you won't be able to seethe images in the game directories.
'''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?
* 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 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.
'''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?
== Developer information ==
'''A''':  You can find the list of supported games on the compatibility page
    at http://www.scummvm.org
    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.
 
'''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 (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.
 
'''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 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 ===


=== Building from source ===
To build ScummVM for PSP you need:
To build ScummVM for PSP you need:


Line 129: Line 71:
* 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)Note: This usually gets installed by the PSP toolchain, so you don't have to do it manually.
* 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.


* 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(x) (svn co svn://svn.pspdev.org/psp/trunk/libmad)
* libmad(x) (svn co svn://svn.pspdev.org/psp/trunk/libmad)
Line 141: Line 83:
(x) = 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), create a subdirectory in your ScummVM folder called 'builds/psp'. Then, in this folder, type
create a subdirectory in your ScummVM folder called 'builds/psp'. Then, in this folder, type
    ../../configure --host=psp --enable-plugins --default-dynamic  
'../../configure --host=psp --enable-plugins --default-dynamic'. If everything is installed
If everything is installed correctly, ScummVM will inform you as it finds the right components. Finally type
correctly, ScummVM will inform you as it finds the right components. Finally type 'make' to build.
  make  
to build.


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


Joost Peters  (joostp@scummvm.org)
Joost Peters  (joostp@scummvm.org)
Line 155: Line 98:


Yotam Barnoy  (yotambarnoy@gmail.com)
Yotam Barnoy  (yotambarnoy@gmail.com)
= External links =
* [http://forums.scummvm.org/viewforum.php?f=3 ScummVM PSP forum]

Latest revision as of 21:38, 14 January 2021

About

psp.png PlayStation Portable Port
Latest Released Version 2.8.1
Supported Audio Options MP3, OGG, Uncompressed
Additional Webpage(s) None
Maintainer(s) rsn8887, joostp, bluddy
Packager(s) rsn8887, joostp
Forum Port Forum
Status Maintained
First Official Version 0.8.0

ScummVM has been ported to the Sony PlayStation Portable.

For more information, including how to install and use ScummVM, see the PlayStation Portable page in the ScummVM user documentation

Image viewer

For your convenience, I've included a simple image viewer in the PSP port. You can view anything you want while playing a game. There are a few simple rules to follow:

  • Images must be of PNG format. If you have images in another format, many graphics utilities will convert them for you.
  • 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.
  • 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.
  • Don't place any images in the ScummVM directory, or you won't be able to seethe images in the game directories.
  • 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 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.

Developer information

Building from source

To build ScummVM for PSP you need:

(x) = optional

Once you've installed these libraries (read their README.PSP for instructions), create a subdirectory in your ScummVM folder called 'builds/psp'. Then, in this folder, type

   ../../configure --host=psp --enable-plugins --default-dynamic 

If everything is installed correctly, ScummVM will inform you as it finds the right components. Finally type

  make 

to build.

Port Authors

Joost Peters (joostp@scummvm.org)

Paolo Costabel (paoloc@pacbell.net)

Thomas Mayer (tommybear@internode.on.net)

Yotam Barnoy (yotambarnoy@gmail.com)