== Compiling ScummVM with Minimalist GNU for Windows (MINGW) ==
MinGW is "a collection of freely available and freely distributable Windows specific header files and import libraries combined with GNU toolsets that allow one to produce native Windows programs that do not rely on any 3rd-party C runtime DLLs".
More information can be found at the [http://www.mingw.org/ MinGW homepage]
== Things needed ==
=== MinGW and MSYS ===
Check the "'''Installing MinGW and MSYS'''" section below for instructions on how to create your ScummVM compilation environment
=== Libraries needed ===
* [http://www.libsdl.org/download-1.2.php SDL 1.2].
** You need at least v1.0.9. Newer versions than this should work, but require GTK's glib and CMAKE to build.
=== Precompiled libraries ===
To ease the whole process, a package of all the needed precompiled libraries has been created.
All you need to do is:
** [http://sourceforge.net/projects/scummvm/files/build/scummvm-required-libs-mingw.zip/download Precompiled libraries]
== Installing MinGW and MSYS ==
Both MinGW and MSYS need to be installed and working to compile ScummVM.
=== Additional information about MinGW and Windows Vista ===
In order to get MinGW properly working under Windows Vista, you need to do the following:
Make sure that the MinGW bin directory is included in the path (e.g. C:\MinGW\bin), which should already be included there from the MinGW installer. Also, make sure that the libexec path is included too (e.g. C:\MinGW\libexec\gcc\mingw32\3.4.2), which is needed in Vista to get MinGW properly working
== MSYS primer ==
From the developer's webpage: "MSYS or Minimal SYStem is a POSIX and Bourne shell environment use with MinGW. It provides a hand picked set of tools to allow a typical configuration script with Bourne syntax to execute. This allows most of the GNU packages to create a Makefile just from executing the typical configure script which can then be used to build the package using the native MinGW version of GCC".
== Building the libraries ==
Now, we need to compile the required libraries and tools.
=== NASM ===
First of all, we need nasm. So unzip the nasm archive in a directory, and copy both files to MinGW's bin directory. Alternatively, you can include the folder you unzipped the files in your system path. To do this, go to Control Panel->System, Advanced tab->environment variables and edit the "PATH" variable in the system variables list, adding the folder where you placed the aforementioned files. Directories in the system path are split with a semicolon (;), e.g. "C:\MinGW\msys\1.0\bin;C:\MinGW\bin;C:\nasm".
Note that changes to the PATH will be reflected on newly opened command prompts only, so if you got any open already, close them to avoid confusion
=== SDL ===
SDL is already compiled and needs no further changes, so we can skip the compilation step for it
* Note the README [http://www.libsdl.org/extras/win32/mingw32/README.txt here], especially the need to include the DirectX development header and libraries from [http://www.libsdl.org/extras/win32/common/directx-devel.tar.gz here] to ensure that the "dsound" rather than the "waveout" / "winmm" fallback audio driver is used.
=== zlib ===
Unzip the source code in a folder, open MSYS, go to the zlib folder and issue this command to compile the library:
=== libogg ===
libogg should be compiled before libvorbis and libFLAC
=== libvorbis ===
Unzip the libvorbis archive in a folder, open MSYS, go to the libvorbis folder and issue these commands to compile the library:
=== libmad ===
Unzip the libmad archive in a folder. Open MSYS, go to the libmad folder. If you are using gcc 4.4 or higher, run the following command:
=== libmpeg2 ===
Unzip the libmpeg2 archive into a folder. Open MSYS, go to the libmpeg2 folder.
=== FLAC ===
Unzip the flac archive in a folder, open MSYS, go to the flac folder and issue these commands to compile the library:
=== FluidSynth ===
We use fluidsynth 1.0.9, since later versions requires GTK.
make install prefix=/mingw
=== libpng ===
Unzip the libpng archive in a folder, open MSYS, go to the libpng folder and issue these commands to compile the library:
=== libtheora ===
Unzip the libtheora archive in a folder, open MSYS, go to the libtheora folder and issue these commands to compile the library:
=== libfaad2 ===
Unzip the libfaad2 archive in a folder, open MSYS, go to the libfaad2 folder and apply the following patch:
=== freetype ===
Unzip the freetype archive in a folder, open MSYS, go to the freetype folder and issue these commands to compile the library:
make install prefix=/mingw
== Compiling ScummVM ==
To compile ScummVM, issue the following commands inside the scummvm folder (where Makefile resides):
== Ready to go! ==
OK this should be all of it (thankfully), so you should be good to go.