ue4离线文档_[UE4,automation]UE4批渲染cmd篇

之前做项目的过程中，有一部分工作是在UE4里制作输出小短片。由于要完成的量比较大，所以研究了一些批渲染的方法。

逻辑上跟以前在maya里用batch render差不多，不过UE4这边的设置相对繁琐一点点。

本文讲解了在不打开UE4软件的前提下，批量输出预先设置好的sequence序列 的方法。也算是我的传统艺能了。因为代码排版和外链接问题，知乎阅读体验更佳。

https://zhuanlan.zhihu.com/david

注意：本文调用的是

"/Script/MovieSceneCapture.AutomatedLevelSequenceCapture"，也就是相当于4.24及以前版本中，在sequence面板里点击render moive一样。 跟4.25更新的movie render queue无关。

https://docs.unrealengine.com/en-US/Engine/Sequencer/Workflow/RenderAndExport/HighQualityMediaExport/Reference/index.html

▊为什么要用cmd做批渲染：

---

我们已经知道UE4.25中更新了非常好用的movie render queue工具，质量高而且方便自定义和输出。 奈何UE更新速度之迅猛，应该有不少项目还没切到4.25 ，还用不了render queue。

另外，在cmd指令里配置多任务，编辑效率和方便性我个人用下来是感觉比render queue高的，而且可以通过开动小脑筋实现简单的分布式渲染。让局域网内的多台机器同时处理一批序列。比如说我一共要渲20个序列，有四台肉鸡，那么可以每台肉鸡自动分5个去渲。

所以，总的来说，研究下怎么用cmd做批渲染，依然有用武之地；而且灵活性便利性都不错。

▊用cmd打开UE4地图：

---

我们先从基本的来——打开UE4项目里的某一张地图。

要打开某张地图的话，首先我们需要知道的信息是：

UE4Editor.exe 文件的位置

想要打开的地图所在的项目位置

所要打开的地图位置

比如说：

UE4Editor路径  

"D:\Program Files\UE_4.24\Engine\Binaries\Win64\UE4Editor.exe"

项目路径

"D:\Projects\UnrealProjects\renderMovieTest\renderMovieTest.uproject"

地图路径

 "D:\Projects\UnrealProjects\Test\Content\Maps\testLaunch"

其中UE4的项目路径可以用相对路径表示，为—— /Game； 所以地图路径可以写为“/Game/Maps/testLaunch”

然后我们新建一个txt文本文件，在文本中写入 

"D:\Program Files\UE_4.24\Engine\Binaries\Win64\UE4Editor.exe" 

D:\Projects\UnrealProjects\renderMovieTest\renderMovieTest.uproject /Game/maps/shot0010

这样一串文本，ctrl+s 保存一下；再把txt文件的后缀改成bat。再双击运行这个bat，你就可以看到我们的UE4启动了，并且正在打开我们指定好的那张图。目标达成。

聪明的朋友可能会在琢磨一件事，就是为什么UE4Editor路径 加了双引号，而另外两个路径没有加双引号呢？

因为cmd命令，基本上是在玩字符串，每一条字符串就是一条command，而在cmd里输入的绝大多数字符，都会被理解成字符串，不管你有没有加 单引号 或者 双引号。而字符串的分隔就是用空格或者回车的。

也就是说

D:\Projects\UnrealProjects\renderMovieTest\renderMovieTest.uproject 这一条路径，在cmd里实际上是一个字符串，是一条command，而D:\Program Files\UE_4.24\Engine\Binaries\Win64\UE4Editor.exe 因为路径里有空格，所以会被理解成两条字符串—— 

D:\Program 和Files\UE_4.24\Engine\Binaries\Win64\UE4Editor.exe。

这当然不是我们想要的结果，我们需要把这两条字符串当成一个command来处理，这个时候就需要用双引号把这个路径括起来，这样，其中的空格也会理解成字符串的一部分。

也就是说，任何没有空格的一条字符串，你都可以不加双引号(也可以加)。而如果出现了空格，就必须加双引号。

