Batch Rendering

Maya's 'Render' Command Line

3Delight renders can be launched using Maya’s Render command line. Issuing the Render command with only the '-r 3delight' option will render using the Render Settings that is active in the render settings window when the scene was saved. But most of its rendering attributes can be overridden with the command line interface. The following command is useful to list these parameters specific to the 3Delight for Maya plug-in:

Render -r 3delight -help

The available parameters to override the Render Settings attributes are listed below (refer to The Render Settings for more information about the effect of each attributes).

Expand to view all the command line parameters...

Render Settings Selection
`-rendersettings <string>`	Specifies the Render Settings to render with. Multiple Render Settings can be specified using a comma-separated list of names. Specifying `all` will sequentially render all Render Settings defined in the scene. Examples: -rendersettings settings1 -rendersettings settings1,settings2 -rendersettings all Because this option defines which render settings will be edited by subsequent flags, it should be specified immediately after the ‘`-r 3delight`’ option.
Mode
`-export <string>`	Export to the specified NSI file instead of render the images Export to NSI file instead of rendering the images. The `<string>` parameter specifies the NSI filename to create.
Scene Elements
`-cam <string>`	Select <string> as the camera to be rendered.
`-objects <string>`	Set the object set to render. Specify an empty string to render all visible objects.
`-lights <string>`	Set the light set to render. Specify an empty string to render all visible lights.
Frame Range
`-animation <boolean>`	Toggle the rendering of the specified frame sequence (animation) on or off.
`-start <int>`	Set the first frame to render. Implicitly sets `-animation` to `true`.
`-end <int>`	Set the last frame to render. Implicitly sets `-animation` to `true`.
`-inc <int>`	Set the frame increment. Implicitly sets `-animation` to `true`.
Image Resolution and Crop
`-x <int>`	Set the X resolution of the rendered image.
`-y <int>`	Set the Y resolution of the rendered image.
`-par <float>`	Specify the pixel aspect ratio of the rendered image.
`-crop <boolean>`	Controls if the specified crop window is used for rendering.
`-cropmin <float> <float>`	Set the top right corner position of the crop window in X and Y, respectively. Implicitly sets `-crop` to `true`.
`-cropmax <float> <float>`	Set the bottom left corner position of the crop window in X and Y, respectively. Implicitly sets `-crop` to `true`.
Performance
`-cpus <int>`	Define the number of threads to use. The default is to use all available threads.
`-texturememory <int>`	Set the size of the texture memory cache, in megabytes.
`-netcache <boolean>`	Toggle the use of network cache on or off. (Use to override the setting in the 3delight.config configuration file.)
`-netcachedirectory <string>`	Set the network cache directory. (Use to override the setting in the 3delight.config configuration file.)
`-netcachesize <int>`	Set the network cache size, in gigabytes. (Use to override the setting in the 3delight.config configuration file.)
Progress
-progress <boolean>	Toggle output of the rendering progress into the "shell".
Quality
`-pixelsamples <int>`	Set the number of pixel samples to use.
`-shadingsamples <int>`	Set the number of shading samples to use.
`-pixelfilter <int>`	Set the pixel filter type. The following values are available: ‘0’ Gaussian filter ‘1’ Mitchell filter ‘2’ Catmull-rom filter ‘3’ Sinc filter ‘4’ Box '5' Triangle
`-filterwidth <float>`	Set the pixel filter width.
`-maxdistance <float>`	Defines the maximum distance a ray can travel.
Motion Blur
`-motionblur <boolean>`	Toggle motion blur on or off.
MEL Scripts
`-prerender <string>`	MEL script executed before rendering.
`-postrender <string>`	MEL script executed after rendering.
`-preframe <string>`	MEL script executed before each frame.
`-postframe <string>`	MEL script executed after each frame.

3Delight's 'renderdl' Command Line*

Offline rendering can also be launched using 3Delight’s standalone renderer renderdl provided the scene have been exported to a NSI File. When rendering using the command line renderdl, many parameters are supported to further control aspects of the rendering process. The following command lists the available parameters:

renderdl -h

Usage: renderdl [options] [file1 ... fileN]
  -v                : output version to console
  -h                : output this help
  -q                : don't print the name of files rendered
  -d                : add a framebuffer display
  -lua              : input file is a NSI scene in LUA
  -id               : add an i-display interactive framebuffer
  -stats            : save statistics in rendered images
  -progress         : print rendering progress at each bucket
  -test             : render a test image
  -t n              : launch the render using 'n' threads
  -catnsi           : output NSI to stdout
  -o file           : when used with -catnsi, output NSI stream to a file
  -binary           : encode NSI stream in binary format
  -gzip             : compress NSI stream using gzip format
  -callprocedurals  : expand all procedurals and archives
  -archiveprocedurals: replace procedurals by NSIEvaluate

_{*Available with 3Delight Studio Pro package}

Page tree

Batch Rendering

Maya's 'Render' Command Line

3Delight's 'renderdl' Command Line*