
vpostscr(1)                  Khoros                   vpostscr(1)

PROGRAM
     vpostscr - Format a Khoros image in Postscript, suitable for
     a LaserWriter

SYNTAX
     vpostscr

     -i             input image filename

     [-w]           width of image in inches

     [-h]           height of image in inches

     [-x]           x offset in inches from upper left corner

     [-y]           y offset in inches from upper left corner

     [-p]           Print photonegative

     [-c]           Force page output

     [-s]           Enable color-to-grey conversion

     [-l]           Print landscape mode

     [-V]           Gives the version for vpostscr

     [-U]           Gives the usage for vpostscr

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called vpostscr.ans
                    or file1

     [-a [file1]]   Uses vpostscr.ans or file1 as the answer file

DESCRIPTION
     vpostscr formats an Khoros BYTE or BIT image for output on a
     Postcript laser printer. Such as the Apple Laserwriter.  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.  An impor-
     tant detail: there is a 1/8 inch wide margin all around the
     page that cannot be writen on even though it is legal to try
     to print there! [Laserwriter feature]. Note that a BYTE
     image is dithered INSIDE the Postscript printer!

     NOTE:  The output from this routine goes to the standard
     output!  This lets one pipe the output directly to the laser
     printer. See example 1 below.

     Also observe that if your printer filter converts ASCII text
     files to Postscript (like the Adobe software), you will have
     to bypass the filter to get useful output.  The way to do
     this is with a program like pscat, which bypasses the
     conversion.

     If the input image is a pseudo colored images ( 3 map
     columns, and map enable FORCE) and the -s flag is true, then
     vpostscr will squish the 3 map columns into 1 map column by
     computing the average over all 3 map columns.  The image is
     then mapped through the map producing a grey scale image
     that can be sent to the postscript printer.

     If the image is a 24-bit color image, or an image as speci-
     fied above, and the -s flag is false, then the output is a
     color postscript file compatible with a QMS color postscript
     printer (i.e. it uses the colorimage operator). Such output
     files can be very large since a full 8-bit color band must
     be sent for each color band in the image (this means that a
     mapped image is  essentially turned back into a 24 bit image
     before being sent out). It is often adviseable to use lpr -s
     so that networked printers don't choke on the size of the
     output file.

     The -c option is used to allow the printing of multiple
     images on one output page.  See example 2 below.

     The -l option is used to print in landscape mode. Note, -w
     and -h refer to the width and height of the image before the
     90 rotation. If you have an image that has a large width and
     a small height and you wish to print it in landscape mode,
     the -w option can now take on a value between 0 and 11. The
     -h option will be limited to 8.5.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image filename

OPTIONAL ARGUMENTS
     -w     type: float
            desc: width of image in inches
            default: 4
            bounds: 0.100000 < [-w] < 11.000000

     -h     type: float
            desc: height of image in inches
            default: 4
            bounds: 0.100000 < [-h] < 11.000000

     -x     type: float
            desc: x offset in inches from upper left corner
            default: 0
            bounds: 0.000000 < [-x] < 10.000000

     -y     type: float
            desc: y offset in inches from upper left corner
            default: 0
            bounds: 0.000000 < [-y] < 10.000000

     -p     type: boolean
            desc: Print photonegative
            default: false

     -c     type: boolean
            desc: Force page output
            default: true

     -s     type: boolean
            desc: Enable color-to-grey conversion
            default: true

     -l     type: boolean
            desc: Print landscape mode
            default: false

EXAMPLES
     Example 1. The following example shows how to pipe the out-
     put from vpostscr directly to the Postscript printer.

          % vpostscr -i feath.xv | lpr -Plaserwriter

     Example 2. The following example how print multiple images
     on a the same page by using the overlay (-c) option.

          % vpostscr -i img1 -x 1.0 -y 1.0 -w 3 -h 3 -c > out1

          % vpostscr -i img2 -x 3.0 -y 4.0 -w 2 -h 2.5 -c > out2

          % vpostscr -i img3 > out3

          % cat out1 out2 out3 | lpr -Plaserwriter

     Example 3. The following example prints a color image using
     the -s 0 option.

          % vpostscr -i image.rgb.xv -w 6 -h 6 -s 0 | lpr -PQMS

     This results in the images img1, img2, and img3 being
     printed on the same output page!  All but the last image
     should be processed with the -c option, which just suspends
     the output until further notice.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvpostscr(3) ,
     lvpostscr(3), vln03(1), vgamut(1), vconvert(1)

RESTRICTIONS
     vpostscr can process only BIT or BYTE images.

COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

