Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Moved unimplemented command line options to separate section

...


Toggle motion blur on or off
Expand
titleExpand 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:

Code Block
-rendersettings settings1
-rendersettings settings1,settings2
-rendersettings all


Info
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.
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.


Expand
titleUnimplemented options...


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> 

.

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:
 

Expand
titlerenderdl -h


Code Block
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