# Texture2D > Class that represents textures in C# code. ## Definition * **Type:** Class * **Namespace:** [UnityEngine](/engine/6000.7/script-reference/unityengine.md) * **Assembly:** UnityEngine.CoreModule * **Inherits from:** [Texture](/engine/6000.7/script-reference/unityengine/texture.md) ```csharp [HelpURL("texture-type-default")] public sealed class Texture2D : Texture ``` ## Remarks Use this class to create textures, or to modify existing [texture assets](/engine/6000.7/manual/materials-and-shaders/textures/textures-getting-started/textures.md). The [ImageConversion](/engine/6000.7/script-reference/unityengine/imageconversion.md) class provides extension methods to this class that handle image encoding functionality. For details on those methods, see the [ImageConversion](/engine/6000.7/script-reference/unityengine/imageconversion.md) documentation. Do not assume that the texture will be created and available in [Awake](/engine/6000.7/script-reference/unityengine/monobehaviour/awake.md). All texture uploads are synchronized on the Main thread at [Start](/engine/6000.7/script-reference/unityengine/monobehaviour/start.md). Perform texture operations in [Start](/engine/6000.7/script-reference/unityengine/monobehaviour/start.md). ## Constructors | Constructor | Description | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | | [Texture2D(System.Int32,System.Int32)](/engine/6000.7/script-reference/unityengine/texture2d/ctor.md#texture2d\(int-int\)) | Create a new empty texture. | | [Texture2D(System.Int32,System.Int32,UnityEngine.TextureFormat,System.Boolean)](/engine/6000.7/script-reference/unityengine/texture2d/ctor.md#texture2d\(int-int-textureformat-bool\)) | Create a new empty texture. | | [Texture2D(System.Int32,System.Int32,UnityEngine.TextureFormat,System.Boolean,System.Boolean)](/engine/6000.7/script-reference/unityengine/texture2d/ctor.md#texture2d\(int-int-textureformat-bool-bool\)) | Create a new empty texture. | | [Texture2D(System.Int32,System.Int32,UnityEngine.TextureFormat,System.Boolean,System.Boolean,System.Boolean)](/engine/6000.7/script-reference/unityengine/texture2d/ctor.md#texture2d\(int-int-textureformat-bool-bool-bool\)) | Create a new empty texture. | | [Texture2D(System.Int32,System.Int32,UnityEngine.TextureFormat,System.Int32,System.Boolean)](/engine/6000.7/script-reference/unityengine/texture2d/ctor.md#texture2d\(int-int-textureformat-int-bool\)) | Create a new empty texture. | | [Texture2D(System.Int32,System.Int32,UnityEngine.TextureFormat,System.Int32,System.Boolean,System.Boolean)](/engine/6000.7/script-reference/unityengine/texture2d/ctor.md#texture2d\(int-int-textureformat-int-bool-bool\)) | Create a new empty texture. | | [Texture2D(System.Int32,System.Int32,UnityEngine.TextureFormat,System.Int32,System.Boolean,System.Boolean,UnityEngine.MipmapLimitDescriptor)](/engine/6000.7/script-reference/unityengine/texture2d/ctor.md#texture2d\(int-int-textureformat-int-bool-bool-mipmaplimitdescriptor\)) | Create a new empty texture. | ## Properties | Property | Description | | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [activeMipmapLimit](/engine/6000.7/script-reference/unityengine/texture2d/activemipmaplimit.md) | The number of high resolution mipmap levels from the texture that Unity doesn't upload to the GPU. (Read Only) | | [alphaIsTransparency](/engine/6000.7/script-reference/unityengine/texture2d/alphaistransparency.md) | Indicates whether this texture was imported with [TextureImporter.alphaIsTransparency](/engine/6000.7/script-reference/unityeditor/textureimporter/alphaistransparency.md) enabled. This setting is available only in the Editor scripts. Note that changing this setting will have no effect; it must be enabled in [TextureImporter](/engine/6000.7/script-reference/unityeditor/textureimporter.md) instead. | | [calculatedMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/calculatedmipmaplevel.md) | The mipmap level calculated by the streaming system, which takes into account the streaming Cameras and the location of the objects containing this Texture. This is unaffected by [Texture2D.requestedMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/requestedmipmaplevel.md) or [Texture2D.minimumMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/minimummipmaplevel.md). | | [desiredMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/desiredmipmaplevel.md) | The mipmap level that the streaming system would load before memory budgets are applied. | | [format](/engine/6000.7/script-reference/unityengine/texture2d/format.md) | The format of the pixel data in the texture (Read Only). | | [ignoreMipmapLimit](/engine/6000.7/script-reference/unityengine/texture2d/ignoremipmaplimit.md) | This property causes a texture to ignore all texture mipmap limit settings. | | [loadedMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/loadedmipmaplevel.md) | The mipmap level that is currently loaded by the streaming system. | | [loadingMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/loadingmipmaplevel.md) | The mipmap level that the mipmap streaming system is in the process of loading. | | [minimumMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/minimummipmaplevel.md) | Restricts the mipmap streaming system to a minimum mip level for this Texture. | | [mipmapLimitGroup](/engine/6000.7/script-reference/unityengine/texture2d/mipmaplimitgroup.md) | The name of the texture mipmap limit group that this texture is associated with. (Read Only) | | [requestedMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/requestedmipmaplevel.md) | The mipmap level to load. | | [streamingMipmaps](/engine/6000.7/script-reference/unityengine/texture2d/streamingmipmaps.md) | Determines whether mipmap streaming is enabled for this Texture. | | [streamingMipmapsPriority](/engine/6000.7/script-reference/unityengine/texture2d/streamingmipmapspriority.md) | Sets the relative priority for this Texture when reducing memory size to fit within the memory budget. | | [vtOnly](/engine/6000.7/script-reference/unityengine/texture2d/vtonly.md) | Returns true if the VTOnly checkbox was checked when the texture was imported; otherwise returns false. For additional information, see [TextureImporter.vtOnly](/engine/6000.7/script-reference/unityeditor/textureimporter/vtonly.md). | ## Static Properties | Property | Description | | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | [blackTexture](/engine/6000.7/script-reference/unityengine/texture2d/blacktexture.md) | Gets a small Texture with all black pixels. | | [grayTexture](/engine/6000.7/script-reference/unityengine/texture2d/graytexture.md) | Gets a small Texture with all gray pixels. | | [linearGrayTexture](/engine/6000.7/script-reference/unityengine/texture2d/lineargraytexture.md) | Gets a small Texture with all gray pixels. | | [normalTexture](/engine/6000.7/script-reference/unityengine/texture2d/normaltexture.md) | Gets a small Texture with pixels that represent surface normal vectors at a neutral position. | | [redTexture](/engine/6000.7/script-reference/unityengine/texture2d/redtexture.md) | Gets a small Texture with all red pixels. | | [whiteTexture](/engine/6000.7/script-reference/unityengine/texture2d/whitetexture.md) | Gets a small Texture with all white pixels. | ## Methods | Method | Description | | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | [Apply](/engine/6000.7/script-reference/unityengine/texture2d/apply.md) | Copies changes you've made in a CPU texture to the GPU. | | [ClearMinimumMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/clearminimummipmaplevel.md) | Resets the minimumMipmapLevel field. | | [ClearRequestedMipmapLevel](/engine/6000.7/script-reference/unityengine/texture2d/clearrequestedmipmaplevel.md) | Resets the requestedMipmapLevel field. | | [Compress](/engine/6000.7/script-reference/unityengine/texture2d/compress.md) | Compress texture at runtime to DXT/BCn or ETC formats. | | [CopyPixels](/engine/6000.7/script-reference/unityengine/texture2d/copypixels.md) | Copies pixel data from another texture on the CPU. | | [GetPixel](/engine/6000.7/script-reference/unityengine/texture2d/getpixel.md) | Gets the pixel color at coordinates (`x`, `y`). | | [GetPixelBilinear](/engine/6000.7/script-reference/unityengine/texture2d/getpixelbilinear.md) | Gets the filtered color at the normalized coordinates (`u`, `v`). | | [GetPixelData](/engine/6000.7/script-reference/unityengine/texture2d/getpixeldata.md) | Gets the raw data from a texture. | | [GetPixels](/engine/6000.7/script-reference/unityengine/texture2d/getpixels.md) | Gets the pixel color data for a mipmap level as [Color](/engine/6000.7/script-reference/unityengine/color.md) structs. | | [GetPixels32](/engine/6000.7/script-reference/unityengine/texture2d/getpixels32.md) | Gets the pixel color data for a mipmap level as [Color32](/engine/6000.7/script-reference/unityengine/color32.md) structs. | | [GetRawTextureData](/engine/6000.7/script-reference/unityengine/texture2d/getrawtexturedata.md) | Gets the raw data from a texture, as a copy. | | [IsRequestedMipmapLevelLoaded](/engine/6000.7/script-reference/unityengine/texture2d/isrequestedmipmaplevelloaded.md) | Checks to see whether the mipmap level set by requestedMipmapLevel has finished loading. | | [LoadRawTextureData](/engine/6000.7/script-reference/unityengine/texture2d/loadrawtexturedata.md) | Sets the raw data of an entire texture in CPU memory. | | [PackTextures](/engine/6000.7/script-reference/unityengine/texture2d/packtextures.md) | Packs multiple Textures into a texture atlas. | | [ReadPixels](/engine/6000.7/script-reference/unityengine/texture2d/readpixels.md) | Reads pixels from the current render target and writes them to a texture. | | [Reinitialize](/engine/6000.7/script-reference/unityengine/texture2d/reinitialize.md) | Reinitializes a Texture2D, making it possible for you to replace `width`, `height`, `textureformat`, and `graphicsformat` data for that texture. | | [SetPixel](/engine/6000.7/script-reference/unityengine/texture2d/setpixel.md) | Sets the pixel color at coordinates (`x`,`y`). | | [SetPixelData](/engine/6000.7/script-reference/unityengine/texture2d/setpixeldata.md) | Sets the raw data of an entire mipmap level directly in CPU memory. | | [SetPixels](/engine/6000.7/script-reference/unityengine/texture2d/setpixels.md) | Sets the pixel colors of part of a mipmap level. | | [SetPixels32](/engine/6000.7/script-reference/unityengine/texture2d/setpixels32.md) | Sets the pixel colors of part of a mipmap level. | | [UpdateExternalTexture](/engine/6000.7/script-reference/unityengine/texture2d/updateexternaltexture.md) | Updates Unity texture to use different native texture object. | ## Static Methods | Method | Description | | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | [CreateExternalTexture](/engine/6000.7/script-reference/unityengine/texture2d/createexternaltexture.md) | Creates a Unity Texture out of an externally created native texture object. | | [GenerateAtlas](/engine/6000.7/script-reference/unityengine/texture2d/generateatlas.md) | Packs a set of rectangles into a square atlas, with optional padding between rectangles. | ## Enums | Enum | Description | | --------------------------------------------------------------------------------------- | -------------------------------------------------- | | [Texture2D.EXRFlags](/engine/6000.7/script-reference/unityengine/texture2d/exrflags.md) | Flags used to control the encoding to an EXR file. | ## Inheritance **Inherited Members:** * [Texture.GenerateAllMips()](/engine/6000.7/script-reference/unityengine/texture/generateallmips.md) * [Texture.SetGlobalAnisotropicFilteringLimits(int, int)](/engine/6000.7/script-reference/unityengine/texture/setglobalanisotropicfilteringlimits.md) * [Texture.GetNativeTexturePtr()](/engine/6000.7/script-reference/unityengine/texture/getnativetextureptr.md) * [Texture.IncrementUpdateCount()](/engine/6000.7/script-reference/unityengine/texture/incrementupdatecount.md) * [Texture.SetStreamingTextureMaterialDebugProperties()](/engine/6000.7/script-reference/unityengine/texture/setstreamingtexturematerialdebugproperties.md#setstreamingtexturematerialdebugproperties\(\)) * [Texture.SetStreamingTextureMaterialDebugProperties(int)](/engine/6000.7/script-reference/unityengine/texture/setstreamingtexturematerialdebugproperties.md#setstreamingtexturematerialdebugproperties\(int\)) * [Texture.mipmapCount](/engine/6000.7/script-reference/unityengine/texture/mipmapcount.md) * [Texture.graphicsFormat](/engine/6000.7/script-reference/unityengine/texture/graphicsformat.md) * [Texture.width](/engine/6000.7/script-reference/unityengine/texture/width.md) * [Texture.height](/engine/6000.7/script-reference/unityengine/texture/height.md) * [Texture.dimension](/engine/6000.7/script-reference/unityengine/texture/dimension.md) * [Texture.isReadable](/engine/6000.7/script-reference/unityengine/texture/isreadable.md) * [Texture.wrapMode](/engine/6000.7/script-reference/unityengine/texture/wrapmode.md) * [Texture.wrapModeU](/engine/6000.7/script-reference/unityengine/texture/wrapmodeu.md) * [Texture.wrapModeV](/engine/6000.7/script-reference/unityengine/texture/wrapmodev.md) * [Texture.wrapModeW](/engine/6000.7/script-reference/unityengine/texture/wrapmodew.md) * [Texture.filterMode](/engine/6000.7/script-reference/unityengine/texture/filtermode.md) * [Texture.anisoLevel](/engine/6000.7/script-reference/unityengine/texture/anisolevel.md) * [Texture.mipMapBias](/engine/6000.7/script-reference/unityengine/texture/mipmapbias.md) * [Texture.updateCount](/engine/6000.7/script-reference/unityengine/texture/updatecount.md) * [Texture.isDataSRGB](/engine/6000.7/script-reference/unityengine/texture/isdatasrgb.md) * [Texture.imageContentsHash](/engine/6000.7/script-reference/unityengine/texture/imagecontentshash.md) * [Texture.totalTextureMemory](/engine/6000.7/script-reference/unityengine/texture/totaltexturememory.md) * [Texture.desiredTextureMemory](/engine/6000.7/script-reference/unityengine/texture/desiredtexturememory.md) * [Texture.targetTextureMemory](/engine/6000.7/script-reference/unityengine/texture/targettexturememory.md) * [Texture.currentTextureMemory](/engine/6000.7/script-reference/unityengine/texture/currenttexturememory.md) * [Texture.nonStreamingTextureMemory](/engine/6000.7/script-reference/unityengine/texture/nonstreamingtexturememory.md) * [Texture.streamingMipmapUploadCount](/engine/6000.7/script-reference/unityengine/texture/streamingmipmapuploadcount.md) * [Texture.streamingRendererCount](/engine/6000.7/script-reference/unityengine/texture/streamingrenderercount.md) * [Texture.streamingTextureCount](/engine/6000.7/script-reference/unityengine/texture/streamingtexturecount.md) * [Texture.nonStreamingTextureCount](/engine/6000.7/script-reference/unityengine/texture/nonstreamingtexturecount.md) * [Texture.streamingTexturePendingLoadCount](/engine/6000.7/script-reference/unityengine/texture/streamingtexturependingloadcount.md) * [Texture.streamingTextureLoadingCount](/engine/6000.7/script-reference/unityengine/texture/streamingtextureloadingcount.md) * [Texture.streamingTextureForceLoadAll](/engine/6000.7/script-reference/unityengine/texture/streamingtextureforceloadall.md) * [Texture.streamingTextureDiscardUnusedMips](/engine/6000.7/script-reference/unityengine/texture/streamingtexturediscardunusedmips.md) * [Texture.allowThreadedTextureCreation](/engine/6000.7/script-reference/unityengine/texture/allowthreadedtexturecreation.md) * [Texture.graphicsTexture](/engine/6000.7/script-reference/unityengine/texture/graphicstexture.md) * [Object.GetEntityId()](/engine/6000.7/script-reference/unityengine/object/getentityid.md) * [Object.GetHashCode()](/engine/6000.7/script-reference/unityengine/object/gethashcode.md) * [Object.InstantiateAsync\(T)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, Transform, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, ReadOnlySpan\, ReadOnlySpan\)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, Transform, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, Transform, Vector3, Quaternion, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, Transform, ReadOnlySpan\, ReadOnlySpan\)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, Transform, ReadOnlySpan\, ReadOnlySpan\, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, Vector3, Quaternion, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, Vector3, Quaternion, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.InstantiateAsync\(T, int, ReadOnlySpan\, ReadOnlySpan\, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md) * [Object.Instantiate(Object, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-vector3-quaternion\)) * [Object.Instantiate(Object, Vector3, Quaternion, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-vector3-quaternion-transform\)) * [Object.Instantiate(Object)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object\)) * [Object.Instantiate(Object, Scene)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-scene\)) * [Object.Instantiate\(T, InstantiateParameters)](/engine/6000.7/script-reference/unityengine/object/instantiate.md) * [Object.Instantiate\(T, Vector3, Quaternion, InstantiateParameters)](/engine/6000.7/script-reference/unityengine/object/instantiate.md) * [Object.Instantiate(Object, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-transform\)) * [Object.Instantiate(Object, Transform, bool)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-transform-bool\)) * [Object.Instantiate\(T)](/engine/6000.7/script-reference/unityengine/object/instantiate.md) * [Object.Instantiate\(T, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiate.md) * [Object.Instantiate\(T, Vector3, Quaternion, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiate.md) * [Object.Instantiate\(T, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiate.md) * [Object.Instantiate\(T, Transform, bool)](/engine/6000.7/script-reference/unityengine/object/instantiate.md) * [Object.Destroy(Object, float)](/engine/6000.7/script-reference/unityengine/object/destroy.md) * [Object.DestroyImmediate(Object, bool)](/engine/6000.7/script-reference/unityengine/object/destroyimmediate.md) * [Object.FindObjectsByType(Type)](/engine/6000.7/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytype\(type\)) * [Object.FindObjectsByType(Type, FindObjectsInactive)](/engine/6000.7/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytype\(type-findobjectsinactive\)) * [Object.DontDestroyOnLoad(Object)](/engine/6000.7/script-reference/unityengine/object/dontdestroyonload.md) * [Object.FindAnyObjectByType\()](/engine/6000.7/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytypet\(\)) * [Object.FindAnyObjectByType\(FindObjectsInactive)](/engine/6000.7/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytypet\(findobjectsinactive\)) * [Object.FindObjectsByType\()](/engine/6000.7/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytypet\(\)) * [Object.FindObjectsByType\(FindObjectsInactive)](/engine/6000.7/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytypet\(findobjectsinactive\)) * [Object.FindAnyObjectByType(Type)](/engine/6000.7/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytype\(type\)) * [Object.FindAnyObjectByType(Type, FindObjectsInactive)](/engine/6000.7/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytype\(type-findobjectsinactive\)) * [Object.ToString()](/engine/6000.7/script-reference/unityengine/object/tostring.md) * [Object.name](/engine/6000.7/script-reference/unityengine/object/name.md) * [Object.hideFlags](/engine/6000.7/script-reference/unityengine/object/hideflags.md) ### Operators | Operator | Description | | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | [operator ==](/engine/6000.7/script-reference/unityengine/object/op-equality.md) | Compares two object references to see if they refer to the same object. | | [bool](/engine/6000.7/script-reference/unityengine/object/op-implicit.md) | Determines whether the object exists. | | [operator !=](/engine/6000.7/script-reference/unityengine/object/op-inequality.md) | Compares if two objects refer to a different object. |