▊用cmd渲染一个序列：

---

具体使用方法，官方有一篇文档大概都讲了：

https://docs.unrealengine.com/en-US/Engine/Sequencer/Workflow/RenderAndExport/RenderingCmdLine/index.html

在上一节打开一张地图的基础上，我们只要继续加一些指令就可以渲染了。

其中必须要加的一条是：

-MovieSceneCaptureType= "/Script/MovieSceneCapture.AutomatedLevelSequenceCapture"

这条可以让我们使用渲染相关的各种cmd指令。

然后需要定义需要渲染的sequence文件路径，这里需要加上-LevelSequence=：

-LevelSequence="/Game/Sequence/testRende02"

另外我们还需要指定输出序列的文件夹位置，这里需要加上 -MovieFolder=：

-MovieFolder="D:\Projects\UnrealProjects\Test"

最后还有两个必须指令：

-game 和 -NoLoadingScreen

按照官方文档说，必须加-NoLoadingScreen ，不然会渲染失败：

而经我测试，-game也是必须的。

到目前为止，我们的cmd 代码大概变成了这样：

"D:\Program Files\UE_4.24\Engine\Binaries\Win64\UE4Editor.exe"

D:\Projects\UnrealProjects\renderMovieTest\renderMovieTest.uproject /Game/maps/shot0010 -MovieSceneCaptureType="/Script/MovieSceneCapture.AutomatedLevelSequenceCapture" 

-LevelSequence="/Game/Sequences/Shot0010" -MovieFolder="D:\Projects\UnrealProjects\renderMovieTest\outputs" -NoLoadingScreen -game

双击运行即可渲染序列了，并且界面也和正常的启动editor界面不同。直接会开始渲染序列，渲完整个窗口就都关了。

▊渲染设置：

---

上一节我们能够渲染出序列了。但是渲染输出的格式啊、尺寸啊、帧率啊、质量啊 这些常用设置，都没有提到。而这些设置，肯定是渲染过程中时常需要调试必不可少的。

这些设置的方法也跟前文类似，都是 - 加一个关键词来设置的，这些关键词大部分能在文档中找到：

https://docs.unrealengine.com/en-US/Engine/Sequencer/Workflow/RenderAndExport/RenderingCmdLine/index.html

-ResX=2560 -ResY=1440 -RenderOffScreen -ForceRes -MovieFormat=PNG -MovieQuality=100 -notexturestreaming -MovieCinematicMode=yes -MovieWarmUpFrames=01 -NoScreenMessages -VSync

我们在之前的基础上再继续添加这些设置，来满足我们的渲染需求。

一定要记住，每条字符串之间用空格隔开，一条完整字符串中，千万别打空格！

比如-MovieQuality=100 字符之间一定不能有空格，不能按照一般编程习惯打成 -MovieQuality = 100

这些设置中，可能有一些需要拿出来讲解一下：

-VSync 会开启垂直同步，让画面不会出现上下撕裂的问题，略微降低渲染效率，但由于我们是输出序列，不用理会帧率的问题，永远要用。

-NoTextureStreaming  关闭流送贴图池的；当UE4渲染一帧画面时，加载的显存大于你手动设置的流送贴图池上限时，会有很多贴图会被加载为非常小的尺寸，贴图在最终画面里会看起来非常模糊。而将其关闭以后，会忽略相关设置，每次都等所有贴图按照高精度加载完成之后再渲染。这个在游戏里会造成卡顿，因为我们渲序列，依然不用在意，永远加上这一条。

-MovieWarmUpFrames=## 设置暖场时间，当你的渲染文件里，有特效、解算的东西时，是很有必要设置的。会在渲染之前先让特效和解算文件先跑你设置的帧数，让特效解算都到位了，再渲染。这是以前离线渲染经常需要设置的东西，多加留心。

-NoScreenMessages  你总不想你们游戏内，程序员的打印的字符信息出现在渲染画面上吧。还有什么，你的灯光、反射采集球需要烘焙这些提示，你不可能想渲到最终画面上吧。所以永远加上这一条。

