Startup Options

The program supports a set of startup switches:

-file [file;file2...]

This option can be used for specifying one or more configuration projects. These projects are loaded with the actual project to be rendered. For example, the configuration project may define light sources, camera orientation and rendering settings allowing you to easily visualize iges, vrml and other files defining only geometric objects.

-plugins [foldername]

Specifies custom plug-in folder for the renderer. The default folder is Realsoft 3D's plugins folder.

-play

Renders all the frames of the project rather than the current frame.

-first [frame]
-last [frame]

These options can be used for defining frame range for animation rendering. They have effect only if -play option is defined.

To render a single frame, pass the same frame number to both options.

-out [filename]

Define file name for the image / animation to be rendered. This overrides the file name specified in the project's output settings.

-frset [objectname]

This option can be used for specifying the rendering specification object to be used for rendering the project. If not given, the currently selected configuration (the one shown by the File/Render window when the project was saved) is used.

This option allows you render your projects with different resolution, quality etc. For example:

batchren -frset PAL myproject.r3d

batchren -frset NTSC myproject.r3d

-hosts ["host1;host2..."]

This option can be used for overriding the distribute network rendering servers specified in the rendering settings / hosts list of the project.

For example to render 'test.r3d' by using three additional rendering servers (moon, mars and rserv.mydomain.com):

batchren -hosts "moon;mars;rserv.mydomain.com" test.r3d

-width [xresol]
-height [yresol]

These options override the image resolution defined by the project to be rendered.

For example, to render 'myicon.r3d' project with 32 by 24 pixels:

batchren -width 32 -height 24 myicon.r3d