INSTALL

BUILDING GEMRB WITH CMAKE
-------------------------

Tools you will need to build GemRB:
  - cmake
  - make
  - g++ or clang (others not tested)

NOTE: g++ 4.3 is known to miscompile gemrb.

Libraries:
  - ZLib
  - Python 2.3 or better, compiled with shared libraries
  - SDL 1.2 or SDL 2.0+
  - OpenAL (optional, for sound)
  - SDL_mixer (optional, for fast lower-quality sound)
  - libpng (optional, for the png importer plugin)
  - FreeType (optional, for the TTF fonts plugin)
  - iconv (optional, for the TTF fonts plugin and only needed when using a non unicode compatible TLK)
  - (lib)VLC 2.0+ (optional, for movies in some mac distributions of the games)
  - OpenGL drivers and GLew (both optional)

Building GemRB on unix-like systems
-----------------------------------

The following commands will try to configure, make and install GemRB.
  mkdir build
  cd build
  cmake ..
  make
  make install

By default, GemRB is installed into /usr/local ("fhs"). You can pass -DLAYOUT
with "home" or "opt" to change the general layout and -DPREFIX to change the
install path prefix. Check the toplevel CMakeLists.txt to get see all the
individual path components you can additionally alter.

Pass -DCMAKE_BUILD_TYPE=Debug to cmake if you want to create a debug build.
Pass -DNOCOLOR=1 if you want to disable colored console output, which is a
useful option for transparent terminal emulators or non white-on-black color
schemes.

If you're on an exotic platform and get a lot of errors trying to build,
also pass -DDISABLE_WERROR=1, so warnings won't impede you. This option is
also suggested if you're making a source package.

If you want to build the OpenGL driver, first ensure you have a working SDL2
install. Then, if you want the standard driver, pass -DUSE_OPENGL=1 and if
you want the OpenGL ES driver, pass -DUSE_OPENGL=2 .

Please let us know if you encounter any problems while building.

Building GemRB with mingw
-------------------------

The following commands will try to configure, make and install GemRB.
  mkdir build
  cd build
  cmake .. -G "MinGW MakeFiles"
  mingw32-make
  mingw32-make install

By default, GemRB is installed into c:\Program Files\GemRB . Supporting
files are mostly installed into the same directory.

See the following for an extensive build walkthrough:
http://forums.gibberlings3.net/index.php?showtopic=13087