<     > 

Converting Images

You can choose from the standalones that let you convert image file formats:

• Convert files between a variety of image file formats with the imgconv standalone.

• Convert image files to other formats including the format for creating memory-map textures with the imf_copy standalone.

Converting between Many File Formats

The imgconv standalone converts files between a wide variety of image file formats. It also provides a set of image processing tools such as blur, contrast, and zoom.

imgconv automatically detects supported image file formats, so input files do not require an extension (such as .pic) to identify their format. To specify the format of the output file, you can use either an extension (such as .tif) or the -format option.

The imgconv standalone can convert to any file format for which there is a dynamic link library (DLL on Windows systems). The setup program installs these DLLs to <install directory>/Application/bin/sil. When you type imgconv, the usage message lists the supported file formats.

To run imgconv, you must set the environment variable SI_IMAGE_PATH to point to the <install directory>/Application/bin/sil directory.

• If SI_IMAGE_PATH is not set or empty, imgconv checks the environment variable SI_HOME.

• If it is set, imgconv looks in SI_HOME/Application/bin/sil.

Usage

imgconv <input file> <output file> [-height <height>]
[-width <width>][-reduction <colormap size>]
[-format <name>][-compression <none|rle|lzw|packbits>]
[-description <string>]
[-processor <name> ["<arguments>"]][-verbose]

• <input file> is the name of the file you want to convert or process.

Use a dash (-) to read from the standard input. imgconv automatically detects supported image file formats, so input files do not require an extension (such as .pic) to identify their format.

• <output file> is the name of the output file.

Use a dash (-) to write to the standard output. To specify the format of the output file, you can either use an extension (such as .tif) or the -format option.

Options

-width Specifies the width in pixels of output images. Used only for raw image formats with no image header.

-height Specifies the height in pixels of output images. Used only for raw image formats with no image header.

-reduction Specifies that output images must be color-reduced using the given color map size.

-format Specifies the format to use for output images or for input images having no signature.

The usage message for imgconv lists the supported formats.

-compression Specifies the compression technique used for output images.

-description Specifies the description string to use for output images.

-processor Specifies a processor name to apply to output images. Processor arguments must be enclosed in quotes.

The usage message for imgconv lists the supported processors.

-verbose Activates verbose output.

There is no -script option available for imgconv despite what the usage message lists.

Converting Image Files to Memory–Mapped Textures

The imf_copy standalone is used to convert image files to other formats including the format required to memory-map texture images into XSI and the mental ray command line renderer.

For more information on memory mapping, see Using Memory-Mapped Textures of the Texturing guide.

Usage

imf_copy [-v] [-p] inimage outimage [outformat [outtype]]

imf_copy supports the following file formats:

Options

-v Activates verbose output.

-p Creates a memory-mappable, filtered image pyramid.

SOFTIMAGE|XSI v.6.01     <     >