1. 项目概述与核心价值

最近在做一个需要实时记录UE5虚拟拍摄画面的项目，客户要求能把CineCamera拍到的每一帧画面都实时保存成JPG或PNG图片，方便后期做分析。一开始我尝试了传统的截图方法，但要么延迟太高，要么画质被压缩，根本达不到“所见即所得”的实时性要求。折腾了一圈，最后发现UE5自带的Composure插件才是解决这个需求的“隐藏神器”。很多人以为Composure只是个做后期合成的工具，其实它内置的渲染输出管线，能让你以极低的性能开销，把任意相机视角的画面无损导出到硬盘上。这比用蓝图定时截图或者写C++插件截取RenderTarget要稳定和高效得多。

这个教程就是把我踩过的坑和最终跑通的完整流程记录下来，目标就是让你看完后，能在自己的UE5项目里，把CineCamera的画面像录监控一样，一帧不差地保存成序列图。无论你是做虚拟制片需要记录演员表演与虚拟场景的合成帧，还是做自动驾驶仿真需要导出传感器（相机）的感知结果，或者是做建筑可视化需要批量渲染不同角度的静帧，这套方案都能直接套用。整个过程不需要写一行C++代码，完全在编辑器内通过蓝图和Composure的节点配置完成，对美术和TA同样友好。

2. Composure插件核心原理与启用

2.1 Composure不是简单的“截图工具”

首先得打破一个误区：Composure不是一个截图插件。它的全称是“Composure Post Process”，本质是一套基于图层（Layer）的、可编程的后期合成与渲染管线。你可以把它理解为一个在UE引擎内部运行的、简易版的After Effects或Nuke。它的核心能力在于，能够以独立的渲染通道（Pass）处理场景中的不同元素（比如前景、背景、UI、特效），最后再把这些图层按照你设定的逻辑合成最终画面。

而我们利用的，正是它这个“独立渲染通道”的能力。我们可以创建一个专门用于输出的“直通”图层，让它只接收来自CineCamera的渲染结果，然后通过Composure的输出配置，将这个图层的内容直接“流”到硬盘上，保存为图像文件。这样做的好处是：

1. 性能隔离：输出渲染与主视图渲染是分离的，不会因为高分辨率的截图而卡顿游戏线程或渲染线程。
2. 画质无损：可以绕过屏幕缩放和UI叠加，直接获取渲染缓冲区（Render Buffer）的原始数据，支持包括浮点格式（如EXR）在内的多种格式，对于JPG/PNG也能保证最高质量。
3. 高精度控制：可以精确控制输出的分辨率、帧率、色彩空间，甚至可以为输出单独设置后处理效果，而不影响主视图。

2.2 插件启用与项目设置要点

在开始之前，确保你的UE5项目已启用Composure插件。

1. 打开你的项目，点击菜单栏的编辑（Edit）->插件（Plugins）。
2. 在插件窗口的搜索框中输入“Composure”。
3. 找到“Composure”插件，勾选其右侧的“已启用（Enabled）”复选框。
4. 编辑器会提示需要重启。点击“立即重启（Restart Now）”。

注意：有些UE5版本（尤其是早期版本或特定分发版）可能将Composure归类在“内置（Built-in）”或“渲染（Rendering）”分类下。如果直接搜索不到，可以浏览这些分类。

插件启用并重启后，需要进行一项关键的项目设置，否则后续步骤可能会失败。

1. 点击菜单栏编辑（Edit）->项目设置（Project Settings）。
2. 在左侧找到“插件（Plugins）”部分，点击其下的“Composure”。
3. 在右侧的设置面板中，找到“为合成渲染器创建后备缓冲区（Create Backbuffer for Compositing Renderer）”选项。务必将其勾选上。
4. 解释一下为什么：这个选项会为Composure合成器分配一个独立的渲染目标（Render Target）作为后备缓冲区。我们的输出图层需要绑定到这个缓冲区来获取渲染数据。如果不开启，输出管线可能无法正确初始化，导致导出失败或得到黑屏图片。

3. 构建实时输出管线：从场景搭建到Composure配置

3.1 场景准备与CineCamera设置

首先，我们需要一个拍摄主体和一台CineCamera相机。

1. 在场景中随意放置一些物体，或者打开一个已有的项目场景。
2. 在内容浏览器中右键或点击“添加（Add）”按钮，选择“摄像机（Cinematic）”->“电影摄影机Actor（Cine Camera Actor）”，将其拖入场景。我习惯将其重命名为“CC_OutputSource”。
3. 调整CC_OutputSource的位置和角度，对准你想要拍摄的内容。
4. 关键设置：选中CC_OutputSource，在细节（Details）面板中，找到“镜头（Lens）”设置。将“当前焦距（Current Focal Length）”设置为你需要的值（例如35mm）。更重要的是，确保“光圈（Aperture）”值不是0（例如设为f/2.8）。在某些渲染模式下，光圈为0可能导致曝光计算异常，影响输出画面的亮度。

