SpriteBatch.Begin Method (SpriteSortMode, BlendState, SamplerState, DepthStencilState, RasterizerState)

Article
08/15/2012

Begins a sprite batch operation using the specified sort, blend, sampler, depth stencil and rasterizer state objects. Passing null for any of the state objects selects the default default state objects (BlendState.AlphaBlend, SamplerState.LinearClamp, DepthStencilState.None, RasterizerState.CullCounterClockwise).

Syntax

'Declaration
Public Sub Begin ( _
         sortMode As SpriteSortMode, _
         blendState As BlendState, _
         samplerState As SamplerState, _
         depthStencilState As DepthStencilState, _
         rasterizerState As RasterizerState _
)

public void Begin (
         SpriteSortMode sortMode,
         BlendState blendState,
         SamplerState samplerState,
         DepthStencilState depthStencilState,
         RasterizerState rasterizerState
)

public:
void Begin(
         SpriteSortMode sortMode,
         BlendState blendState,
         SamplerState samplerState,
         DepthStencilState depthStencilState,
         RasterizerState rasterizerState
)

Parameters

sortMode
Type: SpriteSortMode
Sprite drawing order.
blendState
Type: BlendState
Blending options.
samplerState
Type: SamplerState
Texture sampling options.
depthStencilState
Type: DepthStencilState
Depth and stencil options.
rasterizerState
Type: RasterizerState
Rasterization options.

Exceptions

Exception type	Condition
InvalidOperationException	Begin has been called before calling End after the last call to Begin. Begin cannot be called again until End has been successfully called.

Remarks

This method must be called before any calls to Draw. When all the sprites have been drawn, call End.

Requirements

Namespace: Microsoft.Xna.Framework.Graphics

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

Platforms

Windows Phone