
vcustom(1)                   Khoros                    vcustom(1)

PROGRAM
     vcustom - Create a custom image via keyboard entry, intended
     for building custom kernels for spatial convolution.

SYNTAX
     vcustom

     -o             output image

     -r             specify the number of rows

     -c             specify the number of columns

     [-trigger]     trigger input

     [-t]           lets user choose data type of image:
                     'float' (Float),
                     'byte' (Byte),
                     'short' (Short),
                      or 'integer' (Integer)
                       [default = float]

     [-V]           Gives the version for vcustom

     [-U]           Gives the usage for vcustom

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vcustom creates a small image that can be used for convolu-
     tion kernels or subimages.  The -r and -c arguments specify
     the number of rows and columns in the resulting image.  The
     user is prompted for data entry by row and column. Images of
     data storage type unsigned byte, short, int and float may be
     created.

     The trigger input can be used to cause vcustom to re-execute
     when used inside cantata. No image is read from this input.

REQUIRED ARGUMENTS
     -o     type: outfile
            desc: output image

     -r     type: integer
            desc: specify the number of rows

     -c     type: integer
            desc: specify the number of columns

OPTIONAL ARGUMENTS
     -trigger
            type: infile
            desc: trigger input

     -t     type: string
            desc: lets user choose data type of image
            allowed values:
             'float' (Float),
             'byte' (Byte),
             'short' (Short),
              or 'integer' (Integer)

EXAMPLES
     vcustom -o kernel.xv -r 5 -c 5 -t 1

     This will create a 5 by 5 image with data storage type BYTE.
     The user is prompted for data by row and column.  The
     resulting image can then be used for a convolution kernel,
     or subimage.

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

RESTRICTIONS
     lvcustom can only create byte, short, int and float data
     storage types.

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

Khoros                    Release: 1.0                          1

