Page History
This page introduces command-line parameters for V-Ray Standalone.
Page Contents
| Table of Contents | ||||
|---|---|---|---|---|
|
Overview
...
Below is a list of the command-line parameters for V-Ray Standalone. You can use the VRAY_CMD_PREFIX and VRAY_CMD_SUFFIX environment variables to specify additional command-line parameters – see the V-Ray Standalone Environment Variables page. If you run V-Ray Standalone without any parameters, it will also print a short help text with descriptions of each possible option. Portions of the options in square brackets [] are optional and portions in curly braces {} can be repeated zero or more times.
...
-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.
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.
...
-region=x0;y0;x1;y1 – Sets the а region to render. The integer values are in pixels, relative to the upper-left corner of the image. The default is full image or as A region might be specified in the .vrscene file . Use itself and it will be used in the rendering, unless the -region flag is used to override it or the -region=none flag is used to disable region rendering, even if a region is specified in the .vrscene fileit.
-region=none – – Ignores any the region specified in the .vrscene file
...
-frames=b0[-e0[,s0]]{;bn[-en[,sn]]} – Specifies the frames and/or frame intervals to render. More than one -frames option can be specified: bX is the start frame, eX is the end frame, and sX is the frame increment. If not specified, the frames from the scene description are rendered.
| Example | Description |
|---|---|
| -frames=1;3;5-10 | Render frames 1, 3 and 5 to 10 inclusively |
| -frames=10-100,5 | Render every 5-th frame starting from 10 to 100 (i.e. 10, 15, 20, 25, ..., 95, 100) |
...
0 – The regular render engine is used.
1 – The CPU RT engine is used.
3 – The GPU RT engine running on OpenCL is used.
5 – 5 – The GPU RT engine running on CUDA is used.
...
-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
...
-distributed=0/1/2 – Specifies whether and how to use distributed rendering:
...
-cmdMode=0/1/2 – Specifies if command mode is disabled, enabled through TCP/IP only, or enabled through TCP/IP and the keyboard. See the V-Ray Standalone Command Mode page for more details. 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.