自动关联目录：TSR 时域超分

官方依据：Temporal Super Resolution（UE 5.8 Documentation）。本页覆盖该页全部 36 个条目，并按本库标准重排为"原理 → 参数 → 代价 → 排查"。

1. 定位

TSR 是 UE 自研的平台无关时域超分器：以低于输出的分辨率渲染，把昂贵的计算分摊到多帧，用时间换画质。

一句话定位：TSR 是让 Nanite 的细节和 Lumen 的开销同时成立的关键——没有它，UE5 的画质与性能组合就撑不住。

官方给的实际收益：1080p 内部分辨率输出接近原生 4K 画质，GPU 帧时间减半。

2. 它是什么、在哪一环

在渲染链中的位置（很重要）：

... → 景深（Depth of Field）→ 【TSR】→ 运动模糊 → Bloom → 色调映射 → ...

TSR 发生在景深之后，之后的所有东西都是被放大过的。这直接导致"隐藏成本"，见第 6 节。

3. 五个组成部分

外加两个可选增强：

4. 参数与控制台变量

抗锯齿可扩展性组

sg.AntiAliasingQuality：0=Low, 1=Medium, 2=High, 3=Epic, 4=Cinematic。

BaseScalability.ini 的 [AntiAliasingQuality@3]（High）示例：

[AntiAliasingQuality@3]
r.FXAA.Quality=4
r.TemporalAA.Quality=2
r.TSR.History.R11G11B10=1
r.TSR.History.ScreenPercentage=200
r.TSR.History.UpdateQuality=3
r.TSR.ShadingRejection.Flickering=1
r.TSR.RejectionAntiAliasingQuality=2
r.TSR.Resurrection=1

项目自己的 DefaultScalability.ini 可以覆写。低于 50% 的极端超分只在目标分辨率 >4K，或主机动态分辨率的极少数情况下才应考虑。

核心 CVar

运动模糊相关（都默认开启）

5. 两个关键指标

TSR feed（MP/s）

TSR feed = 显示宽 × 显示高 × ScreenPercentage² × 帧率

衡量"TSR 每秒要收敛多少数据"，与显示分辨率无关地反映运动中的宏观画质。

TSR 1spp（收敛时间）

TSR1spp = 1000 / (ScreenPercentage² × FrameRate)   （毫秒）

达到"每像素一个样本"所需的时间——运动中遮挡解除区域能不能快速补上细节，就看它。

举例：Screen % = 50 时需要 (50/100)^-2 = 4 帧才有每像素一个样本；每帧 16.6ms → 遮挡解除区域要 66.4ms 才够。

重要推论：TSR 不只受 GPU 限制帧率影响，CPU 受限、以及非可变刷新率显示器上的 VSync，都会影响它。

查看方式：stat tsr（或 Viewport Options → Stat > Engine → 勾选 TSR）。

6. 代价与权衡

Nyquist-Shannon 历史：用 4 倍成本换锐度

历史重投影时，当前帧与上一帧的像素几乎不可能对齐，只能插值 → 引入模糊。1 像素厚的细节只移动半像素，这个细节就永久丢失了。

后果很具体：1080p 显示时，运动中的画面观感可能像 540p。

对策：Epic / Cinematic 档把 r.TSR.History.ScreenPercentage 设为 200——历史按两倍显示分辨率存储，用 Mitchell-Netravali 下采样核做重投影，符合 Nyquist-Shannon 采样定理。

代价很直白：历史更新的 GPU 成本变成 4 倍。官方说这看起来反直觉，但逻辑是"沿分辨率轴提供两倍信息"，下采样后保留的细节远多于不这么做。

担心帧预算就用 High 或更低档——Epic 抗锯齿档的 GPU 成本明显更高。

隐藏成本：TSR 之后的 pass

TSR 处在后处理链中段。如果没有二级屏幕百分比，运动模糊和色调映射等之后的所有 pass 跑在显示分辨率而不是渲染分辨率上。

官方明确说：因为 TSR 默认开启，有大量工作投入到降低这些"TSR 之后"的隐藏成本上（半分辨率/四分之一分辨率输出，影响 Gaussian DOF、Convolution Bloom、Lens Flare、自动曝光、Local Exposure）。

