カウンタ

XNAXNA

ページ更新日 2009/ 1/ 4
広告

テクスチャーから部分的に画像を切り出してスプライトを描画する

概要
 作成したテクスチャーから一部分だけを切り出して描画します。
テクスチャーから部分的に画像を切り出してスプライトを描画する
動作確認バージョン
対応 XNA バージョン
  • 2.0
  • 3.0
対応プラットフォーム
  • Windows (XP SP2 以降, Vista)
  • Xbox 360
必要な頂点シェーダバージョン
1.1
必要なピクセルシェーダバージョン
1.1
サンプルの操作方法
内容

※この Tips は XNA Game Studio 2.0 をベースに説明しています。

 作成したテクスチャーから一部だけを切り出してスプライトとして描画するには、「SpriteBatch.Draw」メソッドの第3引数に切り出すテクスチャーの領域を「Rectangle」で指定します。単位はピクセルサイズです。この引数に null を指定した場合はテクスチャー全体が使用されます。

// 左上4分の1を表示
this.spriteBatch.Draw(this.texture, new Vector2(300.0f100.0f),
    new Rectangle(00, (int)this.textureCenter.X, (int)this.textureCenter.Y),
    Color.White, 0.0fVector2.Zero, 1.0fSpriteEffects.None, 0.0f);
SpriteBatch.Draw メソッド
スプライトの描画バッチリストにスプライトを追加します。
texture Texture2D スプライトとして表示するテクスチャーを指定します。
position Vector2 スプライトを表示する位置。スクリーンの左上を基準にしたスクリーン座標で指定します。スプライトの原点は左上の位置になります。
sourceRectangle Nullable<Rectangle> テクスチャーの転送領域を指定します。テクスチャー全体をスプライトとして表示させる場合は null を指定できます。このパラメータを指定すると、任意の領域だけをスプライトとして表示させることができます。
color Color スプライトの色を掛け合わせる色を指定します。Color.White を指定した場合は、スプライトの原色で表示されます。Color.Black を指定した場合は、スプライトの色に関係なく完全な黒で表示されます。計算式は「結果 = スプライトの色 * color」になります。
rotation float スプライトの回転角度。単位は radian で指定する。回転軸はスプライトの左上になります。
origin Vector2 スプライトを回転させるときの回転軸の位置を指定します。スプライトのどの位置を回転軸にするかを指定しますが、実際には回転軸の位置はスプライトの左上固定で、スプライトの表示位置が -origin 移動します。
scale float スプライトの拡大率を指定します。1.0 を基準として、縦と横に拡大縮小します。拡大の原点はスプライトの左上になります。
effects SpriteEffects スプライトの 示反転効果を指定します。特に何もしなければ SpriteEffects.None を指定します。
layerDepth float スプライトを表示する深度を指定します。主にスプライトを手前に表示したり奥に表示するのに使用します。0.0~1.0 の範囲で指定し、0.0 が最前面、1.0 が最背面になります。
MSDN ライブラリの Web ページへリンク

 例えば、下のような画像を用意した場合、上記のプログラムで同様の表示を行えば、青丸だけを表示させることができます。ゲームなどではキャラクターのアニメーションやエフェクトのアニメーションなどを1枚の画像ファイルに書き込んでおき、描画するときに部分的に描画する方法がよく用いられます。

4つの丸を書き込んだ画像ファイル

同じように部分的に切り出して描画

サンプル実行ファイル (Windows のみ)
ファイル サイズ 対応XNAバージョン プラットフォーム 作成日
xna_tips_sourcerectanglesprite_3_0_exe.zip 17.9 KB 3.0 Windows (XP SP2 以降, Vista) 2009/01/04
xna_tips_sourcerectanglesprite_2_0_exe.zip 19.5 KB 2.0 Windows (XP SP2, Vista) 2008/01/01
xna_tips_sourcerectanglesprite_1_0_ref_exe.zip 19.5 KB 1.0 Refresh Windows (XP SP2, Vista) 2007/08/11
プロジェクト ダウンロード
ファイル サイズ 対応XNAバージョン プラットフォーム 作成日
xna_tips_sourcerectanglesprite_3_0_project.zip 33.3 KB 3.0 Windows (XP SP2 以降, Vista), Xbox 360 2009/01/04
xna_tips_sourcerectanglesprite_2_0_project.zip 31.7 KB 2.0 Windows (XP SP2, Vista), Xbox 360 2008/01/01
xna_tips_sourcerectanglesprite_1_0_ref_project.zip 32.3 KB 1.0 Refresh Windows (XP SP2, Vista), Xbox 360 2007/08/11
全コード
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 SourceRectangleSprite
{
    /// <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>
        /// テクスチャーの中心座標
        /// </summary>
        private Vector2 textureCenter = Vector2.Zero;


        /// <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");

            // テクスチャーの中心座標を取得
            this.textureCenter = new Vector2(this.texture.Width / 2, this.texture.Height / 2);
        }

        /// <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, new Vector2(100.0f, 100.0f), Color.White);

            // 左上4分の1を表示
            this.spriteBatch.Draw(this.texture, new Vector2(300.0f, 100.0f),
                new Rectangle(0, 0, (int)this.textureCenter.X, (int)this.textureCenter.Y),
                Color.White, 0.0f, Vector2.Zero, 1.0f, SpriteEffects.None, 0.0f);

            // スプライトの一括描画
            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/08/11 ページ作成
ページトップ▲
Copyright (C) since 2005 Yuichi Onodera (オノデラユウイチ), All rights reserved.