ShaderLab：定义材质属性

本页面包含有关在 ShaderLab 代码中使用 Properties 代码块为 Shader 对象定义材质属性的信息。

概述

在 ShaderLab 代码中，可以定义材质属性。材质属性是 Unity 作为材质资源一部分存储的属性。这使美术师可以创建、编辑和共享具有不同配置的材质。

如果使用材质属性：

• 可以通过对材质调用函数（例如 Material.SetFloat）来获取或设置 Shader 对象中的变量值。
• 可以使用材质 Inspector 查看和编辑值。
• Unity 会将进行的更改保存为材质资源的一部分，因此它们可在会话之间持续存在。

如果不使用材质属性： * 仍可以通过对材质调用函数来获取或设置 Shader 对象中的变量值。 * 这些值没有可视化编辑器。 * 更改不会在会话之间持续存在。

通常_不_创建材质属性的唯一情况是如果要完全使用脚本设置着色器属性值（例如，如果在制作程序化内容）、如果无法将属性设为材质属性或者如果不希望在 Inspector 中编辑它们。

渲染管线兼容性

使用 Properties 代码块

要在 ShaderLab 中将材质属性分配给 Shader 对象，请在 Shader 代码块内放置一个 Properties 代码块。

材质属性声明

所有材质属性声明都遵循以下基本格式：

[optional: attribute] name("display text in Inspector", type name) = default value

确切语法因类型而异。

本节包含以下相关信息：

• 按类型划分的材质属性声明语法。
• 材质属性特性

按类型划分的材质属性声明语法

类型名称和默认值的语法取决于属性的类型。

在着色器代码中，通常所有属性名称都以下划线字符开头。本页面上的示例遵循此约定。

材质属性特性

材质属性声明可以具有一个可选特性，用于告知 Unity 如何处理它们。

除了此处列出的特性外，可以使用相同语法向材质属性添加 MaterialPropertyDrawer。通过这些内容可以控制材质属性在 Inspector 窗口中的显示方式。

将材质属性与 C# 代码结合使用

材质属性在 C# 代码中通过 MaterialProperty 类进行表示。

要访问 HLSL 代码中定义的变量，可以调用 Material.GetFloat、Material.SetFloat。还有其他类似的方法；请参阅材质 API 文档以获取完整列表。使用这些 API 访问 HLSL 变量时，变量是否为材质属性并不重要。

在 Unity 编辑器中，可以控制材质属性在 Inspector 窗口中的显示方式。为此，最简单的方法是使用 MaterialPropertyDrawer。对于更复杂的需求，可以使用 MaterialEditor、MaterialProperty 和 ShaderGUI 类。有关为着色器创建自定义 GUI 的更多信息，请参阅 ShaderLab：分配自定义编辑器。

在 ShaderLab 代码中使用材质属性设置变量

要在 ShaderLab 代码中通过材质属性设置变量的值，请在 ShaderLab 代码中将材质属性名称置于方括号中。

此示例代码演示使用材质属性设置 ShaderLab Offset 命令的 units 值的语法。

Shader "Examples/MaterialPropertyShaderLab"
{
    Properties
    {
        // 在材质 Inspector 中更改此值以影响 Offset 命令的值
        _OffsetUnitScale ("Offset unit scale", Integer) = 1
    }
    SubShader
    {
        // 此处是定义 SubShader 其余部分的代码

        Pass
        {
            Offset 0, [_OffsetUnitScale]

           // 此处是定义 Pass 其余部分的代码
        }
    }
}

在 HLSL 代码中使用材质属性设置变量

要使用材质属性在 HLSL 代码中设置变量的值，请为材质属性提供与着色器属性相同的名称。

可以在以下文章中查看此技术，其中包括正常工作的代码示例：

• 为内置渲染管线编写顶点和片元着色器
• 为通用渲染管线编写自定义着色器