Legacy Documentation: Version 2017.1 (Go to current version)
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Material.SetTexture

Switch to Manual
public void SetTexture(string name, Texture value);
public void SetTexture(int nameID, Texture value);

Parameters

nameID Property name ID, use Shader.PropertyToID to get it.
name Property name, e.g. "_MainTex".
value Texture to set.

Description

Sets a named texture.

Many shaders use more than one texture. Use SetTexture to change the texture (identified by shader property name, or unique property name ID).

When setting textures on materials using the Standard Shader, you should be aware that you may need to use EnableKeyword to enable features of the shader that were not previously in use. For more detail, read Accessing Materials via Script.

Common texture names used by Unity's builtin shaders:
"_MainTex" is the main diffuse texture. This can also be accessed via mainTexture property.
"_BumpMap" is the normal map.

See Also: mainTexture property, GetTexture, Shader.PropertyToID, Properties in Shader Programs.

Did you find this page useful? Please give it a rating: