Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

Expand
titleExpand to view all the command line parameters...


Render Settings Selection
-rendersettings <string>

Specify the render settings or a comma-separated list of render settings to render. Specifying "all" will sequentially render all render settings defined in the scene. Examples:

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

Because this option defines which render settings will be edited by subsequent flags, it should be specified right after the ‘-r 3delight’ option.

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.
-end <int>Set the last frame to render.
-inc <int>

Set the frame increment.

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.

-crminx <float>

Set the top right corner position of the crop window in X.
-crminy <float>Set the top right corner position of the crop window in Y.
-crmaxx <float>Set the bottom left corner position of the crop window in X.
-crmaxy <float>Set the bottom left corner position of the crop window in Y.
Render Engine
-rendermode <rendermode>

Specify the render mode. The following values are available:

  • export

  • render

-nsifile <string>Specify the NSI filename to create in case -rendermode is set to export
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.

-netcachedirectory <string>

Set the network cache directory.

-netcachesize <int>Set the network cache size, in gigabytes.
Progress
-progress <boolean>

Toggle output of the rendering progress into the "shell".

Quality
-pixelsamples <int>Set the pixel samples to use in X.
-shadingsamples <int>Set the pixel samples to use in Y.
-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 in X.
-maxdistance <float>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:


Expand
titlerenderdl -h
For a complete description of 3Delight's standalone renderer renderdl refer to 3Delight Studio Pro User Manual.pdf (in the PDF: chapter 3.1 Using the RIB Renderer - renderdl).


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