XNA Game Studio 2.0

XNA Framework Changes in XNA Game Studio 2.0

A summary of API changes in the XNA Framework from XNA Game Studio Express to XNA Game Studio.

The following list identifies XNA Framework changes by namespace. For a list of new features, see What's New in This Release. Common migration scenarios are covered in Upgrade Guide: XNA Game Studio Express to XNA Game Studio 2.0.

Microsoft.Xna.Framework (Application Model)

Class/Type	Action Taken	Breaking	Workaround/Benefit
Game.LoadGraphicsContent and Game.UnloadGraphicsContent	Deprecated	No	Use LoadContent and UnloadContent. The deprecated methods will still be called in XNA Game Studio 2.0 but may be removed in future versions.
Game.GraphicsDevice	Added	No	Can be used to access the active GraphicsDevice directly from a Game object.
Game.Content	Added	No	Can be used to access the active ContentManager associated with a Game object.
Game.ResetElapsedTime	Added	No	Can be used to prevent a "stutter" when completing an operation that lags gameplay significantly.
DrawableGameComponent.LoadGraphicsContent and DrawableGameComponent.UnloadGraphicsContent	Deprecated	No	Use LoadContent and UnloadContent. The deprecated methods will still be called in XNA Game Studio 2.0 but may be removed in future versions.
DrawableGameComponent.GraphicsDevice	Added	No	Can be used to access the active GraphicsDevice directly from a DrawableGameComponent" object.
GameComponent.Game	Added	No	Can now access the Game object associated with a GameComponent instance.
GameComponentCollection	Added	No	Can now construct a GameComponentCollection to hold GameComponent objects.
GraphicsDeviceInformation.CreationOptions	Removed	Yes	It is no longer necessary to manually recreate a GraphicsDevice.

Microsoft.Xna.Framework (Other)

Class/Type	Action Taken	Breaking	Workaround/Benefit
BoundingSphere.Transform	Added	No	Can be used to translate a BoundingSphere from object space to world space.
Matrix.CreateWorld	Added	No	Can be used to create a world transform Matrix given a position vector and two orientation vectors.
Vector2.Reflect	Added	No	Can be used to calculate a reflection Vector2 given a source vector and a normal vector.

Microsoft.Xna.Framework.Audio

Class/Type	Action Taken	Breaking	Workaround/Benefit
SoundBank.PlayCue	Added overload	No	Overload takes an AudioListener and AudioEmitter to allow playing of 3D audio without having to hold onto a Cue object.
InstancePlayLimitException	Removed	Yes	It is no longer necessary to catch this exception - playing a Cue above its specified instance limit will silently fail rather than throw an exception.

Microsoft.Xna.Framework.GamerServices

New namespace for XNA Game Studio 2.0, see Microsoft.Xna.Framework.GamerServices.

Microsoft.Xna.Framework.Graphics

