Versions Compared

Key

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

This page contains information about V-Ray's standalone VRImg to OpenEXR converter.


Page Contents

Table of Contents
stylecircle

 

Multiexcerpt
MultiExcerptNameconverterOverview

Overview


The VRImg to OpenEXR converter is both a command-line utility and a simple GUI application 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 an application's V-Ray Frame Buffer to store the rendered image incrementally while rendering, in full floating-point format, with all available render elements. The V-Ray Image to EXR Converter converts .vrimg files to EXR format so the render elements may be loaded into compositing software, where they can be used for compositing or fine-tuning at the render element level.


 

 

 

Multiexcerpt
MultiExcerptNameconverterInstallation

Installation


By default, the installation of V-Ray includes the vrimg2exr executible in the bin or tools folder found under [Program Files]\Chaos Group\V-Ray\[host app.]. A shortcut to the converter is also installed in the Start Menu under All Programs > Chaos Group > V-Ray for [Host app.] > Tools > VRImg to OpenEXR converter.


 

 

Multiexcerpt
MultiExcerptNameconverterGUIusage

GUI Usage


Running vrimg2exr without any parameters, or from the Start menu, will open the GUI version of the tool as seen above. The GUI allows you to convert one or a number of .vrimg files to OpenEXR files. You can also get information about the data stored in a .vrimg file.


 

 

Multiexcerpt
MultiExcerptNameconverterCmdUsage

Command Line Usage


There are two methods for running the vrimg2exr converter from the command line. In both cases, the original .vrimg file is not deleted.

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.


Multiexcerpt
MultiExcerptNameconverterCmdNote
Note

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

 

 

Multiexcerpt
MultiExcerptNameconverterOptions

Options


One or more of the following options may be specified:

Option

GUI equivalent

Description

-info Info buttonPrints 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.
-half Pixel type drop-downStores 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.
-sRGB-Converts 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> Available channels drop-downOnly 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> Compression type drop-downSets 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> Buffer size spinnerThe 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, but a larger value, f.e. 100 or more is recommended for large files. A  value of 0 removes the limit for the buffer. In that case it will try to load the image in one pass which may result in utilizing all available memory.
-dataWindow Data window checkboxAttempts to find a rectange in the image that stores non-zero data (based on the alpha channel) and only stores this data window in the OpenEXR file.
-separateFiles Channels in separate files checkboxEach render channel is written to its own OpenEXR file. If not specified, a single multichannel OpenEXR file is produced.
-multiPart Multipart output Each render channel is written to a separate "part" inside a single OpenEXR file. This allows applications to load each render element separately which may speed up the work when there are many render channels.
-longChanNames-Enable channel names with more than 31 characters. The resulting OpenEXR file might not be compatible with applications using a version of the OpenEXR library older than version 1.7
-help-Print all possible command-line parameters.