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　をダウンロードします。
ダウンロードしたファイルを解凍します。

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

• Runtime/ace_cs.dll
  
• Runtime/ace_cs.XML
  
• Runtime/ace_core.dll

プロジェクトの作成

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

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

プロジェクトの設定

1. ソリューションエクスプローラーのACE_Testプロジェクトを右クリックします。追加->既存の項目を選択して、ace_cs.dllとace_core.dll を追加します。
   
2. 追加されたace_cs.dllを右クリックしてプロパティを開き、出力ディレクトリーにコピーの項目を「新しい場合はコピーする」に変更します。同様にace_core.dllに対しても出力ディレクトリーにコピーの項目を変更します。
   
3. ACE_Test->参照設定を右クリックして参照の追加を選択します。ここで、参照ボタンをクリックし、1で追加されたace_cs.dllを選択してOKを押します。

以上でAC-Engineが使えるようになります。

また、ace_cs.XMLをace_cs.dllと同じディレクトリに配置すると関数等の説明がVisualC#上で表示されるようになります。

ビルド、実行

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

using System;
  using System.Collections.Generic;
  using System.Linq;
  using System.Text;
  using System.Threading.Tasks;
  
  namespace ACE_Test
  {
      class Program
      {
          [STAThread]
          static void Main(string[] args)
          {
              // AC-Engineを初期化する。
              ace.Engine.Initialize("Empty", 640, 480, new ace.EngineOption());
  
              // AC-Engineが進行可能かチェックする。
              while (ace.Engine.DoEvents())
              {
                  // AC-Engineを更新する。
                  ace.Engine.Update();
              }
  
              // AC-Engineを終了する。
              ace.Engine.Terminate();
          }
      }
  }
  

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

今後開発する上での設定

「構築されているプロジェクトのプロセッサ アーキテクチャ “MSIL” と、参照...」のような警告が表示される場合はビルド->構成マネージャーを選択しプラットフォームをx86に変更されると表示されなくなります。