C++版の導入(Windows)

C++版の導入方法について説明しています。

VisualStudio2013の導入

VisualStudioのWebページから
「Visual Studio Community 2013 Update 4」をダウンロードします。ただし、会社内でAC-Engineを使用する場合は「Visual Studio Express 2013 with Update 4 for Windows Desktop」をダウンロードします。
これらはプログラムのソースコードから実行可能なアプリケーションを生成するツールです。個人で開発する分には無料で使用できます。

ダウンロードが終わったら、「Visual Studio」をインストールします。

AC-Engineのダウンロード

AC-Engine　をダウンロードします。
ダウンロードしたファイルを解凍します。

開発には以下のファイルを使用します。

プロジェクトの作成

Visual Studioで開発するためには、最初にプロジェクトを作成する必要があります。以下の手順でプロジェクトを作成します。

  1. ファイル->新規作成->プロジェクトを選択します。
  2. 左のカラムからインストール済み->テンプレート->Visual C++を選択した後、中央のカラムからコンソールアプリケーションを選択します。
  3. 下のテキストボックスの名前にプロジェクト名を入力してOKを選択します。ここからはACE_Testと入力したと仮定して説明をします。
  4. ダイアログボックスが表示されますが、何も設定を変更せずにOKを押します。

これでプロジェクトの作成が完了しました。

プロジェクトの設定

プロジェクトの設定をします。

  1. ソリューションエクスプローラからACE_Testプロジェクトを右クリックし、プロパティを選択します。
  2. 構成プロパティ->C++->コード設定を選択します。そして、ランタイムライブラリをマルチスレッドデバッグDLLからマルチスレッドデバッグに変更します。
  3. 適用をクリックします。
  4. 左上のアクティブ(Debug)を選択し、Releaseに切り替えます。
  5. 構成プロパティ->C++->コード設定を選択します。そして、ランタイムライブラリをマルチスレッドデバッグからマルチスレッドに変更します。
  6. OKをクリックします。

プロジェクトの設定が終わったらACEを追加します。

  1. Runtimeの中身を全て、ACE_Test/ACE_Test/にコピーします。

最低限の動作をさせるならば、とりあえずコピーするだけで動作します。

ビルド、実行

ACE_Test.cpp を以下のソースコードに書き換えます。

// ACE_Test.cpp : コンソール アプリケーションのエントリ ポイントを定義します。
  //
  
  #include "stdafx.h"
  
  // AC-Engineのヘッダを読み込む
  #include "ace.h"
  
  // AC-Engineのライブラリを読み込む
  #if _DEBUG
  #pragma comment(lib,"Debug/ace_engine.lib")
  #else
  #pragma comment(lib,"Release/ace_engine.lib")
  #endif
  
  int _tmain(int argc, _TCHAR* argv[])
  {
      // AC-Engineを初期化する。
      ace::Engine::Initialize(ace::ToAString("Empty").c_str(), 640, 480, ace::EngineOption());
  
      // AC-Engineが進行可能かチェックする。
      while (ace::Engine::DoEvents())
      {
          // AC-Engineを更新する。
          ace::Engine::Update();
      }
  
      // AC-Engineを終了する。
      ace::Engine::Terminate();
  
      return 0;
  }

そして、メニューバーからデバッグ->デバッグ開始を選択します。
黒いウインドウが表示されれば成功です。

今後開発する上での設定

今回は、AC-Engineのランタイムをコピーで済ませました。しかし、実際に開発する際は全てのファイルを配置し直すことをおすすめします。

Debug/ace_engine.lib と Release/ace_engine.lib は名称を変更し、 ACE_Test.vcxproj と同じディレクトリに移動しましょう。 Debug と Release というフォルダは
VisualStudioがコンパイルをする際に一時的に生成されるファイルが配置されるディレクトリでもあります。不要なファイルを消すときに間違えて消してしまうかもしれません。

ace_core.Debug.dll と ace_core.dll は生成された実行ファイルが存在するディレクトリにもコピーしましょう。VisualStudioからデバッグしている間は問題は置きませんが、
実行ファイルを起動する際は、実行ファイルと同じディレクトリにこれらのdllが存在する必要があります。