
vlaser(1)                    Khoros                     vlaser(1)

PROGRAM
     vlaser - Format a Khoros image in Impress for output to the
     IMAGEN 8/300

SYNTAX
     vlaser

     -i             input image filename

     [-m]           mag factor = 2**(specifed mag amount)

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

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

     [-p]           Photonegative output

     [-V]           Gives the version for vlaser

     [-U]           Gives the usage for vlaser

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vlaser formats a Khoros BIT image for output on the IMAGEN
     8/300 laser printer.  The magnification is specified as the
     log base 2 of the desired magnification (i.e. 4x is -m 2).
     The x offset and y offset specify where on the printer page
     to place the upper left hand corner of the image.

     The vlaser routine only works on VIFF BIT images. In order
     to print a non-BIT image it will be necessary to dither or
     convert the image before using this routine.  Khoros pro-
     vides several dithering routines, such as vdither(1),
     vdith45(1), and verrdif(1).  vconvert(1) can also be used to
     convert a non-bit image to bit format.

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

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

OPTIONAL ARGUMENTS
     -m     type: integer
            desc: mag factor = 2**(specifed mag amount)
            default: 2
            bounds: 0 < [-m] < 4

     -x     type: float
            desc: x offset in inches from upper left corner
            default: 0
            bounds: 0.000000 < [-x] < 8.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: Photonegative output
            default: false

EXAMPLES
     The following example sends the Khoros BIT image file to the
     "laser" printer.  The outputed image will be offset on the
     page by 3.5 inches in the x direction and 4 inches in the y.
     The output will also be blown up by a factor of 4.  The -p
     flag tells vlaser to invert the image (output the image as
     photopositive). This means that the images black background
     will be white on the paper.

     % vlaser -x 3.5 -y 4 -m 2 -p -i feath.bit | lpr -Plaser

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvlaser(3) ,
     lvlaser(3), vpostscr(1),vlpr(1),verrdif(1),vconvert(1)

RESTRICTIONS
     vlaser works only on BIT images.

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

Khoros                    Release: 1.0                          1

