
vdither(1)                   Khoros                    vdither(1)

PROGRAM
     vdither - Perform dithering using ordered (matrix) tech-
     nique.

SYNTAX
     vdither

     -i             input image filename

     -o             output image filename

     [-t]           Select Dither Matrix (Star) [True] or (Box)
                    [False]

     [-V]           Gives the version for vdither

     [-U]           Gives the usage for vdither

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vdither performs 5x5 ordered dithers.  These dithers provide
     a reasonable compromise between grey levels and spatial
     resolution.

     The output file is of type BIT, suitable for sending to the
     laser printer using one of the Khoros printing (hardcopy)
     routines.  The type of dithering matrix used is either (1
     for Star or 2 for Box).

     1 - Star (default): The Star matrix makes superpixels that
                         look like four-pointed stars.  The Star
                         dither looks best at close range.

     2 - Box:            The Box matrix makes superpixels that
                         look like boxes.

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

     -o     type: outfile
            desc: output image filename

OPTIONAL ARGUMENTS
     -t     type: boolean
            desc: Select Dither Matrix (Star) [True] or (Box)
            [False]
            default: true

EXAMPLES
     vdither -i ball.xv -o dith_ball.xv

     This will perform the 5x5 ordered matrix dithering on the
     input image, and store the result in dith_ball.xv.  The out-
     put image will be of data storage type BIT.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvdither(3)

RESTRICTIONS
     vdither operates only on BYTE data storage type images.

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

Khoros                    Release: 1.0                          1

