Image Copy: imf_copy

The image copying and conversion utility for mental ray. It supports all image formats and types that mental ray generates, and can convert between them. Furthermore, image pyramids for texture filtering can be created and stored in appropriate texture format files.


The image copy utility is started as

imf_copy [options] infile outfile [outformat[outtype]]

The file infile will be copied to outfile using the file format outformat and the data type outtype. If no output format is specified then the file name extension of outfile is used to determine the format. If no output type is given then the default data type of the file format will be taken. The map format is especially valuable for creating memory-mapped or tile-based texture images (see page mmap for details).


These options are supported:

Print brief help text.
Create a pyramid texture, consisting of a sequence of progressively smaller versions of the same image in one file. This allows better texture anti-aliasing. See page pyramid textures. Typically, a smaller version of the image is created from the next higher level by averaging 4 pixels using a simple box filter.
Print verbose progress messages and version banner.
-g gamma
Perform gamma correction with the gamma factor gamma. The default is 1.0.
-q quality
3.1 When writing to a JPEG file, set the quality factor to quality, in the range 1..100. The default is 75.
-f filter
Useful only if the target format is .map. The filter value is stored in the texture. Memory-mapped texture files always override the filter value specified in the color texture statement or with mi_api_texture_set_filter.
When resampling a format to another with fewer bits per component, perform error diffusion instead of truncation.
When writing to a memory-mapped .map file, use little-endian byte order. Map files must have the byte order of the rendering host to be effective. Intel x86-class processors are little-endian; most others are big-endian.
When writing to a memory-mapped .map file, use big-endian byte order.
When writing to a memory-mapped .map file, arrange pixels in rectangles instead of the normal scanline order. This increases cache efficiency and reduces memory usage when rendering.
When writing to a memory-mapped .map file, collate up to 20 input files to form an image pyramid. This option gives control over the image pyramid, unlike the -p option which automatically creates each successive pyramid level at one-half the resolution of the preceding one, using a box filter. The first input image should have full resolution, the next one approximately one-half width and height, the next one approximately one quarter, and so on.
-x N
Extract level N from a pyramid .map file. The first (and largest) level is 0; the highest is 19. This can be seen as the reverse operation to -c, but it also works with pyramids created with -p.
-k K
When writing to an OpenEXR file, set the compression method to K, where K is one of the following: none, piz, zip, rle, pxr24. Default is rle.

Copyright © 1986, 2012 NVIDIA Corporation