You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

renderdl reads a file containing scene description commands and “executes” them. Such files are commonly called RIB files (RIB stands for RenderMan Interface Bytestream). There are two kinds of RIB files: ASCII encoded RIB files and binary encoded RIB files. A binary RIB file is smaller than its ASCII encoded equivalent, but an ASCII RIB file has the advantage of being editable in any text editor or word processor.

 

 

To render a RIB named file.rib, just type:

renderdl file.rib

 

It is possible to render more than one file:

renderdl file1.rib file2.rib file3.rib

In this case, renderdl reads each file one after the other, and the graphic state is retained from one file to another (in other words, the graphic state at the end of one file is the starting graphic state for the next file). If a file cannot be found, it is simply skipped. This behaviour is useful to separate the actual scene description from rendering options. For example:

renderdl slow_options.rib scene.rib
renderdl fast_options.rib scene.rib

 

These render the scene scene.rib twice but with different rendering options. slow_options.rib contains options for high quality rendering such as low ShadingRate and high PixelSamples, and fast_options.rib contains low quality (speedy) option settings.

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 file.rib in renderdl, type: 

cat file.rib | renderdl

Command Line Options

OptionDescription
Multithreading Options

-t n
-p n 

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

n>0Use "n" threads
n=0

Use as many threads as there are available cores

n<0Use all but n threads
 -P nSpecifies the number of processes to use for the render. "n" can take the same values as in the -p option. The way 3Delight cuts the image is controlled using the -tiling option. Note that each process will run with a single thread unless explicitly requested otherwise on the command line using the -p option.{{
Multi Host Rendering Options

-hosts host1,host1,...,hostn 

Specifies a list of machines to use for rendering. It is also possible to specify a file (instead of a host name) that contains a list of machines to use. The format of the file is very simple: one machine name per line.

-tiling

Specifies the tiling mode to use when splitting an image for multiprocess rendering. Four tiling modes are supported:

bFor balanced tiling (default). Uses feedback from the previous multiprocess render to improve the split.
mFor mixed tiling. Splits the image into almost identical squares.
vFor vertical tiling. Splits the image into vertical stripes.
hFor horizontal tiling. Splits the image into horizontal stripes. 

-ssh

Use ssh instead of rsh to start remote renders. More about network rendering in Section 7.1 [Multithreading and Multiprocessing], page 120
-jobscript script

Use script to start remote renders. The script receives the command to run as its first argument and is responsible for choosing a machine and executing the command there in a proper environment. 

-jobscriptparam param

When used with -jobscript, renderdl will pass "param" as the first argument of the script. The command to run then becomes the second argument. 

FrameBuffer Options
-d

Forces a display to the framebuffer display driver. Note that a framebuffer display driver is added to the displays declared inside the RIB so those are still called. If there is already a framebuffer display driver declared in the RIB it is ignored. 

-D

Has the same effect as {{-d}} but automatically closes the framebuffer display driver when rendering ends. 

-id

Starts i-display and launches the render, enabling the user to send multiple renders into a centralized application. See Section 8.1 [dspy idisplay], page 168

-idf

Same as -id but sets the display to output floating point data.

-rid

Replaces all the displays in the RIB by i-display without changing any output or quantize parameters.

 

-nd

Ignores all framebuffer display drivers declared in the RIB file(s). This option overrides -id , -d and -D

-displayvar

Works in conjunction with -id  to specify which output variable variable to render. For example:

renderdl -id -displayvar "color aov_occlusion" test.rib

The default value for this option is ‘rgba’

Image Output Options
-res x y

Specifies the resolution to use when rendering the specified RIB. This overrides any RiFormat command specified in the RIB file. 

-frames f1 f2

Renders the frames between "f1" and "f2", inclusively. This options enables you to render some specific frames inside one RIB file. Frames outside the specified interval are skipped. 

-crop l r t b

Sets a crop window defined by <l r t b> (left right top bottom). The values should be given in screen coordinates, which means that all values are between 0.0 and 1.0 inclusively. This command line option overrides any RiCropWindow command present in the RIB file. 

-noinit

Disable reading of the .renderdl file. See [the .renderdl file], page 10

Statistics Options
-stats

Output statistics after the render. Statistics are explained in more detail in Understanding 3Delight Statistics.

-statsfile filename

Redirect statistics into the provided file name.
-progressPrints a progress status after each rendered bucket.
RIB Output Options
-catrib

Print RIB commands instead of sending them into the renderer. An example usage is converting a binary (or compressed) RIB into an human readable ASCII version:

renderdl -catrib binary.rib.gz > ascii.rib
-o output_file

This is a helper option for the -catrib option above. It redirects the RIB commands into the give file. The example could be written like this:

renderdl -catrib -o ascii.rib binary.rib.gz
  
  
  
  
  • No labels