Initial commit

dists/psp2/readme-psp2.md

@@ -0,0 +1,64 @@
+Prerequisites
+=============
+- A homebrew enabled PlayStation Vita console.
+- At least one ScummVM supported game. The list of compatible games can be seen here: https://www.scummvm.org/compatibility/
+The page https://wiki.scummvm.org/index.php/Where_to_get_the_games references some places where those games can be bought. Demonstration versions for most of the supported games are downloadable on https://scummvm.org/demos/
+
+Installing
+==========
+From a computer, download the installable package. Unzip and copy the .vpk file it to the PlayStation Vita and install it.
+
+Configuring and playing games
+=============================
+The user manual describes how to add games to ScummVM and launch them : https://wiki.scummvm.org/index.php/User_Manual
+
+PlayStation Vita Specifics
+==========================
+Saves are wrote in the ux0:/data/scummvm/saves folder.
+
+Joypad button mapping
+=====================
+- Left stick     => Mouse
+- R + Left stick => Slow Mouse
+- Cross          => Left mouse button
+- Circle         => Right mouse button
+- DPad           => Cursor Keys (useful for character motion)
+- R + DPad       => Diagonal Cursor Keys
+- L Trigger      => Game menu (F5)
+- R Trigger      => Shift (used to enable Mass Add in menu)
+- Square         => Period '.' (used to skip dialog lines)
+- R + Square     => Space ' '
+- Triangle       => Escape (used to skip cutscenes)
+- R + Triangle   => Return
+- Start          => ScummVM's global in-game menu
+- Select         => Toggle virtual keyboard
+- R + Select     => AGI predictive input dialog
+
+Disclaimer
+==========
+Unauthorized distribution of an installable package with non freeware games included is a violation of the copyright law and is as such forbidden.
+
+Building from source
+====================
+This port of ScummVM to the PSP2 is based on SDL2. It uses the open source SDK VITASDK.
+
+The dependencies needed to build it are :
+
+- The toolchain from https://github.com/vitadev/vdpm
+- zlib, libpng, libjpeg-turbo, libogg, libvorbis, flac, curl, openssl, freetype, from https://github.com/vitadev/vdpm
+- libmad from https://github.com/Cpasjuste/libmad-psp2
+- SDL2 from https://github.com/Cpasjuste/SDL-Vita
+- ScummVM from https://github.com/scummvm/scummvm
+- The fbo branch of libvita2d from https://github.com/frangarcj/vita2dlib/tree/fbo/libvita2d
+copied under new names libvita2d_fbo.a in $VITASDK/arm-vita-eabi/lib and vita2d_fbo.h in $VITASDK/arm-vita-eabi/include. The renaming is necessary to prevent conflict with the official vita2d lib that comes with the VitaSDK.
+- The pre-compiled gtu release of vita-shader-collection from https://github.com/frangarcj/vita-shader-collection/releases, copy all headers to $VITASDK/arm-vita-eabi/include and the library libvitashaders.a to $VITASDK/arm-vita-eabi/lib
+
+Once all the dependencies are correctly setup, an installable package can be obtained from source by issuing the following command :
+
+./configure --host=psp2 && make psp2vpk
+
+Thanks
+======
+Xavier from consoleX for donating a ps vita device
+xerpi for initial SDL2 port
+VITASDK and henkaku developers

dists/psp2/template.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<livearea style="a1" format-ver="01.00" content-rev="1">
+	<livearea-background>
+		<image>bg.png</image>
+	</livearea-background>
+
+	<gate>
+		<startup-image>startup.png</startup-image>
+	</gate>
+</livearea>