Page History

...

-numThreads=nnn – Sets the number of rendering threads. The default is 0 - automatic number of threads.

-interactive=0/1 – Enables and disables the interactive mode. The default value is 0, which means the interactive mode is disabled. Enabling it allows the user to access and modify the render settings saved in the .vrscene file. These are the same options that can be found in the Render Settings dialogue in Maya or Render Setup in 3ds Max. Having access to those controls allows the user to change them without having to re-export the .vrscene from either 3ds Max or Maya.

Input Files

...

-sceneFile="filename.vrscene" – Specifies the scene file to render.

-include="includePath{;includePath}" – Specifies path(s) for include files. More than one -include options can be specified.

-remapPath="fromPath=toPath{;fromPath=toPath}" – Specifies path remapping pair. More than one -remapPath option can be specified.

-remapPathFile="remapFile.xml" – Specifies path to an XML file with path remapping data. Example file:

<RemapPaths>
    <RemapItem>
        <From>Z:/export</From>
        <To>/mnt/export</To>
    </RemapItem>
</RemapPaths>

-parameterOverride="<plugin-parameter-id>=<value>" – Makes it possible to change values for plugin parameters without editing the vrscene file.

<plugin-parameter-id> – Can be of two formats - PluginType::parameterName or pluginName.parameterName.
<value> – Its format depends on the type of the parameter you want to override. Supported types are bool, int, float, color, acolor, texture and float texture. For bool, int and float a simple number is expected. For color - Color(1, 0.0, 1.0) is expected. For acolor - AColor(1.0, 0, 0, 0.3). For texture the format should be the same as for acolor or the name of a plugin connected to the parameter. For float texture parameters, either one float or a name of a plugin is expected. More than one -parameterOverride option can be specified and will be executed in the order specified in the command line. Examples:

-parameterOverride="SettingsImageSampler::type=3"
-parameterOverride="TexFresnel::fresnel_ior=1.3"
-parameterOverride="VRayMtl1@diffuse.color=Color(1.0,0.2,1.0)"
-parameterOverride="VRayMtl2@diffuse.color_tex=checker1"

...

Render Output

...

-imgFile="<path>/fileName.<extension>" – Writes the resulting image to the given file. If the file name is empty, no image will be written. Alternatively, files can be saved without using this option in cmd if path (img_dir) and filename (img_file) are defined in the .vrscene output settings content.

...

-displayLUT=0/1 – Determines if the LUT option of the V-Ray VFB will be turned on or off initially. This can also be specified with the VRAY_VFB_LUT environment variable. The command line option overrides the environment variable. The LUT file itself can be specified with the VRAY_VFB_LUT_FILE environment variable. The default value is 0, where LUT is off.

-displayOCIO=0/1 - Determines if the OCIO option of the V-Ray VFB will be turned on or off initially. This can also be specified with the VRAY_VFB_OCIO environment variable. The command line option overrides the environment variable. The OCIO configuration itself can be specified with the OCIO  environment variable. The default value is 0. where the OCIO is off.

-displayAspect=0/1 – Determines if the pixel aspect option of the V-Ray VFB will be turned on or off initially. This can also be specified with the VRAY_VFB_PIXEL_ASPECT environment variable. The command line option overrides the environment variable. The default value is 0, where pixel aspect is off.

...

0 – No information is printed.
1 – Only errors.
2 – Errors and warnings.
3 – Errors, warnings, and informational messages.
4 - All output.

The default is 3.

-detailedTiming=0/1 – Specifies whether summary timing information would be printed to the standard output at the end of execution.

0 – Disabled (the default value);
1 – Enabled;

-showProgress=n – Specifies whether calculation progress should be printed to the standard output:

...

-progressUseCR=0/1 – Controls how to use carriage return when printing render progress information. 

-progressUseColor=0/1 – Specifies whether to colorize the output:

0 – Disabled;
1 – Enabled (the default value).

RT Engine

...

-rtEngine=0/1/3/5/7 – Specifies which rendering engine is going to be used:

0 – The regular render engine is used.
1 – The CPU RT engine is used.
3 – (Deprecated) The GPU RT engine running on OpenCL is used.
5 – The GPU RT engine running on CUDA is used.
7 – The GPU RT engine running on RTX is used.

The default is 0.

-rtTimeOut=fff – Specifies a floating-point render time value (in minutes) when using the RT engine. The default is 0.0, no time limit.

...

-rtSampleLevel=nnn – Specifies maximum number of paths per pixel for a frame when using the RT engine. The default is 0, no limit.

Distributed Render

...

-server  – Start in server mode waiting for connections.

-distributed=0/1/2 – Specifies whether and how to use distributed rendering:

...

0 – Do not transfer.
1 – Transfer missing assets.
2 – Check for assets in the asset cache folder before transferring them. The VRAY_ASSETS_CACHE_PATH environment variable can be used to specify the asset cache folder; if it is not specified, the assets are stored in a directory "vray_assets_cache" inside the temp folder for the current user.

The default is 0.

Command Mode

-cmdModecachedAssetsLimitType=0/1/2 – Specifies if command mode is disabled, enabled through TCP/IP only, or enabled through TCP/IP and the keyboard. The default is 0, where command mode is disabled.-cmdPort=nnnn – Specifies the TCP/IP port number for the command mode. The default is 4368 – Type of limitation used for cached assets on DR server:

0 – No limits (the default value);
1 – Older than: assets older than specified period of hours will be deleted;
2 – Cache size: if the assets cache grow over the specified size (GBs), the oldest assets will be deleted from cache. 

-cachedAssetsLimitValue=fff – Specifies limit value for a cached assets. fff is a floating-point number representing the value. The meaning of the value depends on the -cachedAssetsLimitType parameter. The default value is 0.0.

-overwriteLocalCacheSettings=0/1 - Specifies which settings for asset cache limitations to be taken into account.

0 – Takes the server's settings. This is the default value. It is recommended to use the server's settings for assets cache limitations;
1 – Takes the client's settings. 

-limitHosts=N – Limits the number of render hosts used for distributed rendering to the first N idle hosts specified in the -renderHost options. The default value is 0 - use all available hosts. 

-autoCloseIfIdle=n – Specifies the minutes the server will wait in idle state before closing itself. A value of 0 means this feature is disabled, otherwise it is the idle time in minutes.