RETRO commands


PROGRAM NAME

vgpwl - Create 2D Piecewise Linear Periodic Function (K1)

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.
Note that the X-direction corresponds to across the image from left to right, and the Y-direction corresponds to down the image from top to bottom.

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

REQUIRED ARGUMENTS

-o
type: outfile
desc: resulting image

OPTIONAL ARGUMENTS

-trigger
type: infile
desc: trigger input
default: {none}
-r
type: integer
desc: number of rows
default: 512
bounds: value > 0
-s
type: float
desc: sampling frequency
default: 1
bounds: value > 0.0
-c
type: integer
desc: number of columns
default: 512
bounds: value > 0
-l
type: float
desc: signal minimum
default: 0
bounds: no range checking
-b
type: integer
desc: number of bands
default: 1
bounds: value > 0
-m
type: float
desc: signal maximum
default: 1
bounds: no range checking
-xp
type: float
desc: signal period in X-direction
default: 1
bounds: value > 0.0
-yp
type: float
desc: signal period in Y-direction
default: 1
bounds: value > 0.0
-xr
type: float
desc: rise time in X-direction
default: 0
bounds: value >= 0.0
-yr
type: float
desc: rise time in Y-direction
default: 0
bounds: value >= 0.0
-xf
type: float
desc: fall time in X-direction
default: 0
bounds: value >= 0.0
-yf
type: float
desc: fall time in Y-direction
default: 0
bounds: value >= 0.0
-xw
type: float
desc: pulse width in X-direction
default: 0
bounds: value >= 0.0
-yw
type: float
desc: pulse width in Y-direction
default: 0
bounds: value >= 0.0
-t
type: string toggle
desc: lets user choose data type of image
default: float
allowed values:

EXAMPLES

vgpwl -o plinear.xv -t float

vgpwl -o test.xv -t complex -xr 10 -yr 10 -xw 5 -yw 7

SEE ALSO

RESTRICTIONS

can only generate VFF_TYP_FLOAT and VFF_TYP_COMPLEX type images.

REFERENCES

COPYRIGHT

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