Installing DeSmuME from source on Linux
Contents |
Supported compilers
On the Linux platform, only the GCC compiler and toolchain is supported.
Pre-requisites
The Linux version of desmume comes in source code form only, and if your distribution does not package it or is packaging an old version you will have to compile the sources yourself. In order to compile desmume from a source tarball you'll need at least these packages:
gcc make libglib2 libgtk2 libglade gettext libsdl zlib intltool agg libasound
If you're compiling from svn, you'll need those one as well:
autoconf automake
If you want 3d engines alternatives to software rasterizer you may install libgtkglext or libosmesa.
On debian you should have all the requirements installed with this command:
sudo apt-get install build-essential autoconf automake libgtk2.0-dev libglu1-mesa-dev libsdl1.2-dev libglade2-dev gettext zlib1g-dev libosmesa6-dev intltool libagg-dev libasound2-dev
desmume requires libgtk 2.10 or higher.
After successful compilation, you can start DeSmuME by running desmume. If you want to enable dynamic JIT recompiler, do this:
desmume --cpu-mode=1
Install desmume from source tarball
Go to http://desmume.org/download/ to check out the latest version of desmume available. At the time of writing the latest stable release of desmume is 0.9.11.
Download the tarball and extract it:
wget http://sourceforge.net/projects/desmume/files/desmume/0.9.11/desmume-0.9.11.tar.gz/download tar xvzf desmume-0.9.11.tar.gz
Or if you don't want to save the archive locally:
wget -O - http://sourceforge.net/projects/desmume/files/desmume/0.9.11/desmume-0.9.11.tar.gz/download | tar xvz
Enter the desmume directory and build the source:
cd desmume-0.9.11 ./configure make sudo make install
If you are not using sudo the last command needs to be run as the root user.
If you want to use offscreen mesa as alternative 3d engine use the ./configure --enable-osmesa instead of just ./configure.
Install desmume from git
Grab the source from https://github.com/TASVideos/desmume
Enter the desmume directory and build the source:
cd desmume/src/frontend/posix/ ./autogen.sh ./configure make sudo make install
If you want to use offscreen mesa as alternative 3d engine use the ./configure --enable-osmesa instead of just ./configure.
If you want to enable HUD display, use ./configure --enable-hud.
Enabling compiler optimizations
If you want to optimize the build on Linux, you should set the C++ compiler options to enable specific optimization for your processor:
You can do this by setting the CFLAGS and CXXFLAGS variables like shown below:
CFLAGS='-O2 -march=native' CXXFLAGS=$CFLAGS ./configure
You may need to set the -march=native for example because by default, gcc under 32-bit Debian builds code that works on the 486 (which doesn't support SSE).
On x86 / x86-64 machines you can squeeze the processor a bit more using:
CXXFLAGS='-O2 -march=native -mfpmath=sse' ./configure
For more optimization options, see Optimization#Linux
Known issues
- If you have a crash on a 64bit environment while disabling/enabling sound during gameplay, deinstall agg (libagg-dev on Debian) and rebuild. This should solve the problem. (Alvin: Is this still applicable?)
- Some people on MacOS X have a broken build environment, mixing pieces from fink / macports / source installation / etc... That is wrong and painful for both the user and the developers who have to sort out build issues. Please don't do that! To workaround the issue you can try passing the needed include paths to autoreconf. Modify autogen.sh adding -B/my/path/ to autoreconf invocation, the path should be -B/sw for fink and -B/opt/local for macports. After the modify rerun ./autogen.sh and ./configure.
