IMAGE (kimage_proc) functions


LIBRARY ROUTINE

lipostscr - convert input image object to postscript

LIBRARY CALL

int lipostscr(
   kfile *file, 
   kobject obj,
   double width, 
   double height, 
   double xoffset, 
   double yoffset, 
   int wflg, 
   int hflg, 
   int xflg, 
   int yflg,
   int landscape,
   int eps,
   int showpage)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) on failure

DESCRIPTION

lipostscr 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.

lipostscr 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.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

*

FILES

$IMAGE/objects/library/kimage_proc/src/lipostscr.c

SEE ALSO

kimage_proc(3)

COPYRIGHT

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