Compiling using Code::Blocks
Overview:
The ODAMEX Source package comes with a variety of project and workspace files.
This tutorial will show you how to build ODAMEX using the Code::Blocks IDE.
Contents
Step 1: Getting Code::Blocks
You can download Code::Blocks from its website here: Code::Blocks. Be sure to get the 'latest nightly build, and NOT Release Canadate 2 as this is the one that works with the current project files. Don't start codeblocks yet, though.
Step 2: Setting up the compiler
Windows
This step is only required if you are using the Code::Blocks nightly builds. Once an official Code::Blocks package is released (rc3 or 1.0), MinGW will be included with Code::Blocks and you can skip this step.
You need the latest version of MinGW from this website. You need the latest stable versions of the following packages...
- mingw-runtime
- w32api
- binutils
- gcc 3 (gcc-core and gcc-g++)
- gdb (not required, but highly recomended for debugging purposes)
Download all of them and extract them to C:\mingw. If you're using Windows and don't have an archiver capable of handling tar.gz files, stop living in the stone age and download 7-Zip.
Now start Code::Blocks. You should see a dialog box which lists off various compilers. You should see GNU GCC Compiler: Detected, click OK to continue.
Linux
Chances are your linux installation already has all the necessary programs. If not, refer to your individual distribution's installation methods for installing gcc, gnu make and their appropriate libraries.
Step 3: Required Libraries
For ODAMEX to successfully compile, you must obtain some libraries for it, which are:
Windows
Copy the include and lib folders from the archives and paste them into your C:\MinGW directory.
Linux
Refer to your individual distribution's installation methods for installing the SDL and SDL_Mixer development libraries.
Step 4: Getting the source code for ODAMEX
The source code can be obtained through the website or from the SVN repository using a SVN client.
Step 5: Compiling the ODAMEX source code
After you've extracted the source code to a directory, open the workspace file (currently named odamex.workspace) and go to the Build menu and click Rebuild workspace
Step 6: Obtaining the runtime libraries
Once its all built (and no errors have occurred), you should find some binary files located in the bin directory. The only thing that you're likely missing is the SDL and SDL_mixer runtime libraries. Download the appropriate library for your system from here and here. Also, make sure and copy odamex.wad to the bin directory as well.