1,502
edits
(Added libvorbis, done some minor fixes to other sections) |
(Several changes, finished instructions for ogg, vorbis, zlib and SDL, MSYS commands added) |
||
Line 33: | Line 33: | ||
Check the "'''Installing MinGW and MSYS'''" section below for instructions on how to create your ScummVM compilation environment | |||
=== Libraries needed === | === Libraries needed === | ||
Line 56: | Line 54: | ||
* [http://www.zlib.net/ zlib]. You need the latest zlib source code. | * [http://www.zlib.net/ zlib]. You need the latest zlib source code. | ||
== Installing MinGW and MSYS == | |||
Both MinGW and MSYS need to be installed and working to compile ScummVM. | |||
First, install MinGW through its automated installer. | |||
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. | |||
== MSYS primer == | |||
[TODO: describe how to navigate through folders, which tools will be used] | |||
Line 75: | Line 88: | ||
After extracting the contents of the SDL archive in a folder, copy all the files in SDL's include folder in MinGW's include folder and all the files in SDL's lib folder in MinGW's lib folder. Also, copy SDL.dll and i386-mingw32msvc-sdl-config in MinGW's bin folder. Rename i386-mingw32msvc-sdl-config to sdl-config | |||
Line 83: | Line 96: | ||
=== zlib === | === zlib === | ||
Unzip the source code in a folder, open MSYS, go to the zlib folder and issue this command to compile the library: | |||
make -f win32/makefile.gcc | |||
After compilation, copy '''zlib.h''' and '''zconf.h''' inside MinGW's include folder and libz.a inside MinGW's lib folder | |||
You can do this using Explorer or by typing these commands in MSYS inside the zlib folder: | |||
cp -p libz.a /mingw/lib | |||
cp -p zlib.h zconf.h /mingw/include | |||
Line 90: | Line 112: | ||
libogg should be compiled before libvorbis 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 the library: | |||
./configure --disable-shared | ./configure --disable-shared | ||
Line 96: | Line 118: | ||
When everything is compiled, copy the include\ogg folder inside MinGW's include folder. So, you should end up with an ogg folder in MinGW's include folder. Also, copy the src\.libs folder as-is inside MinGW's lib folder, and also copy the files from the src\.libs folder inside MinGW's lib folder (because ogg libraries are searched both in the lib and in the lib\.libs folder) | When everything is compiled, copy the include\ogg folder inside MinGW's include folder. So, you should end up with an ogg folder in MinGW's include folder. Also, copy the src\.libs folder as-is inside MinGW's lib folder, and also copy the files from the src\.libs folder inside MinGW's lib folder (because ogg libraries are searched both in the lib and in the lib\.libs folder) | ||
You can do this using Explorer or by typing these commands in MSYS inside the libogg folder: | |||
cp -p include/ogg /mingw/include | |||
cp -p src/.libs /mingw/lib | |||
cp -p src/.libs/* /mingw/lib | |||
=== libvorbis === | === libvorbis === | ||
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 | ./configure --disable-shared | ||
Line 106: | Line 135: | ||
When everything is compiled, copy the include\vorbis folder inside MinGW's include folder. So, you should end up with a vorbis folder in MinGW's include folder. Also, copy lib\.libs folder from libvorbis folder as-is inside MinGW's lib folder, and also copy the files from the lib\.libs folder from libvorbis folder inside MinGW's lib folder (because vorbis libraries are searched both in the lib and in the lib\.libs folder) | When everything is compiled, copy the include\vorbis folder inside MinGW's include folder. So, you should end up with a vorbis folder in MinGW's include folder. Also, copy lib\.libs folder from libvorbis folder as-is inside MinGW's lib folder, and also copy the files from the lib\.libs folder from libvorbis folder inside MinGW's lib folder (because vorbis libraries are searched both in the lib and in the lib\.libs folder) | ||
You can do this using Explorer or by typing these commands in MSYS inside the libogg folder: | |||
cp -p include/vorbis /mingw/include | |||
cp -p src/.libs /mingw/lib | |||
cp -p src/.libs/* /mingw/lib | |||
edits