Texture2D
Create a new empty texture.
Read time 10 minutesLast updated 6 days ago
Definition
- Type: Constructor
- Namespace: UnityEngine
- Assembly: UnityEngine.CoreModule
Texture2D(int, int, TextureFormat, int, bool)
Create a new empty texture.
public Texture2D(int width, int height, TextureFormat textureFormat, int mipCount, bool linear)
Parameters
The width in pixels of the texture being created. Should be greater than 0.
The height in pixels of the texture being created. Should be greater than 0.
The format of the texture being created.
The number of mipmaps for the texture being created. If this is less than or equal to zero, the number of mipmaps is automatically calculated based on the dimensions of the texture. If this is one, no mipmaps are generated for the texture. If this is greater than one, then this is the number of mipmaps generated. Mipmaps reduce texture aliasing but do take up some extra GPU memory.
If true, the texture being created is in linear space. If false, it is in sRGB space. Linear space should be used for textures where you care about the raw values, i.e. where you won't apply gamma correction. These are textures like normal maps, roughness maps, displacement maps, etc. sRGB space should be used for textures that contain colors that are meant for human eyes. Examples include diffuse maps, and emissive maps.
Remarks
The texture will be width by height size, with a given format, with mipmaps or without, and in either the linear color space or the sRGB color space.
Usually you will want to set the colors of the texture after creating it, using Texture2D.SetPixel, Texture2D.SetPixels and Texture2D.Apply functions.
Texture2D(int, int, TextureFormat, int, bool, bool)
Create a new empty texture.
public Texture2D(int width, int height, TextureFormat textureFormat, int mipCount, bool linear, bool createUninitialized)
Parameters
The width in pixels of the texture being created. Should be greater than 0.
The height in pixels of the texture being created. Should be greater than 0.
The format of the texture being created.
The number of mipmaps for the texture being created. If this is less than or equal to zero, the number of mipmaps is automatically calculated based on the dimensions of the texture. If this is one, no mipmaps are generated for the texture. If this is greater than one, then this is the number of mipmaps generated. Mipmaps reduce texture aliasing but do take up some extra GPU memory.
If true, the texture being created is in linear space. If false, it is in sRGB space. Linear space should be used for textures where you care about the raw values, i.e. where you won't apply gamma correction. These are textures like normal maps, roughness maps, displacement maps, etc. sRGB space should be used for textures that contain colors meant for human eyes. Examples include diffuse maps and emissive maps.
Enable createUninitialized to make the texture reference uninitialized data (both on the CPU and GPU). Initializing data comes at a small cost. If you're going to overwrite all texels without reading them first, you can set this to true, to potentially get improved performance and reduced memory usage during construction. Note that sampling an uninitialized texture gives unpredictable values.
Remarks
The texture will be width by height size, with a given format, with mipmaps or without, and in either the linear color space or the sRGB color space.
Usually you will want to set the colors of the texture after creating it, using Texture2D.SetPixel, Texture2D.SetPixels and Texture2D.Apply functions.
Texture2D(int, int, TextureFormat, int, bool, bool, MipmapLimitDescriptor)
Create a new empty texture.
public Texture2D(int width, int height, TextureFormat textureFormat, int mipCount, bool linear, bool createUninitialized, MipmapLimitDescriptor mipmapLimitDescriptor)
Parameters
The width in pixels of the texture being created. Should be greater than 0.
The height in pixels of the texture being created. Should be greater than 0.
The format of the texture being created.
The number of mipmaps for the texture being created. If this is less than or equal to zero, the number of mipmaps is automatically calculated based on the dimensions of the texture. If this is one, no mipmaps are generated for the texture. If this is greater than one, then this is the number of mipmaps generated. Mipmaps reduce texture aliasing but do take up some extra GPU memory.
If true, the texture being created is in linear space. If false, it is in sRGB space. Linear space should be used for textures where you care about the raw values, i.e. where you won't apply gamma correction. These are textures like normal maps, roughness maps, displacement maps, etc. sRGB space should be used for textures that contain colors meant for human eyes. Examples include diffuse maps and emissive maps.
Enable createUninitialized to make the texture reference uninitialized data (both on the CPU and GPU). Initializing data comes at a small cost. If you're going to overwrite all texels without reading them first, you can set this to true, to potentially get improved performance and reduced memory usage during construction. Note that sampling an uninitialized texture gives unpredictable values.
Use a MipmapLimitDescriptor to make the texture use the global mipmap limit from the current Quality Settings, or the mipmap limit of a TextureMipmapLimitGroup. Note that a readable CPU copy is required for the texture to re-upload when quality settings change. If the texture is made nonreadable (see Texture2D.Apply), the uploaded resolution will no longer adapt to the active quality level.
Remarks
The texture will be width by height size, with a given format, with mipmaps or without, and in either the linear color space or the sRGB color space.
Usually you will want to set the colors of the texture after creating it, using Texture2D.SetPixel, Texture2D.SetPixels and Texture2D.Apply functions.
Texture2D(int, int, TextureFormat, int, bool, bool, bool, string)
Create a new empty texture.
Warning
Deprecated. Please provide mipmap limit information using a MipmapLimitDescriptor argument
public Texture2D(int width, int height, TextureFormat textureFormat, int mipCount, bool linear, bool createUninitialized, bool ignoreMipmapLimit, string mipmapLimitGroupName)
Parameters
Remarks
The texture will be width by height size, with an RGBA32 TextureFormat, with mipmaps and in sRGB color space.
Usually you will want to set the colors of the texture after creating it, using Texture2D.SetPixel, Texture2D.SetPixels and Texture2D.Apply functions.
// Create a new texture and assign it to the renderer's materialusing UnityEngine;using System.Collections;public class ExampleClass : MonoBehaviour{ void Start() { Texture2D texture = new Texture2D(128, 128); Renderer renderer = GetComponent<Renderer>(); renderer.material.mainTexture = texture; }}
Texture2D(int, int, TextureFormat, bool, bool)
Create a new empty texture.
public Texture2D(int width, int height, TextureFormat textureFormat, bool mipChain, bool linear)
Parameters
The width in pixels of the texture being created. Should be greater than 0.
The height in pixels of the texture being created. Should be greater than 0.
The format of the texture being created.
Whether you want to generate mipmaps for the texture being created. Mipmaps reduce texture aliasing, but do take up some extra GPU memory.
If true, the texture being created is in linear space. If false, it is in sRGB space. Linear space should be used for textures where you care about the raw values, i.e. where you won't apply gamma correction. These are textures like normal maps, roughness maps, displacement maps, etc. sRGB space should be used for textures that contain colors that are meant for human eyes. Examples include diffuse maps, and emissive maps.
Remarks
The texture will be width by height size, with a given format, with mipmaps or without, and in either the linear color space or the sRGB color space.
Usually you will want to set the colors of the texture after creating it, using Texture2D.SetPixel, Texture2D.SetPixels and Texture2D.Apply functions.
Texture2D(int, int, TextureFormat, bool, bool, bool)
Create a new empty texture.
public Texture2D(int width, int height, TextureFormat textureFormat, bool mipChain, bool linear, bool createUninitialized)
Parameters
The width in pixels of the texture being created. Should be greater than 0.
The height in pixels of the texture being created. Should be greater than 0.
The format of the texture being created.
Whether you want to generate mipmaps for the texture being created. Mipmaps reduce texture aliasing, but do take up some extra GPU memory.
If true, the texture being created is in linear space. If false, it is in sRGB space. Linear space should be used for textures where you care about the raw values, i.e. where you won't apply gamma correction. These are textures like normal maps, roughness maps, displacement maps, etc. sRGB space should be used for textures that contain colors meant for human eyes. Examples include diffuse maps and emissive maps.
Enable createUninitialized to make the texture reference uninitialized data (both on the CPU and GPU). Initializing data comes at a small cost. If you're going to overwrite all texels without reading them first, you can set this to true, to potentially get improved performance and reduced memory usage during construction. Note that sampling an uninitialized texture gives unpredictable values.
Remarks
The texture will be width by height size, with a given format, with mipmaps or without, and in either the linear color space or the sRGB color space.
Usually you will want to set the colors of the texture after creating it, using Texture2D.SetPixel, Texture2D.SetPixels and Texture2D.Apply functions.
Texture2D(int, int, TextureFormat, bool)
Create a new empty texture.
public Texture2D(int width, int height, TextureFormat textureFormat, bool mipChain)
Parameters
The width in pixels of the texture being created. Should be greater than 0.
The height in pixels of the texture being created. Should be greater than 0.
The format of the texture being created.
Whether you want to generate mipmaps for the texture being created. Mipmaps reduce texture aliasing, but do take up some extra GPU memory.
Remarks
The texture will be width by height size, with a given format, with mipmaps or without.
Usually you will want to set the colors of the texture after creating it, using Texture2D.SetPixel, Texture2D.SetPixels and Texture2D.Apply functions.
Texture2D(int, int)
Create a new empty texture.
public Texture2D(int width, int height)
Parameters
Remarks
The texture will be width by height size, with an RGBA32 TextureFormat, with mipmaps and in sRGB color space.
Usually you will want to set the colors of the texture after creating it, using Texture2D.SetPixel, Texture2D.SetPixels and Texture2D.Apply functions.
// Create a new texture and assign it to the renderer's materialusing UnityEngine;using System.Collections;public class ExampleClass : MonoBehaviour{ void Start() { Texture2D texture = new Texture2D(128, 128); Renderer renderer = GetComponent<Renderer>(); renderer.material.mainTexture = texture; }}