Version: 2023.2
LanguageEnglish
  • C#

Graphics.Blit

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 static void Blit(Texture source, Material mat, int pass = -1);

Declaration

public static void Blit(Texture source, Material mat, int pass, int destDepthSlice);

Declaration

public static void Blit(Texture source, RenderTexture dest);

Declaration

public static void Blit(Texture source, RenderTexture dest, Material mat, int pass = -1);

Declaration

public static void Blit(Texture source, RenderTexture dest, Vector2 scale, Vector2 offset);

Declaration

public static void Blit(Texture source, RenderTexture dest, int sourceDepthSlice, int destDepthSlice);

Declaration

public static void Blit(Texture source, RenderTexture dest, Vector2 scale, Vector2 offset, int sourceDepthSlice, int destDepthSlice);

Declaration

public static void Blit(Texture source, Rendering.GraphicsTexture dest);

Declaration

public static void Blit(Texture source, Rendering.GraphicsTexture dest, Material mat, int pass = -1);

Declaration

public static void Blit(Texture source, Rendering.GraphicsTexture dest, Vector2 scale, Vector2 offset);

Declaration

public static void Blit(Texture source, Rendering.GraphicsTexture dest, int sourceDepthSlice, int destDepthSlice);

Declaration

public static void Blit(Texture source, Rendering.GraphicsTexture dest, Vector2 scale, Vector2 offset, int sourceDepthSlice, int destDepthSlice);

Parameters

source The source texture.
dest The destination RenderTexture or GraphicsTexture.
mat The material to use. If you don't provide mat, Unity uses a default material.
pass If the value is -1, Unity draws all the passes in mat. Otherwise, Unity draws only the pass you set pass to. The default value is -1.
scale The scale to apply.
offset The offset to apply.
sourceDepthSlice The element in the source texture to copy from, for example the texture in a texture array. You can't use sourceDepthSlice to specify a face in a Cubemap.
destDepthSlice The element in the destination texture to copy from, for example the texture in a texture array. You can't use destDepthSlice to specify a face in a Cubemap.

Description

Uses a shader to copy the pixel data from a texture into a render target.

This method copies pixel data from a texture on the GPU to a render texture or graphics texture on the GPU. This is one of the fastest ways to copy a texture.

When you use Graphics.Blit, Unity does the following:

  1. Sets the active render target to the dest texture. (See RenderTexture.active and GraphicsTexture.active.)
  2. Passes source to the mat material as the _MainTex property.
  3. Uses the material's shader to draw a full-screen surface from the source texture to the dest texture.

If you provide a mat material that doesn't have a _MainTex property, Blit doesn't use source. If you provide a GraphicsTexture as @dest@, it must have GraphicsTextureDescFlags.RenderTarget enabled in GraphicsTexture.descriptor.flags.

You can use Graphics.Blit to create post-processing effects, by setting mat to a material with a custom shader.

Blit changes RenderTexture.active and GraphicsTexture.active. Store the active render target before you use Blit if you need to use it afterwards.

Avoid setting source and dest to the same texture, as this may cause undefined behaviour. Use Custom Render Textures with double buffering instead, or use two render textures and alternate between them to implement double buffering manually.

In linear color space, set GL.sRGBWrite before using Blit, to make sure the sRGB-to-linear color conversion is what you expect.

To blit to the screen in the Built-in Render Pipeline, follow these steps:

  1. Set dest to null. Unity now uses Camera.main.targetTexture as the destination texture.
  2. Set the Camera.targetTexture property of Camera.main to null.

To blit to the screen in the Universal Render Pipeline (URP) or the High Definition Render Pipeline (HDRP), you must call Graphics.Blit or CommandBuffer.Blit inside a method that you call from the RenderPipelineManager.endContextRendering callback.

If you want to use a depth or stencil buffer that is part of the source (Render)texture, or blit to a subregion of a texture, you have to manually write an equivalent of the Graphics.Blit function - i.e. Graphics.SetRenderTarget with destination color buffer and source depth buffer, setup orthographic projection (GL.LoadOrtho), setup material pass (Material.SetPass) and draw a quad (GL.Begin).

See Also: Graphics.BlitMultiTap, Post-processing effects.

using UnityEngine;

public class Example : MonoBehaviour { // Copies aTexture to rTex and displays it in all cameras.

Texture aTexture; RenderTexture rTex;

void Start() { if (!aTexture || !rTex) { Debug.LogError("A texture or a render texture are missing, assign them."); } }

void Update() { Graphics.Blit(aTexture, rTex); } }
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961