Texture2D Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Represents a 2D grid of texels.

Inheritance Hierarchy

System.Object
  Microsoft.Xna.Framework.Graphics.GraphicsResource
    Microsoft.Xna.Framework.Graphics.Texture
      Microsoft.Xna.Framework.Graphics.Texture2D
        Microsoft.Xna.Framework.Graphics.RenderTarget2D

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

Syntax

'Declaration
Public Class Texture2D _
    Inherits Texture
public class Texture2D : Texture

The Texture2D type exposes the following members.

Constructors

  Name Description
Public method Texture2D(GraphicsDevice, Int32, Int32) Creates a new instance of this object.
Public method Texture2D(GraphicsDevice, Int32, Int32, Boolean, SurfaceFormat) Creates a new instance of this object.

Top

Properties

  Name Description
Public property Bounds Gets the size of this resource.
Public property Format Gets the format of the texture data. (Inherited from Texture.)
Public property Height Gets the height of this texture resource, in pixels.
Public property IsDisposed Gets a value that indicates whether the object is disposed. (Inherited from GraphicsResource.)
Public property LevelCount Gets the number of texture levels in a multilevel texture. (Inherited from Texture.)
Public property Width Gets the width of this texture resource, in pixels.

Top

Methods

  Name Description
Public method Dispose() Immediately releases the unmanaged resources used by this object. (Inherited from GraphicsResource.)
Protected method Dispose(Boolean) Immediately releases the unmanaged resources used by this object. (Inherited from GraphicsResource.)
Protected method Finalize Allows this object to attempt to free resources and perform other cleanup operations before garbage collection reclaims the object. (Inherited from GraphicsResource.)
Public method SetData<T>(array<T[]) Sets 2D texture data.
Public method SetData<T>(array<T[], Int32, Int32) Sets 2D texture data, specifying a start index, and number of elements.
Public method SetData<T>(Int32, Nullable<Rectangle>, array<T[], Int32, Int32) Sets 2D texture data, specifying a mipmap level, source rectangle, start index, and number of elements.

Top

Remarks

A texel represents the smallest unit of a texture that can be read from or written to by the GPU. A texel is composed of 1 to 4 components. Specifically, a texel may be any one of the available texture formats represented in the SurfaceFormat enumeration.

A Texture2D resource contains a 2D grid of texels. Each texel is addressable by a u, v vector. Since it is a texture resource, it may contain mipmap levels.

Version Information

Silverlight

Supported in: 5

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.