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: 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 celestar@1524: also be possible to build OpenTTD with GCC: 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 celestar@1524: be no reason of course why the OS/2 version cannot be used, and I celestar@1524: have subsequently built OpenTTD successfully this way. 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 celestar@1524: of date and uses EMX, ignore this darkvater@844: darkvater@844: - libpng celestar@1524: http://www.libpng.org/ - contains an EMX/gcc makefile, ignore this 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: 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 orudge@3398: http://sourceforge.net/projects/openttd/ - see "os2-useful-v1.1.zip". darkvater@844: celestar@1524: A Note About Subversion Revision Numbers celestar@1524: ---------------------------------------- celestar@1524: celestar@1524: The project file uses a bit of a hack to find out the SVN revision number and Celestar@1528: create an appropriate rev.c file. You'll need the SVN tools in your path Celestar@1528: (specifically, "svnversion"). If "svnversion" can't be found, a generic rev.c Celestar@1528: with the revision set to "norev000" will be created. To specifically force a Celestar@1528: version number, set the environment variable "RELEASE" to the number (eg, "0.3.6") Celestar@1528: -before- starting the Open Watcom IDE (which must be launched from the same shell celestar@1524: session). Also, beware, as you WILL cause incompatibilities if you try to celestar@1524: play a multiplayer game with a different version. celestar@1524: 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: celestar@1524: - Owen Rudge