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>

Specifies the name of 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:

ex 1: Render -r 3delight -rendersettings settings1
ex 2:  Render -r 3delight -rendersettings settings1,settings2
ex 3:  Render -r 3delight -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 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 objects set to render. Specify an empty string to render all visible objects.

-lights <string>

Set the lights 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. This implicitly sets -animation to true.
-end <int>Set the last frame to render. This implicitly sets -animation to true.
-inc <int>

Set the frame increment. This 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. This implicitly sets -crop to true.
-cropmax <float> <float>Set the bottom left corner position of the crop window in X and Y, respectively. This 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.
And yet, this is more


Additional options to come:


Expand
titleUnimplemented/upcoming options...


-overridesEnable the use of the Overrides options from the Render Settings (by default they are always ignored during batch rendering).
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".

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*

...