从一堆 Static Switch 说起
做过类似通用特效母材质的 TA 小伙伴,对这个场面不会陌生。下面就是一个典型例子:主贴图采样前的 UV 方案多选一——普通 UV0 / UV1、极坐标、Triplanar、屏幕空间,五个分支,串了四个 Static Switch Parameter,一条"面条"从左连到右。

更难受的是材质实例那一侧。美术看到的是 PolarCoord、ScreenSpace、Triplanar、UV0 or UV1 一排 bool 勾选框——不看节点图或说明文档,完全不知道该怎么勾;更何况这些开关本质互斥,同时勾上两个会发生什么,连做的人都得停下来想一下。

枚举项直接做成输入 Pin
解法是把枚举做成一等公民的静态参数。还是那张特效母材质,改造之后:五个 UV 方案收进一个 UVMethod 节点,枚举项就是输入 Pin,默认值在节点上直接下拉选,"面条"不见了。

实例侧的变化更直接:四个互斥 bool 收成一个下拉框,五个方案一目了然,不存在"勾两个会怎样"的问题。

配置侧也不复杂:枚举项就是 Details 面板里的一个字符串数组,增删后 Pin 自动重建,默认值越界会自动钳回去,不用担心手滑填出一个不存在的分支。

编译期发生了什么
引擎侧的关键是一条链路:实例的覆盖值进入静态参数集 → 参与 shader 缓存键 → 编译期查到生效值 → 只编译选中的那条分支 → 折叠成字面量。没选中的分支,连指令都不会生成。
// UMaterialExpressionStaticEnumParameter::Compile
if (FExpressionInput* EffectiveInput = GetEffectiveInput(Compiler))
{
return EffectiveInput->Compile(Compiler);
}Compile 通过 GetEffectiveInput 拿到当前生效的分支 Input,只编译它,其余分支压根不存在于编译结果里。
// FHLSLMaterialTranslator::StaticEnumParameter
uint32 Value = DefaultValue;
for (const FStaticEnumParameter& Parameter : StaticParameters.EditorOnly.StaticEnumParameters)
{
if (Parameter.ParameterInfo == ParameterInfo)
{
Value = Parameter.Value;
break;
}
}
return StaticUnsignedInt(Value); // 内联成 HLSL 字面量Translator 在静态参数集里查到实例覆盖值,直接内联成一个 uint 字面量。对 shader 来说这就是编译期常量,配合上面只保留一条分支,死代码被消得干干净净。
同时枚举值通过 FStaticEnumParameter::Append 写进 shader 缓存键,所以"高 / 中 / 低"各自是独立的 shader 变体、各自进 DDC,实例之间不会互相污染缓存。
5.8 的新编译路径:IR
上面走的是 Legacy 路径,也是目前绝大多数材质在走的路:FHLSLMaterialTranslator 顺着表达式图一路 Compile,每个节点把 HLSL 文本直接拼进输出流——"表达式 → 文本"的直译,没有中间表示,全局优化基本交给 shader 编译器善后。优点是成熟稳定、表达式全覆盖。
5.8 里还有一条 Epic 正在推进的新路径 Translate_New(引擎日志里自称 "new experimental material translator"):表达式先 Build 成一份后端无关的中间表示(Material IR),在 IR 层做分析和简化,再由 MIR → HLSL 翻译器生成最终代码。结构化的 IR 让全局优化有了落点,也是材质系统往后演进的方向;代价是目前仍是实验性、需要逐材质开启(全局 CVar r.Material.Translator.EnableNew 加母材质上的 bEnableNewHLSLGenerator),而且每个表达式都要单独适配一个 Build(MIR::FEmitter),没适配的节点在新路径下不可用。这个开关会写进 ShaderMapId,两条路径产出的 shader 在 DDC 里分开缓存,互不干扰。
Static Enum 两条路径都做了适配。IR 版的语义和 Legacy 一致:拿到生效的枚举值(GetMaterialExpressionParameterMetadata 内部会查实例的静态参数集,拿到覆盖后的值),把输出直接接到选中分支的输入上——没选中的分支在 IR 图里没有任何引用,自然消掉:
// UMaterialExpressionStaticEnumParameter::Build(IR 路径)
void UMaterialExpressionStaticEnumParameter::Build(MIR::FEmitter& Em)
{
FMaterialParameterMetadata Metadata = GetMaterialExpressionParameterMetadata(Em, this);
const int32 EnumIndex = static_cast<int32>(Metadata.Value.EnumIndex);
Em.Output(0, Em.Input(&Inputs[EnumIndex])); // 输出直接接到选中分支
}一个下拉框背后的改动量
48 个文件,约 1900 行。Runtime 侧是材质表达式、静态参数集、HLSL Translator 和 MIR;Editor 侧是动态 Pin 重建、Slate 枚举下拉(SGraphPinIntEnum)、Details 定制、材质实例编辑器和 MaterialAnalyzer;再加上序列化版本控制,以及材质函数、材质 Layer 链路上的参数透传。
这个功能跟着项目引擎版本做了好几轮 rebase(最近一版落在 5.8.4),中间还顺手修过一个 DEditorStaticEnumParameterValue 的悬垂指针。整套改造已经整理成上游 PR #13880,目前 Open,还没合并。
