
vclose(1)                    Khoros                     vclose(1)

PROGRAM
     vclose - Close boundaries in images

SYNTAX
     vclose

     -i1            Input Boundary Image (resulting from vdrf,
                    vgef, vsdef ...)

     -i2            Input Gradient Image (resulting from vdrf,
                    vsdef, sobel...)

     -o             resulting output image or file

     [-grad]        Gradient Threshold (used by the closing pro-
                    cess)

     [-len]         Minimum Gap Size In Pixels

     [-V]           Gives the version for vclose

     [-U]           Gives the usage for vclose

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vclose uses a boundary image and a gradient image as input.
     Then it tries to close the boundaries by following the max-
     imum gradient between two end points of two contours.

     The new closing part is kept if its length is at least
     "Minimum_Gap_Size" pixels. This parameter is used to prevent
     the result from being covered by small contours (edges of
     noisy areas...).

     The minimum gradient value "Gradient_Threshold" has to be
     set up to indicate to the closing process up to what value
     it can follow a maximum gradient curve to close a boundary.

     This Algorithm has been writen by:

          Professor SERGE CASTAN, Prof CHEN and Dr ZHAO

          IRIT, CNRS, URA 1399

          118, route de Narbonne  31062 Toulouse  FRANCE

REQUIRED ARGUMENTS
     -i1    type: infile
            desc: Input Boundary Image (resulting from vdrf,
            vgef, vsdef ...)

     -i2    type: infile
            desc: Input Gradient Image (resulting from vdrf,
            vsdef, sobel...)

     -o     type: outfile
            desc: resulting output image or file

OPTIONAL ARGUMENTS
     -grad  type: integer
            desc: Gradient Threshold (used by the closing pro-
            cess)
            default: 0
            bounds: value >= 0

     -len   type: integer
            desc: Minimum Gap Size In Pixels
            default: 1
            bounds: value >= 0

EXAMPLES
     vclose -i1 feath_edge.xv -i2 feath_grad.xv -v 5 -f 0.5 -o
     closed_boundary.xv

     Will use feath_edge.xv and feath_grad.xv as the edges and
     respectively the gradient representation of an image. Then
     it will close the unclosed boundaries using a minimum gap
     size of 5 pixels and a gradient threshold of 0.5 .SH SEE
     ALSO intro(1), verror(3), vgparms(3), vutils(3), lvclose(3)

RESTRICTIONS
     vclose will only work with single band images. Then the
     first image has to be of data storage type VFF_TYP_1_BYTE.
     The second input can be anything from VFF_TYP_1_BYTE to
     VFF_TYP_FLOAT.

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

Khoros                    Release: 1.0                          1