上采样本身的成本

TSR 的主要 GPU 工作随它拿到的分辨率缩放（部分工作必须在显示分辨率做）。Valley of the Ancients 实测：r.ScreenPercentage=100 约 0.79ms，=50 约 0.43ms。

异步计算的收益（Fortnite Ch4 / PS5 / XSX 实测）：视差启发式只依赖深度与速度缓冲（它们比场景色/半透明更早完成），可以异步计算，抵消约 0.5ms；最终 TSR 有效成本降到 1.5ms，关键路径 1.1ms。

7. 三类必须知道的内容约束

① WPO 顶点动画

用 WPO 做顶点动画的材质，必须同时求当前帧与上一帧才能得到正确运动向量；否则上一帧结果用的是当前帧的值 → 错误。

Previous Frame Switch 材质节点就是为此存在——它能生成正确的校正运动向量，让运动模糊与 TSR 重投影都正确。

② 半透明

半透明材质默认不画速度，最多画一层 → TSR 不知道它们怎么动 → 边缘不够锐利。

③ 像素动画的不透明材质

纹理平移这类像素着色器动画没有运动向量，但颜色频繁变化 → 被闪烁时域分析判定为"闪烁" → TSR 试图稳定它 → 产生鬼影。

解决方案：在材质（或材质实例的 Material Property Overrides）里勾选 Has Pixel Animation。这会把使用该材质的 primitive 编码进速度缓冲，让闪烁分析忽略这些像素。

8. 可视化与调试

DumpGPU（诊断跨帧累积问题最好用）

r.DumpGPU.Root="*TemporalSuperResolution*"
r.DumpGPU.FrameCount=30
r.DumpGPU.Stream=1
r.DumpGPU.FixedTickRate=30
r.DumpGPU.Delay=3
r.DumpGPU.CameraCut=1

• r.DumpGPU.FrameCount=30：TSR 跨帧累积，必须抓多帧才能看出伪影怎么演化
• r.ResetRenderTargetsExtent：改了渲染分辨率后让内部 RT 对齐
• 动态分辨率开启时可用 r.DynamicRes.TestScreenPercentage 锁定渲染分辨率（内部 RT 大小仍由 r.DynamicRes.MaxScreenPercentage 控制）

空间抗锯齿的自测

r.Test.CameraCut 1
r.Test.SecondaryUpscaleOverride 8
r.TSR.RejectionAntiAliasingQuality 0 / 1     ← 开关对比

9. 鬼影排查（官方给出的检查单，按序执行）

1. 确认是不是 TSR 造成的：用 Temporal Upscaler 视图看输入里有没有鬼影；或换抗锯齿方法/直接关掉 AA 对比。
2. 是不是运动向量错了：TSR 靠运动向量重投影不透明几何。如果问题只出现在特定物体而不是整个场景，基本就是运动向量。
   • 半透明（如云）覆写了速度？试 r.Translucency.Velocity 0 快速验证
   • WPO 是否基于动画参数？检查 Previous Frame Switch 是否喂了上一帧的值
   • 注意：运动向量计算不自动处理逐实例 transform 的运动
3. 是不是闪烁时域分析造成的（先确认 2 已经排除）：TSR 视图里找红色区域；若是做了着色器动画的不透明材质，勾 Has Pixel Animation。
4. 物体是不是半透明：在 Temporal Upscaler 的 Translucency.AfterDOF.Color 输入里确认。TSR 对 After DOF 半透明更不宽容（默认不画速度，无法正确重投影）。

10. 踩坑与排查

抗闪烁调参流程（官方给的步骤）

1. r.TSR.ShadingRejection.Flickering.FrameRateCap = 目标帧率（30 或 60）
2. t.MaxFPS 锁定编辑器帧率到同一个值
3. r.TSR.ShadingRejection.Flickering.Period 调到想要的效果
4. 确认后写进 DefaultEngine.ini，保证编辑器与目标平台一致

参考

• Temporal Super Resolution
• TSR FAQ
• 后处理与体积 · 虚拟阴影贴图 · Nanite