Difference between revisions of "IOS"

From ScummVM :: Wiki
Jump to navigation Jump to search
(Plugins not used/supported by IPhone port.)
(25 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Infobox Port Information|title=iPhone port
{{PortFeatures|
|version=[http://prdownloads.sourceforge.net/scummvm/scummvm-0.12.0-iphone.deb 0.12.0]
name=iPhone|
|audio=Ogg, MP3, Uncompressed
backend=iphone|
|maintainer=[[User:vinterstum|vinterstum]]
version=1.5.0|
|forum=[http://forums.scummvm.org/viewforum.php?f=15 Port Forum]
status=Maintained|
|status=Maintained
mp3=yes|
|firstversion=[http://prdownloads.sourceforge.net/scummvm/scummvm-0.11.0-iphone.zip 0.11.0]
ogg=yes|
flac=yes|
uncompressed=yes|
zlib=yes|
plugins=no|
16bits=no|
buildbot=yes|
firstversion=0.8.0|
maintainer=[[User:vinterstum|vinterstum]]|
packager=[[User:vinterstum|vinterstum]]|
pkgend=-iphone.deb|
forum=15|
icon=iphone|
notes=iPhone, iPod Touch and iPad|
 
agi=yes|
agos=yes|
cine=yes|
cruise=yes|
draci=yes|
drascula=yes|
gob=yes|
groovie=yes|
kyra=yes|
lure=yes|
made=yes|
parallaction=yes|
queen=yes|
saga=yes|
scumm=yes|
sky=yes|
sword1=yes|
sword2=yes|
teenagent=yes|
tinsel=yes|
touche=yes|
tucker=yes|
}}
}}
=iPhone=
=iPhone=
A port of [http://www.scummvm.org ScummVM] for the iPhone / iPod Touch. Look [http://forums.scummvm.org/viewtopic.php?t=4744&start=15 here] for the latest changes.
A port of [http://www.scummvm.org ScummVM] for the iPhone / iPod Touch. Look [http://forums.scummvm.org/viewtopic.php?t=4744&start=15 here] for the latest changes.
Line 13: Line 48:
== Installation ==
== Installation ==
=== Cydia (Firmware 2.0 and upwards) ===
=== Cydia (Firmware 2.0 and upwards) ===
* Start Cydia
{{IPhoneScummVMInstallationCydia}}
* Go to the Sections tab, and find the "Repositories" section.
* Select and install the UrbanFanatics.com source
* ScummVM should now be in "Games" section, ready for you to install!


=== Installer.app (Firmware 1.1.4 and below) ===
=== Installer.app (Firmware 1.1.4 and below) ===
* Open Installer.app on a jailbroken iPhone or iPod touch.  Use Google to find out how to jailbreak your specific version of the firmware on your device.
{{IPhoneScummVMInstallationInstallerApp}}
* Tap the "Sources" button in the bottom-right corner.
* Tap the "Edit" button in the top-right corner.
* Tap the "Add" button in the top-left corner.
* Enter http://urbanfanatics.com/scummvm.xml into the text area and tap "OK".
* Installer will refresh your sources.  It may close.  If so, reopen it.
* ScummVM is now available for install in the Games section.


=== Games ===
=== Games ===
To copy the game data files over to your device:
{{IPhoneGameInstallation}}
* Install an SFTP client (For Macs, [http://cyberduck.ch/ Cyberduck] is good. For Windows, [http://filezilla-project.org/ FileZilla] should do the trick). Then connect your SFTP client to your iPhone/iPod using the IP address the device shows in its network settings (Hit Settings, then Wi-Fi, then find the network you're connected to). The username is "root" and the password probably "alpine".
* If you're using Windows, you can try try [http://code.google.com/p/iphonebrowser iPhoneBrowser] instead.
* Make a subdirectory on your phone under /var/mobile (or /var/root for firmware versions 1.1.2 and below), and upload the games there (don't place them anywhere else on the phone, as you'll be filling up the smaller system partition then). [http://wiki.scummvm.org/index.php/Datafiles Here] you can see exactly which files you need for which games.
* Make sure these files and directories have the right permissions set! You're uploading as root, all the files need to be readable by the 'mobile' user as well.
* When you've uploaded all the games you want, start up ScummVM and add the game(s) there (navigate to the same directory you added them).


== Documentation ==
== Documentation ==
* [http://scummvm.svn.sourceforge.net/viewvc/scummvm/scummvm/trunk/AUTHORS?view=markup Authors]
* [https://github.com/scummvm/scummvm/blob/master/AUTHORS Authors]
* [http://scummvm.svn.sourceforge.net/viewvc/scummvm/scummvm/trunk/COPYING?view=markup License]
* [https://github.com/scummvm/scummvm/blob/master/COPYING License]
* [http://scummvm.svn.sourceforge.net/viewvc/scummvm/scummvm/trunk/COPYRIGHT?view=markup Copyright]
* [https://github.com/scummvm/scummvm/blob/master/COPYRIGHT Copyright]
* [http://scummvm.svn.sourceforge.net/viewvc/scummvm/scummvm/trunk/NEWS?view=markup News]
* [https://github.com/scummvm/scummvm/blob/master/NEWS News]
* [http://scummvm.svn.sourceforge.net/viewvc/scummvm/scummvm/trunk/README?view=markup Readme]
* [https://github.com/scummvm/scummvm/blob/master/README Readme]


== Controls ==
== Controls ==
{{IPhoneControls}}


{| border="0" cellspacing="8"
== A note for those coming from weblogs ==
|-
The official site for ScummVM is [http://www.scummvm.org/ www.scummvm.org]. This is only a port-specific page.
|width="140px"|'''Left click'''||Single tap
|-
|'''Right click'''||Hold one finger on screen where you want to click, single tap another
|-
|'''Arrow keys'''||Without holding any other finger down, swipe your finger quickly across the screen in the direction of the arrow key you want.
|-
|'''ESC'''||Hold one finger on screen, double tap another
|-
|'''F5 (menu)'''||Hold one finger on screen, swipe another down from top to bottom
|-
|'''F 0-9 keys'''||Press the keyboard button directly under the appropriate number
|-
|'''Pause'''||Keyboard spacebar
|-
|'''Toggle Click+Drag mode'''||Hold one finger on screen, swipe another up from bottom to top.  In this mode, a mouse click is sent immediately when you touch the screen, drags to wherever you slide your finger, and releases where you lift your finger.  If you press down a second finger in this mode, you effectively release the left mouse button, and press down the right one (which is then released when you lift your finger again). Useful for ''Monkey Island 3: The Curse of Monkey Island'' and ''Full Throttle''.
|-
|'''Toggle Touchpad mode'''||Hold one finger on screen, swipe another up from left to right.  In this mode, the cursor doesn't stay underneath your finger, but is rather moved around from its current position depending on the direction of your finger movement, just like a touchpad on a laptop. From version 0.12.0-pre3 and upwards only.
|-
 
|'''Suspend'''||Press the tactile "home" button.
|-
|'''Quit'''||Press and hold the tactile "home" button for 5-6 seconds.
|}
 
== A note for those coming from blogs ==
The official site for ScummVM is [http://www.scummvm.org www.scummvm.org]. This is only a port-specific page.


You need original disks to run the games. <span style="color:red">We will not give support to anyone using illegal copies of the games.</span> The only two games which are legal to download ([[Flight of the Amazon Queen]] and [[Beneath a Steel Sky]]) can be found at our [http://www.scummvm.org/downloads.php downloads page]. A number of games are [[Where_to_buy_games|still on sale]], and for games not in the list go to eBay, into your attic or sometimes they're still in local bargain bins.
You need original disks to run the games. <span style="color:red">We will not give support to anyone using illegal copies of the games.</span> There are six games which are legal to download ([[Beneath a Steel Sky]], [[Drascula: The Vampire Strikes Back]], [[Flight of the Amazon Queen]], [[Lure of the Temptress]], [[Dragon History]] and [[TeenAgent]]) which can be found at our [http://www.scummvm.org/downloads.php downloads page] or in other places. A number of games are [[Where to get the games|still on sale]], and for games not in the list go to eBay, into your attic or sometimes they're still in local bargain bins.


'''''ScummVM is not an emulator''''', and the project is not only about LucasArts games since 2002 (i.e. today we support over 150 different games by a number of different game software companies).
'''''ScummVM is not an emulator''''', and the project is not only about LucasArts games since 2002 (i.e. today we support over 150 different games by a number of different game software companies).


Vinterstum created just one of 30 ScummVM ports, and ScummVM is a work for over 40+ [http://www.scummvm.org/credits.php active developers].
Vinterstum created just one of 30 ScummVM ports, and ScummVM is a work for over 40+ [http://www.scummvm.org/credits.php active developers].


== Compatibility List ==
== Compatibility List ==
Line 134: Line 129:
|Zak McKracken and the Alien Mindbenders||Fully playable||
|Zak McKracken and the Alien Mindbenders||Fully playable||
|}
|}


=== Submit Games ===
=== Submit Games ===
Have you tried a game not in the above list, or have an addition to an existing entry?  Please write up a report in [http://forums.scummvm.org/viewtopic.php?t=4724 the iPhone game compatibility thread] and it will be added here!
Have you tried a game not in the above list, or have an addition to an existing entry?  Please write up a report in [http://forums.scummvm.org/viewtopic.php?t=4724 the iPhone game compatibility thread] and it will be added here!
[[Category:Platforms]]

Revision as of 16:38, 1 December 2013

iphone.png iPhone Port
Latest Released Version 1.5.0
Supported Audio Options MP3, OGG, FLAC, Uncompressed
Additional Webpage(s) None
Maintainer(s) vinterstum
Packager(s) vinterstum
Forum Port Forum
Status Maintained
First Official Version 0.8.0

iPhone

A port of ScummVM for the iPhone / iPod Touch. Look here for the latest changes.

Installation

Cydia (Firmware 2.0 and upwards)

  • Start Cydia
  • On the main Cydia tab (the Home screen), click "More Package Sources"
  • Select and install the UrbanFanatics.com source
  • ScummVM should now be in "Games" section, ready for you to install!

Installer.app (Firmware 1.1.4 and below)

  • Open Installer.app on a jailbroken iPhone or iPod touch. Use Google to find out how to jailbreak your specific version of the firmware on your device.
  • Tap the "Sources" button in the bottom-right corner.
  • Tap the "Edit" button in the top-right corner.
  • Tap the "Add" button in the top-left corner.
  • Enter http://urbanfanatics.com/scummvm.xml into the text area and tap "OK".
  • Installer will refresh your sources. It may close. If so, reopen it.
  • ScummVM is now available for install in the Games section.

Games

To copy the game data files over to your device:

  • On the iPhone/iPod install OpenSSH (if it is not already installed), using Cydia.
  • Install an SFTP client (For Macs, Cyberduck is good. For Windows, FileZilla should do the trick). Then connect your SFTP client to your iPhone/iPod using the IP address the device shows in its network settings (Hit Settings, then Wi-Fi, then find the network you're connected to). The username is "root" and the password probably "alpine".
  • Make a subdirectory on your phone under /var/mobile (or /var/root for firmware versions 1.1.2 and below), and upload the games there (don't place them anywhere else on the phone, as you'll be filling up the smaller system partition then). Here you can see exactly which files you need for which games.
  • Make sure these files and directories have the right permissions set! You're uploading as root, all the files need to be readable by the 'mobile' user as well.
  • When you've uploaded all the games you want, start up ScummVM and add the game(s) there (navigate to the same directory you uploaded them to).

Documentation

Controls

 Game Controller Mapping:
Action Touch screen control
Left click Single tap
Right click Hold one finger on screen where you want to click, single tap another
Arrow keys Only with ScummVM 2.1.0 or above, use a three fingers swipe in the direction of the arrow key you want. You can also use the arrow buttons in the bar above the keyboard (on iPhone you may need to scroll the bar to see those).
ESC Hold one finger on screen, double tap another. Since ScummVM 2.1.0 you can also use the Esc key in the bar above the keyboard.
Tab Since ScummVM 2.1.0 use the Tab button in the bar above the keyboard.
Return Since ScummVM 2.1.0 use the Return button in the bar above the keyboard.
Global Main Menu Swipe two fingers down from top to bottom. Note: In all versions before 1.5.0, this only send "F5" and thus in some games different menus were brought up. Since ScummVM 2.1.0 you can also use the left-most button in the bar above the keyboard.
Enable/disable keyboard Rotate phone to Portrait orientation, rather than landscape to enable the keyboard. Since ScummVM 2.1.0 you can also use the pinch gesture to enable or disable the keyboard (pinch in to enable the keyboard and pinch out to disable it). If no external keyboard is connected, this shows and hides the On Screen keyboard. When an external keyboard is connected, instead of showing/hiding the On Screen keyboard this enables/disables inputs from the external keyboard.
F 0-9 keys Press the keyboard button directly under the appropriate number. Since ScummVM 2.1.0 use the bar above the keyboard instead.
Pause Keyboard spacebar
Toggle Click+Drag mode Swipe two fingers up from bottom to top. In this mode, a mouse click is sent immediately when you touch the screen, drags to wherever you slide your finger, and releases where you lift your finger. If you press down a second finger in this mode, you effectively release the left mouse button, and press down the right one (which is then released when you lift your finger again). Useful for Monkey Island 3: The Curse of Monkey Island and Full Throttle.
Toggle Touchpad mode Swipe two fingers from left to right. In this mode, the cursor doesn't stay underneath your finger, but is rather moved around from its current position depending on the direction of your finger movement, just like a touchpad on a laptop. From version 0.12.0-pre3 and upwards only.
Suspend Press the tactile "home" button.
Quit Press and hold the tactile "home" button for 5-6 seconds.


A note for those coming from weblogs

The official site for ScummVM is www.scummvm.org. This is only a port-specific page.

You need original disks to run the games. We will not give support to anyone using illegal copies of the games. There are six games which are legal to download (Beneath a Steel Sky, Drascula: The Vampire Strikes Back, Flight of the Amazon Queen, Lure of the Temptress, Dragon History and TeenAgent) which can be found at our downloads page or in other places. A number of games are still on sale, and for games not in the list go to eBay, into your attic or sometimes they're still in local bargain bins.

ScummVM is not an emulator, and the project is not only about LucasArts games since 2002 (i.e. today we support over 150 different games by a number of different game software companies).

Vinterstum created just one of 30 ScummVM ports, and ScummVM is a work for over 40+ active developers.

Compatibility List

Legend

No known problems Playable, with problems Unplayable


Tested Games

Game Status Notes
Beneath a Steel Sky Fully Playable Save/load buttons must be double-tapped to function.
Broken Sword 1: The Shadow of the Templars Fully Playable
Day of the Tentacle Completed
The Dig Fully playable
Flight of the Amazon Queen Fully playable
Full Throttle Fully playable
Gobliiins Fully playable
Gobliins 2 Fully playable
Indiana Jones and the Fate of Atlantis Completed
Indiana Jones and the Last Crusade Fully playable
King's Quest 3 Fully playable
Loom Completed
Maniac Mansion Completed
Monkey Island 1: The Secret of Monkey Island Completed
Monkey Island 2: LeChuck's Revenge Fully playable
Monkey Island 3: The Curse of Monkey Island Playable Intro can only be skipped with "ESC" in click+drag mode.
Sam & Max Hit the Road Completed
Simon the Sorcerer 1 Fully playable
Simon the Sorcerer 2 Fully playable
Zak McKracken and the Alien Mindbenders Fully playable

Submit Games

Have you tried a game not in the above list, or have an addition to an existing entry? Please write up a report in the iPhone game compatibility thread and it will be added here!