Windows の Cygwin に Irrlicht をインストール

IRRLICHT 3次元エンジンのインストール手順を説明する．

IRRLICHTは，C言語ベースの3次元エンジンです． IRRLICHT は，画像（カラー，モノクロ）の描画、２次元グラフィックス、３次元グラフィックス，イベント処理（マウス，キーボード等）の機能をもったゲームエンジンです． 文字の描画 (unicodeも可), 画像ファイル読み書きの機能もありますし，スライダやボタンなどのGUI部品もあるので，困ることはありません．

Cygwin の場合のインストール手順です．

* Linux でのインストールについては別のWebページで説明している．

* Visual C++ でのインストールについては別のWebページで説明している．

【関連する外部ページ】: http://lesson.ifdef.jp/index.html ・・・ Irrlicht プログラム集

【関連する外部ページ】 http://www.zgock-lab.net/irrlicht/tut01.htm

【関連する外部ページ】 https://irrlichtstg.ifdef.jp/

【関連する外部ページ】 http://www.realintegrity.net/~irr/index.php?FrontPage

前準備

前もってインストールしておくべきソフトウェア

前もって調べておく事項

Irrlicht のコンパイルに必要なソフトウェア等を Cygwin のパッケージを使ってインストール

Cygwin のセットアッププログラム setup.exe を使って， Irrlicht をソースプログラムからコンパイルするのに必要となるソフトウェアをインストールする．簡単にインストールできる．

  1. セットアッププログラムの開始
  2. パッケージ選択画面（Select Packages）」（下図）まで進む
  3. パッケージ選択画面で，パッケージを選ぶ

    下記のパッケージを選ぶ．

    「keep」と表示されている場合は既にインストール済みであるため，そのままでよい．

    • Archive/unzip
    • Libs/libjpeg-devel
    • Libs/libpng12-devel
    • Libs/zlib-devel
    • X11R6（カテゴリ全体）
  4. 終了の確認

インストール手順

  1. 最新版（Irrlicht SDK 1.5.1)を次のアドレスからダウンロードして展開（解凍）する

    https://irrlicht.sourceforge.io/downloads.html

  2. ダウンロードしたファイル irrlicht-1.5.1.zip を /usr/local に置く
  3. ファイルの解凍 
    unzip irrlicht-1.5.1.zip
  4. include/IrrCompileConfig.h の書き換え

    Cygwin環境では一部の機能がサポートされていないため，以下の行をコメントアウトする．

    • 「_IRR_LINUX_X11_VIDMODE_」 の行の先頭に「//」を追加（ビデオモード切替機能の無効化）
    • 「_IRR_COMPILE_WITH_JOYSTICK_SUPPORT」の行の先頭に「//」を追加（ジョイスティックサポートの無効化）
  5. source/Irrlicht/CGUISpinBox.cpp の書き換え

    swprintf の部分でコンパイル時にエラーが出るので，（暫定的な対処であり根本的な解決策ではないが）次のように書き換える．

    * 書き換え前 

         wchar_t str[100]

     swprintf(str, 99, FormatString.c_str(), val)

    * 書き換え後 

        wchar_t str[100];

    sprintf((char*)str, (char*)FormatString.c_str(), val);
  6. ビルドとインストール 
    cd irrlicht-1.5.1
cd source
cd Irrlicht
make
cp ../../lib/Linux/libIrrlicht.a /usr/local/lib
su
make install

    * su コマンドで管理者（root）権限に切り替えた後，make install を実行する．管理者パスワードの入力が求められる．

付属のサンプルプログラム

* サンプルプログラムのビルド 

cd /usr/local/irrlicht-1.5.1/examples/
for i in */Makefile; do
    echo $i
    cat $i | sed 's/-lXxf86vm//g' > /tmp/hoge
    cp /tmp/hoge $i
done
sh ./buildAllExamples.sh

* 上記のスクリプトは，各サンプルのMakefileから -lXxf86vm オプションを削除している．これはCygwin環境でこのライブラリが利用できないためである．

* テストプログラム 01.HelloWorld の実行例 

startx
echo Open Sample Program 01 ...
cd /usr/local/irrlicht-1.5.1/bin/Linux
./01.HelloWorld

* startx コマンドでX Window Systemを起動してから，サンプルプログラムを実行する．

* テストプログラム 04.Movement の実行例 

startx
echo Open Sample Program 04 ...
cd /usr/local/irrlicht-1.5.1/bin/Linux
./04.Movement