※この Tips は XNA Game Studio 2.0 をベースに説明しています。
画像をスクリーン上に描画するための矩形領域です。2Dゲームではこの機能がよく使われていますが、3Dでも擬似的に2D画像描画として使用されることが多いです。
XNA ではすべて3Dポリゴンで描画しないといけないため、スクリーン上に描画する画像はポリゴンを使用した擬似スプライトになります。といってもポリゴンを意識するような操作は必要なく、手軽に描画させることできます。
画像を表示するので画像ファイルを用意しておかなければいけません。サンプルでは下のような画像を使っています。
![]()
サイズが 128×128 の PNG ファイルを使用していますが、大きさは任意で構いません。また、読み込むことができる画像ファイルの形式は標準で下記のファイルになります。
サンプルでは「Content」フォルダに画像ファイルを入れるようにしています。プロジェクトに画像ファイルを入れる方法については下記のページを参照してください。
![]()
スプライトを描画するには、描画するスプライトをバッチ化する「SpriteBatch」と、2次元画像データを格納する「Texture2D」を用意します。
/// <summary> /// スプライトのバッチ化クラス /// </summary> private SpriteBatch spriteBatch = null; /// <summary> /// テクスチャー /// </summary> private Texture2D texture = null;
/// <summary> /// ゲームが始まるときに一回だけ呼ばれ /// すべてのゲームコンテンツを読み込みます /// </summary> protected override void LoadContent() { // テクスチャーを描画するためのスプライトバッチクラスを作成します this.spriteBatch = new SpriteBatch(this.GraphicsDevice); // テクスチャーをコンテンツパイプラインから読み込む this.texture = this.Content.Load<Texture2D>("Texture"); }
LoadGraphicsContent メソッド内で「SpriteBatch」クラスを作成します。引数には GraphicsDevice を渡します。
続いて ContentManager.Load メソッドを使用して、テクスチャーを読み込んで作成します。タイプパラメータには「Texture2D」クラスを指定して、引数にアセット名を指定します。
| SpriteBatch コンストラクタ | ||
|---|---|---|
| スプライトの描画をバッチ化するクラス「SpriteBatch」のインスタンスを作成します。 | ||
| graphicsDevice | GraphicsDevice | 描画に使用する GraphicsDevice を指定します。 |
| MSDN ライブラリの Web ページへリンク | ||
// スプライトの描画準備 this.spriteBatch.Begin(); // スプライトを描画する this.spriteBatch.Draw(this.texture, Vector2.Zero, Color.White); // スプライトの一括描画 this.spriteBatch.End();
Draw メソッド内でテキストの描画を行います。
スプライトを描画には「SpriteBatch.Draw」メソッドを使用しますが、描画前と描画後にそれぞれ「SpriteBatch.Begin」メソッドと「SpriteBatch.End」メソッドを呼ぶようにしています。
SpriteBatch.Draw メソッドの第1引数に、作成した「Texture2D」クラスを指定します。これによって読み込んだ画像ファイルを表示させることができるようになります。
| SpriteBatch.Begin メソッド | ||
|---|---|---|
| スプライトを描画する前に呼び出しておきます。内部ではスプライトの描画に必要な設定を行っています。 | ||
| MSDN ライブラリの Web ページへリンク | ||
| SpriteBatch.Draw メソッド | ||
|---|---|---|
| スプライトの描画バッチリストにスプライトを追加します。 | ||
| texture | Texture2D | スプライトとして表示するテクスチャーを指定します。 |
| position | Vector2 | スプライトを表示する位置。スクリーンの左上を基準にしたスクリーン座標で指定します。スプライトの原点は左上の位置になります。 |
| color | Color | スプライトの色を掛け合わせる色を指定します。Color.White を指定した場合は、スプライトの原色で表示されます。Color.Black を指定した場合は、スプライトの色に関係なく完全な黒で表示されます。計算式は「結果 = スプライトの色 * color」になります。 |
| MSDN ライブラリの Web ページへリンク | ||
| SpriteBatch.End メソッド | ||
|---|---|---|
| バッチ化したスプライトをすべて描画します。描画順序や描画ステートなどは SpriteBatch.Begin メソッドで指定されたものが使用されます。必要に応じてレンダリングステートが SpriteBatch.Begin メソッドを呼び出す前の状態に戻ります。 | ||
| MSDN ライブラリの Web ページへリンク | ||
![]()
パソコンなどで使用するディスプレイなどでは問題ないのですが、Xbox 360 からアナログテレビに出力した場合、左上に表示したスプライトが見えない場合があります。この場合はスプライトの表示位置を調整しなければいけないのですが、それについては別の項目で説明します。
| ファイル | サイズ | 対応XNAバージョン | プラットフォーム | 作成日 |
|---|---|---|---|---|
| xna_tips_drawsprite_3_0_exe.zip | 17.5 KB | 3.0 | Windows (XP SP2 以降, Vista) | 2009/01/04 |
| xna_tips_drawsprite_2_0_exe.zip | 19.2 KB | 2.0 | Windows (XP SP2, Vista) | 2008/01/01 |
| xna_tips_drawsprite_1_0_ref_exe.zip | 19.2 KB | 1.0 Refresh | Windows (XP SP2, Vista) | 2007/07/29 |
| ファイル | サイズ | 対応XNAバージョン | プラットフォーム | 作成日 |
|---|---|---|---|---|
| xna_tips_drawsprite_3_0_project.zip | 33.2 KB | 3.0 | Windows (XP SP2 以降, Vista), Xbox 360 | 2009/01/04 |
| xna_tips_drawsprite_2_0_project.zip | 31.6 KB | 2.0 | Windows (XP SP2, Vista), Xbox 360 | 2008/01/01 |
| xna_tips_drawsprite_1_0_ref_project.zip | 32.0 KB | 1.0 Refresh | Windows (XP SP2, Vista), Xbox 360 | 2007/07/29 |
using System; using System.Collections.Generic; using Microsoft.Xna.Framework; using Microsoft.Xna.Framework.Audio; using Microsoft.Xna.Framework.Content; using Microsoft.Xna.Framework.GamerServices; using Microsoft.Xna.Framework.Graphics; using Microsoft.Xna.Framework.Input; using Microsoft.Xna.Framework.Net; using Microsoft.Xna.Framework.Storage; namespace DrawSprite { /// <summary> /// ゲームメインクラス /// </summary> public class GameMain : Microsoft.Xna.Framework.Game { /// <summary> /// グラフィックデバイス管理クラス /// </summary> private GraphicsDeviceManager graphics = null; /// <summary> /// スプライトのバッチ化クラス /// </summary> private SpriteBatch spriteBatch = null; /// <summary> /// テクスチャー /// </summary> private Texture2D texture = null; /// <summary> /// GameMain コンストラクタ /// </summary> public GameMain() { // グラフィックデバイス管理クラスの作成 this.graphics = new GraphicsDeviceManager(this); // ゲームコンテンツのルートディレクトリを設定 this.Content.RootDirectory = "Content"; } /// <summary> /// ゲームが始まる前の初期化処理を行うメソッド /// グラフィック以外のデータの読み込み、コンポーネントの初期化を行う /// </summary> protected override void Initialize() { // TODO: ここに初期化ロジックを書いてください // コンポーネントの初期化などを行います base.Initialize(); } /// <summary> /// ゲームが始まるときに一回だけ呼ばれ /// すべてのゲームコンテンツを読み込みます /// </summary> protected override void LoadContent() { // テクスチャーを描画するためのスプライトバッチクラスを作成します this.spriteBatch = new SpriteBatch(this.GraphicsDevice); // テクスチャーをコンテンツパイプラインから読み込む this.texture = this.Content.Load<Texture2D>("Texture"); } /// <summary> /// ゲームが終了するときに一回だけ呼ばれ /// すべてのゲームコンテンツをアンロードします /// </summary> protected override void UnloadContent() { // TODO: ContentManager で管理されていないコンテンツを // ここでアンロードしてください } /// <summary> /// 描画以外のデータ更新等の処理を行うメソッド /// 主に入力処理、衝突判定などの物理計算、オーディオの再生など /// </summary> /// <param name="gameTime">このメソッドが呼ばれたときのゲーム時間</param> protected override void Update(GameTime gameTime) { // Xbox360 コントローラの BACK ボタンを押したときにゲームを終了させます if (GamePad.GetState(PlayerIndex.One).Buttons.Back == ButtonState.Pressed) { this.Exit(); } // TODO: ここに更新処理を記述してください // 登録された GameComponent を更新する base.Update(gameTime); } /// <summary> /// 描画処理を行うメソッド /// </summary> /// <param name="gameTime">このメソッドが呼ばれたときのゲーム時間</param> protected override void Draw(GameTime gameTime) { // 画面を指定した色でクリアします this.GraphicsDevice.Clear(Color.CornflowerBlue); // スプライトの描画準備 this.spriteBatch.Begin(); // スプライトを描画する this.spriteBatch.Draw(this.texture, Vector2.Zero, Color.White); // スプライトの一括描画 this.spriteBatch.End(); // 登録された DrawableGameComponent を描画する base.Draw(gameTime); } } }
| 更新日時 | 更新内容 |
|---|---|
| 2009/01/04 | XNA Game Studio 3.0 のプロジェクト追加 |
| 2008/05/18 | 文章・プログラムの校正 |
| 2008/01/01 | XNA Game Studio 2.0 用に修正 |
| 2007/07/29 | ページ作成 |