RenderTarget2D.GetTexture Method

Gets the 2D texture associated with this render target.

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

public Texture2D GetTexture ()

Return Value

The 2D texture associated with this render target.

Exception typeCondition
InvalidOperationExceptionA render target must be resolved (for example, setting the index to null or a different index) before calling GetTexture.

// Create a new render target to receive the drawn data.
renderTarget = new RenderTarget2D(
    // In this case, we are creating
    // a render target to match half of a split screen:
    // Number of levels in the render target:
    // Use the same surface format as the back buffer.

// Set the render target on the device.
graphics.GraphicsDevice.SetRenderTarget(0, renderTarget);

// TODO: Add your code to draw to the render target here.
// For example, this could be a call to Mesh.Draw, 
// a SpriteBatch Begin-End sequence, or a call to
// DrawIndexedPrimitives, as you would have called them
// in the Draw method of your application.

// Set the device render target back to the back buffer.
graphics.GraphicsDevice.SetRenderTarget(0, null);

// Call GetTexture to retrieve the render target data and save it to a texture.
capturedTexture = renderTarget.GetTexture();

Xbox 360, Windows XP SP2, Windows Vista, Zune

Community Additions