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 direction

[-y]
    specifies the impulse spacing in the Y direction

[-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 resulting image
    default: 512
    bounds: value > 0

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

-y  type: integer
    desc: specifies the impulse spacing in the Y direction
    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.