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 | |
|---|---|---|
.gif "Public method") |
Texture2D(GraphicsDevice, Int32, Int32) | Creates a new instance of this object. |
|
Texture2D(GraphicsDevice, Int32, Int32, Boolean, SurfaceFormat) | Creates a new instance of this object. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
Bounds | Gets the size of this resource. |
|
Format | Gets the format of the texture data. (Inherited from Texture.) |
|
Height | Gets the height of this texture resource, in pixels. |
|
IsDisposed | Gets a value that indicates whether the object is disposed. (Inherited from GraphicsResource.) |
|
LevelCount | Gets the number of texture levels in a multilevel texture. (Inherited from Texture.) |
|
Width | Gets the width of this texture resource, in pixels. |
Top
Methods
| Name | Description | |
|---|---|---|
|
Dispose() | Immediately releases the unmanaged resources used by this object. (Inherited from GraphicsResource.) |
.gif "Protected method") |
Dispose(Boolean) | Immediately releases the unmanaged resources used by this object. (Inherited from GraphicsResource.) |
|
Finalize | Allows this object to attempt to free resources and perform other cleanup operations before garbage collection reclaims the object. (Inherited from GraphicsResource.) |
|
SetData<T>(array<T[]) | Sets 2D texture data. |
|
SetData<T>(array<T[], Int32, Int32) | Sets 2D texture data, specifying a start index, and number of elements. |
|
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.