
vsubstit(1)                  Khoros                   vsubstit(1)

PROGRAM
     vsubstit - Substitute each occurrence of a pixel value in an
     image with a different value

SYNTAX
     vsubstit

     -i             input image

     -o             output image

     -old           replaced value

     -new           replacement value

     [-V]           Gives the version for vsubstit

     [-U]           Gives the usage for vsubstit

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     Replace each pixel with value 'old value' with a new pixel
     of 'new value'.  This routine simply reassigns pixels of the
     given value a new value.  This is useful as an intermediate
     step in morphological analysis of binary images.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: output image

     -old   type: integer
            desc: replaced value

     -new   type: integer
            desc: replacement value

OPTIONAL ARGUMENTS
     none

EXAMPLES
     vsubstit -i image1 -o image2 -d 125 -n 220
     replaces all pixels with a value of 125 with the value 220

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvsubstit(3)
     lvsubstit(3), vmcustom(1), lvmcustom(3)

RESTRICTIONS
     vsubstit accepts only BYTE images.

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

Khoros                    Release: 1.0                          1

