.vrimg to .exr Converter 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. The utility is part of the V-Ray Standalone distribution that ships with your copy of V-Ray for Softimage.

Usage


There are two methods for running the vrimg2exr converter:

  • 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.

  • 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 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:

OptionDescription
-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.
-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. Currently supported values for<name> are: AtmosphereBackgroundDiffuseReflectRefract,SelfIllumShadowSpecularLightGICausticsRawGI,RawLightRealColorMtlID,

 RenderIDObjectIDRGB Color,Alpha

-compression <method>Sets the compression type for the resulting .exr file. If not specified, ZIP compression is used. Currently supported values for <method> are: nonezipszippizpxr24
-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.