OpenMW - the completely unofficial reimplementation of Morrowind
================================================================

OpenMW is an open source reimplementation of the Morrowind game
engine. For more information, see README.txt or

    http://openmw.snaptoad.com/




Building from source
====================

Supported Windows platforms:
----------------------------

Only tested on Windows XP. If you manage to compile or run OpenMW on
another Windows platform (9x/Me/NT/Vista), please let me know!


Dependencies:
-------------

Dependencies needed to build OpenMW:

OGRE 1.4.9         (3d engine)
OpenAL             (3d sound system)
FFmpeg             (For MP3 playback)
Mingw              (C++ compiler)
gdc 4.1.3 (mingw)  (D compiler)

The above versions are the ones I have tested recently, but other
versions might work. OGRE, OpenAL and OIS are complex libraries with
their own set of dependencies. I recommend downloading prebuild SDKs
instead of building them from source.

FFmpeg package contains the necessary libraries libavcodec and
libavformat. You will most likely have to build it from source. This
can be done either with Mingw32/Msys or with Cygwin. See below for
instructions. Note that some of the codecs included with FFmpeg might
be patented in your country.

You can find the libraries here:

OGRE:     http://ogre3d.org (See "Getting Ogre" in README-win32.txt for details)
OIS:      Comes with the Ogre SDK
OpenAL:   http://openal.org/
FFmpeg:   http://ffmpeg.mplayerhq.hu/
Mingw     http://sourceforge.net/projects/mingw/
gdc       http://sourceforge.net/projects/gdcwin/

(Note that the "official" D compiler, DMD, will not currently work on
Windows, because it is incompatible with most C++ compilers.)


Setting everything up
---------------------

First, install Mingw (get the automatic installer.) Make sure gcc and
g++ packages are selected.

Next install the gdcwin installer (the package named 'gdc') and
install it in the same directory as Mingw.

Open a command line. Set up your PATH to include Mingw and gdc
(eg. "set PATH=%PATH%;c:\mingw\bin"). Make sure the commands g++ and
gdc work (should output "no input files".)

The build script expects to find the Ogre and FFmpeg SDKs in the
parent directory. An example directory structure is:

c:\openmw\Ogre       - Ogre SDK
c:\openmw\openmw     - OpenMW source
c:\openmw\ffmpeg     - FFmpeg

You must compile FFmpeg from source, since at the time of writing
there are no prebuilt SDKs available. The source must be built with
Mingw as well (not Cygwin!) The following configure flags should work:
./configure --enable-shared --disable--ffserver --disable-ffplay


Building
--------

To build, simply run build_openmw.bat


Running
-------

For instructions on how to set everything up after compilation, see
README-win32.txt.

Good luck!