output_print
Output
print, which contains the following modules:
vlpr
vpostscr
Any mention of xvimage is actually a "field 2D". Also, the INPUTs and
OUTPUTs, which are mapped to avs parameters, inputs, and outputs, are for the
khoros library routine.
*********************************************************************************
Documentation for avs module vlpr
Input
file file descriptor to write output to
image pointer to xvimage structure to be processed
width width of lineprinter in characters
OUTPUT
Return Value: 1 on success, 0 on failure.
Description
vlpr formats a Khoros BYTE image for output on a standard
line printer. Thirty-two grey levels are used, obtained by
multiple-overstrike methods. An image wider in pixels than
the printer width in character positions is cut into strips
which can be placed side by side to form the whole.
The output is sent to the standard output and must be piped
to the appropriate device.
NOTE: This routine can generate large amounts of printer
output. DO NOT send an image to the printer unless you are
sure you can run faster than the users in the queue after
you. They'll soon be after you with a stout rope!
See also
vlpr(1), intro(3), vipl(3), verror(3), vutils(3)
lvpostscr(1), lvconvert(1)
RESTRICTIONS
vlpr works only on BYTE images.
Author
Scott Wilson
COPYRIGHT
Copyright 1991, University of New Mexico. All rights
reserved.
*********************************************************************************
Documentation for avs module vpostscr
INPUT
file file descriptor to write the output to
image pointer to xvimage structure to be processed
force flag to force output of the current page
photo_neg flag to indicate that photonegative output is
desired
wflg flag to indicate that the given width is to
be used rather than the computed one
hflg flag to indicate that the given height is to
be used rather than the computed one
xflg flag to indicate that the given X position is
to be used rather than the computed one
yflg flag to indicate that the given Y position is
to be used rather than the computed one
def_width tells what the desired output width is
(inches)
def_height tells what the desired output height is
(inches)
def_xoffset tells what the desired X offset is (inches)
def_yoffset tells what the desired Y offset is (inches)
landscape indicates if output should be in landscape
mode
OUTPUT
file this descriptor receives the Postscript out-
put
Return Value: 1 on success, 0 on failure.
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.
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 ALSO
vpostscr(1), intro(3), vipl(3), verror(3), vutils(3)
lvln03(1), lvgamut(1), lvconvert(1)
RESTRICTIONS
vpostscr can process only BIT or BYTE images.
AUTHOR
Scott Wilson, Mark Young
COPYRIGHT
Copyright 1991, University of New Mexico. All rights
reserved.
*********************************************************************************