ITOPS(1)

NAME

itops - convert a SGI or TIFF image file to Color PostScript

SYNOPSIS

itops [-a] [-b bits-per-color] [-g gamma-factor] [-i] [-l]

[-p page-type] [-q] [-r] [-s scale-factor] [-z] [-8] [-E]

[-S] [-L label-file] image-file

DESCRIPTION

itops converts an SGI RGB format or TIFF format image file to Color PostScript. The output appears on standard output and would normally be piped directly to the lpr(1) or lp(1) command.

OPTIONS

The -l option lists all known page types.

The -p option sets the page type; the default is ``Letter.''

The -r option rotates the image so it is in landscape mode instead of portrait mode.

The -g option gamma-corrects the image data by the given amount. Depending on the printer, this value should range from from 0.9 to 2.2; the default is the same value as is used for the screen.

The -s option scales the image by the given amount.

The -a option overrides the -s option and automatically scales the image to fit the page type. If the -r option is given as well, then the image is optionally rotated for the best fit.

The -i option makes one pixel match one square PostScript unit. Otherwise, a pixel is normally shrunk to give the PostScript image the same size as the screen image.

The -b option sets the number of bits per color to download. 8 is equivalent to 24-bit RGB; other possible values are 1, 2, or 4. For printers with small color gamuts, you can speed up printing by using a value smaller than the default of 8.

The -q option suppresses all informational and error messages (quiet).

The -z option will remove (zap) image-file after conversion.

The -8 option tells itops to generate binary (8-bit) PostScript. The resulting output cannot be sent to most PostScript printers but is approximately half the size.

The -E option changes the output to be an Encapsulated PostScript file that is meant to be included in other documents. It will not print.

The -S option sets all of the above options that are appropriate for slides: a page type of 35mm, 24-bit RGB, binary PostScript, gamma of 1.0, and automatic scaling and rotation.

The -L option lets one specify an ilabel(1) label-file that will be scaled and rotated to match the image.

SEE ALSO

ilabel(1), gamma(6), snapshot(1), ``Graphics Library User's Guide,'' ~4Dgifts/iristools

DIAGNOSTICS

The program refuses to generate output if the image won't fit on the page.

BUGS

The -a and -r options are almost always desired. The options are separate because some older color PostScript printers are much slower when images are rotated.

The image libraries do not allow piping images from one program to another.

Does not do any color correction.

Autoscaling fits the page size, rather than the imageable area.

AUTHOR

Greg Couch, UCSF Computer Graphics Laboratory