-- only available on UNIX systems on which Midas is installed --

-- not implemented in Chimera --

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] [-1] [-E] [-L label-file] [-S] 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 or lp command.

COMMAND-LINE ARGUMENTS

-a
Overrides -s and automatically scales the image to fit the page type. If -r is also given, then the image is optionally rotated for the best fit. 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.
-b bits-per-color
Sets the number of bits per color to download. 8 (default) 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 8.
-g gamma-factor
Gamma-corrects the image data by gamma-factor. Depending on the printer, this value should range from from 0.9 to 2.2; the SGI default is the same value as is used for the screen, for all others it is 1.0.
-i
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.
-l
Lists all known page types.
-p page-type
Sets the page type; the default page-type is Letter. Use -l for a listing of types.
-q
Suppresses all informational and error messages (quiet).
-r
Rotates the image so it is in landscape mode instead of portrait mode.
-s scale-factor
Scales the image by scale-factor.
-z
Removes (zaps) image-file after conversion.
-1
Generates Level 1 PostScript with the CMYK extensions instead of Level 2 PostScript. Level 2 PostScript output is roughly 60% the size of Level 1 PostScript (or smaller).
-E
Changes the output to be an Encapsulated PostScript file that is meant to be included in other documents. It will not print.
-L label-file
Lets one specify an ilabel file named label-file; the labels will be scaled and rotated to match the image.
-S
Sets options appropriate for slides: -p 35mm, 24-bit RGB ( -b 8), -g 1.0, and automatic scaling and rotation (-a and -r). -S will override any preceding conflicting flags, but not those which follow it in the command line.
image-file
Image-file is the input image file in SGI RGB or TIFF format.

SEE ALSO

ilabel

DIAGNOSTICS

The program refuses to generate output if the image will not fit on the page.

BUGS

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
Computer Graphics Laboratory
University of California, San Francisco