This page provides information about the V-Ray Image to Tiled Multiresolution EXR convertor standalone tool.
Windows: start the img2tiledexr executable from C:\Program Files\Chaos Group\V-Ray\host application\bin\
Linux: start the img2tiledexr executable from /usr/ChaosGroup/V-Ray/host application/bin/
Mac OS X: start the img2tiledexr executable from /Applications/ChaosGroup/V-Rayhost application/
Supported input image formats are:
V-Ray image file (*.vrimg)
Running img2tiledexr 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 image files to tiled multiresolution OpenEXR files.
Pixel type – Specifies whether the data in the .exr file is saved as 16-bit or 32-bit floating point numbers.
Compression type – Sets the compression type, choosing between the several available methods. If not specified, the ZIP method is used.
DWA compression level – A floating-point value that controls the compression level when using the lossy DWA compression methods.
Linear – Specifies if the input image should be converted from sRGB to linear color space when saved into the tiled OpenEXR file. Possible values are: off (no conversion), on (convert colors from sRGB to linear space), auto (convert all images except .hdr and .exr files).
Color Mode – Specifies whether to create a color EXR file (with RGB channels) or grayscale EXR file (with Y channel). When set to Auto, the image can be checked if it actually contains alpha and/or color data, and the output channels can be optimized, writing only the needed channels.
Tile size – Sets the dimensions of a squared tile.
Conversion type – Selects the type of conversion to be performed.
Input file – Specifies the image file when Single file is selected as the Conversion type.
Input dir – Specifies the input files' directory when Multiple files is selected as the Conversion type.
Output dir – Specifies the output directory for the tiled .exr files when Multiple files is selected as the Conversion type.
Wildcard – Specifies a search pattern for the input file names. Wildcards (*) can be used to define the pattern.
Subdirectories – When this option is enabled, all image files contained in subdirectories of the specified input directory are also converted.
Convert – Starts the conversion.
Command Line Usage
There are three methods for running the img2tiledexr from the command line:
If you type just
on the command line, this is the same as double-clicking the file.
Converting a single image file to a single .exr file:
> img2tiledexr <image_file> <exr_file> [options]
In this case, the <image_file> cannot contain wildcards. Note that the .exr extension is not added automatically to the output file name.
Converting multiple image files to multiple .exr files:
> img2tiledexr <image_wildcard> [output_dir] [options]
In this case, <image_wildcard> can contain the wild-card symbols '*' and '?'; the image files will automatically be converted to OpenEXR tiled multiresolution files with the .exr file extension. Optionally you can specify in <output_dir> the directory of the output files. If not specified, the output files will be written to the input directory.
Caution! Under Linux and OS X parameters with wildcards must be enclosed with 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 all cases, the original image files are not deleted.
Postfix "_tiled" will be added to the file name in case you use wildcards.
Note that many applications expect the colors in OpenEXR files to be in linear color space rather than sRGB/gamma 2.2 color space.. For this reason, img2tiledexr automatically converts the colors in the input image from sRGB to linear space for all image file formats except .hdr and .exr images. You can use the -linear option to control this conversion.
One or more of the following options may be specified: