aboutsummaryrefslogtreecommitdiff
path: root/dists/raspberrypi
diff options
context:
space:
mode:
authorvanfanel2016-10-13 15:50:45 +0200
committervanfanel2016-10-13 15:50:45 +0200
commitb44a501499528a8bf3054a770295689044abde0f (patch)
tree8f47daa47d94acd09589be5d664589432d541b40 /dists/raspberrypi
parentb905a3ba8efdcc15185d59b2796891acfaaef8af (diff)
downloadscummvm-rg350-b44a501499528a8bf3054a770295689044abde0f.tar.gz
scummvm-rg350-b44a501499528a8bf3054a770295689044abde0f.tar.bz2
scummvm-rg350-b44a501499528a8bf3054a770295689044abde0f.zip
RASPBERRYPI: Add Raspberry Pi specific README.
Diffstat (limited to 'dists/raspberrypi')
-rw-r--r--dists/raspberrypi/README_raspberrypi46
1 files changed, 46 insertions, 0 deletions
diff --git a/dists/raspberrypi/README_raspberrypi b/dists/raspberrypi/README_raspberrypi
new file mode 100644
index 0000000000..da1d70a113
--- /dev/null
+++ b/dists/raspberrypi/README_raspberrypi
@@ -0,0 +1,46 @@
+ScummVM Raspberry Pi README
+-------------------------------------------------------------------------------
+
+NOTES ON NEEDED DEPENDENCIES
+
+The Raspberry Pi version is linked against the following GNU/Linux libraries
+that may or may not be already installed on a Raspberry Pi GNU/Linux system
+and hence needs them installed in your system before running ScummVM on it:
+ -SDL2, version 2.0.4 recommended and included. See notes on this below.
+ -libVorbis, for OGG music needed by some engines and the fantastic
+ enhanced music packs by James Woodcock.
+ -libJPEG, needed by some engines.
+ -libPNG, needed by some engines.
+
+So, if you are in Raspbian, for example, you can install these, except
+SDL 2.0.4 by doing:
+
+sudo apt-get install libvorbis0a libjpeg62-turbo libpng12-0
+
+You can look at the other library dependencies by running ldd on the
+scummvm executable. They are standard GNU Linux, C++ and Raspberry Pi
+Video Core IV libraries that should come installed with your system.
+
+RUNNING SCUMMVM ON THE RASPBERRY PI SERIES OF MICROCOMPUTERS
+------------------------------------------------------------
+
+To launch Scummvm on the Raspberry Pi, run the scummvm.sh script.
+It will run the scummvm binary using the SDL2 library in the lib
+directory.
+You can do so like this:
+cd scummvm
+./scummvm.sh
+
+Notes on SDL2 version 2.0.4
+----------------------------------------------
+
+This version of ScummVM is built against SDL2, and stable version 2.0.4 is
+recommended. Previous versions could have mouse input bugs on the Pi.
+Using SDL 1.x on the Pi is buggy, even if a hacky dispmanx (native 2D API)
+backend exists, it's not recommended at all.
+
+For this reason, a Pi-version-gnostic of libSDL2-2.0.so.0 (will work on a Pi1,
+Pi2 or Pi3) is included until the Raspbian people finally include SDL 2.0.4
+with the system by default.
+That's why you should run scummvm using the scummvm.sh script instead of
+running the binary directly.