vmcdilate(1)

PROGRAM
vmcdilate - Conditionally dilate a binary image by a structuring 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 foreground (-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 variables 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 structuring 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.