Question

从命令行渲染时，可以添加开关启用多种选项，从基本参数（如输出分辨率）一直到高级功能（如 Backburner 作业提交和 EXR 格式规范）。

可以在命令提示窗口的命令行上的 3dsmaxcmd 后使用以下开关，也可以作为文本文件中的条目。下表显示开关及其效果。

注意:使用命令行渲染功能需要熟悉 Windows 命令提示符（也称为 DOS 或 MS-DOS），并了解命令行的结构。

在长度级别 5 上，来自命令行渲染的输出消息包括时间戳和日期戳。主消息的时间戳按分号分隔，“帧已完成”消息的已用时间消息按分号分隔。这允许您将消息传输到文件，然后通过设置分隔符字符使用相应的列在电子表格程序中打开它。

分隔符

下表中列出的很多开关都在末尾带有冒号，如 -w: 或 -h:。使用冒号分隔符为可选项，并且可以用空格或等号（=）来代替。因此，命令行如下：

“c:\\program files\\autodesk\\[program folder name]\\3dsmaxcmd”-outputName:“c:\\program files\\autodesk\\[program folder name]\\renderoutput\\myImage.jpg”-w:640 -h:480“c:\\program files\\autodesk\\[program folder name]\\scenes\\myscene.max”

“c:\\program files\\autodesk\\[program folder name]\\3dsmaxcmd”-outputName“c:\\program files\\autodesk\\[program folder name]\\renderoutput\\myImage.jpg”-w 640 -h 480“c:\\program files\\autodesk\\[program folder name]\\scenes\\myscene.max”

“c:\\program files\\autodesk\\[program folder name]\\3dsmaxcmd”-outputName=“c:\\program files\\autodesk\\[program folder name]\\renderoutput\\myImage.jpg”-w=640 -h=480“c:\\program files\\autodesk\\[program folder name]\\scenes\\myscene.max”

将给出相同的结果。使用等号使命令行文件看起来像 INI 文件。

注意:该开关 -submit:[manager_name] 是唯一必须要使用冒号的开关。

启用/关闭命令行开关

很多要使用的开关只需“启用/关闭”切换，例如 -rfw: 和 -renderFields: 开关。如果愿意，除了使用 1 或 0 来指定其状态外，还可以使用 True 或 False。例如，要将场景渲染到指定的文件类型中并显示“渲染帧”窗口，命令行类似下图所示：

“c:\\program files\\autodesk\\[program folder name]\\3dsmaxcmd”-outputName=“c:\\program files\\autodesk\\[program folder name]\\renderoutput\\myImage.jpg”-rfw=true“c:\\program files\\autodesk\\[program folder name]\\scenes\\myscene.max”

基本选项

注意:开关不区分大小写。

开关	效果
-?	在 DOS 窗口中显示这些开关的列表。
-x	显示示例命令行列表。
-v:#	设置长度级别，其中 # 是从 0（最低长度）到 5（最高长度）的整数。
@command_file 或 -cmdFile:command_file	指向包含命令行选项的单独文件。
-preset:<filename> 或 -rps:<filename>	使用渲染预设文件，其中 <filename> 是预设文件的名称。
-sceneState:<scene-state-name>	在渲染图像之前加载特定的场景状态文件。
-batchRender	在“批处理渲染”对话框中渲染所有激活的任务。
-batchRender:<batch-render-name>	在名为 batch-render-name 的文件中渲染批处理渲染。
-preRenderScript:<filename> 或 -script:<filename>	使用预渲染脚本，其中 <filename> 是脚本文件的名称。
-postRenderScript:<filename>	使用后期渲染脚本，其中 <filename> 是脚本文件的名称。
-workPath:<pathname>	作业数据文件夹的根位置。
-pathFile:<pathname>	路径配置文件（MXP 格式）。
-bitmapPath:<pathname>	（过时）提供额外的位图路径。可以输入多条路径并使用 UNC 命名转换。
-xrefPath:<pathname>	（过时）指定额外的外部参考路径。可以输入多条路径并使用 UNC 命名转换。
-split:<strips, overlap>	拆分渲染、条带数、重叠量。
-strip:<strips, overlap, strip>	拆分渲染：条带数、重叠量、条带号（以 1 开始）。这与 -split 类似，但可使您渲染特定的单个条带。 注意:在将作业提交给 backburner 时，条带值不会产生任何效果。此作业仍会渲染所有的条带。拆分和缝合功能仅用于本地渲染。
-stitch:<strips, overlap>	缝合条带（参见上面）将它们合并为一个图像：条带数、重叠量。缝合功能仅用于本地渲染。
-dateFormat:<dateformat>	指定用于信息戳中位于速度级别 5 上的日期格式，默认为独立于区域格式。有关详细信息，请使用 3dsmaxcmd }3dsvizcmd -x 选项。
-timeFormat:<timeformat>	指定用于信息戳中位于速度级别 5 上的时间格式。默认到独立于区域的格式以及 24 小时钟。有关详细信息，请使用 3dsmaxcmd -x 选项。

