...
Command Line Options
Option | Description | ||
---|---|---|---|
-display | Launch 3Delight Display to display the image while rendering instead of writing images to files (as specified in the NSI file). | ||
-cloud | Render the file using 3Delight Cloud instead of locally. | ||
-cloudspeed n | Increase the default number of cores use to calculate the image by a factor of "n". By default, renderdl renders using around 96 cores for 2K images and proportionally more or less for higher and lower resolutions.
| ||
-collective name | Render the fils using the 3Delight Collective with the specified collective "name" instead of locally. | ||
-lowpriority | Launch the render using a lower system priority. This is useful when using the same machine for batch renders and 3Delight Collective renders. | ||
-id(obsolete option) | Launch 3Delight Display to display the image while rendering instead of writing images to files (as specified in the NSI file). (Obsolete option. It is replaced with the -display option.) | ||
-t n | Controls th number of cores/threads to use when rendering. If "n" is a whole number , it implies: n > 0 : Use exactly "n" threads. If "n" is a fraction between 0 and 1, then a fraction of the available cores will be used (eg. -t 0.5 specifies to use half of the available cores. By default, renderdl use as many threads as there are available cores (including virtual/logical cores). This option is ignored when the option -cloud or -collective is used. | ||
-stats | Embed statistics in rendered images. This is supported for EXR and TIFF files only. Statistics are explained in more detail in Detailed Statistics. | ||
-progress | Prints a progress status after each rendered bucket. | ||
-cat | 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:
| ||
-cat -binary | Outputs the NSI commands in binary format. For example:
| ||
-cat -gzip | Outputs the NSI file in compressed form. For example:
| ||
-cat -callprocedurals | expand all procedurals and archives. This is very useful when packaging an NSI file. | ||
-cat -o filename | output NSI stream to filename instead of stdout. | ||
-lua | Interpret input file as a LUA file. | ||
-v | Prints the current version of the renderer. | ||
-h | 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:
Code Block |
---|
renderdl Reading (stdin) <enter commands here> |
If you wish to pipe the content of file.nsi
in renderdl
, type:
Code Block |
---|
cat file.nsi | renderdl |
Shell Return values
The renderdl
executable will return one of the following values:
Return Value | Description |
---|---|
0 | No error. |
1 | Bad combination of parameters. An error message will explain why. |
199 | Option "licensing" "waitforlicense" 0 was used and no license was available. |
255 | The NSI file specified on the command line could not be read. |