Version: 2023.2
LanguageEnglish
  • C#

Shader.SetGlobalColor

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

Declaration

public static void SetGlobalColor(string name, Color value);

Declaration

public static void SetGlobalColor(int nameID, Color value);

Parameters

nameID The name ID of the property retrieved by Shader.PropertyToID.
name The name of the property.

Description

Sets a global color 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" color (for example, color of the sun). Then you can set the global property from script and don't have to setup the same color in all materials.

Note that unlike Material.SetColor, this function doesn't do color space conversion. It is just an alias to SetGlobalVector.

Additional resources: SetGlobalFloat, SetGlobalVector, SetGlobalTexture; Material class, ShaderLab documentation.