IMAGE commands


PROGRAM NAME

ipostscr - Convert Image to Postscript

DESCRIPTION

ipostscr formats an image for output on a Postscript printer. The width and height are specified in inches. The X and Y offset specifies the location of the lower left corner of the image from the lower left corner of the page.

ipostscr will generate either a binary, grayscale, truecolor image from the input object. If the data set contains a map, then the first three columns (assuming that there are at least three) will be interpreted a the red, green, and blue components and will be used to construct a truecolor postscript image by mapping the value data through the map. If a map exists, but it does not have three or more columns, then the existing columns will be padded out to three columns with 0's.

If the data set does not contain a map, then if its data type is KBIT, it will generate a bitmapped black and white postscript. Otherwise, the data set will be cast to unsigned byte and a grayscale image will be generated.

This program can be used to generate either Postscript or Encapsulated Postscript images in either Landscape or Portrait mode. The -eps flag is used to specify that encapsulated postscript should be output.

If you only specify the width, or the height, the other dimension will be calculated, so that you will get a postscript image which reflects the true dimensions of the image.

REQUIRED ARGUMENTS

-i
type: infile
desc: Object to be output in postscript form
-f
type: outfile
desc: output postscript file

OPTIONAL ARGUMENTS

-width
type: double
desc: Desired width in inches of the printed image
default: 4
bounds: value > 0.0
-height
type: double
desc: Desired height of printed image in inches
default: 4
bounds: value > 0.0
-xoffset
type: double
desc: Width offset in inches from bottom left corner of printed page
default: 1
bounds: value > 0.0
-yoffset
type: double
desc: Height offset in inches from bottom left corner of printed page
default: 1
bounds: value > 0.0
-showpage
type: flag
desc: Issue showpage at end of output

Mutually Exclusive Group; if desired, specify ONE of:

-portrait
type: flag
desc: Specify that portrait style output is desired.
OR
-landscape
type: flag
desc: specifies that landscape output is desired

Mutually Exclusive Group; if desired, specify ONE of:

-ps
type: flag
desc: Specify that regular Postscript output is desired.
OR
-eps
type: flag
desc: Specify that Encapsulated Postscript is desired.

EXAMPLES

SEE ALSO

RESTRICTIONS

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.