转到：说明。返回值。相关。标志。MEL 示例。
标志
active, addHosts, addIncludes, addLinks, binary, camera, echo, exportFilter, exportFilterString, exportPathNames, exportStartFile, file, fragmentChildDag, fragmentExport, fragmentIncomingShdrs, fragmentMaterials, immediateModeRender, layer, license, listHosts, listLinks, logFile, miStream, padframe, pauseTuning, perframe, preview, previousView, project, region, regionRect, removeHosts, removeLinks, render, renderNoSlaves, renderTarget, renderThreads, renderVerbosity, tabstop, updateHosts, updateRayrc, verbosity, xResolution, yResolution
通用标志
- -verbosity(-v) uint
-
设置插件消息的详细级别。值的范围可以从 0 至 6，分别将详细级别设置为无、致命、错误、警告、信息、进度和详细信息。默认设置：渲染全局设置（警告级别）
- -renderVerbosity(-rv) uint
-
设置 mental ray 消息的详细级别。值的范围可以从 0 至 6，分别将详细级别设置为无、致命、错误、警告、信息、进度和详细信息。默认设置：渲染全局设置（警告级别）
- -project(-prj) string
-
设置插件所要使用的项目根目录。影响默认的输出目录以及针对未使用完整文件路径提供地址的项目子目录中的文件引用的处理，例如纹理。默认设置：对于文件导出，为无；对于预览，为默认项目目录
- -updateRayrc(-ur)
-
重新加载 maya.rayrc 文件来重新初始化 mental ray。仅供内部使用。
- -addIncludes(-ai) string
-
以交互方式包含指定的 .mi 文件。必须在 mental ray 正确初始化后使用，例如在图像渲染后。仅供内部使用。
- -addLinks(-al) string
-
以交互方式链接指定的着色器库。必须在 mental ray 正确初始化后使用，例如在图像渲染后。仅供内部使用。
- -removeLinks(-rl) string
-
以交互方式取消链接指定的着色器库。必须在 mental ray 正确初始化后使用，例如在图像渲染后。仅供内部使用。
- -listLinks(-ll)
-
列出当前链接的着色器库。必须在 mental ray 正确初始化后使用，例如在图像渲染后。仅供内部使用。
- -active(-a)
-
仅平移活动的场景元素以创建最终场景。这包括刚刚选定的几何体以及这些对象引用的所有着色节点，所有灯光和渲染摄影机。这样可以确保始终生成可渲染的场景。可以将此模式与导出过滤器组合使用。默认设置：平移整个场景
- -fragmentExport(-fe)
-
启用碎片 .mi 文件导出。其仅平移任何支持类型的选定节点。有更多选项可将平移扩展为也考虑相关或连接的节点，请参见下文。该模式允许创建仅包含所需信息的 .mi 文件，这通常会导致不可渲染的 .mi 文件。请注意，对于几何对象，导出将始终包含对象及其实例，无论是否仅选定了形状节点或其父对象变换。默认设置：平移整个场景
- -fragmentChildDag(-fcd)
-
在碎片模式中，将另外平移当前选择中所发现的任何变换节点的子 DAG 图形。默认设置：仅平移选定对象/实例
- -fragmentMaterials(-fem)
-
在碎片模式中，将另外平移当前选择中所发现的形状/变换节点的附着材质。默认设置：忽略附着材质
- -fragmentIncomingShdrs(-fis)
-
在碎片模式中，将另外平移连接至当前选择中所发现节点（驱动节点）的着色节点。默认设置：忽略连接
- -init(-ini)
-
再次为集成渲染器执行初始化步骤，包括加载启动文件以及重做自定义链接和包含命令。仅供内部使用。
渲染标志
- -preview(-pv)
-
使用集成的 mental ray 执行预览渲染。仅用于交互式渲染。（不用于批渲染）不能通过 r/render 指定。默认设置：禁用
- -render(-r)
-
在批处理模式下使用集成的 mental ray 执行渲染。仅用于批渲染。（不用于交互式渲染）不能通过 pv/preview 指定。
- -camera(-cam) string
-
使用该摄影机作为预览渲染的渲染摄影机。需要摄影机形状名称。默认设置：渲染全局摄影机
- -previousView(-prv)
-
使用通过预览渲染的先前运行获得的渲染摄影机（如果相同的命令行没有给出明确的摄影机）。默认设置：场景中找到的第一个可渲染摄影机
- -region(-rg)
-
仅对 Maya 渲染窗口的当前区域矩形进行预览渲染。默认设置：渲染整个图像
- -regionRect(-rr) uint uint uint uint
-
如果启用了区域，这将为预览渲染设置自定义矩形区域。四个整数值将按左侧、底部、右侧和顶部边界顺序指定相应的左侧、底部、右侧和顶部边界。默认设置：渲染窗口区域
- -xResolution(-x) uint
-
为预览渲染设置输出图像的 x 分辨率。默认设置：渲染全局图像宽度
- -yResolution(-y) uint
-
为预览渲染设置输出图像的 y 分辨率。默认设置：渲染全局图像高度
- -logFile(-log)
-
将 mental ray 渲染消息写入到名为“mentalray.log”的文件中，该文件位于当前目录中。此外，这些消息仍然写入到输出或父 Shell 窗口。
- -renderThreads(-rt) uint
-
它用于减少 mental ray 中为当前渲染所使用的渲染线程数。接受的值的范围为 1 到 4。默认设置：4
- -layer(-l) string
-
渲染指定的渲染层。只有该渲染层将被渲染，而不考虑渲染层的可渲染属性值。层名称将附加到输出图像文件名。指定的渲染层在渲染之前成为当前渲染层，并在渲染之后仍然为当前渲染层。
- -renderTarget(-rtg) string
-
渲染指定的渲染目标。如果设置了此标志，mental ray 将不渲染场景。相反，它将会渲染以目标字符串所指定的节点为根的图像处理图形。此标志的目的是使用 mental ray 进行合成和常规图像处理任务。FLAGHEADER 网络渲染标志，与其他渲染标志
FLAG renderNoMaster rnm CREATE NO_QUERY NO_EDIT NO_MULTI COMMENT 配合使用，如果给定，将可以在从属计算机上渲染几乎所有内容，因此可以减少主计算机（正在运行 Maya 的计算机）的工作负荷。
- -renderNoSlaves(-rns)
-
如果给定，将可以在主计算机（正在运行 Maya 的计算机）上渲染几乎所有内容，因此可以减少从属计算机的工作负荷。
- -updateHosts(-uh)
-
重新加载 maya.rayhosts 文件并相应更新主机计算机（从属计算机）列表。必须在 mental ray 正确初始化后使用，例如在图像渲染后。仅供内部使用。
- -addHosts(-ah) string
-
将给定的计算机名称添加到主机列表。（附加给定的主机。）必须在 mental ray 正确初始化后使用，例如在图像渲染后。仅供内部使用。
- -removeHosts(-rh) string
-
从主机列表中移除给定的计算机名称。（分离给定的主机。）必须在 mental ray 正确初始化后使用，例如在图像渲染后。仅供内部使用。
- -listHosts(-lh)
-
列出主机列表中的计算机名称。必须在 mental ray 正确初始化后使用，例如在图像渲染后。仅供内部使用。
- -license(-lic) string
-
mental ray IPR 标志
- -immediateModeRender(-imr) boolean
-
仅交互式渲染。开始/停止 mental ray 立即模式渲染 (IPR)。可后跟 pt/pauseTuning、rg/region、rr/regionRect。在与查询标志 q/query 一起使用时，如果 mental ray IPR 正在运行，则返回
true，否则返回 false。如果 mental ray IPR 处于启用状态，只有选项的子集将被接受。
- -pauseTuning(-pt) boolean
-
与 imr/immediateModeRender 一起使用。暂停/继续 mental ray IPR。如果暂停，属性更改将仍然更新内部数据库。
注意上述标志可以在命令的创建模式和查询模式中出现。
导出标记
- -miStream(-mi)
-
- -file(-f) string
-
为 .mi 导出或 .mi 回显设置文件名和路径。默认设置：无标题
- -perframe(-pf) uint
-
控制动画的逐帧 .mi 文件导出。支持的值如下：0（单个 .mi 文件，其中包含整个动画，且利用增量更改），值大于 0 时，逐帧导出一个 .mi 文件，不使用增量更改，使用不同的命名方案：1（名称.扩展名.#）、2（名称.#.扩展名）、3（名称.#）。默认值：0
- -padframe(-pad) uint
-
设置用于在动画逐帧 .mi 文件导出期间生成文件扩展名的帧编号填充（固定字段宽度）。默认设置：0，无填充
- -tabstop(-tab) uint
-
设置用于缩进 .mi 文件中的行的空格字符数量。默认设置：4
- -echo(-e)
-
通过将场景数据发送到内置 mental ray 并执行其回显命令，将场景导出到 .mi 文件中。默认设置：禁用
- -binary(-bin)
-
导出二进制 .mi 格式（在对象定义中写入二进制向量）。默认设置：禁用，写入 ascii 格式
- -exportFilter(-xf) int
-
这将允许从导出的 .mi 文件移除某些类型的 mental ray 实体。整型参数是位集，其中每一位表示一个过滤器条目。这是完整的列表：
| 值 |
位置 |
值 |
| FilterLink |
0 |
1 |
| FilterInclude |
1 |
2 |
| FilterVersion |
2 |
4 |
| FilterTextures |
3 |
8 |
| FilterObject |
4 |
16 |
| FilterGroup |
5 |
32 |
| FilterLight |
6 |
64 |
| FilterCamera |
7 |
128 |
| FilterMaterial |
8 |
256 |
| FilterOptions |
9 |
512 |
| FilterFunction |
10 |
1024 |
| FilterFuncDecl |
11 |
2048 |
| FilterPhenDecl |
12 |
4096 |
| FilterUserData |
13 |
8192 |
| FilterInstObject |
14 |
16384 |
| FilterInstGroup |
15 |
32768 |
| FilterInstLight |
16 |
65536 |
| FilterInstCamera |
17 |
131072 |
| FilterInstFunction |
18 |
262144 |
| FilterRender |
19 |
524288 |
| FilterCustomText |
20 |
1048576 |
| FilterCustomShader |
21 |
2097152 |
| FilterCustomPhen |
22 |
4194304 |
此列表中的整数值确定模式中的位位置。MEL 中没有位移动操作，但是有以下命令：
可用于计算最终的整数值。支持任意组合过滤器条目，最终过滤器整数是各个值的总和。
示例：若要不写入（剪切掉）“link”和“include”语句，您将给出 Mayatomr -mi -file fileName -exportFilter 3
一个方便的 MEL 函数 miExportFilterValue(string $entries[]) 可用于根据提供的说明性类型名称计算最终整数参数，像“link”、“include”，等等。支持的类型名称列表可在文件 mentalrayUI.mel
中找到。
默认设置：无过滤器
- -exportFilterString(-xfs) string
-
使用字符串参数设置导出过滤器，其中字符串中的每个字符都标记上述模式中的相应位位置。默认设置：无过滤器
- -exportStartFile(-xsf)
-
将当前使用的启动文件 maya.rayrc 包含到导出的 .mi 文件中。在此情况下，启动文件语句不需要再次从场景文件（通过自定义文本）给定。默认设置：禁用
- -exportPathNames(-xp) string
-
用于文件引用（例如：链接库、包含 mi 文件、纹理文件、光照贴图等）的导出选项。
所有文件引用可以强制为相同，使用值：abs - 绝对路径，rel - 相对路径，non - 无路径。
此外，该字符串可以指定每个单独的文件引用，其中字符串中的每个字符表示单个文件引用条目，意义分别为：0 - 无更改，1 - 绝对路径，2 - 相对路径，3 - 无路径，或 0 - 无更改，a - 绝对路径，r - 相对路径，n - 无路径。
文件引用条目按照如下顺序指定：链接库、包含 mi 文件、纹理文件、光照贴图、灯光剖面、输出图像、阴影贴图、最终聚集贴图、光子贴图、需要加载对象 mi 文件。默认设置：无更改。
例如，“-xp aarrararra”将针对链接库、包含文件、灯光剖面、阴影贴图、需要加载对象 mi 文件使用绝对路径，以及针对纹理文件、光照贴图、输出图像、最终聚集贴图、光子贴图使用相对路径。如果单独的文件引用字符串没有完全指定，那么将为其余的所有文件引用假定使用最后的字符。因此，例如，“-xp
aarra”等同于“-xp aarraaaaaa”
MEL 示例
// Render the lower left corner of the image to the render view with // progress messages. persp camera is used to render the image. Mayatomr -preview -v 5 -region -rr 0 0 300 300 -camera perspShape; // Batch render occlusionLayer with occlusionCamera, with 1k square // resolution. Mayatomr -render -layer occlusionLayer -xResolution 1024 -yResolution 1024; // Export the scene to test.mi file with tabstop value 8. // Texture files exported with absolute path, and all other file entries // are exported with no path. Mayatomr -mi -tabstop 8 -xp "3313333333" -file "test.mi";
