
vconvolve(1)                 Khoros                  vconvolve(1)

PROGRAM
     vconvolve - Compute two-dimensional convolution of a pair of
     images

SYNTAX
     vconvolve

     -i1            first input image

     -i2            second input image (filter kernel)

     -o             resulting output image

     [-V]           Gives the version for vconvolve

     [-U]           Gives the usage for vconvolve

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vconvolve performs a two dimensional  convolution  of  an
     image a specified kernel image.

     If either of the files is of data storage type FLOAT, the
     output  will  be in  that  format,  otherwise  the output
     will be 4_BYTE (integer).

     The second input image should be smaller than the first
     input image as it is treated as the filter kernel or
     weights.

     Edge problems are handled by truncating the part of the ker-
     nel that is off of the image array.

REQUIRED ARGUMENTS
     -i1    type: infile
            desc: first input image

     -i2    type: infile
            desc: second input image (filter kernel)

     -o     type: outfile
            desc: resulting output image

OPTIONAL ARGUMENTS
     none

EXAMPLES
     vconvolve -i1 feath.xv -i2 laplace3x3.xv -o result.xv

     Convolves the laplacian3x3 kernel with "feath.xv" and leaves
     the result in "result.xv". The data type of the output image
     will be VFF_TYP_4_BYTE (32-bit integer).

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvconvolve(3) ,
     lvconvolve(3), vfft(1)

RESTRICTIONS
     vconvolve will not operate on VFF_TYP_COMPLEX images.  Accu-
     mulator error may occur when convolving two large images.

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

Khoros                    Release: 1.0                          1

