1. UE5全景图导出基础配置
第一次用UE5导出全景图时，我对着满屏参数直接懵圈。后来发现只要搞定三个核心配置，就能解决80%的基础问题。先打开项目设置里的Rendering→Panoramic Capture，这里藏着全景导出的所有秘密武器。
输出目录是最容易踩坑的地方。默认的C:/PanoramicCaptureFrames路径经常报错，实测需要手动创建目标文件夹。我习惯在项目根目录建个/Output/Panorama，然后在SP.OutputDir填上绝对路径，比如D:/UE5_Projects/ArchViz/Output/Panorama。注意斜杠方向要统一用正斜杠，反斜杠会导致引擎识别失败。
分辨率设置有个隐藏技巧：SP.StepCaptureWidth默认6144会导致显存爆炸，我的RTX 3080跑4K都吃力。建议先降到4096测试，成品输出时再调回6144。如果只是做预览，2048*1024完全够用，这时要把SP.StepCaptureWidth同步改为2048，否则会出现画面拉伸。
单双图模式的选择直接影响后期处理流程。SP.Monoscopic参数特别关键：
- 设为1时输出单张全景图，适合直接上传到社交媒体
- 设为0（默认值）会生成左右眼两张图，用于VR设备 有次客户要VR版展示，我忘了改这个参数，结果渲染完发现只有单图，不得不重跑8小时序列——血泪教训啊！
2. 高级参数调优实战
调通基础配置只是开始，真正影响画质的是这些隐藏参数。SP.CaptureSlicePixelWidth控制切片渲染宽度，网上有人说要改成分辨率的一半，实测完全不用动。保持默认720即可，改小会增加渲染时间，改大会导致显存溢出。
动态模糊处理是个大坑。全景图本身是360度环绕的，如果直接开启运动模糊会导致接缝处出现撕裂。我的解决方案是：
- 在项目设置里关闭
Motion Blur - 改用后期处理体积的
Radial Blur - 调整
Blur Amount不超过0.3
光照烘焙对全景图特别重要。建议在World Settings里把Lightmass参数调到这些值：
| 参数 | 常规场景 | 室内精模 |
|---|---|---|
| Static Lighting Level Scale | 0.5 | 0.3 |
| Num Indirect Lighting Bounces | 16 | 32 |
| Indirect Lighting Quality | 4 | 8 |
遇到过最诡异的问题是天空盒闪烁。后来发现是默认的SkyLight采样精度不够，把Cubemap Resolution从128调到512立即解决。如果是动态天气系统，还要勾选Real Time Capture，否则云层移动会有残影。
3. 渲染性能优化技巧
用UE5渲染8K全景图就像让显卡跑马拉松，这些技巧能让效率提升3倍不止。首先在ConsoleVariables.ini里添加：
r.VSync=0 r.ScreenPercentage=50 r.Tonemapper.Sharpen=0这三行代码分别关闭垂直同步、降低实时预览分辨率、禁用锐化滤镜，实测能让视口操作流畅度翻倍。
批量导出时一定要用Movie Render Queue，比手动截帧稳定得多。我的标准配置流程：
- 创建CineCameraActor对准场景中心
- 添加PanoramicCapture组件
- 在MRQ里新建PIE（Player in Editor）渲染任务
- 设置帧范围时留出2秒预热帧
显存优化有个邪道技巧：把r.TextureStreaming设为0强制加载所有贴图。虽然初始加载慢，但渲染过程中不会卡顿。对于32GB以上内存的机器，还可以在引擎启动参数加上-d3d12 -malloc=system，让UE5直接调用系统内存。
4. 常见问题解决方案
输出目录报错是最常见的问题，除了检查路径格式，还要注意：
- 路径不能包含中文或特殊符号
- 磁盘剩余空间要大于预期文件大小的3倍
- 关闭所有可能占用该目录的程序（包括资源管理器）
遇到画面接缝错位时，先检查这些参数：
SP.CaptureRotation是否设为(0,0,0)- 相机是否完全水平（Roll值必须为0）
- 场景里有没有超出边界的粒子特效
有次客户反馈全景图有黑色条纹，排查发现是抗锯齿的锅。UE5默认的Temporal AA在全景渲染时会出问题，换成FXAA立即解决。如果是影视级输出，建议用RenderDoc抓帧检查每个pass的输出。
最后分享一个压箱底的调试技巧：在控制台输入PanoramicCapture.Debug 1，会实时显示每个切片的渲染状态。看到红色区块就表示那里有错误，绿色代表正常渲染。这个命令救过我无数次 Deadline 渲染农场排错。
