Image Copy: imf_copy

The image copying and conversion utility imf_copy is started as

   imf_copy [options] infile outfile [outtype]

The file infile will be copied to outfile. The outtype specifies the format of outfile. If no type is specified, the file name extension of outfile is used. See section picformats for a list of valid formats. The map format is especially valuable for creating memory-mappable texture images (see page mmap for details). These options are supported:


Print a brief option summary.


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 imfcopyp. Typically a smaller version of the image is created from the next higher level by averaging 4 pixels using a simple box filter.


Verbose output prints messages showing what imf_copy is doing, and a 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.


3.1 When resampling a format to another with fewer bits per component, perform error diffusion instead of truncation.


3.1 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. Alpha and x86-class processors including Intel Pentium are little-endian; most others are big-endian.


3.1 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. Files created in this way can only be rendered with mental ray 3.2 or higher, which is why it is not enabled by default.


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. Files created with this option can be read by any mental ray 3.x version.

-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

3.4 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-2009 by mental images GmbH