Version: 2023.2
LanguageEnglish
  • C#

CommandBuffer.GetTemporaryRT

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public void GetTemporaryRT(int nameID, int width, int height, int depthBuffer, FilterMode filter, RenderTextureFormat format, RenderTextureReadWrite readWrite, int antiAliasing, bool enableRandomWrite);

Declaration

public void GetTemporaryRT(int nameID, RenderTextureDescriptor desc, FilterMode filter);

Parameters

nameID Shader property name for this texture.
width Width in pixels, or -1 for "camera pixel width".
height Height in pixels, or -1 for "camera pixel height".
depthBuffer Depth buffer bits (0, 16 or 24).
filter Texture filtering mode (default is Point).
format Format of the render texture (default is ARGB32).
readWrite Color space conversion mode.
antiAliasing Anti-aliasing (default is no anti-aliasing).
enableRandomWrite Should random-write access into the texture be enabled (default is false).
desc Use this RenderTextureDescriptor for the settings when creating the temporary RenderTexture.
memorylessMode Render texture memoryless mode.

Description

Add a "get a temporary render texture" command.

This creates a temporary render texture with given parameters, and sets it up as a global shader property with nameID. Use Shader.PropertyToID to create the integer name.

Release the temporary render texture using ReleaseTemporaryRT, passing the same nameID. Any temporary textures that were not explicitly released will be removed after camera is done rendering, or after Graphics.ExecuteCommandBuffer is done.

After getting a temporary render texture, you can set it as active (SetRenderTarget) or blit to/from it (Blit). You do not explicitly need to preserve active render targets during command buffer execution (current render targets are saved & restored afterwards).

Additional resources: ReleaseTemporaryRT, SetRenderTarget, Blit.