命令行渲染器的公用标志

下表包含所有渲染器都有的公用标志。若要查看这些标志，请在 shell 或终端 (macOS) 窗口中键入以下命令：

Render -help

下面列出了您可在下列情况中使用的所有选项：

文件渲染器 (Render -r file)
文件渲染器使用文件（与所使用渲染器有关）中指定的设置。
矢量渲染器 (Render -r vr)。

公用选项

标志名称	定义
`-test`	打印 MEL 命令，但不执行。
`-verb`	执行 MEL 命令之前打印这些命令。
`-keepMel`	保存临时 MEL 文件。
`-listRenderers`	列出所有可用的渲染器。
`-renderer <string>` 或 `-r <string>`	使用以下特定的渲染器：sw、hw、vr、文件。
`-proj <string>`	使用该 Maya 项目加载该文件。
`-log <string>`	指定渲染日志文件和位置。该日志文件包含标准输出和标准错误信息。此标志仅在 Windows 平台中有效。除了使用此标志以外，还可以使用 >、>> 或 I 等命令重定向操作符写入日志文件。
`-pythonver [2\|3]`	指定运行脚本时要使用的 Python 版本。指定 `-pythonver 2` 将使用 Python 2 运行脚本。指定 `-pythonver 3` 将使用 Python 3 运行脚本。注： Python 2 仅在 Linux 和 Windows 上可用。

通用标志

标志	定义
`-rd <path>`	存储图像文件的目录。
`-im <filename>`	图像文件输出名称。
`-fnc <int>`	“帧/动画扩展名”(Frame/Animation ext)，例如“名称”(name)、“名称.扩展名”(name.ext)。有关详细信息，请参见“渲染设置: 公用”(Render Settings: Common)选项卡。
`-of <format>`	输出图像文件格式。有关支持的文件格式，请参见“渲染设置”(Render Settings)窗口的“图像格式”(Image format)下拉列表。

帧编号选项

标志	定义
`-s <float>`	动画序列的开始帧。
`-e <float>`	动画序列的结束帧。
`-b <float>`	动画序列的帧数或步长。
`-pad <int>`	输出图像帧文件的扩展名的数字位数。
`-rfs <int>`	重建帧编号(Renumber frames)：开始编号(Start number) - 渲染时第一个图像的编号。
`-rfb <int>`	重建帧编号(Renumber frames)：帧数(By frame) - 用于重建帧编号的步长。
`-skipExistingFrames`	启用此选项后，渲染器将检测并跳过已渲染的帧。此功能可节省渲染时间。

摄影机选项

标志	定义
`-cam <name>`	指定要使用的摄影机。
`-rgb <boolean>`	启用或禁用 RGB 输出。
`-alpha <boolean>`	启用或禁用 Alpha 输出。
`-depth <boolean>`	指定渲染图像是否包含深度通道。

分辨率选项

标志	定义
`-x <int>`	设置最终图像的 X 分辨率。
`-y <int>`	设置最终图像的 Y 分辨率。
`-percentRes <float>`	使用指定的分辨率百分比渲染图像。
`-ard <float>`	（软件渲染器）渲染图像的设备纵横比。
`-par <float>`	（硬件渲染器，矢量渲染器）渲染图像的像素纵横比。
`-x <int>`	设置最终图像的 X 分辨率。

渲染层和渲染过程

标志	定义
`-rl <boolean:name>`	单独渲染每一个渲染层。同时适用于传统渲染层和渲染设置。
`-rp <boolean:name>`	单独渲染通道。仅适用于传统渲染层。
`-sel <boolean:name>`	选择要渲染的对象、组和/或集。

标志

定义

-rl <boolean:name>

单独渲染每一个渲染层。

同时适用于传统渲染层和渲染设置。

-rp <boolean:name>

单独渲染通道。

仅适用于传统渲染层。

-sel <boolean:name>

选择要渲染的对象、组和/或集。

渲染设置

将以下标志与渲染设置系统一起使用。请参见在批渲染过程中应用渲染设置模板文件。

标志	定义
`-rst <string:filename>`	在进行命令行渲染之前，将渲染设置模板应用到场景文件。仅支持先前在“渲染设置”(Render Setup)编辑器中通过“文件 > 导出全部”(File > Export All)导出的 `.json` 模板。不支持通过“文件 > 导出选定对象”(File > Export Selected)导出的模板。
`-rsp <string:filename>`	在进行命令行渲染之前，从此 `.json` 模板文件导入场景的“渲染设置”(Render Settings)。
`-rsa <string:filename>`	使用 Arnold for Maya 渲染器进行渲染时，请使用此标志。在进行命令行渲染之前，从此 `.json` 模板文件导入 AOV。这相当于在“渲染设置”(Render Setup)编辑器中执行“文件 > 导入场景 AOV”(File > Import Scene AOVs)，然后进行批渲染。

标志

定义

-rst <string:filename>

在进行命令行渲染之前，将渲染设置模板应用到场景文件。仅支持先前在“渲染设置”(Render Setup)编辑器中通过“文件 > 导出全部”(File > Export All)导出的 .json 模板。不支持通过“文件 > 导出选定对象”(File > Export Selected)导出的模板。

-rsp <string:filename>

在进行命令行渲染之前，从此 .json 模板文件导入场景的“渲染设置”(Render Settings)。

-rsa <string:filename>

使用 Arnold for Maya 渲染器进行渲染时，请使用此标志。

在进行命令行渲染之前，从此 .json 模板文件导入 AOV。这相当于在“渲染设置”(Render Setup)编辑器中执行“文件 > 导入场景 AOV”(File > Import Scene AOVs)，然后进行批渲染。

MEL 回调

标志	定义
`-preRender <string>`	渲染前执行的 MEL 代码。
`-postRender <string>`	渲染后执行的 MEL 代码。
`-preLayer <string>`	每个渲染层之前执行的 MEL 代码。
`-postLayer <string>`	每个渲染层之后执行的 MEL 代码。
`-preFrame <string>`	每一帧之前执行的 MEL 代码。
`-postFrame <string>`	每一帧之后执行的 MEL 代码。
`-pre string`	已废弃的标志。
`-post string`	已废弃的标志。