渲染参数

注意:具有“启用/禁用”切换的命令行开关可以输入 1，0，on 或 off 进行切换。

开关	效果
-outputName:<filename> 或 -o:<filename>	设置输出文件名和格式。
-camera:<string> 或 -cam:<string>	指定摄影机名。
-width:<integer> 或 -w:<integer>	设置输出宽度（像素数）。
-height:<integer> 或 -h:<integer>	设置输出高度（像素数）。
-pixelAspect:<number>	设置像素纵横比。
-start:<integer>	设置渲染序列的开始帧。 如果指定了开始帧，但没有指定结束帧，则仅渲染第一帧。
-end<integer>	设置渲染序列的结束帧。 如果指定了结束帧，但未指定开始帧，则渲染第一帧到结束帧。
-nthFrame<integer>	设置“每 N 帧”值。
-frames<string>	指定帧列表；例如，(1,3,5-12) 或 all。
-stillFrame 或 -sf	表示这是静止帧渲染，没有添加帧后缀。
-imageSequenceFile:<0/1/2>	图像序列文件创建：0=无; 1=.imsq; 2=.ifl
-gammaCorrection:<1/0>	切换 gamma 校正。1 为启用，0 为禁用。
-gammaValueIn:<number>	设置“输入 Gamma”值。
-gammaValueOut:<number>	设置“输出 Gamma”值。
-continueOnError	如果出现错误，3ds Max 将尝试继续渲染。
-videopostJob:<1/0>	对于该作业启用或禁用“视频后期处理”。

渲染标记

开关	效果
-showRFW:<1/0> 或 -rfw:<1/0>	切换“渲染帧窗口”。1 为启用，0 为禁用。
-skipRenderedFrames:<1/0>	切换“跳过现有图像”。1 为启用，0 为禁用。
-videoColorCheck:<1/0>	切换“视频颜色检查”。1 为启用，0 为禁用。
-force2Sided:<1/0>	切换“强制双面”。1 为启用，0 为禁用。
-renderHidden:<1/0>	切换“渲染隐藏”。1 为启用，0 为禁用。
-atmospherics:<1/0>	切换“大气”。1 为启用，0 为禁用。
-superBlack:<1/0>	切换“超级黑”。1 为启用，0 为禁用。
-renderFields:<1/0>	切换“渲染场”。1 为启用，0 为禁用。
-fieldOrder:even 或 odd	切换“场顺序”。默认为奇数。
-displacements:<1/0>	切换“置换贴图”。1 为启用，0 为禁用。
-effects:<1/0>	切换“渲染效果”。1 为启用，0 为禁用。
-useAreaLights:<1/0>	切换区域灯光/阴影。1 为启用，0 为禁用。
-useAdvLight:<1/0>	切换使用高级照明。1 为启用，0 为禁用。
-computeAdvLight:<1/0>	切换计算高级照明。1 为启用，0 为禁用。
-ditherPaletted:<1/0>	切换“输出抖动（索引）”。1 为启用，0 为禁用。
-ditherTrueColor:<1/0>	切换“输出抖动（真彩色）”。1 为启用，0 为禁用。
-renderElements:<1/0>	切换渲染元素（真彩色）。1 为启用，0 为禁用。

Backburner 作业提交

这些切换涉及向网络渲染提交渲染作业。

开关	效果
-submit[:manager_name] 或 -s[:manager_name]	将场景 <filename> 提交给特定的服务器系统，以进行网络渲染。 注意:这是唯一需要冒号分隔符的开关。
-port:<integer>	指定管理器端口号。
-netmask:<string>	用于指定不同于 255.255.255.0 的子网掩码。
-jobName:<string>	用于指定要渲染的作业名。
-priority<integer>	设置作业优先级。
-suspended:<1/0>	切换“开始时挂起”。1 为“是”，0 为“否”。
-writeJobFile	将所有作业设置写到 XML 文件中。该文件使用与 MAX 文件相同的名称，例如 test.max 生成 test.xml。
-readJobFile:<filename>	从 XML 文件中读取所有作业设置。
-waitLoad:<integer>	等待 3ds Max 加载的时间，以分钟为单位。默认设置为 20。
-waitRender:<integer>	等待 3ds Max 渲染的时间，以分钟为单位。默认设置为 600。
-waitUnload:<integer>	等待 3ds Max 卸载的时间，以分钟为单位。默认设置为 10。
–平台：32 或 64	将渲染场景的平台（32 位或 64 位）。当想要在不同于创建场景的平台上的渲染场景时，使用该开关。

