常见问题

1. Untoon Engine 和普通卡通后处理方案有什么区别？

普通后处理方案只能在屏幕空间做风格化，材质、阴影、多光源和 Lumen 路径都很难稳定控制。

Untoon Engine 把 Untoon 语义加进引擎渲染管线，能长期用，代价是维护成本更高。

2. 为什么不做成插件？

因为改动落在插件碰不到的地方：Shading Model、GBuffer、材质翻译器、Renderer Pass、Shader 组织。这些改动超出普通插件的安全边界，只能按源码引擎分支维护。

3. 使用这个分支后，非 Untoon 材质还能正常工作吗？

可以。分支保留 UE 默认光照，Untoon 是并行增加的一条路径。

4. 灯光一定只能影响 Untoon 材质吗？

不一定。每盏灯对默认光照和 Untoon 光照各有自己的开关和强度。

5. 我应该先调材质还是先调灯光？

先把 Untoon 材质调到一版稳定基线，再调灯光。反过来做，容易把材质的问题当成灯光问题。

6. 上游合并最容易出问题的地方在哪里？

集中在材质翻译器、GBuffer 绑定、Deferred Renderer 调度、Shader 参数结构体，以及 Untoon shader 的宏和函数名。

7. Wiki 应该如何继续扩展？

按需要补，大致按这个优先级：角色材质样例、场景灯光预设、常见报错排查、Shader 调试工作流。

8. 哪些文件不需要 Untoon Engine Start/End 包裹？

以下 Untoon 自有目录内的文件不需要 marker：

• Engine/Shaders/Private/Untoon
• Engine/Source/Runtime/Renderer/Private/Untoon

其他 engine、renderer、shader、runtime 文件中的 Untoon 改动仍需要 marker。

9. 已经在 marker 里的代码还要再包一层吗？

不需要。marker 只保留一层。如果改动位置已经在 Untoon Engine Start/End 中，直接在现有块内修改，不要嵌套 marker。