Class/Type	Action Taken	Breaking	Workaround/Benefit
ResourceUsage	Removed	Yes	Methods that take ResourceUsage now take BufferUsage or TextureUsage. See below for methods that have been changed.
DisplayMode.AspectRatio	Added	No	Can be used to retrieve the aspect ratio of a DisplayMode, useful in Xbox 360 programming.
DynamicVertexBuffer and DynamicIndexBuffer	Added	No	Can be used for vertex and index buffers that you expect will be changed continuously. See Dynamic Vertex Buffers in XNA. Note that you must hook and respond to the DynamicVertexBuffer.ContentLost and DynamicIndexBuffer.ContentLost if you choose to use dynamic vertex and index buffers.
VertexBuffer.SetData and IndexBuffer.SetData	Changed	Yes	Does not take a SetDataOptions parameter. Dynamic vertex and index buffer setting can be accomplished using DynamicVertexBuffer and DynamicIndexBuffer objects.
VertexBuffer.ResourceUsage and IndexBuffer.ResourceUsage	Changed	Yes	Replaced with VertexBuffer.BufferUsage and IndexBuffer.BufferUsage
VertexBuffer.ResourceManagementMode and IndexBuffer.ResourceManagementMode	Removed	Yes	Resource management in non-dynamic vertex and index buffers is automatically handled.
Effect.Lost and Effect.Reset events	Removed	Yes	Effects will now handle device reset and lost events automatically.
GraphicsAdapter.IsWideScreen	Added	No	Can be used to determine if the adapter is displaying in wide screen mode. Useful for Xbox 360 programming.
GraphicsAdapter.CheckDeviceFormat	Changed	Yes	Now takes a TextureUsage parameter instead of a ResourceUsage parameter.
GraphicsDevice.Reset	Added overload	No	You can now call Reset with a new GraphicsAdapter, useful in multi-monitor scenarios.
GraphicsDevice.ResolveBackBuffer	Changed	Yes	Now takes a ResolveTexture2D instead of a Texture2D. ResolveTexture2D is a type of Texture2D that is configured to hold render target data.
GraphicsDeviceCapabilities.NumberSimultaneousRenderTargets	Renamed	No	Renamed to MaxSimultaneousRenderTargets.
PrimitiveCaps.SupportsClipPlaneScaledPoints, PrimitiveCaps.SupportsPerStageConstant, PrimitiveCaps.SupportsTextureStageStateArgumentTemp	Removed	Yes	Removed, as these are fixed-function pipeline-related capabilities flags and are unsupported in programmable-pipeline primitives.
GraphicsDeviceCreationParameters.CreationOptions	Removed	Yes	Removed, as it is no longer necessary to manually recreate a device.
OcclusionQuery	Added	No	Can be used in draw testing using occlusion queries, which test whether pixels from draw calls were actually rendered to the screen. See OcclusionQuery for an example.
RenderTarget.RenderTargetUsage	Added	No	Can be used to control whether render target contents are preserved or discarded each frame.
RenderTarget.ResourceManagementMode	Removed	Yes	Removed, it is no longer necessary to manually manage resources of a RenderTarget.
ResolveTexture2D	Added	Yes	Can be used to hold the contents of a RenderTarget. You will only need to construct this manually when calling GraphicsDevice.ResolveBackBuffer.
Texture2D, Texture3D, TextureCube constructors	Changed	Yes	Now takes TextureUsage instead of ResourceUsage.
Viewport.AspectRatio	Added	No	Can be used to retrieve the aspect ratio of a Viewport, useful in setting up projection matrices.

Microsoft.Xna.Framework.Input

Class/Type	Action Taken	Breaking	Workaround/Benefit
GamePadState.IsButtonUp and GamePadState.IsButtonDown	Added	No	Can be used to check multiple button states in the new Buttons enumeration.
GamePadType enumeration	Changed	No	Added Guitar and DrumKit types.
Keys enumeration	Changed	No	Added Pause value, as well as ChatpadGreen and ChatpadOrange values to support the Chatpad.
Keyboard.GetState	Added overload	No	New overload takes a PlayerIndex, used to get input from a Chatpad device connected to the player's controller. PlayerIndex.One corresponds to a plugged-in USB keyboard as well as player one's Chatpad.

Microsoft.Xna.Framework.Net

New namespace for XNA Game Studio 2.0, see Microsoft.Xna.Framework.Net.

Microsoft.Xna.Framework.Storage

Class/Type	Action Taken	Breaking	Workaround/Benefit
BeginShowStorageDeviceGuide and EndShowStorageDeviceGuide	Moved	Yes	Moved to the GamerServices namespace, see Guide.BeginShowStorageDeviceSelector and Guide.EndShowStorageDeviceSelector.
ShowStorageDeviceGuide	Removed	Yes	You may no longer show the device selection guide synchronously. Use Guide.BeginShowStorageDeviceSelector and Guide.EndShowStorageDeviceSelector in the GamerServices namespace.