Rotate the sprite
Page update date :
Page creation date :
summary
Rotate the sprite. In the sample, the rotation is rotated automatically so that it is easy to understand.
Operating environment
Prerequisites
Supported XNA Versions |
|
Supported Platforms |
|
Windows Required Vertex Shader Version | 2.0 |
Windows Required Pixel Shader Version | 2.0 |
Operating environment
platform |
|
substance
To rotate the sprite, specify the rotation angle as "radian" in the fifth argument of the "SpriteBatch.Draw" method. The commonly used unit of numbers 0~360 is called "degree", and "radian" is a value of 0~2π.
In the sample, the generally recognizable degree unit is used to convert the number to radians using the "MathHelper.ToRadians" method and pass it to the argument.
// リアルタイムに回転させてスプライトを描画する
this.spriteBatch.Draw(this.texture, new Vector2(200.0f, 200.0f), null,
Color.White, MathHelper.ToRadians(this.realRotate), Vector2.Zero, 1.0f,
SpriteEffects.None, 0.0f);
SpriteBatch.Draw
method
Adds a sprite to the sprite drawing batch list.
texture | Texture2D | Specifies the texture to display as a sprite. |
position | Vector2 | The position where the sprite should be displayed. Specify in screen coordinates relative to the top left of the screen. The origin of the sprite will be in the upper left position. |
sourceRectangle | Nullable<Rectangle> | Specifies the transfer area for the texture. If you want the entire texture to be displayed as a sprite, you can specify null. If you specify this parameter, you can make only an arbitrary area appear as a sprite. |
color | Color | Specifies the color to multiply the color of the sprite. If you specify Color.White, it is displayed in the primary color of the sprite. If Color.Black is specified, the sprite is displayed in full black, regardless of its color. The formula is "Result = sprite color * color". |
rotation | float | The rotation angle of the sprite. Units are specified in radian. The axis of rotation will be at the top left of the sprite. |
origin | Vector2 | Specifies the position of the axis of rotation when rotating the sprite. You specify which position of the sprite is the axis of rotation, but in reality, the position of the axis of rotation is fixed to the top left of the sprite, and the display position of the sprite is moved by -origin. |
scale | float | Specifies the magnification of the sprite. Scales vertically and horizontally relative to 1.0. The origin of the magnification will be in the upper left corner of the sprite. |
effects | SpriteEffects | Specifies the flip effect of the sprite. If you don't do anything else, specify SpriteEffects.None. |
layerDepth | float | Specifies the depth at which the sprite is displayed. It is mainly used to display sprites in the foreground and in the back. Specify in the range of 0.0~1.0, where 0.0 is the front and 1.0 is the back. |
MathHelper.ToRadians
method
Convert the degree value to radian. The conversion formula is "radian = degree * π / 180.0".
degrees | float | Specifies the degree value to convert to radian. |
Return Values | float | Returns the degree value converted to radian. |
The axis of rotation defaults to the top-left position of the sprite.
All Codes
using System;
using System.Collections.Generic;
using System.Linq;
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.Media;
#if WINDOWS_PHONE
using Microsoft.Xna.Framework.Input.Touch;
#endif
namespace RotateSprite
{
<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>
リアルタイムに増加する回転量(degree)
</summary>
float realRotate = 0.0f;
<summary>
GameMain コンストラクタ
</summary>
public GameMain()
{
// グラフィックデバイス管理クラスの作成
this.graphics = new GraphicsDeviceManager(this);
// ゲームコンテンツのルートディレクトリを設定
this.Content.RootDirectory = "Content";
#if WINDOWS_PHONE
// Windows Phone のデフォルトのフレームレートは 30 FPS
this.TargetElapsedTime = TimeSpan.FromTicks(333333);
// バックバッファサイズの設定
this.graphics.PreferredBackBufferWidth = 480;
this.graphics.PreferredBackBufferHeight = 800;
// フルスクリーン表示
this.graphics.IsFullScreen = true;
#endif
}
<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)
{
// Xbox 360 コントローラ、Windows Phone の BACK ボタンを押したときに
// ゲームを終了させます
if (GamePad.GetState(PlayerIndex.One).Buttons.Back == ButtonState.Pressed)
{
this.Exit();
}
// 回転量を増やす
this.realRotate += (float)gameTime.ElapsedGameTime.TotalSeconds * 60.0f;
// 登録された 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(200.0f, 200.0f), null,
Color.White, MathHelper.ToRadians(0.0f), Vector2.Zero, 1.0f,
SpriteEffects.None, 0.0f);
// リアルタイムに回転させてスプライトを描画する
this.spriteBatch.Draw(this.texture, new Vector2(200.0f, 200.0f), null,
Color.White, MathHelper.ToRadians(this.realRotate), Vector2.Zero, 1.0f,
SpriteEffects.None, 0.0f);
// スプライトの一括描画
this.spriteBatch.End();
// 登録された DrawableGameComponent を描画する
base.Draw(gameTime);
}
}
}