Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

RenderTarget2D.GetTexture Method

Gets a copy of 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

A copy of 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

Community Additions

© 2015 Microsoft