-CaptureFramesInHDR 渲染成exr格式的高动态图片。当你需要无损图片时，应当使用相关设置。

-CustomRenderPasses="RenderPassName"  这个是设置渲染通道用的，什么diffuse、reflection、velocity之类的。我知道很多搞影视渲染的朋友看到这个眼睛要发光，因为熟悉的工作流程似乎可以在UE4里文艺复兴了(包括曾经的自己)。

但我现在非常不推荐大家用这种输出多pass再到合成软件里面调的流程，首先在UE4里这个流程就不够健壮，想要对标影视的流程，需要二次开发，超麻烦。另外，以前的合成流程，主要是为了解决离线渲染太慢，一些小改动需要重新渲染的问题。现在UE4里渲染快得飞起，所见即所得，为啥不直接都在UE4里调到位呢？

记住，UE4里 post process就是你的nuke，几乎没有什么是nuke能做，后处理不能做的。所以，输出exr图片不是为了分pass，唯一的情况是你的画面里有较多过度细腻的暗部层次，这种层次在导出8位图片的时候，会被吃掉，导出浮点exr图片，可以保留足够的原始信息在你后面输出最终剪辑视频的时候，能提高画质。

-RenderOffScreen 最后要介绍的这一条，确实非常关键的一条，并且是在官方帮助文档上没有写的一条。按照前面的所有讲解，都设置好以后，你可以非常方便地渲染出一个序列，但是渲染的过程中会弹出一个窗口，显示你渲染的过程；然而在我们确定渲染内容没问题时，我们是不需要看到这个窗口的内容的，这条指令可以让你的渲染变成真正的后台渲染，没有任何窗口，只看到序列帧在文件夹里一个个创建(cool，这非常批渲染)。

除此之外，还有非常关键的一点，按照官方帮助文档的说法， -ForceRes 可以让你渲染出超过你显示器尺寸的序列：比如你显示器是1920*1080，加上 -ForceRes 可以渲染出2560*1440的序列。而在使用过程中，我发现这是错误的，就算加上 -ForceRes，你渲染的序列，依然会被卡在你的显示器尺寸上，即为1920*1080，没法更大。只有再加上-RenderOffScreen，才能让你突破显示器像素尺寸极限，这条乃非常重要的踩坑经验。

▊用蓝图调整游戏内质量：

---

然后有很多游戏内需要用 console command设置的质量指令，官方文档是说写在 Game/Config配置文件里。但在项目制作里，这种做法很容易影响到别的不该被影响的地方，所以我个人是用蓝图的形式，放在每个需要渲染的map中的。

官方文档也有一些设置建议，可以参考上一节的链接。

我的质量配置蓝图大概是这么设置的。将需要调节的参数暴露出去，于是每个地图里的质量，都可以单独设置。

另外，在蓝图中，Excute Console Command 节点，接受的字符串，不需要等号连接；也就是说，不需要用 r.MotionBlurQuality=4 这种，而是直接用 r.MotionBlurQuality 4(中间一个空格)这种。所以我上面append str节点，A里面填的字符串，最后都有一个空格。最后执行的时候，如下图所示：

▊渲染多个序列前置技能：

---

前面已经把渲染一个序列的方法都讲到位了。而我们用cmd去批渲染，关键还是要在渲染很多任务的时候，才有价值。

你当然可以把前面所有的内容复制一遍，修改一下需要渲染的地图名和Sequence名，但这也太搓了。看着就难受，并且对于渲染任务较多的时候，极容易出错。

所以这个时候，我们就必须真的拿cmd写代码了。这里稍微科普一点cmd的语法，这是想要写的优雅必须掌握的基本技能。

设置变量：

---

cmd中也可以设置变量，使用关键词set，于是按照一般的变成思路，我们会写成：

set varA='test'

echo varA

@pause

(echo可以理解成打印print，@pause会让窗口执行完不关闭，可以观察结果)

然而令人遗憾的是，打印出来的是我们的变量名，而不是变量的赋值：

