Command Line Rendering

AMD Radeon ProRender supports Maya’s command line rendering capabilities, letting you perform batch rendering jobs or run scripts that use the command line. An advantage of rendering with the command line is that it allows you to launch render jobs without accessing the Maya interface, which helps to free up resources normally used by the GUI and so speeds up the render process.

Setting Up Render

To learn about the location of the Maya Render command for your OS, see Set up command line rendering in the Maya documentation.

Render Command

The command for performing the batch rendering should look like this:

Render -r FireRender -flag <argument> scene.file

Note that:

• The name of the Maya scene file should always be passed as the last argument to the command.

• Arguments other than -r and scene file are optional. In case no optional arguments are specified, render settings will be retrieved from the saved scene.

Render Flags

You can use the following render flags to change the render settings for a scene.

General Purpose

Flag	Description	Example
-r FireRender	Sets AMD Radeon ProRender as the render engine.	Render -r FireRender scene.file

Output File

Flag	Description	Example
-rd <path>	The path to a directory in which to store the output image file.	Render -r FireRender -rd “D:output” scene.file
-im <filename>	Name of the output image file.	Render -r FireRender -im “OutputFile” scene.file
-of <filetype>	The type of the output image file, without the dot.	Render -r FireRender -of “png” scene.file

Camera

Flag	Description	Example
-cam <name>	The camera to be used for rendering.	Render -r FireRender -cam “camera1” scene.file

Image Resolution

Flag	Description	Example
-x <int>	The X resolution of the output image, in pixels.	Render -r FireRender -x 640 -y 480 scene.file
-y <int>	The Y resolution of the output image, in pixels.	Render -r FireRender -x 640 -y 480 scene.file
-percentRes <float>	The percentage of the resolution for the output image (from 1 to 100).	Render -r FireRender -percentRes 50.5 scene.file

Quality

Flag	Description	Example
-ccit <int>	The number of iterations for rendering (the same as the number of samples in AMD Radeon ProRender).	Render -r FireRender -ccit 80 scene.file
-ft <filtertype>	The anti-aliasing filter type.	Render -r FireRender -ft “lanczos” -fs 1.5 scene.file
-fs <float>	Anti-aliasing filter size, in pixels.	Render -r FireRender -ft “lanczos” -fs 1.5 scene.file
-g <bool>	Applies gamma settings as defined with the Display gamma parameter in the scene. The default value is 2.2.	Render -r FireRender -g scene.file
-set_gamma <float>	Sets the gamma value. If both the -g and -set_gamma flags are passed to the command, the latter takes precedence.	Render -r FireRender -set_gamma 2.2 scene.file

Render Settings

Flag	Description	Example
-stmp <bool>	Enables the render stamp.	Render -r FireRender -stmp 1 scene.file
-devc <hardware>	The hardware to use for rendering. Possible values are ‘cpu’ or ‘gpuN’. For example, ‘gpu1’ stands for the first GPU. We can select multiple cards or a GPU-and-CPU mixture.	For a single device: Render -r FireRender -devc “gpu1” scene.file For multiple devices: Render -r FireRender -devc “gpu1;gpu2” scene.file Render -r FireRender -devc “gpu1;cpu” scene.file
-cchr <int>	The limitation of the render duration in hours.	Render -r FireRender -cchr 1 scene.file
-ccmn <int>	The limitation of the render duration in minutes.	Render -r FireRender -ccmn 15 scene.file
-ccsc <int>	The limitation of the render duration in seconds.	Render -r FireRender -ccsc 45 scene.file

Notes

• At the moment, only single images can be rendered from the command line. Batch rendering for a frame range of an animated scene is not supported.

• Boolean flags can take the following values as TRUE: on, yes, true or 1; and the following values as FALSE: off, no, false or 0.