位图参数

开关	效果
-BMP_TYPE:2 或 8	设置要渲染的 BMP 文件类型。2 为索引颜色，8 为 24 位真彩。
-JPEG_QUALITY:1 至 100	设置 JPG 质量值。范围为 1 至 100。
-JPEG_SMOOTHING:1 到 100	设置 JPG 平滑值。范围为 1 至 100。
-TARGA_COLORDEPTH:16, 24 或 32	为 TGA 文件设置颜色深度。
-TARGA_COMPRESSED:<1/0>	切换 TGA 压缩。1 为启用，0 为禁用。
-TARGA_ALPHASPLIT:<1/0>	切换“TGA Alpha 分割”。1 为启用，0 为禁用。
-TARGA_PREMULTALPHA:<1/0>	切换 TGA“预乘 Alpha”。1 为启用，0 为禁用。
-TIF_TYPE:<0/1/2/3/4>	选择 TIF 类型。0 为单色，1 为彩色，2 为 logl，3 为 logluv，4 为 16 位彩色。
-TIF_ALPHA:<1/0>	切换 TIF 文件 alpha。1 为启用，0 为禁用。
-TIF_COMPRESSION:<1/0>	切换 TIF 压缩。1 为启用，0 为禁用。
-TIF_DPI:<number>	为 TIF 文件设置“每英寸点数”值。

以下的每一个 -RLA_xxxx 开关，均有对应的 -RPF_xxxx 选项。

开关	效果
-RLA_COLORDEPTH:8、16 或 32	设置 RLA 颜色的位深。
-RLA_ALPHA:<1/0>:	切换 RLA Alpha。1 为启用，0 为禁用。
-RLA_PREMULTALPHA:<1/0>	切换 RLA“预乘 Alpha”。1 为启用，0 为禁用。
-RLA_DESCRIPTION:<string>	用于指定 RLA 描述（用引号）。
-RLA_AUTHOR:<string>	用于指定 RLA 作者名称（用引号）。
-RLA_ZDEPTHCHANNEL:<1/0>	切换 RLA Z 深度通道。1 为启用，0 为禁用。
-RLA_MTLIDCHANNEL:<1/0>	切换 RLA“材质 ID 通道”。1 为启用，0 为禁用。
-RLA_OBJECTIDCHANNEL:<1/0>	切换 RLA“对象通道”。1 为启用，0 为禁用。
-RLA_UVCHANNEL:<1/0>	切换 RLA UV“坐标通道”。1 为启用，0 为禁用。
-RLA_NORMALCHANNEL:<1/0>	切换 RLA“曲面法线通道”。1 为启用，0 为禁用。
-RLA_NONCLAMPEDCOLORCHANNEL:<1/0>	切换 RLA“超亮色通道”。1 为启用，0 为禁用。
-RLA_COVERAGECHANNEL:<1/0>	切换 RLA“覆盖通道”。1 为启用，0 为禁用。

以下 -RPF_xxxx 开关没有相应的 -RLA_xxxx 选项。

开关	效果
-RPF_NODERENDERIDCHANNEL	启用“RPF 节点渲染 ID 通道”。
-RPF_COLORCHANNEL	启用“RPF 颜色通道”。
-RPF_TRANSPCHANNEL	启用“RPF 透明通道”。
-RPF_VELOCCHANNEL	启用“RPF 速度通道”。
-RPF_WEIGHTCHANNEL<1/0>	启用“RPF 子像素权重通道”。
-RPF_MASKCHANNEL	启用“RPF 子像素遮罩通道”。

开关	效果
-EXR_USEEXPONENT	EXR 使用指数启用/禁用
-EXR_EXPONENT	EXR 指数值（小数）
-EXR_PREMULTALPHA	EXR 预乘 alpha 启用/禁用
-EXR_ALPHA	EXR 保存 alpha 组件启用/禁用
-EXR_RED	EXR 保存红色组件启用/禁用
-EXR_GREEN	EXR 保存绿色组件启用/禁用
-EXR_BLUE	EXR 保存蓝色组件启用/禁用
-EXR_BITDEPTH	EXR 位深度：0=8–位整数；1=半个浮动；2=浮动
-EXR_USEFRAMENUMDIGITS	EXR 使用帧位数启用/禁用
-EXR_FRAMENUMDIGITS	EXR 帧位数（整数）
-EXR_COMPRESSIONTYPE	EXR 压缩类型：0=没有压缩；1=RLE；2=ZIP（(1 扫描线）；3=ZIP（(16 扫描线）；4=PIZ
-EXR_USEREALPIX	EXR 使用 RealPix RGB 数据启用/禁用