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 important 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 specified 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 output 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.