Differences
This shows you the differences between two versions of the page.
|
install:ios [2012/03/21 14:21] brada [Installation] |
install:ios [2013/01/25 17:01] (current) brada [Game Data Installation] |
||
|---|---|---|---|
| Line 2: | Line 2: | ||
| ===== Version info ===== | ===== Version info ===== | ||
| - | **Warning: builds after [[http://sourceforge.net/projects/gemrb/files/Buildbot%20Binaries/Apple/IOS/GemRB-ios-v0.7.0-292-g654f183.ipa|GemRB-ios-v0.7.0-292-g654f183.ipa]] use SDL 2.0 and GemRB SDL20Video driver. This driver is incomplete and many things may not work at all. You have been warned.** | ||
| - | |||
| Builds are compiled and uploaded automatically to [[http://sourceforge.net/projects/gemrb/files/Buildbot%20Binaries/Apple/IOS/|sourceforge]]. Complete source to the iOS version of GemRB is contained within the GemRB git repository. Anyone with an Apple developer certificate and Xcode can download the source and compile themselves without the need to jailbreak. | Builds are compiled and uploaded automatically to [[http://sourceforge.net/projects/gemrb/files/Buildbot%20Binaries/Apple/IOS/|sourceforge]]. Complete source to the iOS version of GemRB is contained within the GemRB git repository. Anyone with an Apple developer certificate and Xcode can download the source and compile themselves without the need to jailbreak. | ||
| ===== Requirements ===== | ===== Requirements ===== | ||
| Line 45: | Line 43: | ||
| ===== Game Data Installation ===== | ===== Game Data Installation ===== | ||
| + | |||
| + | **You don't need widescreen mod to play fullscreen on iOS!** | ||
| + | All the original data is in 4:3 ratio, iOS will scale everything to fullscreen for you. You may widescreen if you wish, but you should only go up to 1024x768, otherwise things will be too small to play. | ||
| + | |||
| + | Its possible that widescreen mod will cause graphical corruption in the intro videos, but it is negligible. | ||
| + | |||
| use iTunes to load games, configuration files, and <del>saves</del>. | use iTunes to load games, configuration files, and <del>saves</del>. | ||
| using iTunes File Sharing you can load files with the ".cfg" extension to GemRB's documents; you can select which of these files to load at runtime. | using iTunes File Sharing you can load files with the ".cfg" extension to GemRB's documents; you can select which of these files to load at runtime. | ||
| - | iTunes can also be used to upload games. simply create a zip archive of the game directory and rename the file extension to the GameType for the game (ie BG1, BG2, IWD, PST...). When you run GemRB after uploading a game you can choose to install the game which will unzip the archive to "Library/GameType" and copy the default configuration file and name it "foldername.gametype.cfg". This config file will contain automatically generated paths to the data. If you install a file that already exists the old one will be overwritten so beware. | + | iTunes can also be used to upload games. simply create a zip archive of the game directory and rename the file extension to the **//lowercase//** GameType for the game (ie BG1, BG2, IWD, PST...). When you run GemRB after uploading a game you can choose to install the game which will unzip the archive to "Library/GameType" and copy the default configuration file and name it "foldername.gametype.cfg". This config file will contain automatically generated paths to the data. If you install a file that already exists the old one will be overwritten so beware. |
| == Crating Your Archive == | == Crating Your Archive == | ||
| Line 57: | Line 61: | ||
| * Unix/Linux: from a command line //zip -r GameName.Gametype GameDirectory// | * Unix/Linux: from a command line //zip -r GameName.Gametype GameDirectory// | ||
| - | Be sure to rename the extension to the game type. | + | Be sure to rename the extension to the **//lowercase//** game type. |
| Depending on your IE game and what device you are using (iPad vs iPhone) you will need to change your config resolution. If you don't have the IE game modded with the widescreen mod the maximum resolution you can set for iPhone (assuming your IE game supports it) is 800x600 and the maximum for ipad (no widescreen mod required) is 1024x768. | Depending on your IE game and what device you are using (iPad vs iPhone) you will need to change your config resolution. If you don't have the IE game modded with the widescreen mod the maximum resolution you can set for iPhone (assuming your IE game supports it) is 800x600 and the maximum for ipad (no widescreen mod required) is 1024x768. | ||
| - | |||
| ===== Features Unique to iOS ===== | ===== Features Unique to iOS ===== | ||
| Any of these could be implemented on other platforms, although, some of the code behind it is not in the GemRB branch. (I will share if asked for it) | Any of these could be implemented on other platforms, although, some of the code behind it is not in the GemRB branch. (I will share if asked for it) | ||
| Line 79: | Line 82: | ||
| ===== Known Issues (and bugs outside our control i.e. SDL bugs) ===== | ===== Known Issues (and bugs outside our control i.e. SDL bugs) ===== | ||
| - | * The console sometimes wont appear. Usually swipe down a couple times (even if the keyboard isn't up) and try again. | + | * <del>The console sometimes wont appear. Usually swipe down a couple times (even if the keyboard isn't up) and try again.</del> fixed? |
| - | * Its probably not noticeable unless you are not using fullscreen, but leaving and restoring GemRB switches orientation from landscape to portrait (probably an SDL bug) | + | * <del>iPhone seems to run in portrait mode (SDL bug)</del> fixed? |
| - | * when playing in "windowed" mode SDL is improperly calculating the offset from the status bar. (seemingly 2x what is necessary; I assume this is because it was developed and tested for retina displays only) | + | |
| - | * iPhone seems to run in portrait mode (SDL bug) | + | |
| - | * the display is flipped upside down when starting the game | + | |
| * GameType=auto does not work. this is because iOS doesn't have a full python install. you could make it work your self by editing the info.plist and setting a PYTHON_HOME environment variable to a path to a full python install from Cydia. | * GameType=auto does not work. this is because iOS doesn't have a full python install. you could make it work your self by editing the info.plist and setting a PYTHON_HOME environment variable to a path to a full python install from Cydia. | ||
| + | * Its possible that widescreen mod will cause graphical corruption in the intro videos, but it is negligible. | ||
| == Known Issues With GemRB's SDL 2 driver (affects only builds after 0.7.0-292) == | == Known Issues With GemRB's SDL 2 driver (affects only builds after 0.7.0-292) == | ||
| Line 90: | Line 91: | ||
| * Modal windows don't have the darkening effect on the background interface. | * Modal windows don't have the darkening effect on the background interface. | ||
| * gamma setting doesnt work. | * gamma setting doesnt work. | ||
| - | * SDL_QUIT event will actually crash the program. (quitting doesn't work) | ||
| * Game Rendering is extremely inefficient (tho this was a problem before when using the compatibility layer too) | * Game Rendering is extremely inefficient (tho this was a problem before when using the compatibility layer too) | ||
| ===== Roadmap ===== | ===== Roadmap ===== | ||
| [[developers:brad|refer to my TODO page]] | [[developers:brad|refer to my TODO page]] | ||
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 3.0 Unported
