Difference between revisions of "Compiling ScummVM/MinGW"

From ScummVM :: Wiki
Jump to navigation Jump to search
(21 intermediate revisions by 8 users not shown)
Line 1: Line 1:
== Compiling ScummVM with Minimalist GNU for Windows (MINGW) and MINimal System 2 (MSYS2) ==
== 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".  
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 ==


=== Setup MinGW and MSYS ===
=== 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 and install the latest [https://osdn.net/projects/mingw/releases/ MinGW Installation Manager] (mingw-get-setup.exe)
* From the list of packages shown, check ''mingw-developer-toolkit-bin'', ''mingw32-base-bin'' and ''mingw32-gcc-g++-bin'', as well as ''mingw32-libz-dev'' from the "MinGW Libraries" section (right-click > Mark for Installation)
* Click the Installation > Apply Changes menu to install MinGW and MSYS
* Once installation is complete, you can run MSYS from inside the MinGW directory (by default C:\MinGW\msys\1.0\msys.bat)


==== Download ====
=== Libraries needed ===
'''Download''' and '''execute''' the MSYS2 bundle for your architecture from [http://msys2.github.io/ here].


==== Update the core of MSYS2 ====
* [http://www.libsdl.org/download-1.2.php SDL 1.2].  
In the installation folder run msys2-shell.bat, which should open a MSYS2 terminal.
** You need the latest SDL 1.2 source code revision from Mercurial ([https://hg.libsdl.org/SDL/archive/1bffae6992b0.tar.bz2 1bffae6992b0] at the time of writing).
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 ====
ScummVM uses Makefiles to build the project. Makefiles 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 its 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):
 
* '''SDL''' Mandatory.
 
* '''nasm''' Optional, for faster compile of scalers.
 
* '''flac'''. Optional, for FLAC support.
 
* '''libogg''' and '''libvorbis''' Optional, for OGG support.
 
* '''libmad''' Optional, for MP3 support.
 
* '''libmpeg2''' Optional, for MPEG2 cutscene support.
 
* '''zlib'''. Optional, for compressed saved games.
 
* '''libtheora'''. Optional, for Broken Sword 2.5.
 
* '''libfaad2'''. Optional, for AAC support.
 
* '''libpng'''. Optional, for PNG support.
 
* '''freetype'''. Optional, for TTF support.


* '''fluidsynth'''. Optional, for soundfont MIDI support.
* [https://www.libsdl.org/projects/SDL_net/release-1.2.html SDL_net 1.2]. Optional, for network support.
** You need the latest SDL_net source code ([https://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.8.tar.gz v1.2.8] at the time of writing).


=== Let's get compiling! ===
* [https://sourceforge.net/projects/pkgconfiglite/ pkg-config-lite].
** You need the latest Win32 binary ([https://sourceforge.net/projects/pkgconfiglite/files/0.28-1/pkg-config-lite-0.28-1_bin-win32.zip/download v0.28-1] at the time of writing).


Finally, we are ready to compile the project!
* [http://www.nasm.us/pub/nasm/releasebuilds/?C=M;O=D NASM]. Optional, for faster compile of scalers
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:
** You need the latest Win32 binary ([http://www.nasm.us/pub/nasm/releasebuilds/2.15.03/win32/ v2.15.03] at the time of writing).
<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:
* [https://cmake.org/ CMake]. Optional, for compiling libjpeg-turbo.
<syntax type="bash">
** You need the latest Win32 installer.
$> strip scummvm.exe
</syntax>


== Ready to go! ==
* [https://xiph.org/flac/download.html FLAC]. Optional, for FLAC support
 
** You need the latest flac source code ([http://downloads.xiph.org/releases/flac/flac-1.3.3.tar.xz v1.3.3] at the time of writing).
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:
 
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/binutils/binutils-2.21/binutils-2.21-3-mingw32-bin.tar.lzma/ binutils]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gcc/Version4/gcc-4.6.2-1/gcc-core-4.6.2-1-mingw32-bin.tar.lzma/download gcc-core dev]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gcc/Version4/gcc-4.6.2-1/libgcc-4.6.2-1-mingw32-dll-1.tar.lzma/download gcc-core dll]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gcc/Version4/gcc-4.6.2-1/gcc-c%2B%2B-4.6.2-1-mingw32-bin.tar.lzma/download gcc-g++ dev]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gcc/Version4/gcc-4.6.2-1/libstdc%2B%2B-4.6.2-1-mingw32-dll-6.tar.lzma/download gcc-g++ dll]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gmp/gmp-5.0.1-1/gmp-5.0.1-1-mingw32-dev.tar.lzma/download gmp dev]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gcc/Version4/gcc-4.6.2-1/libgomp-4.6.2-1-mingw32-dll-1.tar.lzma/download gmp dll]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gcc/Version4/gcc-4.6.2-1/libgomp-4.6.2-1-mingw32-dll-1.tar.lzma/download gomp]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gettext/gettext-0.17-1/libintl-0.17-1-mingw32-dll-8.tar.lzma/download iconv]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/libiconv/libiconv-1.13.1-1/libiconv-1.13.1-1-mingw32-dev.tar.lzma/download intl dev]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/libiconv/libiconv-1.13.1-1/libiconv-1.13.1-1-mingw32-dll-2.tar.lzma/download intl dll]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gmp/gmp-5.0.1-1/libgmp-5.0.1-1-mingw32-dll-10.tar.lzma/download libgmp]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/mingw-rt/mingwrt-3.18/mingwrt-3.18-mingw32-dev.tar.gz/download mingw-runtime dev]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/mingw-rt/mingwrt-3.18/mingwrt-3.18-mingw32-dll.tar.gz/download mingw-runtime  dll]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/mpc/mpc-0.8.1-1/mpc-0.8.1-1-mingw32-dev.tar.lzma/download mpc dev]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/mpc/mpc-0.8.1-1/libmpc-0.8.1-1-mingw32-dll-2.tar.lzma/download mpc dll]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/mpfr/mpfr-2.4.1-1/mpfr-2.4.1-1-mingw32-dev.tar.lzma/download mpfr dev]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/mpfr/mpfr-2.4.1-1/libmpfr-2.4.1-1-mingw32-dll-1.tar.lzma/download mpfr dll]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/pthreads-w32/pthreads-w32-2.8.0-3/pthreads-w32-2.8.0-3-mingw32-dev.tar.lzma/download pthreads dev]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/pthreads-w32/pthreads-w32-2.8.0-3/libpthread-2.8.0-3-mingw32-dll-2.tar.lzma/download pthreads dll]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/gcc/Version4/gcc-4.6.2-1/libssp-4.6.2-1-mingw32-dll-0.tar.lzma/download ssp]
*[http://sourceforge.net/projects/mingw/files/MinGW/Base/w32api/w32api-3.17/w32api-3.17-2-mingw32-dev.tar.lzma/download w32api]
 
Download MSYS and the MSYS Developer Tools:
 
*[http://sourceforge.net/projects/mingw/files/MSYS/Base/msys-core/msys-1.0.11/MSYS-1.0.11.exe/download MSYS 1.0.11]
*[http://sourceforge.net/projects/mingw/files/Other/Unsupported/MSYS/msysDTK/msysDTK-1.0.1/msysDTK-1.0.1.exe/download msysDTK]
 
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 the latest Development Libraries file for Mingw32.
 
* [http://www.nasm.us/pub/nasm/releasebuilds/?C=M;O=D NASM] Optional, for faster compile of scalers
** You need the latest Win32 binary ([http://www.nasm.us/pub/nasm/releasebuilds/2.10.07/win32/ 2.10.07] at the time of writing).
 
* [http://flac.sourceforge.net/download.html FLAC]. Optional, for FLAC support
** You need the latest flac source code.


* [http://downloads.xiph.org/releases/ogg/ libogg] and [http://downloads.xiph.org/releases/vorbis/ libvorbis] Optional, for OGG support
* [http://downloads.xiph.org/releases/ogg/ libogg] and [http://downloads.xiph.org/releases/vorbis/ libvorbis] Optional, for OGG support
** You need the latest libogg and libvorbis (not vorbis) source code.
** You need the latest libogg source code ([https://downloads.xiph.org/releases/ogg/libogg-1.3.4.tar.xz v1.3.4] at the time of writing).
** You need the latest libvorbis (not vorbis) source code ([https://downloads.xiph.org/releases/vorbis/libvorbis-1.3.7.tar.xz v1.3.7] at the time of writing).


* [ftp://ftp.mars.org/pub/mpeg/ libmad] Optional, for MP3 support
* [ftp://ftp.mars.org/pub/mpeg/ libmad] Optional, for MP3 support
** You need the latest libmad source code.
** You need the latest libmad source code ([ftp://ftp.mars.org/pub/mpeg/libmad-0.15.1b.tar.gz v0.15.1b] at the time of writing).


* [http://libmpeg2.sourceforge.net/ libmpeg2] Optional, for MPEG2 cutscene support.
* [http://libmpeg2.sourceforge.net/ libmpeg2] Optional, for MPEG2 cutscene support.
** You need the latest libmpeg2 source code, currently v0.5.1.
** You need the latest libmpeg2 source code, ([http://libmpeg2.sourceforge.net/files/libmpeg2-0.5.1.tar.gz v0.5.1] at the time of writing).
 
* [http://www.zlib.net/ zlib]. Optional, for compressed saved games.
** You need the latest zlib source code.


* [http://downloads.xiph.org/releases/theora/ libtheora]. Optional, for Broken Sword 2.5.
* [http://downloads.xiph.org/releases/theora/ libtheora]. Optional, for Broken Sword 2.5.
** You need the latest libtheora source code.
** You need the latest libtheora source code ([https://downloads.xiph.org/releases/theora/libtheora-1.1.1.tar.bz2 v1.1.1] at the time of writing).


* [http://www.audiocoding.com/downloads.html libfaad2]. Optional, for AAC support.
* [https://github.com/knik0/faad2 libfaad2]. Optional, for AAC support.
** You need the latest libfaad2 source code.
** You need the latest libfaad2 source code ([https://github.com/knik0/faad2/releases/tag/2_9_2 v2.9.2] at the time of writing).


* [http://www.libpng.org/pub/png/libpng.html libpng]. Optional, for PNG support.
* [http://www.libpng.org/pub/png/libpng.html libpng]. Optional, for PNG support.
** You need the latest libpng source code.
** You need the latest libpng source code ([https://download.sourceforge.net/libpng/libpng-1.6.37.tar.xz v1.6.37] at the time of writing).


* [http://download.savannah.gnu.org/releases/freetype/ freetype]. Optional, for TTF support.
* [http://download.savannah.gnu.org/releases/freetype/ freetype]. Optional, for TTF support.
** You need the latest freetype source code.
** You need the latest freetype source code ([http://download.savannah.gnu.org/releases/freetype/freetype-2.10.2.tar.xz v2.10.2] at the time of writing).
 
* [http://www.fluidsynth.org/ fluidsynth]. Optional, for soundfont MIDI support.
** You need at least [https://sourceforge.net/projects/fluidsynth/files/older%20releases/fluidsynth-1.0.9.tar.gz/download v1.0.9]. Newer versions than this should work, but require GTK's glib and CMAKE to build.


* [http://sourceforge.net/apps/trac/fluidsynth fluidsynth]. Optional, for soundfont MIDI support.
* [https://github.com/fribidi/fribidi FriBiDi]. Optional, for bidirectional text in languages that need it (e.g. Hebrew)
** You need at least v1.0.9. Newer versions than this should work, but require GTK's glib and CMAKE to build.
** You need the latest FriBiDi source code ([https://github.com/fribidi/fribidi/releases/tag/v1.0.10 v1.0.10] at the time of writing).
 
* [https://libjpeg-turbo.org/ libjpeg-turbo]. Optional, for JPEG support.
** You need the latest libjpeg-turbo source code ([https://sourceforge.net/projects/libjpeg-turbo/files/2.0.5/libjpeg-turbo-2.0.5.tar.gz/download v2.0.5] at the time of writing).
 
* [http://liba52.sourceforge.net/ liba52]. Optional, for AC-3 support.
** You need the latest liba52 source code ([http://liba52.sourceforge.net/files/a52dec-0.7.4.tar.gz v0.7.4] at the time of writing).
 
* [https://curl.haxx.se/ libcurl]. Optional, for cloud support.
** You need the latest libcurl source code ([https://curl.haxx.se/download/curl-7.71.1.tar.xz v7.71.1] at the time of writing).


==== Precompiled libraries ====
==== Precompiled libraries ====
Line 187: Line 75:
All you need to do is:
All you need to do is:
* Download the precompiled libraries and the [http://www.libsdl.org/release/SDL-1.2.15-win32.zip latest SDL runtime library] - latest version is 1.2.15 at the time this was written, you can find the latest version [http://www.libsdl.org/download-1.2.php here]. Precompiled libraries:
* Download the precompiled libraries and the [http://www.libsdl.org/release/SDL-1.2.15-win32.zip latest SDL runtime library] - latest version is 1.2.15 at the time this was written, you can find the latest version [http://www.libsdl.org/download-1.2.php here]. Precompiled libraries:
** [http://sourceforge.net/projects/scummvm/files/build/scummvm-required-libs-mingw.zip/download Precompiled libraries]
** [http://www.scummvm.org/frs/build/scummvm-required-libs-mingw.zip Precompiled libraries]
* Extract them to your MinGW directory (e.g. C:\MinGW)


=== Installing MinGW and MSYS ===
== Additional information about MinGW and Windows Vista ==
 
Both MinGW and MSYS need to be installed and working to compile ScummVM.
 
* Create a directory called mingw in the root directory of drive (ie C:\MinGW\ )
* Extract all the mingw packages to the mingw directory
* Then, install MSYS. After installation, a new console window will appear, asking if you wish to proceed with the post install. Answer 'y' to that prompt. You will then be asked if you have MinGW installed. Answer 'y' to that and then type in the path of your MinGW directory using forward slashes (e.g. C:/MinGW). Make sure that there is no "make" utility in the MinGW bin folder, as this will clash with the make utility in MSYS. With the recent packages described in the section above, you shouldn't have that problem.
* After both MinGW and MSYS are installed correctly, install MSYS DTK
 
 
==== 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 206: Line 85:
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 240: Line 119:




=== 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".  
Unzip the nasm archive in a folder, and copy both files to MinGW's bin directory.


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 ====
=== pkg-config-lite ===


SDL is already compiled and needs no further changes, so we can skip the compilation step for it
Unzip the pkg-config-lite archive in a folder, and copy the "bin" and "share" to MinGW's root directory.


After extracting the contents of the SDL archive in a folder, copy all the files in the 'include/SDL' folder to MinGW's include folder, copy all the files in the 'lib' folder to MinGW's lib folder and copy all the files in the 'bin' folder to MinGW's bin folder.


If you do wish to recompile SDL from source code, please note the following:
=== SDL ===
* Check that the libSDL source file src/main/win32/version.rc contains the correct version. This was incorrectly listed as v1.2.14 for the v1.2.15 release, needed an additional patch.
* 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 SDL archive in a folder, open MSYS, go to the SDL folder and issue these commands to compile and install the library:


Unzip the source code in a folder, open MSYS, go to the zlib folder and issue this command to compile the library:
  ./configure --disable-shared --prefix=/mingw
 
make
  make -f win32/makefile.gcc
make install
 
After compilation, copy '''zlib.h''' and '''zconf.h''' inside MinGW's include folder and libz.a inside MinGW's lib folder


It may be necessary to modify the bin/sdl-config and lib/pkgconfig/sdl.pc files  (located under the mingw directory) which are just text. These files provide the compiler option information to ScummmVM and SDL is passing the -mwindows compiler option by default which will result in a valid executable, but with broken console / command-line output. These should be removed or replaced by -mconsole (though this will affect all SDL compiled binaries made by the MinGW toolchain). ScummVM's configure script should deal automatically with this issue in future as the upstream SDL project has indicated that removing this "forced" option is a WONTFIX issue.


You can do this using Explorer or by typing these commands in MSYS inside the zlib folder:
Note the README [http://www.libsdl.org/extras/win32/mingw32/README.txt here], especially the need to include the DirectX development headers 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.


cp -p libz.a /mingw/lib
cp -p zlib.h zconf.h /mingw/include


=== libogg ===


==== libogg ====
libogg should be compiled before libvorbis, libtheora and libFLAC.


libogg should be compiled before libvorbis and libFLAC
Unzip the libogg archive in a folder, open MSYS, go to the libogg folder and issue these commands to compile and install the library:
Unzip the libogg archive in a folder, open MSYS, go to the libogg folder and issue these commands to compile the library:


  ./configure --disable-shared --prefix=/mingw
  ./configure --disable-shared --prefix=/mingw
  make
  make
make install


To install the library, type:
make install prefix=/mingw


=== libvorbis ===


==== libvorbis ====
Unzip the libvorbis archive in a folder, open MSYS, go to the libvorbis folder and issue these commands to compile and install the library:
 
Unzip the libvorbis archive in a folder, open MSYS, go to the libvorbis folder and issue these commands to compile the library:


  ./configure --disable-shared --prefix=/mingw
  ./configure --disable-shared --prefix=/mingw
  make
  make
 
  make install
To install the library, type:
  make install prefix=/mingw




==== 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:
  sed -i '/-fforce-mem/d' configure
  sed -i '/-fforce-mem/d' configure


Then issue these commands to compile the library:
Then issue these commands to compile and install the library:
  ./configure --disable-shared --prefix=/mingw
  ./configure --disable-shared --prefix=/mingw
  make
  make
 
  make install
To install the library, type:
  make install prefix=/mingw




==== 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 and issue these commands to compile and install the library:
 
sed -i -e '/AC_C_ALWAYS_INLINE/d' -e 's/-mcpu/-mtune/' configure.ac
Then issue these commands to compile the library:
./bootstrap
  ./configure --disable-sdl --disable-shared --prefix=/mingw
  ./configure --disable-sdl --disable-shared --prefix=/mingw
  make
  make
make install


To install the library, type:
make install prefix=/mingw
Note that if you are compiling x64 i.e. for a 64-bit target, then currently (v0.5.1), the following patch is needed:
<syntax type="diff">
--- libvo/video_out_dx.c.orig  2014-02-17 16:38:24.000000000 +0100
+++ libvo/video_out_dx.c        2014-02-17 16:39:34.000000000 +0100
@@ -92,7 +92,7 @@
    switch (message) {
    case WM_WINDOWPOSCHANGED:
-      instance = (dx_instance_t *) GetWindowLong (hwnd, GWL_USERDATA);
+      instance = (dx_instance_t *) GetWindowLongPtr (hwnd, GWLP_USERDATA);
        /* update the window position and size */
        point_window.x = 0;
@@ -173,7 +173,7 @@
    /* store a directx_instance pointer into the window local storage
      * (for later use in event_handler).
      * We need to use SetWindowLongPtr when it is available in mingw */
-    SetWindowLong (instance->window, GWL_USERDATA, (LONG) instance);
+    SetWindowLongPtr (instance->window, GWLP_USERDATA, (LONG) instance);
    ShowWindow (instance->window, SW_SHOW);
</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 and install the library:


  ./configure --disable-shared --prefix=/mingw
  ./configure --disable-shared --prefix=/mingw
  make
  make
make install


To install the library, type:
make install prefix=/mingw


 
=== 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 363: Line 203:
Unzip the fluidsynth archive in a folder, open MSYS, go to the fluidsynth folder and apply the following patch:
Unzip the fluidsynth archive in a folder, open MSYS, go to the fluidsynth folder and apply the following patch:


<syntax type="diff">
<syntaxhighlight lang="diff">
--- include/fluidsynth.h
--- include/fluidsynth.h
+++ include/fluidsynth.h
+++ include/fluidsynth.h
Line 381: Line 221:
  #elif defined(MACOS9)
  #elif defined(MACOS9)
  #define FLUIDSYNTH_API __declspec(export)
  #define FLUIDSYNTH_API __declspec(export)
</syntax>
--- fluidsynth.pc.in
+++ fluidsynth.pc.in
@@ -7,4 +7,5 @@
Description: Software SoundFont synth
Version: @VERSION@
Libs: -L${libdir} -lfluidsynth
+Libs.private: @LIBFLUID_LIBS@
Cflags: -I${includedir}
</syntaxhighlight>
 
Then issue these commands to compile and install the library:
./configure --disable-shared --prefix=/mingw
make
make install
 
 
=== libpng ===
 
Unzip the libpng archive in a folder, open MSYS, go to the libpng folder and issue these commands to compile and install the library:
 
./configure --disable-shared --prefix=/mingw
make pnglibconf.h
sed -i 's/\x0D//' pnglibconf.h
make
make install
 
 
=== libtheora ===
 
Unzip the libtheora archive in a folder, open MSYS, go to the libtheora folder and issue these commands to compile and install the library:
 
./configure --disable-shared --disable-examples --prefix=/mingw
make
make install
 
 
=== libfaad2 ===


Then issue these commands to compile the library:
Unzip the libfaad2 archive in a folder, open MSYS, go to the libfaad2 folder and issue these commands to compile and install the library:
./bootstrap
  ./configure --disable-shared --prefix=/mingw
  ./configure --disable-shared --prefix=/mingw
  make
  make
make install


To install the library, type:
make install prefix=/mingw


==== libpng ====
=== freetype ===


Unzip the libpng archive in a folder, open MSYS, go to the libpng 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 and install the library:


  ./configure --disable-shared --prefix=/mingw
  ./configure --disable-shared --prefix=/mingw
  make
  make
make install


To install the library, type:
make install prefix=/mingw


=== fribidi ===


==== libtheora ====
Unzip the fribidi archive in a folder, open MSYS, go to the fribidi folder and apply the following patch:


Unzip the libtheora archive in a folder, open MSYS, go to the libtheora folder and issue these commands to compile the library:
<syntaxhighlight lang="diff">
--- fribidi.pc.in.orig  2020-07-05 20:17:23 +0100
+++ fribidi.pc.in      2020-08-30 17:17:43 +0100
@@ -9,5 +9,4 @@
Description: Unicode Bidirectional Algorithm Library
Version: @VERSION@
Libs: -L${libdir} -lfribidi
-Cflags: -I${includedir}/@PACKAGE@
-CFLAGS.private: -DFRIBIDI_LIB_STATIC
+Cflags: -I${includedir}/@PACKAGE@ -DFRIBIDI_LIB_STATIC
</syntaxhighlight>


  ./configure --disable-shared --disable-examples --prefix=/mingw
Then issue these commands to compile and install the library:
 
  ./configure --disable-shared --prefix=/mingw
  make
  make
make install


To install the library, type:
make install prefix=/mingw


=== libjpeg-turbo ===


==== libfaad2 ====
Unzip the libjpeg-turbo archive in a folder, open MSYS, go to the libjpeg-turbo folder and issue these commands to compile and install the library:


Unzip the libfaad2 archive in a folder, open MSYS, go to the libfaad2 folder and apply the following patch:
cmake -G "MSYS Makefiles" -DENABLE_SHARED=OFF -DCMAKE_INSTALL_PREFIX=$PREFIX -DCMAKE_BUILD_TYPE=Release .
make
make install


<syntax type="diff">
--- frontend/main.c
+++ frontend/main.c
@@ -31,7 +31,9 @@
#ifdef _WIN32
#define WIN32_LEAN_AND_MEAN
#include <windows.h>
+#ifndef __MINGW32__
#define off_t __int64
+#endif
#else
#include <time.h>
#endif
</syntax>


Then issue these commands to compile the library:
=== liba52 ===
 
Unzip the liba52 archive into a folder, open MSYS, go to the liba52 folder and issue these commands to compile and install the library:
 
rm -f autotools/{config.guess,config.sub,install-sh,ltmain.sh,missing,mkinstalldirs} {autotools,doc,include,liba52,libao,src,test,vc++,.}/Makefile.in include/config.h.in include/stamp-h.in aclocal.m4 configure
sed -i -e '/AC_C_ALWAYS_INLINE/d' -e 's/-mcpu/-mtune/' configure.in
autoreconf -fi
  ./configure --disable-shared --prefix=/mingw
  ./configure --disable-shared --prefix=/mingw
  make
  make
make install


To install the library, type:
=== SDL_net ===
make install prefix=/mingw


Unzip the SDL_net archive in a folder, open MSYS, go to the SDL_net folder and apply the following patch:


==== freetype ====
<syntaxhighlight lang="diff">
--- SDL_net.pc.in.orig  2012-01-15 16:20:10 +0000
+++ SDL_net.pc.in      2020-08-30 17:42:19 +0100
@@ -7,5 +7,5 @@
Description: net library for Simple DirectMedia Layer
Version: @VERSION@
Requires: sdl >= @SDL_VERSION@
-Libs: -L${libdir} -lSDL_net
+Libs: -L${libdir} -lSDL_net @INETLIB@
Cflags: -I${includedir}/SDL
</syntaxhighlight>


Unzip the freetype archive in a folder, open MSYS, go to the freetype folder and issue these commands to compile the library:
Then issue these commands to compile and install the library:


  ./configure --disable-shared --prefix=/mingw
  ./configure --disable-shared --prefix=/mingw
  make
  make
make install


To install the library, type:
=== libcurl ===
make install prefix=/mingw


=== Compiling ScummVM ===
Unzip the curl archive in a folder, open MSYS, go to the curl folder and issue these commands to compile and install the library:
 
./configure --disable-shared --prefix=/mingw --with-winssl --disable-pthreads --disable-ldap
make
make install
 
 
== 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 458: Line 360:


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

Revision as of 18:35, 30 August 2020

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 MinGW homepage

Things needed

MinGW and MSYS

  • Download and install the latest MinGW Installation Manager (mingw-get-setup.exe)
  • From the list of packages shown, check mingw-developer-toolkit-bin, mingw32-base-bin and mingw32-gcc-g++-bin, as well as mingw32-libz-dev from the "MinGW Libraries" section (right-click > Mark for Installation)
  • Click the Installation > Apply Changes menu to install MinGW and MSYS
  • Once installation is complete, you can run MSYS from inside the MinGW directory (by default C:\MinGW\msys\1.0\msys.bat)

Libraries needed

  • SDL 1.2.
    • You need the latest SDL 1.2 source code revision from Mercurial (1bffae6992b0 at the time of writing).
  • SDL_net 1.2. Optional, for network support.
    • You need the latest SDL_net source code (v1.2.8 at the time of writing).
  • NASM. Optional, for faster compile of scalers
    • You need the latest Win32 binary (v2.15.03 at the time of writing).
  • CMake. Optional, for compiling libjpeg-turbo.
    • You need the latest Win32 installer.
  • FLAC. Optional, for FLAC support
    • You need the latest flac source code (v1.3.3 at the time of writing).
  • libogg and libvorbis Optional, for OGG support
    • You need the latest libogg source code (v1.3.4 at the time of writing).
    • You need the latest libvorbis (not vorbis) source code (v1.3.7 at the time of writing).
  • libmad Optional, for MP3 support
    • You need the latest libmad source code (v0.15.1b at the time of writing).
  • libmpeg2 Optional, for MPEG2 cutscene support.
    • You need the latest libmpeg2 source code, (v0.5.1 at the time of writing).
  • libtheora. Optional, for Broken Sword 2.5.
    • You need the latest libtheora source code (v1.1.1 at the time of writing).
  • libfaad2. Optional, for AAC support.
    • You need the latest libfaad2 source code (v2.9.2 at the time of writing).
  • libpng. Optional, for PNG support.
    • You need the latest libpng source code (v1.6.37 at the time of writing).
  • freetype. Optional, for TTF support.
    • You need the latest freetype source code (v2.10.2 at the time of writing).
  • fluidsynth. Optional, for soundfont MIDI support.
    • You need at least v1.0.9. Newer versions than this should work, but require GTK's glib and CMAKE to build.
  • FriBiDi. Optional, for bidirectional text in languages that need it (e.g. Hebrew)
    • You need the latest FriBiDi source code (v1.0.10 at the time of writing).
  • libjpeg-turbo. Optional, for JPEG support.
    • You need the latest libjpeg-turbo source code (v2.0.5 at the time of writing).
  • liba52. Optional, for AC-3 support.
    • You need the latest liba52 source code (v0.7.4 at the time of writing).
  • libcurl. Optional, for cloud support.
    • You need the latest libcurl source code (v7.71.1 at the time of writing).

Precompiled libraries

To ease the whole process, a package of all the needed precompiled libraries has been created. All you need to do is:

  • Download the precompiled libraries and the latest SDL runtime library - latest version is 1.2.15 at the time this was written, you can find the latest version here. Precompiled libraries:
  • Extract them to your MinGW directory (e.g. C:\MinGW)

Additional information about MinGW and Windows Vista

In order to get MinGW properly working under Windows Vista, you need to do the following: Go to Control Panel->System, and click on "Advanced System Settings" to the left. Then click on "Environment variables" and on the bottom window ("System variables"), select the "Path" variable and edit it. This variable tells windows where to look for binaries when it can't find them in the current folder. You'll find a lot of directories there separated by semicolons.

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".


For more information, check the MinGW FAQ page


MSYS commands can be confusing for people using Windows, as MSYS emulates a Bourne shell environment, which is found in most Unix/Linux distributions. The available commands can be viewed by typing "help" in the command prompt. Help on a specific command is available by typing "help" followed by the command, e.g. "help alias".


Note that MSYS uses forward slashes between folder names, not backward slashes, as is the case with Windows. Additionally, some special characters like the space need to be escaped with a backward slash("\"). Drives are mounted to folders, so drive "C:" would be under folder "/c". Therefore, to switch to directory:

C:\Program Files\Test Folder

we would switch to:

/c/Program\ Files/Test\ Folder

The basic commands you'll need are:


cd - changes the current drive and directory
pwd - shows the current drive and directory
ls - lists files in a folder
make - makefile, used to compile projects
strip - remove debug information from executable files


Note that if you wish to run a file from the current folder, you need to specify it before the file name, i.e. if you wish to run "test" from the current folder, you should type:

./test


Building the libraries

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


NASM

Unzip the nasm archive in a folder, and copy both files to MinGW's bin directory.


pkg-config-lite

Unzip the pkg-config-lite archive in a folder, and copy the "bin" and "share" to MinGW's root directory.


SDL

Unzip the SDL archive in a folder, open MSYS, go to the SDL folder and issue these commands to compile and install the library:

./configure --disable-shared --prefix=/mingw
make
make install

It may be necessary to modify the bin/sdl-config and lib/pkgconfig/sdl.pc files (located under the mingw directory) which are just text. These files provide the compiler option information to ScummmVM and SDL is passing the -mwindows compiler option by default which will result in a valid executable, but with broken console / command-line output. These should be removed or replaced by -mconsole (though this will affect all SDL compiled binaries made by the MinGW toolchain). ScummVM's configure script should deal automatically with this issue in future as the upstream SDL project has indicated that removing this "forced" option is a WONTFIX issue.

Note the README here, especially the need to include the DirectX development headers from here to ensure that the "dsound" rather than the "waveout" / "winmm" fallback audio driver is used.


libogg

libogg should be compiled before libvorbis, libtheora and libFLAC.

Unzip the libogg archive in a folder, open MSYS, go to the libogg folder and issue these commands to compile and install the library:

./configure --disable-shared --prefix=/mingw
make
make install


libvorbis

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

./configure --disable-shared --prefix=/mingw
make
make install


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:

sed -i '/-fforce-mem/d' configure

Then issue these commands to compile and install the library:

./configure --disable-shared --prefix=/mingw
make
make install


libmpeg2

Unzip the libmpeg2 archive into a folder, open MSYS, go to the libmpeg2 folder and issue these commands to compile and install the library:

sed -i -e '/AC_C_ALWAYS_INLINE/d' -e 's/-mcpu/-mtune/' configure.ac
./bootstrap
./configure --disable-sdl --disable-shared --prefix=/mingw
make
make install


FLAC

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

./configure --disable-shared --prefix=/mingw
make
make install


FluidSynth

We use fluidsynth 1.0.9, since later versions requires GTK.

Unzip the fluidsynth archive in a folder, open MSYS, go to the fluidsynth folder and apply the following patch:

--- include/fluidsynth.h
+++ include/fluidsynth.h
@@ -28,13 +28,7 @@
 #endif
 
 #if defined(WIN32)
-#if defined(FLUIDSYNTH_DLL_EXPORTS)
-#define FLUIDSYNTH_API __declspec(dllexport)
-#elif defined(FLUIDSYNTH_NOT_A_DLL)
-#define FLUIDSYNTH_API 
-#else
-#define FLUIDSYNTH_API __declspec(dllimport)
-#endif
+#define FLUIDSYNTH_API
 
 #elif defined(MACOS9)
 #define FLUIDSYNTH_API __declspec(export)
--- fluidsynth.pc.in
+++ fluidsynth.pc.in
@@ -7,4 +7,5 @@
 Description: Software SoundFont synth
 Version: @VERSION@
 Libs: -L${libdir} -lfluidsynth
+Libs.private: @LIBFLUID_LIBS@
 Cflags: -I${includedir}

Then issue these commands to compile and install the library:

./configure --disable-shared --prefix=/mingw
make
make install


libpng

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

./configure --disable-shared --prefix=/mingw
make pnglibconf.h
sed -i 's/\x0D//' pnglibconf.h
make
make install


libtheora

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

./configure --disable-shared --disable-examples --prefix=/mingw
make
make install


libfaad2

Unzip the libfaad2 archive in a folder, open MSYS, go to the libfaad2 folder and issue these commands to compile and install the library:

./bootstrap
./configure --disable-shared --prefix=/mingw
make
make install


freetype

Unzip the freetype archive in a folder, open MSYS, go to the freetype folder and issue these commands to compile and install the library:

./configure --disable-shared --prefix=/mingw
make
make install


fribidi

Unzip the fribidi archive in a folder, open MSYS, go to the fribidi folder and apply the following patch:

--- fribidi.pc.in.orig  2020-07-05 20:17:23 +0100
+++ fribidi.pc.in       2020-08-30 17:17:43 +0100
@@ -9,5 +9,4 @@
 Description: Unicode Bidirectional Algorithm Library
 Version: @VERSION@
 Libs: -L${libdir} -lfribidi
-Cflags: -I${includedir}/@PACKAGE@
-CFLAGS.private: -DFRIBIDI_LIB_STATIC
+Cflags: -I${includedir}/@PACKAGE@ -DFRIBIDI_LIB_STATIC

Then issue these commands to compile and install the library:

./configure --disable-shared --prefix=/mingw
make
make install


libjpeg-turbo

Unzip the libjpeg-turbo archive in a folder, open MSYS, go to the libjpeg-turbo folder and issue these commands to compile and install the library:

cmake -G "MSYS Makefiles" -DENABLE_SHARED=OFF -DCMAKE_INSTALL_PREFIX=$PREFIX -DCMAKE_BUILD_TYPE=Release .
make
make install


liba52

Unzip the liba52 archive into a folder, open MSYS, go to the liba52 folder and issue these commands to compile and install the library:

rm -f autotools/{config.guess,config.sub,install-sh,ltmain.sh,missing,mkinstalldirs} {autotools,doc,include,liba52,libao,src,test,vc++,.}/Makefile.in include/config.h.in include/stamp-h.in aclocal.m4 configure
sed -i -e '/AC_C_ALWAYS_INLINE/d' -e 's/-mcpu/-mtune/' configure.in
autoreconf -fi
./configure --disable-shared --prefix=/mingw
make
make install


SDL_net

Unzip the SDL_net archive in a folder, open MSYS, go to the SDL_net folder and apply the following patch:

--- SDL_net.pc.in.orig  2012-01-15 16:20:10 +0000
+++ SDL_net.pc.in       2020-08-30 17:42:19 +0100
@@ -7,5 +7,5 @@
 Description: net library for Simple DirectMedia Layer
 Version: @VERSION@
 Requires: sdl >= @SDL_VERSION@
-Libs: -L${libdir} -lSDL_net
+Libs: -L${libdir} -lSDL_net @INETLIB@
 Cflags: -I${includedir}/SDL

Then issue these commands to compile and install the library:

./configure --disable-shared --prefix=/mingw
make
make install


libcurl

Unzip the curl archive in a folder, open MSYS, go to the curl folder and issue these commands to compile and install the library:

./configure --disable-shared --prefix=/mingw --with-winssl --disable-pthreads --disable-ldap
make
make install


Compiling ScummVM

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

./configure
make

After compilation, you'll end up with a very big scummvm.exe (around 16MB). This is because debug symbols and information are embedded by default in the exe file, making it very big. To remove all the unneeded debug information from the executable, thus reducing its size by about 12MB, go to the folder where the compiled scummvm.exe file is and run the following command:

strip scummvm.exe

Ready to go!

OK this should be all of it (thankfully), so you should be good to go.