Your Ad Here

Batch Rendering

You can use command-line options to render scenes without opening the XSI user interface. In addition, you can export render archives from the command line.

 

The previous syntax for batch rendering using the -r switch has been deprecated and is no longer recommended. Use render events in place of the -prescript and -postscript options,

Rendering in Batch Mode

To render in batch mode:

1. Do one of the following:

- On Windows, open a Softimage command prompt window.

To do this, choose All Programs > Softimage Products > SOFTIMAGE|XSI 6.01 > Command Prompt from the Windows Start menu.

- On Linux, open a shell or terminal window and source the .xsi_6.01 XSI resource file.

2. At the command line, run xsi with the -render or -export option. For example:

   xsi -render mypath/myscene.scn

Alternatively, you can create and run batch or script files that include commands like the one above.

Batch Render Options

Here are the batch rendering options you can use on a command line.

Usage

xsibatch <-render|-export> <path to scene> 
              [-pass <pass1,pass2,...,passN>] 
              [-frames <start,end[,step]>|<frame set>] 
              [-output_dir <dir>] 
              [-mb <on|off>] 
              [-skip <on|off>]

Options

-render <scene>  

Loads the given scene and renders it.

-export <scene>  

Loads the given scene and exports it to a render archive.

-pass <pass1,pass2,...,passN>  

Gives the list of passes to render. If no pass is specified, then all passes are rendered.

-frames <start,end[,step]>|<frame set>

Overrides the frame settings of all passes. The frame setting can be given either as a list of two or three comma separated numbers, or any other string, which will get interpreted as a frame set. If a frame set is required but it consists of only two or three frames, it is possible to give the frame set like 2-2,5-5, since a string that contains a hyphen (-) will always be interpreted as a frame set. Alternatively the string can also be surrounded by single quotes.

-output_dir <dir>  

Override the output directory of the scene render options.

-mb <on|off>  

Enable or disable motion blur for all passes.

-skip <on|off>  

Enable or disable frame skipping for all passes.

Using Scripts to Set Other Options

If you want to modify other options than those provided with the -render and -export switches, you can use the -script option to specify a script. The script runs after the scene has been loaded and modifications performed on the passes and scene render options according to the command line options. The render or export starts after the script has finished.

When using -script together with -render or -export, all the script options apply, including -lang and -main. For more information about batch scripts, see Batch Scripts.

Example 1

To turn final gathering on or off, create a script called RenderScript.vbs containing this procedure:

   Sub RenderScript( fg_enable )
   SetValue "Passes.List.*.mentalray.FGEnable", CBool( fg_enable )
End Sub

This can be used on the command line as follows:

xsibatch -render <.scn file> -script RenderScript.vbs -main RenderScript -args -fg_enable True

Example 2

To set the mental ray verbosity level to full, create a script called VerboseFull.vbs with the following line:

SetValue "Passes.List.*.mentalray.Verbosity", 252

This can be used on the command line as follows:

xsibatch -render <.scn file> -script VerboseFull.vbs

Remote Batch Rendering

You can render in batch mode remotely using Telnet or a remote shell (rsh).

• On Linux, use xsi -render or xsi -export as usual.

• On Windows, use xsibatch -render or xsibatch -export instead. The xsibatch command supports the same options as xsi. However, the beta version of the Telnet daemon included in some versions of the Windows Resource Kit (TELNETD) is not supported.



SOFTIMAGE|XSI v.6.01     

Return to Softimage XSI Index


Your Ad Here