
vextcent(1)                  Khoros                   vextcent(1)

PROGRAM
     vextcent - Extract a rectangular image from the center of a
     larger image.

SYNTAX
     vextcent

     -i             input image

     -o             resulting output image

     [-w]           specifies the subimage width in pixels

     [-h]           specifies the subimage height in pixels

     [-V]           Gives the version for vextcent

     [-U]           Gives the usage for vextcent

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vextcent extracts the center of an image and places the
     result in the specified output image.  The dimensions of the
     extracted area are specified by the height (-h) and width
     (-w) arguments.  The dimensions of the resulting output
     image correspond to the extracted area.

     If the subimage is larger than the original image, the rou-
     tine will fail.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: resulting output image

OPTIONAL ARGUMENTS
     -w     type: integer
            desc: specifies the subimage width in pixels
            default: 128
            bounds: value > 0

     -h     type: integer
            desc: specifies the subimage height in pixels
            default: 128
            bounds: value > 0

EXAMPLES
     vextcent -i ball.xv -o ball_cent.xv -h 64 -w 64

     This extracts a 64 by 64 subimage from the center of the
     image, ball.xv, and stores the result in ball_cent.xv.  The
     resulting image will have the same data type as the input
     image.

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

RESTRICTIONS
     vextcent will not operate on BIT, and transform data storage
     types.

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

Khoros                    Release: 1.0                          1

