NoGeneration

DreamShader » Generation » NoGeneration

（2.1.2 之后） 一个源，或它的某个导出，只有命名它的编译才会构建它。其他所有编译都会让其资产保持磁盘上的原样，任何使用该资产的东西也按原样使用它。

用于重建代价高昂的资产，或由某人在编辑器中手动调整、不应在共享头部每次更改时被重建的资产。

编写它

// M_Ocean.dss -- none of its assets is rebuilt unless the file is compiled by name.
#pragma nogeneration

export void M_Ocean(inout material m) { … }

// Only MF_Heavy is left alone; MF_Light is built as usual.
/// @nogeneration
export float3 MF_Heavy(float3 p) { … }

export float3 MF_Light(float3 p) { return MF_Heavy(p) * 0.5; }

// 1.x: on any block that builds an asset -- Shader, ShaderFunction, ShaderLayer, ShaderLayerBlend.
ShaderFunction(Name = "Noise/MF_Heavy", NoGeneration = true)
{
    …
}

1.x 文件也可以在其顶层为文件的每个块写入 #pragma nogeneration。dsc migrate 会把 NoGeneration = true 写为 /// @nogeneration。

未命名它的编译会做什么

源仍会被读取、绑定和检查，因此保存仍会报告其错误。然后，对于每个 NoGeneration 资产：

文件的其他资产会照常构建。调用同一文件的 NoGeneration 导出的资产会调用磁盘上的资产；当没有时，会以 DSH8279 失败。

使用它的东西

没有任何东西会替它先编译一个 NoGeneration 源：

DSH8279 要求你按名称编译该源一次；从那时起，其使用者会基于那次编译所写的内容进行构建。

手动编辑

NoGeneration 资产绝不会在你背后被重建，因此对它的手动编辑会在每次不命名该源的编译中保留下来。而命名它的编译是一次普通重建，分歧检查仍会阻止它在未经询问的情况下覆盖手动编辑。

另见

• 缓存 — 编译让资产保持原样的另一个原因：其构建键是当前的
• 重新生成 — 重建会对资产做什么
• 禁用诊断 — 对于一个从不打算自动构建的文件，可以禁用 DSH8278