darkvater@844: OpenTTD: OS/2 version darkvater@844: ===================== darkvater@844: darkvater@844: OpenTTD has been ported to work on OS/2 4.x or later (including darkvater@844: eComStation). The game should work as well as it does on Windows darkvater@844: or other platforms: the main issues you may encounter are graphics darkvater@844: card problems, but that is really the fault of SDL. darkvater@844: darkvater@844: ========================= darkvater@844: USING OPENTTD FOR OS/2 darkvater@844: ========================= darkvater@844: darkvater@844: LIBRARIES REQUIRED FOR END USERS darkvater@844: -------------------------------- darkvater@844: darkvater@844: SDL.DLL (SDL 1.2.7) and FSLib.dll are required to use this program: darkvater@844: these can be downloaded from the Files section at orudge@3398: http://sourceforge.net/projects/openttd/ - see "os2-useful-v1.1.zip". orudge@3398: Version 20051222 of SDL or later is required. This can be found at orudge@3398: http://sdl.netlabs.org/. darkvater@844: orudge@3398: Please note that earlier SDL releases will probably NOT work with orudge@3398: OpenTTD. If you experience problems with OpenTTD, please check orudge@3398: your SDL and FSLib.dll versions (both must match). orudge@1849: darkvater@844: Note that to actually play the game, I have found in my own darkvater@844: experience that a version of the Scitech Display Drivers or its later darkvater@844: incarnation (see www.scitech.com) are necessary for it to work. If darkvater@844: you have trouble with your native drivers, try the Scitech drivers darkvater@844: and see if they help the problem. darkvater@844: darkvater@844: KNOWN ISSUES darkvater@844: ------------ darkvater@844: darkvater@844: - If an error occurs during loading, the OS/2 error message window darkvater@844: is not always displayed. darkvater@844: darkvater@844: A NOTE ABOUT MUSIC darkvater@844: ------------------ darkvater@844: darkvater@844: OpenTTD includes a music driver which uses the MCI MIDI system. Unfortunately, darkvater@844: due to the lack of proper MIDI hardware myself, I have been unable to test it, darkvater@844: but during testing, I found that when MIDI was enabled, I got no sound darkvater@844: effects. I therefore decided to DISABLE music by default. darkvater@844: darkvater@844: To enable music, start OpenTTD with the command line: darkvater@844: darkvater@844: openttd -m os2 darkvater@844: darkvater@844: If I hear enough responses that both music and sound work together (it might darkvater@844: just be my system), I'll have the defaults changed. darkvater@844: orudge@7541: Please note also that the GCC version does not currently support the MCI MIDI orudge@7541: system. orudge@7541: orudge@7541: darkvater@844: A NOTE ABOUT DEDICATED MULTIPLAYER SERVERS darkvater@844: ------------------------------------------ darkvater@844: darkvater@844: To start a dedicated multiplayer server, you should run the dedicated.cmd darkvater@844: file. This enables OpenTTD to open up a VIO console window to display darkvater@844: its output and gather any necessary input. Running "openttd -D" darkvater@844: directly will result in the console not being displayed. You may darkvater@844: still pass any other parameters ('-D' is already passed) to darkvater@844: dedicated.cmd. darkvater@844: orudge@7541: You can find the dedicated.cmd file in the os/os2 directory. orudge@7541: darkvater@844: ========================= darkvater@844: BUILDING THE OS/2 VERSION darkvater@844: ========================= darkvater@844: darkvater@844: Compiler darkvater@844: -------- darkvater@844: orudge@5842: Innotek GCC, an OS/2 port of the popular GCC compiler, was used to build OpenTTD. orudge@5842: See www.innotek.de for more information. You WILL need a reasonably UNIX-like orudge@5842: build environment in order to build OpenTTD successfully - the following link orudge@5842: may help to set one up (although some of the links from that page are broken): darkvater@844: orudge@5842: http://www.mozilla.org/ports/os2/gccsetup.html orudge@5842: orudge@7541: Alternatively, Paul Smedley's ready-to-go GCC build environment has been known to orudge@7541: successfully build the game: orudge@7541: orudge@7541: http://www.smedley.info/os2ports/index.php?page=build-environment orudge@7541: orudge@5842: To build, you should, if your environment is set up well enough, be able to just orudge@5842: type `./configure' (or `sh configure' if you're using the OS/2 shell) and `make'. orudge@5842: orudge@7541: You may have to manually specify `--os OS2' on the configure command line, as orudge@7541: configure cannot always detect OS/2 correctly. orudge@7541: orudge@5842: A note on Open Watcom orudge@5842: --------------------- orudge@5842: orudge@5842: Open Watcom C/C++ was previously used to build OpenTTD (version 0.4.x and earlier). orudge@5842: However, due to advanced C++ features used in the YAPF portion of OpenTTD 0.5 orudge@5842: in particular, the compiler is no longer able to build the game at the moment. orudge@5842: Hopefully one day Open Watcom will be able to catch up and we will be able to build orudge@5842: the game once again (it's easier than getting an OS/2 UNIX-like environment set up orudge@5842: in my opinion!), but until then, OpenTTD 0.5 and later can only be built with GCC. darkvater@844: darkvater@844: Libraries Required darkvater@844: ------------------ darkvater@844: darkvater@844: The following libraries are required. To build zlib and libpng, I darkvater@844: simply added the required files (watch out for sample programs, etc) darkvater@844: to an IDE project file and built a library. Do not use the makefiles darkvater@844: provided, they are not designed for Watcom (apart from SDL): darkvater@844: darkvater@844: - zlib orudge@5842: http://www.zlib.org/ darkvater@844: darkvater@844: - libpng orudge@5842: http://www.libpng.org/ darkvater@844: darkvater@844: - SDL for OS/2 orudge@3398: ftp://ftp.netlabs.org/pub/sdl/sdl-1.2.7-src-20051222.zip used for orudge@3398: 0.4.7 darkvater@844: orudge@5842: - Freetype orudge@5842: http://freetype.sourceforge.net/ celestar@1524: orudge@5842: Currently, there are no pre-built libraries available for GCC. If you manage to get orudge@5842: OpenTTD working on Watcom though (do let us know if this is the case!), pre-built orudge@5842: versions can be downloaded from the Files section at orudge@5842: http://sourceforge.net/projects/openttd/ - see "os2-useful-v1.1.zip". darkvater@844: darkvater@844: Contact Information darkvater@844: ------------------- darkvater@844: darkvater@844: If you have any questions regarding OS/2 issues, please contact me darkvater@844: (owen@owenrudge.net) and I'll try to help you out. For general OpenTTD darkvater@844: issues, see the Contacting section of readme.txt. darkvater@844: orudge@5842: Thanks to Paul Smedley for his help with getting OpenTTD to compile under GCC on OS/2. orudge@5842: orudge@7541: - Owen Rudge, 24th June 2007