1

OpenTTD: OS/2 version

     2

=====================

     3

     4

OpenTTD has been ported to work on OS/2 4.x or later (including

     5

eComStation). The game should work as well as it does on Windows

     6

or other platforms: the main issues you may encounter are graphics

     7

card problems, but that is really the fault of SDL.

     8

     9

=========================

    10

USING OPENTTD FOR OS/2

    11

=========================

    12

    13

LIBRARIES REQUIRED FOR END USERS

    14

--------------------------------

    15

    16

SDL.DLL (SDL 1.2.7) and FSLib.dll are required to use this program:

    17

these can be downloaded from the Files section at

    18

http://sourceforge.net/projects/openttd/ - see "os2-useful-v1.1.zip".

    19

Version 20051222 of SDL or later is required. This can be found at

    20

http://sdl.netlabs.org/.

    21

    22

Please note that earlier SDL releases will probably NOT work with

    23

OpenTTD. If you experience problems with OpenTTD, please check

    24

your SDL and FSLib.dll versions (both must match).

    25

    26

Note that to actually play the game, I have found in my own

    27

experience that a version of the Scitech Display Drivers or its later

    28

incarnation (see www.scitech.com) are necessary for it to work. If

    29

you have trouble with your native drivers, try the Scitech drivers

    30

and see if they help the problem.

    31

    32

KNOWN ISSUES

    33

------------

    34

    35

- If an error occurs during loading, the OS/2 error message window

    36

  is not always displayed.

    37

    38

A NOTE ABOUT MUSIC

    39

------------------

    40

    41

OpenTTD includes a music driver which uses the MCI MIDI system. Unfortunately,

    42

due to the lack of proper MIDI hardware myself, I have been unable to test it,

    43

but during testing, I found that when MIDI was enabled, I got no sound

    44

effects. I therefore decided to DISABLE music by default.

    45

    46

To enable music, start OpenTTD with the command line:

    47

    48

   openttd -m os2

    49

    50

If I hear enough responses that both music and sound work together (it might

    51

just be my system), I'll have the defaults changed.

    52

    53

A NOTE ABOUT DEDICATED MULTIPLAYER SERVERS

    54

------------------------------------------

    55

    56

To start a dedicated multiplayer server, you should run the dedicated.cmd

    57

file. This enables OpenTTD to open up a VIO console window to display

    58

its output and gather any necessary input. Running "openttd -D"

    59

directly will result in the console not being displayed. You may

    60

still pass any other parameters ('-D' is already passed) to

    61

dedicated.cmd.

    62

    63

=========================

    64

BUILDING THE OS/2 VERSION

    65

=========================

    66

    67

Compiler

    68

--------

    69

    70

Innotek GCC, an OS/2 port of the popular GCC compiler, was used to build OpenTTD.

    71

See www.innotek.de for more information. You WILL need a reasonably UNIX-like

    72

build environment in order to build OpenTTD successfully - the following link

    73

may help to set one up (although some of the links from that page are broken):

    74

    75

   http://www.mozilla.org/ports/os2/gccsetup.html

    76

    77

To build, you should, if your environment is set up well enough, be able to just

    78

type `./configure' (or `sh configure' if you're using the OS/2 shell) and `make'.

    79

    80

A note on Open Watcom

    81

---------------------

    82

    83

Open Watcom C/C++ was previously used to build OpenTTD (version 0.4.x and earlier).

    84

However, due to advanced C++ features used in the YAPF portion of OpenTTD 0.5

    85

in particular, the compiler is no longer able to build the game at the moment.

    86

Hopefully one day Open Watcom will be able to catch up and we will be able to build

    87

the game once again (it's easier than getting an OS/2 UNIX-like environment set up

    88

in my opinion!), but until then, OpenTTD 0.5 and later can only be built with GCC.

    89

    90

Libraries Required

    91

------------------

    92

    93

The following libraries are required. To build zlib and libpng, I

    94

simply added the required files (watch out for sample programs, etc)

    95

to an IDE project file and built a library. Do not use the makefiles

    96

provided, they are not designed for Watcom (apart from SDL):

    97

    98

- zlib

    99

  http://www.zlib.org/

   100

   101

- libpng

   102

  http://www.libpng.org/

   103

   104

- SDL for OS/2

   105

  ftp://ftp.netlabs.org/pub/sdl/sdl-1.2.7-src-20051222.zip used for

   106

  0.4.7

   107

   108

- Freetype

   109

  http://freetype.sourceforge.net/

   110

   111

Currently, there are no pre-built libraries available for GCC. If you manage to get

   112

OpenTTD working on Watcom though (do let us know if this is the case!), pre-built

   113

versions can be downloaded from the Files section at

   114

http://sourceforge.net/projects/openttd/ - see "os2-useful-v1.1.zip".

   115

   116

Contact Information

   117

-------------------

   118

   119

If you have any questions regarding OS/2 issues, please contact me

   120

(owen@owenrudge.net) and I'll try to help you out. For general OpenTTD

   121

issues, see the Contacting section of readme.txt.

   122

   123

Thanks to Paul Smedley for his help with getting OpenTTD to compile under GCC on OS/2.

   124

   125

- Owen Rudge, 8th January 2007