
vdyth(1)                     Khoros                      vdyth(1)

PROGRAM
     vdyth - Perform dynamic thresholding on an image.

SYNTAX
     vdyth

     -i             input image

     -o             resulting output image

     -w             window width argument

     -h             window height argument

     -v             non zero output pixel value

     [-t]           Use Median as Threshold [False] or Mean
                    [True]

     [-V]           Gives the version for vdyth

     [-U]           Gives the usage for vdyth

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vdyth performs dynamic thresholding on an image by either
     using the median value or mean value of a window (mask) as
     the threshold value.  The window is specified by its width
     argument, w, and its height argument, h.  Thresholding is
     performed by moving the window over the image, and at each
     new position a new threshold value is determined for the
     pixel currently at the center of the window.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: resulting output image

     -w     type: integer
            desc: window width argument

     -h     type: integer
            desc: window height argument

     -v     type: integer
            desc: non zero output pixel value

OPTIONAL ARGUMENTS
     -t     type: boolean
            desc: Use Median as Threshold [False] or Mean [True]
            default: false

EXAMPLES
     vdyth -i input.image -o output.image -w 3 -h 3 -v 11 -t 0

     This command performs a dynamic threshold on input.image and
     stores the result in output.image.  The size of the window
     for the operation is 3 by 3.  The value of non-zero pixels
     in the output will be 11, and the median is used to deter-
     mine the threshold.

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

RESTRICTIONS
     vdyth supports only BYTE data storage type images.

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

Khoros                    Release: 1.0                          1

