Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

There are some environment variables that affect the operation of V-Ray. Some of these variables are in effect in both V-Ray Standalone and V-Ray for 3ds Max, while some of them are pertinent to V-Ray Standalone only. The variables that are valid for V-Ray Standalone only are marked with (standalone).

 


Licensing

...

VRAY_AUTH_CLIENT_FILE_PATH  – The path to the vrlclient.xml file containing information about the license (e.g. license server IP address and port).

VRAY_CONNECT_TIMEOUT  – The timeout (in milliseconds) when connecting to the license server. 


Command Line

...

VRAY_CMD_PREFIX (standalone) – Specifies command-line options for V-Ray Standalone, which are pre-pended to the actual command line.

VRAY_CMD_SUFFIX (standalone) – Specifies command line options that are appended to the actual command line.

 


Processes

...

VRAY_PROCESS_MAX_OPEN_FILES – Controls the file limit for the whole process. It is helpful for tackling the Too many open files (24) error. This command is available in V-Ray 6 only.

 


Anchor
TexturesAndRenderAssets
TexturesAndRenderAssets
Textures and Render Assets

...

VRAY5_FOR_3DSMAXnnnn_PLUGINS (standalone) – Specifies a list of paths for additional V-Ray plugins. Paths are separated with ';' on Windows and ';' or ':' on Linux/macOS. nnnn in the name of the variable is the version of 3ds Max (for example VRAY5example VRAY5_FOR_3DSMAX2021_PLUGINS).

VRAY_TEXTURE_CACHE  – Specifies the size, in megabytes, of a separate texture cache to be used for tiled OpenEXR files. If this is not present, or the value is 0, the same cache is shared between dynamic geometry and tiled textures. One of the advantages of a separate texture cache is that it is persistent across frames when rendering an animation.

...

VRAY_GPU_SL_SHADERS_LIMIT – Controls the number of OSL cache to be deleted during animation. The default value is 64. If set to 1, the cache is deleted for every frame. For more complicated scenes, or when using an interactive render a higher value works better. This variable is useful for animations with 3ds max OSLs as these shaders can cause a progressive slowdown in animation.

VRAY_PATH_REMAP_FILEPATH (standalone) – Specifies a path to an XML file with path remapping data. This environment variable is an alternative to the -remapPathFile flag.  Example file:

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

VFB Control

...

VRAY_VFB_SRGB (standalone) – If set to 1, the sRGB button of the V-Ray VFB is automatically switched on. If set to 2, the sRGB button of the V-Ray VFB is switched off.

...

0 - disabled
1 - force enable always on top
2 - force disable always on top

 


Log File

...

VRAY_SYSTEM_LOG_FILE – Sets the location of the V-Ray log file. This overrides the system_vrayLog_file vrender parameter.

...

VRAYSL_LOG_FILE_PATH (standalone) – Specifies the path to the log file for DR rendering (the temp folder is used if not set). 


Distributed Rendering

...

VRAY_DR_CONTROLPORT (standalone) – Specifies the port number used for distributed rendering. Note that in V-Ray 3.0 this environment variable is used only if you specify 0 for the port number. If this environment variable is also missing, port 20204 is used, as that is the default value set for V-Ray for 3ds Max.

...

VRAY_VRSCENE_LOCATION – When set on a machine that is used as a render server during distributed rendering, this variable specifies the path to store the temporary .vrscene file. The default user temp directory is used when this variable is not set.

 

Ray Differentials

VRAY_USE_NORMAL_DIFFERENTIALS – If set to 1, V-Ray uses the surface curvature when calculating ray differentials for secondary rays for reflection, refraction, and GI. This is typically helpful with tiled OpenEXR and TIFF textures, as it produces a more accurate estimate for the required mip-map level (which otherwise might be overestimated resulting in a more detailed level being loaded than is really necessary). 


V-Ray GPU

...

VRAY_GPU_PLATFORMS – Specifies the CUDA devices to be used for V-Ray GPU rendering. This variable is automatically set when a device is selected using the V-Ray GPU settings in 3ds Max (or the equivalent external tool provided with the V-Ray installation vray_gpu_device_select.exe). If the variable is not set, all available devices are used. The syntax allows a case insensitive pattern matching of any value to a device name, vendor, type and its index. More than one values can be specified by separating them with a semicolon.

...