
vimpulse(1)                  Khoros                   vimpulse(1)

PROGRAM
     vimpulse - Create an image containing one or more unit
     impulses spaced as specified.

SYNTAX
     vimpulse

     -o             resulting impulse image

     [-trigger]     trigger input

     [-r]           specifies the number of rows in the resulting
                    image

     [-c]           specifies the number of columns in the
                    resulting image

     [-x]           specifies the impulse spacing in the X direc-
                    tion

     [-y]           specifies the impulse spacing in the Y direc-
                    tion

     [-n]           specifies the number of impulses in the X
                    direction

     [-m]           specifies the number of impulses in the Y
                    direction

     [-u]           the X offset of first impulse from upper left
                    corner of image

     [-v]           the Y offset of first impulse from upper left
                    corner of image

     [-V]           Gives the version for vimpulse

     [-U]           Gives the usage for vimpulse

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vimpulse creates an unsigned BYTE image (data storage type
     byte) where a background of zero has unit impulses spaced at
     intervals x and y. The r and c arguments specify the size of
     the desired image. The u and v specify the offset of the
     upper left (first) impulse from the upper left corner of the
     image.  n and m specify how many impulses to generate in
     each direction.

     Note that if only the row and column sizes are specified,
     then a single impulse is generated and placed at the center.

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

REQUIRED ARGUMENTS
     -o     type: outfile
            desc: resulting impulse image

OPTIONAL ARGUMENTS
     -trigger
            type: infile
            desc: trigger input

     -r     type: integer
            desc: specifies the number of rows in the resulting
            image
            default: 512
            bounds: value > 0

     -c     type: integer
            desc: specifies the number of columns in the result-
            ing image
            default: 512
            bounds: value > 0

     -x     type: integer
            desc: specifies the impulse spacing in the X direc-
            tion
            default: 256
            bounds: value > 0

     -y     type: integer
            desc: specifies the impulse spacing in the Y direc-
            tion
            default: 256
            bounds: value > 0

     -n     type: integer
            desc: specifies the number of impulses in the X
            direction
            default: 1
            bounds: value > 0

     -m     type: integer
            desc: specifies the number of impulses in the Y
            direction
            default: 1
            bounds: value > 0

     -u     type: integer
            desc: the X offset of first impulse from upper left
            corner of image
            default: 256
            bounds: value >= 0

     -v     type: integer
            desc: the Y offset of first impulse from upper left
            corner of image
            default: 256
            bounds: value >= 0

EXAMPLES
     The example below shows how to generate an array of impulses
     located in the center of the first quadrant of a 512x512
     image.  The impulses will be spaced 16 pixels apart in the X
     direction, 8 apart in the Y direction.  The array will have
     8 impulses in the X direction and 16 in the Y direction.

     % vimpulse -r 512 -c 512 -u 320 -v 64 -n 8 -m 16 -x 16 -y 8
     -o impulse_out

     To generate an image with a single impulse located at
     (97,221) in a 512x512 image, the following command can be
     used:

     % vimpulse -r 512 -c 512 -u 97 -v 221 -o impulse_out

     To generate a 122x318 image with an impulse at the geometric
     center, the following command can be used:

     % vimpulse -r 122 -c 318 -o impulse_out

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

RESTRICTIONS
     generates only byte data storage type output files.

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

Khoros                    Release: 1.0                          1

