Unreal渲染帧组织

游戏线程里对象已经改变，渲染帧却还用旧状态，先看更新怎样交给场景代理与渲染任务。Renderer组织可见性和通道，RDG安排资源，RHI表达后端请求。把这几个边界连起来，才能知道修改应放在哪一层，以及捕获里的命令对应哪份场景数据。

版本与证据范围

本篇按 UE5.4 官方 Renderer、RDG 与 Mesh Drawing Pipeline 文档中的稳定概念组织。具体方法签名、源码行号、GPUScene 和 Nanite 路径以项目 checkout 为准。文档核对日期为 2026-10-22，未将未运行的示例标记为引擎实验。

数据与线程边界

游戏线程：Component 与游戏状态
  → SceneProxy / 场景更新
渲染线程及任务：可见性、MeshBatch、通道组织
  → RDG 声明与编译
RHI 命令列表：资源、绘制与同步请求
  → D3D12 / Vulkan / Metal 后端
GPU 队列：执行与完成

SceneProxy 是渲染侧表示，不能假设它是游戏组件的实时可变镜像。更新按引擎跨线程消息与资源生命周期完成。RHI 线程是软件任务分工，实际后端队列由平台能力决定。

状态快照与延迟销毁

假设游戏线程把对象颜色从红色改为蓝色。渲染命令应携带蓝色这个值，渲染侧再写入自己的场景表示；若命令只保存组件指针，并在稍后读取其颜色，这时组件可能又变成绿色，甚至已经销毁。按值提交让本次更新对应一个确定状态，对象所有权则保证命令执行期间目标代理仍有效。

游戏线程：构造更新包 {proxyId, generation, color, transform}
提交队列：按引擎契约传递更新包并保留所需资源
渲染侧：校验代理身份 → 应用快照 → 构建本帧命令
销毁侧：停止新更新 → 注销代理 → 等待对应渲染工作完成 → 释放资源

这是所有权伪代码，generation用于说明防止槽位复用，不宣称UE内部每种代理都采用同一字段。UE5.4官方Threaded Rendering的线程数据结构与资源释放章节支持线程分属及延迟释放原则。CPU渲染任务结束与GPU使用资源结束是两种事件，涉及GPU资源回收时还要满足后端完成条件。

排查一帧滞后时记录游戏状态版本、代理应用版本与捕获帧号。版本连续而固定落后一帧可能是流水化结果；更新丢号或销毁后继续消费则是所有权问题。每帧强制等待渲染线程会压缩流水线，先用这些记录确认需求，再决定是否存在必须等待的边界。

网格与全屏功能

网格通道常经过 MeshBatch、PassProcessor、MeshDrawCommand，再提交排序和缓存后的命令。后处理或计算功能常直接以 RDG 全屏或计算通道表达，两者可以使用同一帧的资源。

EMeshPass 类型注册不自动决定运行时顺序；场景渲染器需要显式调度。源码改动应记录注册、处理器、Shader 类型、资源、消费者和执行位置。

Shader 与参数

Global Shader 适合独立的全屏或计算功能。Material Shader 与 VertexFactory 组合表达不同几何输入及材质逻辑。Permutation 控制编译组合，ShouldCompilePermutation 根据平台能力排除无效组合。

参数结构让引擎生成绑定信息，RDG 参数还提供资源访问声明。静态开关会影响 Shader 组合，附件格式和深度混合状态进一步影响 PSO。减少组合需要同时检查构建日志、包体、运行内存和首用卡顿。

自定义功能的定位

一个原型先确认输入和输出：后处理颜色、独立对象 buffer，还是参与 GBuffer 和光照。可用项目插件或现有扩展入口表达时，按该版本接口接入；涉及核心材质编码、网格通道注册与布局时，需要对照引擎源码。

定义输入/输出
  → 选择 Material / View Extension / RDG / Mesh Pass 入口
  → 注册 Shader 与参数
  → 声明资源消费者
  → 捕获通道、参数和输出

这是接入步骤轮廓，具体入口可用范围需项目版本核对。不要把一种版本的类名当成所有 UE5 的统一配方。

材质生成与绘制

Material Graph 生成目标 Shading Model 和 Pass 所需 Shader。Material Domain、Blend Mode、Shading Model、Two Sided 等设置会影响生成哪些变体和管线路径。

Unlit Material 只表示不走常规受光模型，不代表没有 Base Pass、Depth、Translucency 或后处理成本。

对象遮罩与后处理

Unreal 可以让选定对象写 Custom Depth/Stencil，再在 Post Process Material 中读取，用于描边、遮挡显示和分类效果。

先确认选中对象是否写入Custom Depth，再用Stencil区分类别。若目标是只显示可见部分，把该对象深度与场景最近深度在相同投影约定下比较；若要透墙显示，则单独定义遮挡分支。透明是否参与写入由材质与版本配置核对。最后检查TAA前后位置及上采样分辨率，否则遮罩与颜色可能来自不同像素网格，静态正确、移动时却出现错边。

后处理颜色阶段

通过 Blendable Location 插入后处理。不同位置提供不同 Scene Color 状态：HDR、Tone Mapping 前后、Translucency 前后可能不同。

例如场景线性值4在色调映射以后已被压到显示范围。在后处理材质里读取不同位置的Scene Color，再套同一亮度阈值，会选择不同的像素。先用恒等输出核对输入含义，再添加运算；若效果需要HDR亮度，应选择保留该信息的阶段，而不是在显示颜色上提高阈值。材质必须明确读取的Scene Texture是否在当前路径可用。

CPU反馈与GPU完成

渲染功能若需要把GPU统计交回Gameplay，记录命令时还没有统计结果。读取必须等待对应GPU工作及回读传输完成，再以帧号或请求ID交付。游戏线程用当前帧状态解释迟到的上一帧计数，可能把已经删除对象的结果应用到新对象，因此交付还需核对对象身份与结果年龄。

每帧同步等待回读会把GPU延迟直接加到游戏线程关键路径；可延迟消费的调试与统计应采用在途请求与完成查询。必须同帧获得的权威结果则需要重新评估是否适合由GPU异步功能产生。粒子内部模拟与透明成本由 GPU粒子系统 解释，本页关注帧之间的数据交接。

配置与观测

变量名和默认值由版本决定；参数表应记录项目实际值、来源和预期通道变化。编辑器和 Shipping 性能要分别记录。

验证方法

• 给新通道唯一事件名，在 GPU 捕获中确认实际位置与资源格式。
• 停用输出消费者，检查通道和资源是否按图语义变化。
• 在双视图、阴影、透明和不同画质下检查 Shader 组合。
• 捕获游戏线程、渲染线程与 GPU，判断卡顿是编译、记录、等待还是执行。
• 升级引擎时重新检查类型注册、参数结构、消费者和平台实现。

相关主题

• Unreal RDG Pass实现
• Unreal自定义Mesh Pass
• PSO首次使用卡顿

示例与验证范围：代码按文中前提解释机制，完整类型、资源和项目状态需由接入工程补齐。完整目标引擎运行与GPU性能尚未验证；正文给出的机制与实际实验范围分别记录。

参考资料

• Unreal RDG，Shader Parameter Structs与Resource Lifetimes。
• Unreal Mesh Drawing Pipeline，Cached and Dynamic Mesh Batches与FMeshPassProcessor。
• Epic Games，Shader Development、Unreal Insights 与 Graphics Programming 官方文档。
• 源码定位：Renderer/Private、RenderGraphBuilder.h、RHICommandList.h、MeshPassProcessor.h。