XNA - 開発メモ@ ウィキ - atwiki（アットウィキ）

xnaに関する憶え書き

＜クイックリンク＞
ひにけにXNA - Site Home - MSDN Blogs

ファイル拡張子

pdb	デバッグ用に使用されるファイル
xnb	Content Pipeline によって処理されたアセットデータ

Game

GraphicsDeviceManager

自前でグラフィックデバイスを作成しないでもあらかじめ用意された設定を利用できるクラス

Microsoft.Xna.Framework

Game.GraphicsDeviceからアクセスできるRenderStateやVertexDeclaration等

Microsoft.Xna.Framework.Graphics

マネージャーを利用せず自分でGraphicsDeviceを作成する際に利用するクラス

Matrix

3D処理に必要な行列（４×４の２次元配列）、行列に関わるメンバー関数等を収めたクラス
例えばビュー行列の場合、メンバーの　CreateLookAt　関数を利用することで手軽に必要な行列を得ることが出来る。
この行列をエフェクトなどに渡すことで効果を反映させることが出来る。

VertexDeclaration

頂点宣言。頂点の型やフォーマットをグラフィックデバイスに伝えるクラス

BasicEffect（自前でエフェクトファイルを作成しないでもあらかじめ用意された設定を利用できるクラス）

頂点データーを行列変換しピクセルとして描画する機能を統括するクラス（HLSLの代理、本来はfxファイルが必要）
（Update更新推奨）

ワールド行列（平行移動、回転、スケール）
ビュー行列（カメラ位置、カメラターゲット、アップベクター）
射影行列（視野角、アスペクト比、近クリップ、遠クリップ）

（Draw更新推奨）

テクニック、パスの処理開始、終了をフレームワークに知らせる処理など

ポリゴンの描画（基礎）

準備：ポリゴン表示に必要な要素であり、あらかじめ準備しておく必要があるもの。

VertexDeclaration　|　頂点宣言
BasicEffect等　|　HLSL（Hi Level Shade Language）を処理するエフェクト
fxファイル（カスタマイズが不必要な場合、XNAにあらかじめ用意されたBasicEffectを利用可）
VertexPositionColor等　|　頂点データそのものを格納する型

これらをXNAフレームワークのLoadContentやDraw内で適切に設定運用すればポリゴンを表示可能となる。
実装作業する際は、頂点データがPrimitiveType列挙型のメンバのどれに該当するか確認しておくと良い。

メモ：XNAのspriteBatch機能をシェーダーを利用することにより拡張（主にピクセルシェーダーを書き換えて利用することを推奨しているっぽい）

シェーダーのサンプル：http://create.msdn.com/ja-JP/education/catalog/utility/spritebatch_shader
SpriteBatch.Drawメソッド：http://msdn.microsoft.com/ja-jp/library/microsoft.xna.framework.graphics.spritebatch.draw(XNAGameStudio.20).aspx
資料：http://blogs.msdn.com/b/ito/archive/2007/03/12/spritebatch-part1.aspx

簡単なデバッグ方法

簡易的な値の表示を視認したい場合、ウインドウ枠のタイトル表示を利用するとprivateな値も表示可能となる。
例：

Window.Title = "ElapsedGameTime=" + gameTime.ElapsedRealTime + particles[1].Position;

ゲーム内の時間について

ゲーム内時間はXNAのUpdate関数やDraw関数で拾える「GameTime gameTime」を利用する。
ディフォルトでは60FPSに設定されている。プロパティはintの値が多いので適時float等に変換して使うと良い。
良く使うプロパティは以下の二つ。他のプロパティはこちらを参照。

ElapsedGameTime	前回の更新から経過したゲーム時間の合計
TotalGameTime	ゲームの開始以降のゲーム時間の合計

サービスを使った疎結合

XNAではGameServiceContainerクラスによりインターフェイスを使ったサービスプロパイダーによるクラス間の疎結合を行うことが出来る。
常にＸＮＡのフレームワークが持つGameプロパティを経由してサービスへとアクセスできる点に注目。

＜定義側＞
   public interface IVisualProvider     //サービスに登録する場合、インターフェイスに登録されたメンバーのみ外部からアクセスが許可されると思ってよい
   {
       IList<CMyShip> CMyShips { get; }
       IList<CShot> CShots { get; }
   }
   /// <summary>
   /// 外部に公開する視覚的なコレクション要素
   /// サービスにより疎結合される共有クラス
   /// </summary>
   public class CVisualProvider :IVisualProvider
   {
       IList<CMyShip> cMyShip;
       IList<CShot> cShots;
       public IList<CMyShip> CMyShips
       {
           get { return cMyShip; }
       }
       public IList<CShot> CShots
       {
           get { return cShots; }
       }
       public  CVisualProvider()
       {
           cMyShip = new List<CMyShip>();
           cShots = new List<CShot>();
       }
   }

＜実装側＞
       IVisualProvider visualProvider;
       public Game1()
       {
           visualProvider = new CVisualProvider();
           Services.AddService(typeof(IVisualProvider), visualProvider);     //ここでサービスにインターフェイスを登録している
       }

＜外部クラスからの疎結合:継承してプロパティにより拾う＞
       IVisualProvider visualProvider;
       protected IVisualProvider VisualProvider
       {
           get { return visualProvider; }
           set { visualProvider = value; }
       }
       public CMover(Game1 game)
       {
           visualProvider = (IVisualProvider)game.Services.GetService(typeof(IVisualProvider));   //登録されたインターフェイスをサービスから取り出している
       }
      // これによりvisualProviderプロパティを利用して外部のクラスのインターフェイスで指定されたプロパティにアクセス可能となる