summaryrefslogtreecommitdiff
path: root/docs/INSTALL/win32.txt
blob: 8469321abb04407f0eb921d121f6b4de0f90d3e2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
How setup Dev-C++ to compile TMW on a Win32 Box
===============================================

The Mana World project
======================
Homepage: themanaworld.sourceforge.net
IRC:      irc.freenode.net / #manaworld


0. Index
========
1. Requirements
2. Installing Dev-C++
3. Installing the required libraries
4. Compiling The Mana World


1. Requirements
===============

In this tutorial we will use Dev-C++ because of the fact that it's a very good
free IDE for Win32 built around GCC. Remember, Win32 was not meant for GCC and
stuff so you will probably run into trouble unless you really know what you're
doing, so best stick with Dev-C++.

Besides a C++ compiler, TMW depends on the following libraries:

1) SDL
2) SDL_mixer
3) SDL_image
4) Guichan 0.4.0
5) libxml2
6) PhysFS


2. Installing Dev-C++
=====================

I recommend that you get the latest beta version, which is 4.9.9.2 at the time
of writing. Though this tutorial is written for and tested with that, it may
also apply to the latest stable version. Get Dev-C++ here:

  http://www.bloodshed.net/
  
After you fetched it simply run and install.


3. Installing the required libraries
====================================

The easy way is to get our development package which should work with the latest
CVS (I'll try to update it as much as I can).
You can find it at:

  http://themanaworld.sourceforge.net/files/tmw-cvs.DevPak (by ElvenProgrammer)
  http://riekale.com/~rotonen/ (by Rotonen)


Elven's devpak is usually more recommended than Rotonen's, but Rotonen's might
be more up to date, although it might also include stuff like a new compiler
and such, so it might be more unstable to use, a tweaker / power user oriented
devpak.

Just install this one and you should be ready to go. (Although please remember
to remove anything the devpak might overlap before installing, for example the
previous devpak.) Remember to copy the required dlls from your dll folder in
the Dev-Cpp root directory, to the folder where you have your copy of The Mana
World. You also have to add the SDL include folder in your C++ include paths.
If you can't get the package or you are experiencing problems with it, just
send me an email at elvenprogrammer@gmail.com or continue reading.(Or to
joni.orponen@gmail.com if you're using Rotonen's devpak. Coming to bug us on
the IRC channel is a valid alternative too.)

Most of the libs have DevPaks that are very easy drop-ins for Dev-C++, without
any complex actions on your side.

Get the following DevPaks and archives:

- SDL           (http://devpaks.org/show.php?devpak=57)
- SDL_mixer     (http://devpaks.org/show.php?devpak=26)
- SDL_image     (http://devpaks.org/show.php?devpak=25)
- Guichan       (http://guichan.sourceforge.net/downloads.shtml)
- libxml2 **    (ftp://ftp.zlatkovic.com/pub/libxml/)
- PhysFS ***    (http://icculus.org/physfs/downloads/unsupported/)

Install them all through the Dev-C++ package manager. For SDL_image you may
still need to manually get the SDL_image.lib file from the SDL_image homepage
(devel VC6 zip file) and copy it to your Dev-Cpp/lib directory.

 **) For libxml2, download the following files (these or newer versions):

        libxml2-2.6.17.win32.zip
        iconv-1.9.1.win32.zip
        zlib-1.2.1.win32.zip

     From each file, copy the headers to your include directory, the libs to
     the lib direcotry and the dlls (in bin direcotry) to your tmw directory.

***) For PhysFS copy the headers to your include directory, the libs to
     the lib direcotry and the dlls (in bin direcotry) to your tmw directory.

You should now be fully equipped for compiling the latest TMW CVS code!


4. Compiling The Mana World
===========================

Check out The Mana World from CVS using either the command line cvs tool or
TortoiseCVS, pick what you like to use most and install that. Next, check out
the tmw module from our repository. For anonymous users, the CVSROOT is:

  :pserver:anonymous@cvs.sourceforge.net:/cvsroot/themanaworld

Open "The Mana World.dev" in Dev-C++. From there on you should be able to
start compilition with Excute -> Compile. A file called tmw.exe should appear
in the same directory as where you opened the .dev from.

Before you can actually run the executable be sure to copy over the following
DLLs from your Dev-Cpp/dll directory to the directory containing tmw.exe (or 
alternatively into your c:\windows\system\):

 SDL.dll
 SDL_image.dll
 SDL_mixer.dll
 guichan.dll
 guichan_sdl.dll
 jpeg.dll
 libpng1.dll
 zlib1.dll

And also make sure you have:

 libxml2.dll
 iconv.dll

Additionally don't forget to copy any updated .dll (when libs are updated,
the dll are usually updated too) to the folder containing tmw.exe (or to the
c:\windows\system\).

Have fun hacking The Mana World!