lvimpulse(3)

LIBRARY ROUTINE
lvimpulse - Create an image containing one or more unit impulses spaced as specified.

LIBRARY CALL
#include "vinclude.h"
int
lvimpulse(image,deltax,deltay,nx,ny,xoff,yoff,rows,cols)
struct xvimage **image;
int deltax,deltay,nx,ny,xoff,yoff,rows,cols;

INPUT

image
    pointer to VIFF structure containing image data to be processed.

deltax
    impulse spacing in x direction

deltay
    impulse spacing in y direction

nx  number of impulses in x direction

ny  number of impulses in y direction

xoff
    the X offset for the first impulse from the upper left corner of the image

yoff
    the Y offset for the first impulse from the upper left corner of the image

rows
    number of rows in the image to be generated

cols
    number of columns in the image to be generated

OUTPUT

image
    pointer to VIFF structure containing image data after processing.

Return Value:
    1 on success, 0 on failure.

MODIFICATIONS
John Rasure, Marcelo Teran, Ron E. Neher 10-May-89

DESCRIPTION

DIAGNOSTICS
The inputs are:
*image - pointer to xvimage structure pointer to receive address of image
deltax - impulse spacing in x direction
deltay - impulse spacing in y direction
nx - number of impulses in x direction
ny - number of impulses in y direction
xoff - the X offset for the first impulse from the upper left corner of the image
yoff - the Y offset for the first impulse from the upper left corner of the image
rows,cols - size of the image to be generated

The output image contains all zeros, except for the unit impulses.

lvimpulse returns a zero upon failure and a one upon success.

SEE ALSO
vimpulse(1), intro(3), vipl(3), verror(3), vutils(3)

RESTRICTIONS
generates only byte data storage type output files.

AUTHOR

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