Table of Contents
1 Linuxの場合
1.1 ubuntu-14.04
SDL2のパッケージが用意されているのでそれを使います。
sudo apt-get install -y libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-net-dev libsdl2-ttf-dev
1.2 ubuntu-12.04
SDL2のパッケージが用意されていないので、自分でビルドしてインストールします。
SDLのビルド環境を利用して、SDL2のビルド環境を整えます。
sudo apt-get build-dep -y libsdl1.2-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsdl-net1.2-dev libsdl-ttf2.0-dev
SDL2のソースコードを取得します。
wget https://www.libsdl.org/projects/SDL_ttf/release/SDL2_ttf-2.0.12.tar.gz
SDL2-2.0.3をビルドしてインストールします。
configureで–prefixを指定しない場合、/usr/localディレクトリ配下にインストールされます。
tar zxvf SDL2-2.0.3.tar.gzcd SDL2-2.0.3./configure && make && sudo make install
SDL2-2.0.3をインストールすることで、他のパッケージも同様にconfigure、make、sudo make installでインストールできます。
1.3 SDL2がない他のディストリビューション
SDL2がないディストリビューションでも、ubuntu-12.04のように、SDLのビルド環境を利用すれば、SDL2のビルドは容易です。
2 osxの場合
portやhomebrewでインストールします。
sudo port install libsdl2 libsdl2_image libsdl2_mixer libsdl2_net libsdl2_ttf
SDL2のサイトからdmgファイルをダウンロードしてインストールすることも可能ですが、sdl2-configが含まれておらず、コンパイル時にインクルードパスとライブラリの設定を追加する必要がある為、portやhomebrewの方をお勧めします。
3 Windowsの場合
MinGWとVisual Studioを用いる方法があります。
ここではMinGWとeclipseを用いた方法を説明します。
3.1 MinGW
MinGWはgcc、g++、make等のツールチェインを提供するものです。
sdl2-configはUnix系シェルスクリプトで記述されている為、別途bash等が必要で、Cygwinをインストールする必要があります。
sdl2-configを使用せず、コンパイル時に自分でインクルードパスとライブラリのパスを設定すればCygwinは必要になりません。
今回はeclipseの設定でインクルードパスとライブラリのパスを設定します。
3.2 MinGWのインストール
MinGWをダウンロードページから入手します。
インストーラを起動します。パスはデフォルトだとC:MinGWになります。
Continueを２回押すと、パッケージの選択画面になります。ここでg++等を選択し、Apply Changesを実行します。実行後、再度Applyボタンを押せばインストールが開始されます。
環境変数PathにC:MinGWbinを追加しておきます。
環境変数Pathを反映する為、一度マシンを再起動します。
3.3 JDKのインストール
eclipseはJavaで動作している為、JDKをインストールする必要があります。
JDKのダウンロードページからWindows向けのインストーラを入手します。
インストーラのガイドに沿ってインストールを完了させます。
3.4 SDL2のインストール
SDL2、SDL2_image、SDL2_mixer、SDL2_net、SDL2_ttfのページからMinGW開発用のアーカイブをダウンロードします。
各アーカイブを展開すると、i686-w64-mingw32とx86_64-w64-mingw32というフォルダが生成されています。
BUGS.txt INSTALL.txt README.txt includex86_64-w64-mingw32COPYING.txt Makefile WhatsNew.txt libCREDITS.txt README-SDL.txt i686-w64-mingw32 test
私の環境ではi686-w64-mingw32を使用しました。
i686が32bit用、x86_64が64bit用だと思うのですが、上記のMinGWインストーラでインストールされるコンパイラが32bitのものであるようで、i686でないとリンクエラーになってしまいました。
i686-w64-mingw32フォルダの中身を一つのフォルダにまとめます（それぞれのフォルダに対して、インクルードパスとライブラリのパスを個別に設定するならば、別々でも構いません）。
まとめると以下のようになります（i686-w64-mingw32をSDLという名前に変更してます）。
eclipseにて、このフォルダのincludeにインクルードパスを、libにライブラリのパスを設定します。また、binは実行時に必要なdllが格納されています。
SDL├── bin│ ├── LICENSE.FLAC.txt│ ├── LICENSE.freetype.txt│ ├── LICENSE.jpeg.txt│ ├── LICENSE.mikmod.txt│ ├── LICENSE.modplug.txt│ ├── LICENSE.ogg-vorbis.txt│ ├── LICENSE.png.txt│ ├── LICENSE.smpeg.txt│ ├── LICENSE.tiff.txt│ ├── LICENSE.webp.txt│ ├── LICENSE.zlib.txt│ ├── SDL2.dll│ ├── SDL2_image.dll│ ├── SDL2_mixer.dll│ ├── SDL2_net.dll│ ├── SDL2_ttf.dll│ ├── libFLAC-8.dll│ ├── libfreetype-6.dll│ ├── libjpeg-9.dll│ ├── libmikmod-2.dll│ ├── libmodplug-1.dll│ ├── libogg-0.dll│ ├── libpng16-16.dll│ ├── libtiff-5.dll│ ├── libvorbis-0.dll│ ├── libvorbisfile-3.dll│ ├── libwebp-4.dll│ ├── sdl2-config│ ├── smpeg2.dll│ └── zlib1.dll├── include│ └── SDL2│ ├── SDL.h│ <snip>│ └── close_code.h├── lib│ ├── libSDL2.a│ ├── libSDL2.dll.a│ ├── libSDL2.la│ ├── libSDL2_image.a│ ├── libSDL2_image.dll.a│ ├── libSDL2_image.la│ ├── libSDL2_mixer.a│ ├── libSDL2_mixer.dll.a│ ├── libSDL2_mixer.la│ ├── libSDL2_net.a│ ├── libSDL2_net.dll.a│ ├── libSDL2_net.la│ ├── libSDL2_test.a│ ├── libSDL2_ttf.a│ ├── libSDL2_ttf.dll.a│ ├── libSDL2_ttf.la│ ├── libSDL2main.a│ └── pkgconfig│ ├── SDL2_image.pc│ ├── SDL2_mixer.pc│ ├── SDL2_net.pc│ ├── SDL2_ttf.pc│ └── sdl2.pc└── share └── aclocal └── sdl2.m4
私の環境ではこのSDLというフォルダをC:Usershiroom2Documentsに格納しています。
3.5 SDL_platform.hの修正
SDL2-2.0.3ではMinGW使用時にSDL_platform.hでコンパイルエラーが出る為、以下の修正を加えます。
本修正はリポジトリにある最新のSDL2では反映済みです。
diff -uprN SDL2-2.0.3.org/x86_64-w64-mingw32/include/SDL2/SDL_platform.h SDL2-2.0.3/x86_64-w64-mingw32/include/SDL2/SDL_platform.h— SDL2-2.0.3.org/x86_64-w64-mingw32/include/SDL2/SDL_platform.h 2014-03-16 11:34:41.000000000 +0900+++ SDL2-2.0.3/x86_64-w64-mingw32/include/SDL2/SDL_platform.h 2015-05-07 16:18:44.000000000 +0900@@ -114,10 +114,10 @@ #define __SOLARIS__ 1 #endif -#if defined(WIN32) || defined(_WIN32) || defined(__CYGWIN__)+#if defined(WIN32) || defined(_WIN32) || defined(__CYGWIN__) || defined(__MINGW32__) /* Try to find out if we’re compiling for WinRT or non-WinRT */ /* If _USING_V110_SDK71_ is defined it means we are using the v110_xp or v120_xp toolset. */-#if defined(__MINGW32__) || (defined(_MSC_VER) && (_MSC_VER >= 1700) && !_USING_V110_SDK71_) /* _MSC_VER==1700 for MSVC 2012 */+#if (defined(_MSC_VER) && (_MSC_VER >= 1700) && !_USING_V110_SDK71_) /* _MSC_VER==1700 for MSVC 2012 */ #include <winapifamily.h> #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP) #undef __WINDOWS__
3.6 eclipseのインストール
eclipseのページからEclipse IDE for C/C++ Developersをダウンロードします。
アーカイブを解凍し、eclipseを起動します。
c++のプロジェクトを作成し、MinGWをコンパイラとして選択します。
プロジェクトのプロパティにて、インクルードパスを追加します。
ライブラリのパスを追加します。
ライブラリを追加します。
mingw32、SDL2main、SDL2の前後関係に注意してください。
SDL_imageはlibjpeg等を前にして、SDL_imageを後にすれば良いでしょう。
他のSDL2プロジェクトも同様だと思います。
Run Configurationsにて、実行時に参照するdllのパスを設定します。
4 ビルドの確認
Linuxとosxの場合はMakefileを利用します。
sdl2-configを用いてインクルードパスとライブラリのパスを設定します。
PROG := $(patsubst %.cc,%,$(wildcard *.cc))CXXFLAGS += -I. -std=c++0x $(EXTRA_CXXFLAGS)CXXFLAGS += $(shell sdl2-config –cflags)LDFLAGS += $(shell sdl2-config –libs)LDLIBS += -lSDL2 -lSDL2_ttf -lSDL2_image -lSDL2_mixer -lpthread -ldlall: $(PROG)clean:$(RM) -rf $(PROG) *.dSYM
以下のソースコードをビルドできるか確認します。
#include <iostream>#include <SDL.h>int main(int argc, char *argv[]){ if (SDL_Init(SDL_INIT_EVERYTHING) < 0) { std::cerr << “SDL_Init: ” << SDL_GetError() << std::endl; return 1; } SDL_Quit(); return 0;}
4.1 main関数とlibSDL2main.aについて
ios、android、windowsの場合、プリプロセッサによってmain関数をSDL_main関数に置き換えられる為、main関数は以下の書式である必要があります。
int main(int argc, char *argv[]) #if defined(SDL_MAIN_NEEDED) || defined(SDL_MAIN_AVAILABLE)#define main SDL_main#endif/** * The prototype for the application’s main() function */extern C_LINKAGE int SDL_main(int argc, char *argv[]);
これはプログラム開始用の関数がmain関数でない処理系の為のものです。
プログラム開始用の関数はlibSDL2main.aで実装されています。
libSDL2main.aで定義されたプログラム開始用の関数からSDL_main関数が呼び出されます。
main関数からプログラムが開始する処理系の場合はlibSDL2main.aを必要としません。
