width | Texture width in pixels. |
height | Texture height in pixels. |
depth | Number of bits in depth buffer (0, 16, 24 or 32). Note that only 24 and 32 bit depth have stencil buffer support. |
format | Texture color format. |
colorFormat | The color format for the RenderTexture. |
depthStencilFormat | The depth stencil format for the RenderTexture. |
mipCount | Amount of mips to allocate for the RenderTexture. |
readWrite | How or if color space conversions should be done on texture read/write. |
desc | Create the RenderTexture with the settings in the RenderTextureDescriptor. |
textureToCopy | Copy the settings from another RenderTexture. |
Creates a new RenderTexture object.
The render texture is created with width
by height
size, with a depth buffer
of depth
bits (depth can be 0, 16, 24 or 32), and in format
format and with sRGB read / write on or off.
Note that constructing a RenderTexture object does not create the hardware representation immediately.
The actual render texture is created upon first use or when Create is called manually. So after
constructing the render texture, it is possible to set additional variables, like format,
dimension and so on.
Also note that your graphics device capabilities determine the maximum size of a RenderTexture. To determine the maximum size, use SystemInfo.maxTextureSize for 2D and cubemap RenderTextures, SystemInfo.maxTexture3DSize for 3D RenderTextures, and SystemInfo.maxTextureSize and SystemInfo.maxTextureArraySlices for 2D array RenderTextures.
When the requested size exceeds the maximum size, Unity's behavior varies. If the RenderTexture is not a 3D texture, and the requested size is a power of two, Unity automatically scales down the requested size by a factor of 2 until it is below the maximum, and then creates the RenderTexture at that size. Otherwise, Unity fails to create the RenderTexture, and throws an error.
See Also: format, GetTemporary.
using UnityEngine;
public class Example : MonoBehaviour { public RenderTexture rt;
void Start() { rt = new RenderTexture(256, 256, 16, RenderTextureFormat.ARGB32); } }
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.