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:
|-id||Launch 3Delight Display to display the image while rendering instead of writing images to files (as specified in the NSI file).|
Specifies the number of threads to use for the rendering. "n" can take any of the following values:
n > 0 : Use "n" threads.
By default, renderdl use as many threads as there are available cores.
|Prints 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:
Outputs the NSI commands in binary format. For example:
Outputs the NSI file in compressed form. For example:
|Prints the current version of the renderer.|
Prints the following help:
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:
renderdl Reading (stdin) <enter commands here>
If you wish to pipe the content of
cat file.nsi | renderdl
renderdl executable will return one of the following values:
|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.|