/*!
  \page devel_win_page Windows

  ライブラリの一部は、SDL に依存しています。\n
  以下では、各ライブラリのインストール方法を説明します。

  - \ref devel_win_vc_section
  - \ref devel_win_mingw_section
  - \ref devel_win_qt_section

  \n
  <hr>
  \section devel_win_vc_section Visual Studio 2005

  \subsection devel_win_vc_sdl Visual Studio への SDL インストール

  - Visual Stduio で SDL を使う方法を説明します。\n
  具体的には、インクルードパスとライブラリパスの設定を行います。
    - まず、SDL を適用する Win32 コンソールアプリケーションのプロジェクトが作成済みとし、main() の中に、include と SDL の関数である SDL_Init() が記述してあるとします。

    \image html vc_main_program.png #include <SDL.h> と SDL_Init(0) を追記

    - SDL_devel.zip をダウンロードし、解凍します。今回は、プロジェクトと同じフォルダに配置します。
      - <a href="SDL_devel.zip">SDL_devel.zip</a>

    \image html sample_and_sdl_folder.png SDL_devel をプロジェクトと同じフォルダに配置

    - 追加のインクルードディレクトリに SDL_devel\\include を追加します。

    \image html vc_add_include.png
    \n

    - 追加のライブラリディレクトリに対し、SDL_devel\\lib を追加します。

    \image html vc_add_lib_path.png
    \n

    - 追加の依存ファイルに対し、SDL.lib SDLmain.lib を追加します。

    \image html vc_add_lib.png
    \n

    - 後は、通常通り、F5 などを押すとビルドされます。
    - プログラム実行時に <strong>「SDL.dll がないためプログラムを実行できません。...」</strong> というエラーがでることがありますが、この問題は、実行ファイルと同じディレクトリに SDL.dll を配置すると解決します。SDL.dll は SDL_devel\\lib にあります。

    \image html add_dll_folder.png
    \n

<!--
  \n
  \subsection devel_win_vc_boost Visual Studio への Boost インストール

  - Boost Consulting 社が、Visual Sdutio 用のインストーラーを無償で配布しています。

  - <a href="http://www.boost-consulting.com/">Boost Consulting 社のサイト</a> のトップページから、<strong>「Products」</strong> -> <strong>「Free Downloads」</strong> と移動することで、ダウンロードページに移動できます。

  \image html boost_vc_setup.png インストーラの実行画面

  - ダウンロードしたインストーラを実行し、指示に従うことでインストールが行えます。
  - インストールした boost フォルダを Visual Studio のインクルードディレクトリに追加することで設定が完了します。
-->

  \n
  <hr>
  \section devel_win_mingw_section MinGW

  MinGW インストールの際には、g++ も指定するようにして下さい。

  \image html mingw_gpp_window.png g++ にもチェックを加える

  \subsection devel_win_mingw_sdl MinGW への SDL インストール

  - <a href="http://www.libsdl.org">SDL のサイト</a> から SDL-1.2.XX.tar.gz などをダウンロードし、コンパイルします  \verbatim
$ tar zxvf SDL-1.2.XX.tar.gz
$ cd SDL-1.2.XX/
$ ./configure --prefix=/mingw && make
$ make install

$ tar zxvf SDL_net-1.2.X.tar.gz
$ cd SDL_net-1.2.X/
$ ./configure --prefix=/mingw && make
$ make install \endverbatim
  また、MinGW でコンパイルしたファイルを実行するためには、SDL.dll が必要です。SDL.dll は MinGW/bin/ にあります。

<!--
  \n
  \subsection devel_win_mingw_boost MinGW への Boost インストール

  - <a href="http://www.boost.org">Boost のサイト</a> から boost-1.34.X などをダウンロードし、コンパイルします。
  \verbatim
$ tar zxvf boost_1_34_X.tar.gz
$ cd boost_1_34_X/
$ configure && make
$ bjam.exe -sTOOLS=mingw --prefix=/mingw install

$ cd /mingw/include/
$ mv boost_1_34_X/boost boost \endverbatim
-->

  \n
  <hr>
  \section devel_win_qt_section Qt

  Qt とは、<a href="http://trolltech.com">Trolltech 社</a>の、マルチプラットフォーム C++ GUI ツールキットです。

  URG プログラミングガイドでは、サンプルのアプリケーションの作成に Qt を使っています。 (ライブラリ付属のサンプルでは利用していません。) \n
  したがって、アプリケーションをソースコードから構築するには、Qt が必要です。

  また、サンプルのアプリケーションでは Boost ライブラリも使っており \ref devel_win_mingw_boost の手順にて、Boost をインストールする必要があります。

  \n
  \subsection devel_win_qt_install Qt のインストール

  Qt には 商用版と Open Source 版がありますが、ここでは Open Source 版のインストール方法を説明します。\n
  Qt 4.5 以降の Open Source 版で作成したアプリケーションには、LGPL ライセンスが適用されます。

  - パッケージのダウンロード
    - <a href="http://trolltech.com/downloads">Trolltech のダウンロードページ</a>
    \n \n
  - パッケージのインストール
    - ライセンス条項に同意した後は、基本的に Next を押すことでインストールが進みます。
    \n \n
    \image html qt_installer_first.png インストーラ画面
    \n \n
    - ただし、MinGW もインストールする場合には、この画面で "Download and install minimal MinGW installation." にチェックを入れます
    \image html qt_installer_mingw.png MinGW もインストールする場合

  \n
  \subsection devel_win_qt_compile Qt プロジェクトのコンパイル例

  Qt インストール後は、プロジェクトのあるフォルダに移動して qmake && make を実行することでコンパイルが完了します。

  コンパイル例
  \verbatim
% ls *.pro             # プロジェクトファイルがあることを確認
UrgDrawWidget.pro
% qmake
% make
/usr/local/Trolltech/Qt-4.4.0/bin/uic UrgViewerWindowForm.ui -o ui_UrgViewerWindowForm.h
...(コンパイルメッセージを省略)...
g++ -Wl,(中略) -lpthread \endverbatim

  \n
  Windows 環境の場合、インストール方法によっては

  \verbatim
make[1]: C:Qt4.4.3bin/moc.exe: Command not found \endverbatim

  というエラーがでることがあります。\n
  この問題は、Makefile.Release の moc.exe パス指定の \\ を / に変更することで修正できます。

  修正前
  \verbatim
	C:\Qt\4.4.3\bin/moc.exe (以下省略) \endverbatim

  修正後
  \verbatim
	C:/Qt/4.4.3/bin/moc.exe (以下省略) \endverbatim


  \n
  \subsection devel_win_qt_release Qt プログラムの実行、配布

  - Qt でコンパイルされたプログラムを実行するには、Qt の DLL が必要です。 Qt の FAQ には「DLL は自由に出荷してかまいません」という記述があります。

  - Qt の Open Source 版で作成されたプログラムを配布するには LGPL に準拠する必要があります。\n
  LGPL に準拠しないで配布したい場合には Qt の商用版を購入する必要があります。

  \n
*/
