prxshot v0.4 - Codestation

This Homebrew is an entry for the PSP Genesis competition 2011, sponsored by npt, psp-hacks.com, pspgen.com, pspslimhacks.com, exophase.com, pspcustomfirmware.com, daxhordes.org, gamegaz.jp, xtreamlua.com and wololo.net

This is a screenshot plugin that doesn't need to pause the game to take the capture (useful for online gaming) and classifies the images per game using their name and icons.

The plugin stores the screenshot in BMP format inside:

/PSP/SCREENSHOT/<GAME_ID>/pic_XXXX.bmp

for umd/iso games or:

/PSP/SCREENSHOT/PS<8 bytes sha1sum of the title>/pic_XXXX.bmp

for homebrew or games in PBP format (because the homebrews have the same GAME_ID).

Installation: Copy the prxshot directory to the seplugins directory (or anywhere you want) and add the plugin to the game.txt file (and/or vsh.txt if you want to).

How to use it: press the NOTE button to take a screenshot (or configure it to the key(s) that you want)

The prxshot directory comes with these files:

• prxshot.prx: the plugin
• default_icon0.png: optional default icon to use for those homebrews without icon (you can make your own image, just try to maintain the same dimensions)
• xmb.sfo: template to make folder icon for screenshots in VSH mode.
• prxshot.ini: configuration file

Meaning of the options in the prxshot.ini:

"General" category:

• CreatePic1: 0 by default. Change to 1 if you want the game background image that appears in the XMB in the screenshot folder.

• PSPGoUseMS0: 0 by default. Change to 1 if you have a PSP Go and want to store the pictures into the M2 instead of the internal storage.

• XMBClearCache: 0 by default. Change to 1 if you want to refresh the cache after taking a screenshot in the XMB (solves the problem of the picture viewer that doesn't show the new screenshots but can cause freezes when using Game Categories)

• ScreenshotKey: 0x800000 by default. Change it to one of the values of the table below (or a combination of them) to select the button(s) required for the screenshot.

• KeyTimeout: 0 by default. Change it to a positive value (in millisecs) to delay the screenshot key(s) to that value. For example, setting it to 1000 causes the screenshot to be taken 1 second after the key was pressed

• ScreenshotName: %s/pic_%04d.bmp by default. Here you can specify a different prefix/suffix for the screenshot. Important: the "%s/, "%04d" and the ".bmp" are mandatory in that order.

"CustomKeys" category:

• ULJM08500 (a.k.a. game id): Undefined by default. Here you can use a game id (you can obtain them from your game box, playstation site, UMDGen, ISO Tool, PSPFiler (reading the UMD_DATA.BIN in the iso/umd), cwcheat, etc, etc) and a screenshot key that you want to link to that game. Examples:

ULJM05800 = 0x000009 (Monster Hunter 3rd game using SELECT + START to take the screenshot)

ULES01505 = 0x000101 (Dissidia Duodecim using SELECT + LTRIGGER to take the screenshot)

"CustomTimeout" category:

• ULJM08500 (a.k.a. game id): Undefined by default. Here you can use a game id (you can obtain them from your game box, playstation site, UMDGen, ISO Tool, PSPFiler (reading the UMD_DATA.BIN in the iso/umd), cwcheat, etc, etc) and a timeout for that game (see KeyTimeout definition for details). Examples:

ULJM05800 = 300 (Monster Hunter 3rd game using 300 msecs to take a screenshot)

ULES01505 = 1500 (Dissidia Duodecim using 1.5 secs before taking the screenshot)

Values for the screenshot button

Select button 0x000001

Start button 0x000008

Up D-Pad button 0x000010

Right D-Pad button 0x000020

Down D-Pad button 0x000040

Left D-Pad button 0x000080

Left trigger 0x000100

Right trigger 0x000200

Triangle button 0x001000

Circle button 0x002000

Cross button 0x004000

Square button 0x008000

Hold button 0x020000

Music Note button 0x800000

Screen button 0x400000

Volume up button 0x100000

Volume down button 0x200000

Changelog: v0.4: [+]Implemented key timeout, so now you can add some delay to the screenshot button so doesn't interfere with the normal game operation. [!]Internal change: rewrote the plugin in C++ [!]Fixed the known issue of taking a screenshot while the aLoader is launching an ISO (only in c++ branch). v0.3: [+]Added the option to set your custom screenshot key per game. [!]Major rewrite to the hook core (removed the asm payload code), so it avoids the crashes in 6.20 TN + loaders (i hate those loaders, really >_<). [!]Moved the comments of the prxshot.ini to the readme for more readibility. v0.2.4: [!]Fixed the bug introduced in 0.2.3 that didn't detect the settings in the .ini file. [!]Fixed bug with homebrew not properly detected in PSPGo using the internal storage. v0.2.3: [+]Added support for eLoader (1.50 eboot loader) [+]Recreate the XMB folder if is deleted. [!]Fixed nasty bug that causes a crash when taking very early screenshots (Note that you can't take screenshots on loaders because the game isn't loaded yet, a special folder is gonna be added for this in the future) [+]Added option XMBClearCache to the prxshot.ini. While this updates the picture directory when taking screenshots in the XMB i recommend that is better to leave it disabled because it causes troubles with game categories. Added more debug messages. v0.2.2: [+]Added support for POPS (PSone games support). [+]Added support for storing the screenshots into the M2 in the PSPGo. [+]Added logging and made it conditional on build when compiling from source. [!]Fixed bug with XMB icon creation introduced in 0.2.0. v0.2.1: [+]Added OIL to blacklist. v0.2.0: [!]Removed trailing "/" so the directory creation don't fail. [+]New configuration file (prxshot.ini) so now you can configure some things like background use for picture folders, change the button combo to take the screenshot and the suffix/prefix of the picture file. v0.1.3: [+]Create /PSP/SCREENSHOT in case it doesn't exists v0.1.2: [!]Rewrote asm payload code (doesn't need memory allocation anymore so hopefully the issues with 6.20 / aLoader are finally fixed) v0.1.1: [!]Fixes bugs with 6.20 TN and/or aLoader v0.1.0: [+]First release

Source code available at https://github.com/codestation/prxshot