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 darkvater@844: http://sourceforge.net/projects/openttd/ - see "os2-useful.zip". darkvater@844: (Note that a newer version of SDL is now available at darkvater@844: ftp://ftp.netlabs.org/pub/sdl/sdl-dev-os2-2004-12-22.zip which may darkvater@844: help solve some problems). darkvater@844: 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: 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: darkvater@844: ========================= darkvater@844: BUILDING THE OS/2 VERSION darkvater@844: ========================= darkvater@844: darkvater@844: Compiler darkvater@844: -------- darkvater@844: darkvater@844: Open Watcom 1.3 was used to build OpenTTD (earlier versions will darkvater@844: NOT work). See http://www.openwatcom.org/ to download it. It may darkvater@844: also be possible to build OpenTTD under OS/2: I attempted this darkvater@844: before using Open Watcom, but found the tools available for OS/2 darkvater@844: at the time to be a bit more tricky to get working. darkvater@844: darkvater@844: Due to complexities in my set-up, I actually used the Win32 version darkvater@844: of Open Watcom to initially compile OpenTTD for OS/2. There should darkvater@844: be no reason of course why the OS/2 version cannot be used. 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 darkvater@844: http://www.zlib.org/ - contains a makefile for OS/2, but is out darkvater@844: of date and uses EMX darkvater@844: darkvater@844: - libpng darkvater@844: http://www.libpng.org/ - contains an EMX/gcc makefile darkvater@844: darkvater@844: - SDL for OS/2 darkvater@844: For 0.3.5, I used ftp://ftp.netlabs.org/pub/sdl/SDL-1.2.7-src-20040908a.zip - darkvater@844: take SDL.dll and SDL.lib from the src/ directory. Note that 20041222 is darkvater@844: out now, which is recommended for stability updates. darkvater@844: darkvater@844: If you do not wish to build the libraries yourself, pre-built versions darkvater@844: can be downloaded from the Files section at darkvater@844: http://sourceforge.net/projects/openttd/ - see "os2-useful.zip". darkvater@844: darkvater@844: Compiling darkvater@844: --------- darkvater@844: darkvater@844: To compile, open the os/os2/openttd.wpj file in the IDE and first build darkvater@844: the strgen.exe target. This will build the .lng file generator, and will darkvater@844: also attempt to build all the language files (plus the table\strings.h darkvater@844: file which is required for openttd.exe to be built). Once strgen.exe and darkvater@844: the language files are built successfully, you can build the openttd.exe darkvater@844: target. 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: darkvater@844: - Owen Rudge, 26th December 2004