因为cmd里，varA并不是变量，而是字符串"varA”，要把他当变量打印，需要用%把他围起来：

set varA='test'

echo %varA%

@pause

这样就对了，但是打印出来的是'test'而不是我们一般想象的test字符串，是因为，cmd里打的绝大多数字符，都强制是字符串，包括单引号，也是字符串的一部分，所以我们赋予一段字符串给变量，不需要用引号扩起来：

set varA=test

echo %varA%

@pause

这样才对。

虽然这个语法感觉怪怪的，但习惯起来也不算特别艰难。

for循环：

---

光设置变量还不行，我们要渲染多个序列，少不了要用for循环。

比如我们在一个数组['a','b','c','d']中对元素逐个打印，我们可以这样写：

@echo off

set listA=a b c d

for %%s in (%listA%) do (

    echo %%s

)

@pause

其中@echo off是屏蔽系统执行过程中的一些打印信息，这样，我们就可以只看到我们自己用echo打印的信息。

cmd中没有list那种东西，但我们可以用空格隔开字符串，赋予给一个变量，把这个变量当list用。

for循环中的变量，需要两个%来修饰。其余的都应该很好理解。

局部变量问题：

---

当我们在for循环内部，需要做一些额外处理的时候，比如，我们要在上一节的abcd后面加后缀，并且后缀数字逐个增长，输出成a_v01,b_v02,c_v03,d_v04这样。

我们需要掌握一些额外的知识。首先是变量的数值增加。

一般语言我们直接用：

b = 3

b = b+2

这样，就可以让b = 5，但在cmd里，我们直接这样写，会得到：

因为，b+2会被理解成字符串，而不是加法操作，如果要让cmd理解这是加法操作，我们需要在设置变量的时候，加一个算术表达式的标识符 /A

set b=3

set /A b=b+2

echo %b%

@pause

这样就对了。

那么按照我们之前的目标，开始在循环内给字符串加后缀，很容易写出：

@echo off

set listA=a b c d

set postfix=1

for %%s in (%listA%) do (

    echo %%s_v0%postfix%

    set /A postfix=postfix+1

)

@pause

大家稍微注意一下%%s_v%postfix，看起来像乱码一样，这就是cmd的毛病了；我们得拆开来看，首先%%s是for循环内的遍历变量，比如说第二次循环时，%%s是b，而%postfix%是我们定义的后缀变量，第二次循环中理论上应该是2，而这两个变量中间有一个_V0，这其实会被理解成字符串；最终cmd会把三个字符串连在一起，于是应该输出成b_v02。

而我们打印出来一看，却和预想的不一样：

每次打印的时候，postfix变量都是1，并没有按我们想象的每次都 +1 。

这是因为cmd的机制问题，%postfix%其实一直取的是外部变量，也就是永远是1；要想把他当内部变量用，我们需要加一串东西：

setlocal enabledelayedexpansion

并且，用 !postfix! 的形式取内部变量，可以参考这篇文章：

https://www.jb51.net/article/29323.htm

最后我们把代码改成：

@echo off

set listA=a b c d

set postfix=1

setlocal enabledelayedexpansion

for %%s in (%listA%) do (

    echo %%s_v0!postfix!

    set /A postfix=!postfix!+1

)

@pause

目标达成，终于掌握了输出多个序列的前置技能点了。

▊渲染多个序列脚本编写：

---

首先，我们把不会变的东西都设置成变量：

然后，把需要批处理的任务设置成数组(一般我为了简化管理，会把seq的名字和map的名字设置一样，所以不需要额外定义一个seqToRender)：

最后，for循环伺候：

其中，做了一个if else的判断： 判断当前输出文件夹是否存在，如果存在，表示可能别的机器已经渲染过这个序列了，于是忽略，如果不存在，那么没人渲过，我来渲染。

这样，就可以搞简单的人肉分布式渲染了。

最后又加了一点逻辑判断，完整的示例代码。微信排代码太难受了，去知乎看吧

https://zhuanlan.zhihu.com/david