RETRO (vipl) functions


LIBRARY ROUTINE

lvgpwl - Create a two dimensional piecewise linear image

LIBRARY CALL

int lvgpwl(
    xvimage **image, 
    int rows, 
    int cols, 
    int bands, 
    float fs, 
    float minimum, 
    float maximum, 
    float xperiod, 
    float yperiod, 
    float xrise, 
    float yrise, 
    float xfall, 
    float yfall, 
    float xwidth, 
    float ywidth, 
    int type)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) on failure

DESCRIPTION

creates a two dimensional piecewise linear image. The image pixel values follow a square waveform. The user can specify the period, phase, minima and maxima, sampling frequency, rise and fall times, and image dimensions.

NOTE: According to the Sampling Theorem, the sampling frequency should be at least twice that of the signal frequency to generate a signal properly.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

can only generate VFF_TYP_FLOAT and VFF_TYP_COMPLEX type images

MODIFICATION

Jeremy Worley 05 Mar 1992 08:26 MST -- Fixed up an fprintf function that had too few arguments based on the format field. Added rows,cols, and bands to the list of explicitly declared arguments to lvgpwl().

FILES

$RETRO/objects/library/vipl/src/lvgpwl.c

SEE ALSO

vipl(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.