3.2 创建Composure合成元素与输出图层

这是整个流程的核心步骤，我们需要在关卡中搭建Composure的合成逻辑。

1. 在场景中再次点击“添加（Add）”按钮，这次选择“视觉效果（Visual Effects）”->“合成元素（Compositing Element）”。将其拖入场景，重命名为“Comp_OutputPipeline”。
2. 选中Comp_OutputPipeline，在细节面板中，点击“打开合成器（Open Compositing Comp）”按钮。这会打开Composure专用的合成器编辑界面。
3. 合成器界面看起来可能有点复杂，但别慌。我们只需要关注两个核心部分：左侧的“元素列表（Element List）”和中间节点的“输入/输出（Inputs/Outputs）”。
4. 在“元素列表”中，默认会有一个名为“FinalComp”的元素。我们不需要改动它。我们需要创建一个新的“输出（Output）”元素。点击列表下方的“+ 元素（+ Element）”按钮，在弹出的菜单中选择“输出（Output）”。将其重命名为“Output_JPG”。
5. 创建后，确保Output_JPG元素被选中。在右侧的“细节（Details）”面板中，找到“输出（Output）”类别。这里就是配置导出格式和路径的地方。
   • 输出文件名格式（Output Filename Format）：这是定义保存图片命名规则的字符串。我推荐使用：{shot}_{frame}.jpg。其中{shot}会被替换为“输出镜头名称（Output Shot Name）”，{frame}会被替换为帧号。例如，你可以将“输出镜头名称”设为“MyRender”，那么生成的文件就会是MyRender_00001.jpg，MyRender_00002.jpg。
   • 输出目录（Output Directory）：点击文件夹图标，选择一个项目内的目录来保存图片。例如，可以创建一个Saved/Screenshots/Composure/文件夹。绝对不要使用包含中文或特殊字符的路径，这可能导致保存失败。
   • 输出格式（Output Format）：下拉菜单中可以选择PNG或JPG。根据你的需求选择：
     • JPG：有损压缩，文件小，适合对文件大小敏感、不需要透明通道的连续帧记录。
     • PNG：无损压缩，文件较大，支持Alpha透明通道。如果你的CineCamera拍摄的画面包含半透明物体（如粒子特效、透明材质）且你需要保留透明度信息，必须选PNG。
   • 图像质量（Image Quality）：如果选择JPG，这个滑块会生效。100为最佳质量，文件也最大。通常85-95能在画质和文件大小间取得良好平衡。
   • 启用写入磁盘（Enable Write to Disk）：这是最重要的开关！只有勾选它，Composure才会真正把图片写到硬盘上。但先别急着勾，我们还需要连接输入源。

3.3 连接CineCamera到输出图层

现在，我们需要告诉Output_JPG这个输出元素，它的画面数据从哪里来。

1. 在合成器界面的节点区域，你应该能看到Output_JPG节点有一个输入引脚（通常是左侧的某个端口）。
2. 我们需要为它提供一个输入源。在左侧“元素列表”中，再次点击“+ 元素”按钮，这次选择“直通（Pass Through）”。将其重命名为“Pass_CameraView”。直通元素的作用就是简单地将其输入传递到输出，不做任何处理，正好用来承载我们的相机画面。
3. 将Pass_CameraView元素拖到节点区域。现在我们需要设置它的输入源为我们的CineCamera。
4. 选中Pass_CameraView节点，在右侧细节面板，找到“直通（Pass Through）”类别。点击“输入（Input）”旁边的下拉菜单（或空白处的“选择（Select）”按钮）。
5. 在弹出的对象选择器中，找到并选择我们之前放置在场景中的电影摄影机Actor：CC_OutputSource。
6. 连接节点：用鼠标从Pass_CameraView节点的输出引脚（右侧）拖出一条线，连接到Output_JPG节点的输入引脚（左侧）。这条线就代表了数据流：CineCamera的画面 -> 直通元素 -> 输出元素。
7. 现在，回到Output_JPG元素的细节面板，勾选“启用写入磁盘（Enable Write to Disk）”。

至此，一个最基础的实时输出管线就搭建好了。理论上，当你运行游戏（PIE）时，Composure就会开始按照游戏帧率，将CC_OutputSource相机看到的画面保存为图片。

4. 蓝图控制与高级参数配置

4.1 使用蓝图控制输出启停与命名

