In the Unity Editor, when you view a material in the material InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary, you can enable and disable its local shaderA program that runs on the GPU. More info
See in Glossary keywords. This is useful for two reasons:
[KeywordEnum]
MaterialPropertyDrawer, Unity automatically disables the other keywords in a set. This ensures that exactly one keyword from a set is enabled at any time.As with any shader settings or data, shader keywords are only available in the material Inspector when they are declared as material properties in the shader source file.
For shaders created in Shader Graph, keywords are material properties by default. This means that these settings are automatically available in the material Inspector. To change this, open the Blackboard, and change the Exposed property.
For hand-coded shaders, you must ensure that your ShaderLabUnity’s language for defining the structure of Shader objects. More info
See in Glossary code defines a material property that represents the keyword set. The material property must have a type of Float
, and must use the [Toggle]
, [ToggleOff]
, or [KeywordEnum]
MaterialPropertyDrawer attribute to expose it correctly to the Inspector.
Shader "Custom/ApplyEffectIfKeywordIsOn"
{
Properties
{
// Display a toggle in the Material's Inspector window
[Toggle] _Keyword ("Keyword", Float) = 0.0
}
SubShader
{
Pass
{
#pragma shader_feature _Keyword
fixed4 frag(v2f i) : SV_Target
{
#if _Keyword
// If _Keyword is on at build time, Unity creates a shader variant that uses the following code
ApplyEffect();
#endif
// rest of shader code...
}
}
}
}
For more information and examples, see the documentation for the MaterialPropertyDrawer API.