PLEASE NOTE : This is the documentation for the avs module executable 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. *********************************************************************************