
vmcdilate(1)                 Khoros                  vmcdilate(1)

PROGRAM
     vmcdilate - Conditionally dilate a binary image by a struc-
     turing element.

SYNTAX
     vmcdilate

     -i             input image

     -k             input kernel

     -o             output image

     [-f]           foreground value

     [-w]           wave value

     [-V]           Gives the version for vmcdilate

     [-U]           Gives the usage for vmcdilate

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vmcdilate computes the conditional Dilation of an binary
     image by a structuring element.

     BEHAVIOR:

     For this binary dilation function, the user may specify a
     'foreground' grey level; then all grey levels different from
     the foreground are considered 'background'.  The user may
     also specify a 'wave' value, that is, the value given the
     pixels that are changed by the dilation.  This is useful for
     visualizing the effects of the dilation.  If neither fore-
     ground (-f) nor new value (-n) are specified, then it is
     assumed that the background is black and all other values
     are foreground.

     Note that erosion, the dual of dilation, can be achieved by
     interchanging the roles of foreground and bckground.  th

     The structuring element is a morphological kernel (created
     by vmcustom).  This kernel is an image file with two vari-
     ables ispare1 and ispare2 that define the origin of the
     structuring element (refer to vmcustom and lvmcustom).

     This algorithm is a modification of one found in :

          "Morphological Methods in Image and Signal Processing"

          Charles R.Giardina

          Edward R. Dougherty

          Prentice Hall, Englewood Cliffs, New Jersey 07632

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -k     type: infile
            desc: input kernel

     -o     type: outfile
            desc: output image

OPTIONAL ARGUMENTS
     -f     type: integer
            desc: foreground value
            default: 255
            bounds: 0 < [-f] < 255

     -w     type: integer
            desc: wave value
            default: 255
            bounds: 0 < [-w] < 255

EXAMPLES
     vmcdilate -i image1 -k kernel -o image2 -f 128 -n 200
     Computes the dilation of an image X (input -i ) by a struc-
     turing element B (input -k) and stores the result in the
     output image ( -o).  Dilates only those regions whose value
     is equal to the foreground value of 128 (input -f). The
     changed pixels are set to 200 (-n).

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvmcdilate(3)
     lvmcdilate(3), vmcustom(1), lvmcustom(3), vmdilate(1),
     vmspan(1)

RESTRICTIONS
     vmcdilate accepts only BYTE images.  The structuring element
     is an image file, nevertheless, it should always be created
     by  vmcustom so that the origin will be specified.

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

Khoros                    Release: 1.0                          1

