反编译导出

反编译器会遍历一个已有的 UMaterial 或 UMaterialFunction 节点图，写出等价的 DreamShaderLang 源文件。 这是把一个已经存在的材质迁进这门语言的办法 —— 不用手工重搭。

怎么调用

两个编辑器入口都要求恰好选中一个资产，写完文件后用你偏好的编辑器打开它 —— 见 编辑器工具。无头入口见命令行。

进度对话框在 0.25 秒延迟后出现，标题是 Decompiling Material '{Asset}'... 或 Decompiling Material Function '{Asset}'...，每访问一个节点走一帧。commandlet 运行中不显示。

文件写到哪

<SourceDirectory> 是 Source Directory 项目设置，默认 DShader。Layer 和 layer blend 各有自己的目录， 而且类判定是 blend 优先，所以 layer blend 永远不会落进 Layers。

在分类目录内部，资产的 package path 变成相对文件路径，每个 package 段一层目录：

/Game/Materials/Metal/M_Steel
  →  <Project>/DShader/Decompiled/Materials/Game/Materials/Metal/M_Steel.dsm

给 commandlet 传 -Out= 会覆盖整套计算，路径归一化后精确写到指定位置。编辑器入口不接受覆盖。

文件里的那个名字

写在文件内部的 Name= 不是文件路径。它是 Decompiled/<Category>/<package 段>， 每段里的 \ / . : 都换成 _：

/Game/Materials/Metal/M_Steel
  →  Shader(Name="Decompiled/Materials/Game/Materials/Metal/M_Steel")

文件结构

// Decompiled from <full object path>
[// Warning: <text>]…

[<VirtualFunction declaration>]…

{ Shader | ShaderFunction | ShaderLayer | ShaderLayerBlend }(Name="<generated name>")
{
    [Properties = { … }]
    [Inputs     = { … }]   // function kinds only
    [Settings   = { … }]   // Shader only
    [Outputs    = { … }]
    [Graph      = { … }]
    [Layout     = { … }]
}

反编译出来的 Shader 的 Settings 块总是以 Domain、ShadingModel 和 BlendMode 开头，无条件写出。 其他每一项设置只在与 UMaterial 类默认值不同时才写；能往返的集合见 材质 Settings。当反编译到 Base.FrontMaterial 绑定时，shading model 会被强制成 Substrate，因为 Substrate 材质自己的 shading-model 枚举并不描述它的表面。

Outputs 为每个已连接的材质属性声明一个变量并绑定它，顺序固定：

EmissiveColor, BaseColor, Metallic, Specular, Roughness, Anisotropy, Opacity, OpacityMask,
Normal, Tangent, WorldPositionOffset, SubsurfaceColor, CustomData0, CustomData1,
AmbientOcclusion, Refraction, PixelDepthOffset, MaterialAttributes,
FrontMaterial        (UE 5.4 及以上)

未连接的属性整条跳过。

能忠实还原的部分

节点遍历器对下面每个类都有一条精心写好的分支。其余全部落到通用回退。

直接写成 DreamShaderLang 语法

未连接的操作数 pin 会退回节点自己的常量属性（Min、Max、LinearInterpolate、Power 和 Clamp 都会读它们的 Const* 值），再退不成就退到字面量 0.0。

写成 property 声明

这些会变成 Properties 段里的条目，并在 Graph 中按名字引用。名字会做唯一化处理； 当 DreamShaderLang 标识符不得不与资产的参数名不同时，会补一条 ParameterName= 元数据。

只要有任何输入 pin 被连接，TextureSampleParameter2D 就改为写成一条精选的 UE.Expression， 参数实参和采样器实参一起带上 since 1.3.7。它的 RGBA 输出被写进一个具名临时变量一次， 其他每个 pin 都变成它的 swizzle。

写成精选的 UE.Expression

这些保留手写的参数列表，而不是反射 dump，所以只有真正与节点默认值不同的属性才会出现。

UE.Expression 回退

上面没有分支的类都会被导出成一个通用的 UE.Expression 调用， 反编译器同时为它记一条警告。

参数列表分两趟构建：

1. 每个已连接的输入 pin，按 pin 名命名，按 pin 顺序。
2. 每个值与类默认值不同的反射字面量属性 since 1.3.7。

一个属性只有同时满足下列全部条件，才会在第 2 趟被导出：

名字比较是在归一化之后做的，所以 bTwoSided 和 Two Sided 会冲突。

OutputType 总是写出，按真实输出索引解析。存在具名输出选择器（Output= / OutputName=）时， OutputIndex 会被抑制，因为生成器拒绝同时带两者的调用。参数超过三个、或长度超过 120 字符的调用会拆成多行。

Layout 导出

由 Export Decompiled Layout 项目设置控制，默认开。打开时文件会带一个 Layout 段：

文本以 DreamShader: 开头的注释框会被跳过 —— 那些是生成的标记，不是作者写的注释。

与这个设置无关地，每个表达式还会被归到最小的那个包住它的注释框，这些归属会变成对应 Graph 语句周围的 #Region / #EndRegion 指令。关掉 layout 导出会去掉 Layout 块，但不会去掉 region。 见 Layout 与 #Region。

诊断

运行期替换写作 {Placeholder}。

写进文件里的警告

每条只写一次，作为 // Decompiled from … 头行下面的 // Warning: … 注释。它们都不会让导出失败。

导出失败

编辑器 toast

日志：Display 级的 Exported Material '{Asset}' to DSM '{File}'.，以及 Warning 级的 Failed to export Material '{Asset}' to DSM: {Error}。

已知缺口

1.5.0 的实测行为。每一行都是导出文件还原不了的东西。把源文件当作事实来源之前， 先核对与你的资产相关的那几行。

示例

无头导出 /Game/Materials/M_Steel，然后看结果：

& "$Engine\Binaries\Win64\UnrealEditor-Cmd.exe" "I:\Project\Project.uproject" `
    -run=DreamShader decompile -Asset="/Game/Materials/M_Steel" `
    -unattended -nopause -nosplash -stdout -log

DreamShader decompiled '/Game/Materials/M_Steel.M_Steel' to
'I:/Project/DShader/Decompiled/Materials/Game/Materials/M_Steel.dsm'.

写出的文件：

// Decompiled from /Game/Materials/M_Steel.M_Steel
Shader(Name="Decompiled/Materials/Game/Materials/M_Steel")
{
    Properties = {
        ScalarParameter Roughness_0 = 0.35 [ParameterName="Roughness"];
        VectorParameter Tint = float4(0.8, 0.8, 0.82, 1.0);
    }
    Settings = {
        Domain = "Surface";
        ShadingModel = "DefaultLit";
        BlendMode = "Opaque";
    }

    Outputs = {
        float3 BaseColor;
        float Metallic;
        float Roughness;

        Base.BaseColor = BaseColor;
        Base.Metallic  = Metallic;
        Base.Roughness = Roughness;
    }

    Graph = {
        BaseColor = Tint.rgb;
        Metallic  = 1.0;
        Roughness = saturate(Roughness_0);
    }

    Layout = {
        Node(Var="Tint", X=-640, Y=-208);
        Node(Var="Roughness_0", X=-640, Y=48);
    }
}

注意第一条 property 上的 ParameterName="Roughness"。资产里那个参数就叫 Roughness， 但这个标识符在本文件里已经被占用了，于是声明被唯一化成 Roughness_0，真实参数名作为元数据保留下来 —— 否则重新生成的材质会以错误的名字暴露参数。见元数据与分组。

继续阅读