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

XNA Game Studio 4.0
Adds a sprite to a batch of sprites for rendering using the specified texture, destination rectangle, source rectangle, and color.

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

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

Parameters

texture
A texture.
destinationRectangle
A rectangle that specifies (in screen coordinates) the destination for drawing the sprite. If this rectangle is not the same size as the source rectangle, the sprite will be scaled to fit.
sourceRectangle
A rectangle that specifies (in texels) the source texels from a texture. Use null to draw the entire texture.
color
The color to tint a sprite. Use Color.White for full color with no tinting.

Exception typeCondition
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.

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

Tasks

Concepts

Xbox 360, Windows 7, Windows Vista, Windows XP, Windows Phone 7

Community Additions

ADD
Show: