Startup options

Realsoft 3D accepts the following startup options.

-tpaths [texture folders]

If a material refers to an image and the image is not found, these paths will be scanned to resolve the path. Useful if you have to render a project in another workstations. Multiple paths can be given by separating them with ; (semicolon).

Example: Realsoft 3D -tpaths "d:\mytextures;e:\moretextures"

-file [startup file]

Startup project.

-ccol [rrggbb]

Conflict color for the user interface controls representing conflicting attributes of multi selected objects.

-plugins [folder]

Specifies the folder from which the program reads plug-in modules. You don't usually have to specify this. The default values is 'Plugins'.

-lang [language]

This startup option allows you to select the language for the user interface. The value associcated with the switch refers to sub folders of locale folder.

For example:

Realsoft 3D -lang english

Attemps to read strings from the folder Realsoft 3D\locale\english.

-port [port number]

Distributed network rendering system uses the port 10050. If you have already used this port for something else, or if you can't use this port for whatever other reason (firewall), you can change it with this option (in which case remember to tell the port also for RendD!).

Example:

Realsoft 3D -port 10099

-btree

If given, the select window uses balanced tree layout.

-noguiload

If specified, user interface specific data sections are not loaded from project files.

-render If given, the program renders the given project and then exits. Only the current frame is rendered. This option is useful if you have to render several projects from a script file.

Example:

Realsoft 3D -render -file proj1.r3d Realsoft 3D -render -file proj2.r3d Realsoft 3D -render -file proj3.r3d

-play

This option renders the project as an animation.

Example:

Realsoft 3D -play myanim.r3d

-firstframe [frame]-lastframe [frame]

These options can be used with -play option to define the frame range to be rendered.

Example: Let's assume you have two workstations and you want to render the frames 0 ... 100 in the first workstation and the frames 101 ... 199 in the second workstation.

In workstation 1 enter: Realsoft 3D -play -firstframe 0 -lastframe 100

In workstation 2 enter: Realsoft 3D -play -firstframe 101 -lastframe 199

-forcetoscreen

If given, the program moves all windows to a visible screen so that the user can see them. You may need this option when reading projects that has been created on a multi monitor system.

-home [folder]

Specifies the home directory for the local user files. You don't usually have to touch this.

-nethome [folder]

If Network setup is used, executable files, manuals and other user independent files are installed on a server. This option specifies the home directory for these common program files. You don't usually have to touch this.

-debug

If specified, the program prints an error message whenever it finds a request it doesn't recognize. Can be useful for tracking old plug-in modules down, for example.

-prshost [hostname]-prsport [port]

These startup options control distributed network rendering. Servers to be used for rendering can be specified explicitely, by entering them to the Hosts list of rendering settings window. Or, you can ask the program to find them automatically from the host specified by these startup options. The host referred must run the PRS service.

-helpdir [folder]

This parameter can be used for defining custom path for the reference manual.

-html

If passed, the program attemps to use the html help manual rather than the native help manual.

-stcanvas

Enable single threaded rendering model. Helps to run the program with "beta" graphics drivers. help.