Version: 2019.3
LanguageEnglish
  • C#

Shader.SetGlobalTexture

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

Switch to Manual
public static void SetGlobalTexture(string name, Texture value);
public static void SetGlobalTexture(int nameID, Texture value);
public static void SetGlobalTexture(string name, RenderTexture value, Rendering.RenderTextureSubElement element);
public static void SetGlobalTexture(int nameID, RenderTexture value, Rendering.RenderTextureSubElement element);

Parameters

nameIDThe name ID of the property retrieved by Shader.PropertyToID.
nameThe name of the property.
valueThe texture to set.
elementOptional parameter that specifies the type of data from the render texture to set.

Description

Sets a global texture property for all shaders.

Global properties are used if a shader needs them but the material does not have them defined (for example, if the shader does not expose them in Properties block).

Usually this is used if you have a set of custom shaders that all use the same "global" texture (for example, custom diffuse-lighting cubemap). Then you can set the global property from script and don't have to setup the same texture in all materials.

By specifying a RenderTextureSubElement, you can indicate which type of data from the render texture to set. The possible options are: RenderTextureSubElement.Color, RenderTextureSubElement.Depth, RenderTextureSubElement.Stencil.

See Also: SetGlobalColor, SetGlobalFloat; Material class, ShaderLab documentation, RenderTextureSubElement.