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 convolution 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.