Page Contents

 

Overview


This is a command-line utility that can be used to convert .vrimg image files to .exr files in OpenEXR format. The .vrimg file format is a special format used by the V-Ray VFB to store the rendered image incrementally while rendering, in full floating-point format, will all available render elements.

 

Installation


By default, the installation of V-Ray for SketchUp installs the .vrimg to .exr converter in the folder

For Windows: Program Files\Chaos Group\V-Ray\V-Ray for SketchUp\extension\tools

For MacOS: /Applications/ChaosGroup/V-Ray/V-Ray\ for\ SketchUp/extension/tools/

 

Usage


There are two methods for running the vrimg2exr converter: 

  1. Converting a single .vrimg file to a single .exr file:

    > vrimg2exr <vrimg_file> <exr_file> [options]

    In this case, the <vrimg_file> cannot contain wildcards. Note that the .exr extension is not added automatically to the output file name.

  2. Converting multiple .vrimg files to multiple .exr files:

    > vrimg2exr <vrimg_wildcard> [options]

    In this case, <vrimg_wildcard> can contain the wild-card symbols '*' and '?'; the .vrimg files will automatically be converted to OpenEXR files with the .exr file extension.

    Caution! Under Linux and OS X parameters with wildcards must be placed within apostrophe symbols -'image_wildcard'. Otherwise the command line shell will expand automatically the wildcard into file list, which will force the program to terminate.

In both cases, the original .vrimg file is not deleted.

 

Options


One or more of the following options may be specified:

Option Description
-infoPrints information about the .vrimg file (resolution, channels present etc). This is only supported for .vrimg files created with V-Ray versions 1.48.xx and higher.
-halfStores the floating-point data in the .exr file as 16-bit floating point numbers. If this option is not specified, the data is stored as 32-bit floating point numbers.
-sRGBConverts the RGB data from the .vrimg file to the sRGB color space before writing it to the .exr file. Without this option, no color conversion is performed.
-gamma <gamma_value>Applies the specified gamma value to the RGB colors before writing the .exr file. If this option is not specified, the data is stored in linear space.
-channel <name>Only reads the specified channel from the .vrimg file and writes it as the RGB channel in the output file. No other channels are written to the .exr file. This option can be used to extract the different channels in the .vrimg file to separate image files. Use the -info option for a list of available channels in the file.
-compression <method>Sets the compression type for the resulting .exr file. If not specified, ZIP compression is used. Currently supported values for <method> are: none, zips, zip, piz, pxr24
-bufsize <buf_size>The maximum buffer size per channel (in megabytes) that will be used for the conversion. If the image does not fit into that buffer size, the converter will process it in several passes. Larger buffer size means faster conversion, but, obviously, requires more memory. The default is 10 MB per channel.