Skip to content

Latest commit

 

History

History
48 lines (33 loc) · 2.53 KB

README.md

File metadata and controls

48 lines (33 loc) · 2.53 KB
Raw

ScummVM for iOS 9

This is a quick fix of the latest ScummVM (1.8.0) for iOS 9. It has been tested on real iPhone 6S+, and iPad Pro, and also on all the available Xcode simulators.

I tried to use all the latest iOS features to replace the old code. For instance, it uses gesture recognizers most of the time, it supports the new iPhones 6 / 6+ / 6s / 6s+ resolution, and you can copy your game files using iTunes.

Compilation

First, clone the repository:

$ git clone -b ios-fix --recursive https://github.com/bSr43/scummvm.git

The next step is to compile the create_project tool. Open the Xcode project you'll found in the devtools/create_project/xcode/ directory. Once compiled, copy the binary somewhere in your PATH, and create a build directory somewhere on your harddisk. It is recommended to create this directory next to the cloned repository (they share the same parent).

Execute the following commands in a terminal:

$ cd path_to_the_build_directory
$ create_project path_to_scummvm_repository --xcode --disable-mad --disable-jpeg --disable-bink --disable-scalers --disable-hqscalers --disable-16bit --disable-mt32emu --disable-nasm --disable-opengl --disable-theora --disable-taskbar

This will create an Xcode project for ScummVM, for both the OS X, and the iOS target.

Now, download the external libraries from http://bsr43.free.fr/scummvm/ScummVM-iOS-libraries.zip. Unzip the archive in your build directory. Please make sure that the lib, and include directories are at the root of the build directory, not in a subdirectory.

Now, your build directory should contain:

  • a generated engines directory,
  • a generated scummvm.xcodeproj project,
  • an include directory,
  • a lib directory.

You are ready to compile ScummVM: open the scummvm.xcodeproj project, and build it.

Usage

The game data files can be copied on the iOS device using iTunes. Once done, add your games in ScummVM as usual.

Here is a list of the in-game gestures:

Gesture Description
Two fingers swipe down Display the ScummVM menu for loading, saving, etc.
Two fingers swipe right Enable / disable the touchpad mode
Two fingers swipe up Enable / disable the mouse-click-and-drag mode
Two fingers tap Simulate a right click. You should tap with one finger, and then tap with another while keeping your first finger on the screen.
Two fingers double-tap Skip the cinematic / video

The iOS keyboard is visible when the device is in portrait mode, and hidden in landscape mode.