Page tree
Skip to end of metadata
Go to start of metadata

renderdl reads a file containing scene description commands and “executes” them to produce an image. renderdl also has some auxiliary usage as explained in the parameters description below.

In the simplest form, to render a file named file.nsi, just type:

renderdl file.nsi 

Command Line Options

Option                               Description
-cloudRender the file using 3Delight Cloud instead of locally.
-collective nameRender the fils using 3Delight Collective with the specified collective
-lowpriorityLaunch the render using a lower system priority. This is useful when using the same machine for batch renders and 3Delight Collective renders.
-idLaunch 3Delight Display to display the image while rendering instead of writing images to files (as specified in the NSI file).

-t n

Specifies the number of threads to use for the rendering. "n" can take any of the following values: 

n > 0 : Use "n" threads.
n = 0 : Use as many threads as there are available cores (including virtual cores).
n < 0 :  Use all but "n" threads.
n between 0 and 1 : use a fraction n of available cores. 

By default, renderdl use as many threads as there are available cores.


Embed statistics in rendered images. This is supported for EXR and TIFF files only. Statistics are explained in more detail in Detailed Statistics.

-progressPrints a progress status after each rendered bucket.

Print the NSI commands in human readable ascii format instead of processing them for rendering. This can be used to convert a binary (or compressed) NSI file into an human readable ASCII file:

renderdl -cat binary.nsi.gz > ascii.nsi
-cat -binary

Outputs the NSI commands in binary format. For example:

renderdl -cat -binary ascii.nsi > binary.nsi
-cat -gzip

Outputs the NSI file in compressed form. For example:

renderdl -cat -gzip ascii.nsi > ascii.nsi.gz
-cat -callprocedurals expand all procedurals and archives. This is very useful when packaging an NSI file.
-cat -o filenameoutput NSI stream to filename instead of stdout.
-lua Interpret input file as a LUA file.
-vPrints the current version of the renderer.

Prints the help.

No File Name Specified

If no file name is specified, renderdl reads scene description commands from the standard in. This feature enables piping commands directly in renderdl. For example, to enter scene description commands interactively (which is not really practical), do the following:

Reading (stdin)
<enter commands here>

If you wish to pipe the content of file.nsi in renderdl, type: 

cat file.nsi | renderdl

Shell Return values

The renderdl executable will return one of the following values:

Return ValueDescription
0No error.
1Bad combination of parameters. An error message will explain why.
199Option "licensing" "waitforlicense" 0 was used and no license was available.
255The NSI file specified on the command line could not be read.



  • No labels