File	Date	Author	Commit
ext	2010-08-18	kornerr	[d92188] INSTALL, MinGWBuild scripts
include	2010-08-15	Alexander Shubenkov	[24eda0] dynamic camera
res	2010-08-15	Alexander Shubenkov	[24eda0] dynamic camera
src	2010-08-15	Alexander Shubenkov	[24eda0] dynamic camera
.hgtags	2010-03-21	kornerr	[eb5f10] remove outdated tags
CMakeLists.txt	2010-08-18	kornerr	[d92188] INSTALL, MinGWBuild scripts
INSTALL	2010-08-18	kornerr	[d92188] INSTALL, MinGWBuild scripts
README	2010-08-18	kornerr	[d92188] INSTALL, MinGWBuild scripts

Read Me

=================================================
Dependencies' versions.
=================================================

OIS          = 1.2.0
OGRE        >= 2281:70927bc62cdc (2010-07-31)
CEGUI        = svn of 2515
OpenAL Soft >= 1.4.272
ALURE       >= git of 2010-05-23
OGS Sound    = r29:7f59ca121738

=================================================
Linux dependencies.
=================================================

You can either use pre-compiled libraries or compile the libraries yourself.

1. Libraries' compilation.

~~~ OIS ~~~

Get the sources from
    http://sourceforge.net/projects/wgois/files/

Compile the OIS and install it into /usr or /usr/local.

~~~ OGRE ~~~

Get the sources from OGRE Mercurial repository as described in
    http://www.ogre3d.org/developers/mercurial

Patch the sources with the patch located at ext/ogre.

Compile OGRE with the following options:
    OGRE_CONFIG_ALLOCATOR = 1
    OGRE_CONFIG_THREADS = 0
    OGRE_USE_BOOST = OFF
    OGRE_CONTAINERS_USE_CUSTOM_ALLOCATOR = OFF

Install OGRE into /usr or /usr/local.

~~~ CEGUI ~~~

Get the sources from CEGUI SVN repository, v0-7 branch, as described in
    http://www.cegui.org.uk/docs/current/downloading.html

Compile the CEGUI with OGRE renderer (enabled if OGRE was found) and with defayl XML parser  ExpatParser(./configure --with-default-xml-parser=ExpatParser).
Install it into /usr or /usr/local.

~~~ OpenAL Soft ~~~

You may have the OpenAL Soft installed already.
If not, get the the sources as described in
    http://kcat.strangesoft.net/openal.html

Compile the OpenAL Soft and install it into /usr or /usr/local.

~~~ ALURE ~~~

Get the sources as described in
    http://kcat.strangesoft.net/alure.html

Compile the ALURE with OGG support (enabled if OGG was found) and
install it into /usr or /usr/local.

~~~ OGS Sound ~~~

Get the sources from Mercurial repository
    http://bitbucket.org/kornerr/sound

Compile the OGS Sound and install it into /usr or /usr/local.

2. Pre-compiled libraries.



=================================================
Compile under Windows.
=================================================

Install CMake-2.8
Install TDM-MINGW into C:/MinGW

OgreSDK_MinGW
cp include/*     C:/MinGW/include
cp lib/release/* C:/MinGW/lib
cp boost_1_42/boost C:/MinGW/include/boost

OpenAL soft
cp AL C:/MinGW/include
cp lib/Win32/* C:/MinGW/lib

ALURE
You must build it with standard MinGW (not TDM one used to build OGRE).
Before building ALURE install libsnd binary for windows and copy sndfile.h into C:/MinGW/include. Add the
    INCLUDE_DIRECTORIES(C:/MinGW/include)
directive to the CMakeLists.txt.

cp alure.h C:/MinGW/include/AL
cp lib/Win32/* C:/MinGW/lib

Build OGS sound with CMake.
Ogre include dir to OGRE. OpenAL include dir to AL.
Specify include dirs. TODO: Add C:/MinGW into include defaults like for MJ.
Copy libOGSSound.dll.a to C:/MinGW/lib
cp include/ogs to C:/MinGW/include


***** 
libintl
http://gnuwin32.sourceforge.net/packages/libintl.htm

Install it into C:/MinGW

*****

Build CEGUI with CMake.
Set DEFAULT_XMLPARSER to Expat.
Install pcre, freetype, zlib from GnuWin32 project into C:/MinGW
Install Expat to default Program Files, then create MinGW lib files:
  pexports libexpat.dll > expat.def
  pexports libexpatw.dll > expatw.def
  dlltool -d expat.def -l libexpat.a
  dlltool -d expatw.def -l libexpatw.a
cp expat/Source/lib/*.h C:/MinGW/include
Copy libexpat.a to C:/MinGW/lib
Set FREETYPE_INC_DIR to C:/MinGW/include/freetype2 
cp libCEGUI*.a C:/MinGW/lib
cp CEGUI/cegui/include/* C:/MinGW/include/CEGUI

Set MINGW_DIR to C:/MinGW
Set OPENAL_INC_DIR to C:/MinGW/include/AL


Launching.

libCEGUI*.dll
freetype6.dll
zlib1.dll
pcre3.dll
OgreMain.dll
OIS.dll
RenderSystem_GL.dll
libOGSSound.dll
ALURE32.dll
libexpat.dll
cp ogs/res build/mj
libsndfile-1.dll


Layouts
from
http://games.kde.org/old/kmahjongg/layouts.html

Tile geometry:

   - 4 -
  ------- \
| |     |\ 2
  |     | \ \
6 |     |  |
  |     |  |
| |     |  |
  |     |  |
  -------  |
   \     \ |
    \     \|
     -------


**** Windows build evironment setup ****

1. Install CMake-xxx-win32-x86.

At the "Install Options" screen select
"Add CMake to the system PATH for all users" and "Create CMake Desktop Icon".

2. Intall Cygwin.

The following packages must be installed in addition to standard ones:
- rsync
- unzip
Cygwin is used just as UNIX shell, MSYS replacement, not for compilation.

3. Instal MinGW.

Download the following MinGW files from the official site:

and place them into "mingw" directory. Put it into the same directory with MinGW.MinGWBuild script.
Then run the script:
    ./MinGW.MinGWBuild

It will install MinGW into C:/MinGW.

pexports.