我们不能让输出一直无休止地进行。通常我们需要在特定时刻（如按下某个键、触发某个事件）开始录制，在另一时刻停止。这就需要用到蓝图。

1. 在内容浏览器中右键，选择“蓝图类（Blueprint Class）”->“Actor”，创建一个新的蓝图，命名为BP_ComposureController。
2. 双击打开BP_ComposureController。
3. 在事件图表（Event Graph）中，我们需要获取对场景中Comp_OutputPipeline（合成元素Actor）的引用。通常有两种方式：
   • 方式一（推荐）：通过标签获取。在场景中选中Comp_OutputPipeline，在细节面板的“标签（Tags）”处，添加一个标签，例如“ComposureOutput”。然后在蓝图中，使用“Get All Actors With Tag”节点，输入标签名“ComposureOutput”，从返回的数组中找到第一个元素（索引0），并转换为“Compositing Element”类型。
   • 方式二：直接引用。如果该控制器只在这个特定关卡使用，可以将Comp_OutputPipeline直接拖拽到蓝图的变量列表中，创建一个对象引用变量，并在场景中把Comp_OutputPipeline赋值给它。
4. 获取到Comp_OutputPipeline的引用后，我们可以调用其函数来控制输出。关键函数在“Composure元素（Composure Element）”类别下：
   • “设置元素启用状态（Set Element Enabled）”：可以启用或禁用某个合成元素。我们可以用这个来开关Output_JPG元素。
   • “设置渲染输出启用（Set Render Output Enabled）”：更直接的控制输出写入磁盘的函数。
   • “设置输出文件名格式（Set Output Filename Format）”：动态修改输出文件的命名规则。
   • “设置输出镜头名称（Set Output Shot Name）”：动态修改{shot}标签所替换的名称。

一个典型的控制流程蓝图如下：

• 事件开始运行（Event BeginPlay）时，先调用Set Render Output Enabled，将Output_JPG元素禁用（Enabled参数为false），确保一开始不会误写入。
• 按下键盘按键（例如‘R’）事件：
  • 第一次按下时，先使用Set Output Shot Name设置一个唯一的镜头名（例如“Take_01”），然后调用Set Render Output Enabled启用输出。
  • 再次按下‘R’时，调用Set Render Output Enabled禁用输出。

这样，你就可以通过键盘按键，精准控制录制的开始和结束了。

4.2 分辨率、帧率与抗锯齿深度配置

默认情况下，输出图片的分辨率与你游戏窗口的分辨率一致。但很多时候我们需要输出4K甚至更高分辨率的静态帧，或者以低于游戏帧率的频率采样。

1. 输出分辨率：选中Output_JPG元素，在细节面板的“输出（Output）”类别下，找到“输出分辨率乘数（Output Resolution Multiplier）”。这是一个缩放因子。例如，游戏窗口是1920x1080，将此值设为2.0，则输出图片分辨率将是3840x2160（4K）。注意：提高分辨率会显著增加GPU负载和单帧渲染时间，可能无法维持实时帧率。
2. 渲染帧率控制：Composure本身不直接提供“每隔N帧保存一张”的选项。实现这个功能需要在蓝图里做逻辑控制。思路是：
   • 在控制输出的蓝图中，维护一个帧计数器（整数变量）。
   • 每帧（Event Tick）将计数器加1。
   • 当计数器达到你设定的间隔（例如，30帧保存一次）时，才调用一次Set Render Output Enabled (true)，并在下一帧立即调用Set Render Output Enabled (false)。这样就能实现抽帧保存。切记要立刻关闭，否则会连续保存。
3. 抗锯齿与后处理：Pass_CameraView元素会继承CineCamera上的所有后期处理体积（Post Process Volume）和相机自身的后期设置。如果你需要为输出单独配置抗锯齿（如Temporal AA）或调色，最好的方法是为这台CC_OutputSource相机单独添加一个“相机后期处理体积（Camera Post Process Volume）”，并只影响这台相机。在体积设置中，你可以调整抗锯齿方法、胶片颗粒、色差等所有后期参数，而这些调整不会影响主玩家视角。

5. 实战调试与性能优化策略

5.1 常见问题与排查清单

在实际操作中，你可能会遇到以下问题。这里提供一个快速排查清单：

5.2 性能优化与稳定性心得

经过多个项目的实践，我总结了几条保证Composure输出稳定高效的要点：

