Difference between revisions of "Compiling ScummVM/MinGW"

Jump to navigation Jump to search
Added a new guide to compile under recent MinGW versions.
(→‎Libraries needed: Add missing fluidsynth.)
(Added a new guide to compile under recent MinGW versions.)
Line 1: Line 1:
== Compiling ScummVM with Minimalist GNU for Windows (MINGW) ==
== Compiling ScummVM with Minimalist GNU for Windows (MINGW) and MINimal System 2 (MSYS2) ==


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".  
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]
More information can be found at the [http://www.mingw.org/ MinGW homepage]
{| border="0" cellpadding="1" cellspacing="2" style="margin-left:5em; background:#FF9999; width:80%"
|- align="center"
| '''NOTE'''
|- style="margin-left:1em; background:#ffffff;"
|- style="background:#ffffff"
| This guide covers '''only''' the compilation under MinGW64 and MSYS2, and makes heavy use of the pacman package manager, which may not be available under other MinGW setups.
For an older version of the guide, please go to [[Compiling_ScummVM:MinGW#Compilation in older versions of MinGW and MSYS | the bottom of this page]].
|}


== Things needed ==
== Things needed ==


=== MinGW and MSYS ===
=== Setup MinGW and MSYS ===
 
'''NOTE:''' This guide is a vast simplification of that found [https://sourceforge.net/p/msys2/wiki/MSYS2%20installation/ here]. While this article should be enough, we recommend you read through the entire guide.
 
==== Download ====
'''Download''' and '''execute''' the MSYS2 bundle for your architecture: [https://sourceforge.net/projects/msys2/files/Base/x86_64/ 64-bit] or [https://sourceforge.net/projects/msys2/files/Base/i686/ 32-bit]
 
==== Update the core of MSYS2 ====
In the installation folder run msys2-shell.bat, which should open a MSYS2 terminal.
Type the following command, to update the core dependencies of the environment:
 
<syntax type="bash">
$> update-core
</syntax>
 
Restart the MSYS2 terminal.
Type the following command, to update the managed packages:
<syntax type="bash">
$> pacman -Su
</syntax>
 
==== Download and install the compilation toolchain====
In the MSYS2 terminal, type:
<syntax type="bash">
$> pacman -S mingw-w64-<env>-toolchain
</syntax>
where <env> is either x86_64 or i686, depending on your architecture (64-bit and 32-bit, respectively).
 
This command will fetch and install the packages needed for compiling, including (but not limited to) GCC 5.x, GDB, and libwinpthread-git.
 
==== Install make ====
In order to compile properly the project utilizes Makefiles, which are build configuration files that the compiler uses to compile, link and solve dependencies. "make" is the software that runs the Makefiles.
 
MSYS2 does not support make out of the box, but it has it's own implementation. Install it by typing:
 
<syntax type="bash">
$> pacman -S make
</syntax>
 
=== Install the needed libraries ===
In order to compile properly, ScummVM needs you to have certain libraries installed. All the libraries in the list can be installed with similar commands:
<syntax type="bash">
$> pacman -S mingw-w64-<env>-<library>
</syntax>
where <env> is the environment as previously stated, and <library> is the name of the library, as stated in the list (e.g. pacman -S mingw-w64-x86_64-SDL):
 
* [http://www.libsdl.org/download-1.2.php SDL] Mandatory.
 
* [http://www.nasm.us/pub/nasm/releasebuilds/?C=M;O=D nasm] Optional, for faster compile of scalers.
 
* [http://flac.sourceforge.net/download.html flac]. Optional, for FLAC support.
 
* [http://downloads.xiph.org/releases/ogg/ libogg] and [http://downloads.xiph.org/releases/vorbis/ libvorbis] Optional, for OGG support.
 
* [ftp://ftp.mars.org/pub/mpeg/ libmad] Optional, for MP3 support.
 
* [http://libmpeg2.sourceforge.net/ libmpeg2] Optional, for MPEG2 cutscene support.
 
* [http://www.zlib.net/ zlib]. Optional, for compressed saved games.
 
* [http://downloads.xiph.org/releases/theora/ libtheora]. Optional, for Broken Sword 2.5.
 
* [http://www.audiocoding.com/downloads.html libfaad2]. Optional, for AAC support.
 
* [http://www.libpng.org/pub/png/libpng.html libpng]. Optional, for PNG support.
 
* [http://download.savannah.gnu.org/releases/freetype/ freetype]. Optional, for TTF support.
 
* [http://sourceforge.net/apps/trac/fluidsynth fluidsynth]. Optional, for soundfont MIDI support.
 
=== Let's get compiling! ===
 
Finally, we are ready to compile the project!
To do that, just open a MSYS2 console, [http://gvsigce.sourceforge.net/wiki/index.php/Getting_started_with_MSYS#Navigating_the_file_system navigate] to the source folder where you have cloned scummvm.git, and type the following commands:
<syntax type="bash">
$> ./configure # Executes a bash script that helps you configure.
$> make # Executes the make program, which triggers the compilation.
</syntax>
 
If everything went well, you should have a big executable in the compilation folder, named scummvm.exe. The size of the executable comes from the debug symbols embedded in the file, so you can run the following command to shrink it:
<syntax type="bash">
$> strip scummvm.exe
</syntax>
 
== Ready to go! ==
 
OK this should be all of it (hopefully), so you should be good to go.
 
== Common Issues ==
 
* If the executable compiles correctly, but you get a "somelibrary.dll missing" error when executing it, you just need to add the following path to your PATH variable: <installdir>/msys<env>/mingw64/bin/
 
== Compilation in older versions of MinGW and MSYS ==
 
==== MinGW and MSYS ====


Download MinGW:  
Download MinGW:  
Line 41: Line 145:
Check the "'''Installing MinGW and MSYS'''" section below for instructions on how to create your ScummVM compilation environment
Check the "'''Installing MinGW and MSYS'''" section below for instructions on how to create your ScummVM compilation environment


=== Libraries needed ===
==== Libraries needed ====


* [http://www.libsdl.org/download-1.2.php SDL 1.2].  
* [http://www.libsdl.org/download-1.2.php SDL 1.2].  
Line 79: Line 183:
** You need at least v1.0.9. Newer versions than this should work, but require GTK's glib and CMAKE to build.
** You need at least v1.0.9. Newer versions than this should work, but require GTK's glib and CMAKE to build.


=== Precompiled libraries ===
==== Precompiled libraries ====
To ease the whole process, a package of all the needed precompiled libraries has been created.  
To ease the whole process, a package of all the needed precompiled libraries has been created.  
All you need to do is:
All you need to do is:
Line 85: Line 189:
** [http://sourceforge.net/projects/scummvm/files/build/scummvm-required-libs-mingw.zip/download Precompiled libraries]
** [http://sourceforge.net/projects/scummvm/files/build/scummvm-required-libs-mingw.zip/download Precompiled libraries]


== Installing MinGW and MSYS ==
=== Installing MinGW and MSYS ===


Both MinGW and MSYS need to be installed and working to compile ScummVM.  
Both MinGW and MSYS need to be installed and working to compile ScummVM.  
Line 95: Line 199:




=== Additional information about MinGW and Windows Vista ===
==== Additional information about MinGW and Windows Vista ====


In order to get MinGW properly working under Windows Vista, you need to do the following:
In order to get MinGW properly working under Windows Vista, you need to do the following:
Line 102: Line 206:
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
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 ==
=== 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".
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".
Line 136: Line 240:




== Building the libraries ==
=== Building the libraries ===


Now, we need to compile the required libraries and tools.
Now, we need to compile the required libraries and tools.




=== NASM ===
==== 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".  
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".  
Line 147: Line 251:
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
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 ====


SDL is already compiled and needs no further changes, so we can skip the compilation step for it
SDL is already compiled and needs no further changes, so we can skip the compilation step for it
Line 157: Line 261:
* 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.
* 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 ===
==== zlib ====


Unzip the source code in a folder, open MSYS, go to the zlib folder and issue this command to compile the library:
Unzip the source code in a folder, open MSYS, go to the zlib folder and issue this command to compile the library:
Line 172: Line 276:




=== libogg ===
==== libogg ====


libogg should be compiled before libvorbis and libFLAC
libogg should be compiled before libvorbis and libFLAC
Line 184: Line 288:




=== libvorbis ===
==== libvorbis ====


Unzip the libvorbis archive in a folder, open MSYS, go to the libvorbis folder and issue these commands to compile the library:
Unzip the libvorbis archive in a folder, open MSYS, go to the libvorbis folder and issue these commands to compile the library:
Line 195: Line 299:




=== libmad ===
==== 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:
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:
Line 208: Line 312:




=== libmpeg2 ===
==== libmpeg2 ====


Unzip the libmpeg2 archive into a folder. Open MSYS, go to the libmpeg2 folder.
Unzip the libmpeg2 archive into a folder. Open MSYS, go to the libmpeg2 folder.
Line 242: Line 346:
</syntax>
</syntax>


=== FLAC ===
==== FLAC ====


Unzip the flac archive in a folder, open MSYS, go to the flac folder and issue these commands to compile the library:
Unzip the flac archive in a folder, open MSYS, go to the flac folder and issue these commands to compile the library:
Line 253: Line 357:




=== FluidSynth ===
==== FluidSynth ====


We use fluidsynth 1.0.9, since later versions requires GTK.
We use fluidsynth 1.0.9, since later versions requires GTK.
Line 286: Line 390:
  make install prefix=/mingw
  make install prefix=/mingw


=== libpng ===
==== libpng ====


Unzip the libpng archive in a folder, open MSYS, go to the libpng folder and issue these commands to compile the library:
Unzip the libpng archive in a folder, open MSYS, go to the libpng folder and issue these commands to compile the library:
Line 297: Line 401:




=== libtheora ===
==== libtheora ====


Unzip the libtheora archive in a folder, open MSYS, go to the libtheora folder and issue these commands to compile the library:
Unzip the libtheora archive in a folder, open MSYS, go to the libtheora folder and issue these commands to compile the library:
Line 308: Line 412:




=== libfaad2 ===
==== libfaad2 ====


Unzip the libfaad2 archive in a folder, open MSYS, go to the libfaad2 folder and apply the following patch:
Unzip the libfaad2 archive in a folder, open MSYS, go to the libfaad2 folder and apply the following patch:
Line 335: Line 439:




=== freetype ===
==== freetype ====


Unzip the freetype archive in a folder, open MSYS, go to the freetype folder and issue these commands to compile the library:
Unzip the freetype archive in a folder, open MSYS, go to the freetype folder and issue these commands to compile the library:
Line 345: Line 449:
  make install prefix=/mingw
  make install prefix=/mingw


== Compiling ScummVM ==
=== Compiling ScummVM ===


To compile ScummVM, issue the following commands inside the scummvm folder (where Makefile resides):
To compile ScummVM, issue the following commands inside the scummvm folder (where Makefile resides):
Line 354: Line 458:


  strip scummvm.exe
  strip scummvm.exe
== Ready to go! ==
OK this should be all of it (thankfully), so you should be good to go.
6

edits

Navigation menu