SpriteBatch.Draw Method (Texture2D, Vector2, Nullable<Rectangle>, Color)

Article
08/15/2012

Adds a sprite to a batch of sprites for rendering using the specified texture, position, source rectangle, and color.

Syntax

'Declaration
Public Sub Draw ( _
         texture As Texture2D, _
         position As Vector2, _
         sourceRectangle As Nullable(Of Rectangle), _
         color As Color _
)

public void Draw (
         Texture2D texture,
         Vector2 position,
         Nullable<Rectangle> sourceRectangle,
         Color color
)

public:
void Draw(
         Texture2D texture,
         Vector2 position,
         Nullable<Rectangle> sourceRectangle,
         Color color
)

Parameters

texture
Type: Texture2D
A texture.
position
Type: Vector2
The location (in screen coordinates) to draw the sprite.
sourceRectangle
Type: Nullable<Rectangle>
A rectangle that specifies (in texels) the source texels from a texture. Use null to draw the entire texture.
color
Type: Color
The color to tint a sprite. Use Color.White for full color with no tinting.

Exceptions

Exception type	Condition
ArgumentNullException	texture is null.
InvalidOperationException	Draw was called, but Begin has not yet been called. Begin must be called successfully before you can call Draw.

Remarks

Before making any calls to Draw, you must call Begin. Once all calls to Draw are complete, call End.

If you are texture wrapping with a Reach profile or texture wrapping on Windows Phone, the texture must have power of 2 dimensions.

Tasks

Drawing a Sprite

Concepts

What Is a Sprite?

Requirements

Namespace: Microsoft.Xna.Framework.Graphics

Assembly: Microsoft.Xna.Framework.Graphics (in microsoft.xna.framework.graphics.dll)

Platforms

Windows Phone

Share via