1. 固态硬盘是必须的：实时保存序列图是连续的、小文件的密集写入操作。机械硬盘的磁头寻道时间会成为巨大瓶颈，导致丢帧甚至引擎崩溃。务必使用NVMe或SATA SSD作为输出目录所在盘。
2. 内存监控：长时间、高分辨率的序列输出会占用大量内存（尤其是使用PNG格式时）。建议在输出时打开任务管理器，观察UE5编辑器进程的内存占用。如果持续增长，可能是内存泄漏的征兆，需要检查蓝图逻辑，确保在停止输出后相关资源被正确释放。
3. 异步保存：Composure的写入操作默认是同步的，即渲染完一帧后，引擎会等待该帧图片写入磁盘完成，再进行下一帧。对于高帧率（如60fps）录制，这可能导致卡顿。遗憾的是，编辑器内置功能未提供异步选项。如果遇到此问题，一个变通方案是降低输出帧率，比如通过蓝图控制每2帧或每3帧保存一次，给硬盘写入留出时间。
4. 单独的输出相机：强烈建议为输出专门创建一个CineCamera，并将其放置在独立的、优化过的子关卡（Sublevel）中。这个子关卡可以只包含输出必需的几何体和灯光，关闭所有与输出无关的Actor（如NPC、动态粒子、体积雾等）。在需要输出时动态加载这个子关卡，输出完毕后再卸载。这能最大程度减少性能干扰。
5. 测试先从低分辨率开始：在搭建完管线后，不要立刻用4K分辨率测试。先将游戏窗口和输出分辨率都设为720p，确保整个流程（触发、保存、命名、停止）全部跑通，再逐步提高分辨率，这样可以快速定位问题是出在流程逻辑还是性能瓶颈上。

6. 扩展应用：序列帧、Alpha通道与批处理

6.1 生成带Alpha通道的序列帧

对于需要后期合成的项目，带透明通道（Alpha）的序列帧至关重要。用Composure实现这一点非常优雅。

1. 在Output_JPG元素的“输出格式”中，选择PNG。PNG格式天然支持Alpha通道。
2. 关键在于场景渲染。你需要确保背景是透明的。有两种主流方法：
   • 方法A：使用绿色幕布（Chroma Key）：在3D场景中放置一个绿色的平面或立方体作为背景。然后在Pass_CameraView元素之后，Output_JPG元素之前，插入一个“色键（Chroma Key）”元素。将这个色键元素的输入连接到Pass_CameraView，输出连接到Output_JPG。在色键元素的细节面板中，设置键控颜色为背景的绿色，调整容差和边缘柔化参数，即可抠掉绿色背景，使背景区域变为透明。
   • 方法B：渲染单独的遮罩层：这是更专业的方法。利用Composure的图层能力，你可以创建多个直通元素，分别绑定到不同的相机（或同一相机的不同渲染层）。例如，一个元素只渲染前景角色（通过自定义深度或Stencil Buffer实现），另一个元素只渲染背景。然后在合成逻辑中，只输出前景层，背景自然就是透明的。这种方法更灵活，但设置也更复杂，需要配合材质和渲染设置。

6.2 自动化批处理渲染多个镜头

如果你需要渲染同一个场景的多个固定机位，手动移动相机并逐个触发太麻烦。可以用蓝图实现简单的批处理。

1. 在场景中放置多个CineCamera Actor，命名为Cam_01,Cam_02等。
2. 在控制器蓝图中，创建一个CineCamera类型的数组变量CameraArray，并将这些相机全部添加进去。
3. 再创建一个整数变量CurrentCameraIndex作为索引。
4. 设计一个流程：
   • 开始批处理时，设置CurrentCameraIndex为0。
   • 将CameraArray[CurrentCameraIndex]赋值给Pass_CameraView元素的“Input”属性（这可能需要通过“Set Input”节点动态设置，具体函数名可能因版本略有不同，需在蓝图上下文中搜索“Set Input”或“Assign Input”）。
   • 动态设置Output_JPG的“输出镜头名称”为Cam_{CurrentCameraIndex+1}。
   • 启用输出，等待N秒（或N帧）以确保该角度渲染完成。
   • 禁用输出，CurrentCameraIndex加1。
   • 判断CurrentCameraIndex是否小于数组长度，如果是，则延迟一小段时间后（如0.5秒，让引擎稳定）重复上述步骤；如果否，则批处理结束。
5. 这个蓝图逻辑可以让你一键自动遍历所有预设机位并保存图片，极大提升工作效率。

通过以上从原理到实战，从基础到进阶的完整拆解，你应该已经掌握了使用UE5 Composure插件进行高质量、实时画面导出的全套技能。这套方案的核心优势在于其稳定性和画质保障，它直接利用了引擎内部的渲染管线，避免了外部截图的诸多弊端。无论是用于快速预览、制作宣传素材，还是集成到严肃的生产管线中，都是一个非常可靠的工具。