vgpwl(1)

PROGRAM
vgpwl - Creates a set of piecewise linear periodic image.

SYNTAX

vgpwl

-o  resulting image

[-trigger]
    trigger input

[-r]
    number of rows

[-c]
    number of columns

[-b]
    number of bands

[-s]
    sampling frequency

[-l]
    signal minimum

[-m]
    signal maximum

[-xp]
    signal period in X-direction

[-yp]
    signal period in Y-direction

[-xr]
    rise time in X-direction

[-yr]
    rise time in Y-direction

[-xf]
    fall time in X-direction

[-yf]
    fall time in Y-direction

[-xw]
    pulse width in X-direction

[-yw]
    pulse width in Y-direction

[-t]
    lets user choose data type of image:
     'float' (select data type),
      or 'complex' (choose data type)
       [default = float]

[-V]
    Gives the version for vgpwl

[-U]
    Gives the usage for vgpwl

[-P]
    Prompts for command line options

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

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

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

-r  type: integer
    desc: number of rows
    default: 512
    bounds: value > 0

-c  type: integer
    desc: number of columns
    default: 512
    bounds: value > 0

-b  type: integer
    desc: number of bands
    default: 1
    bounds: value > 0

-s  type: float
    desc: sampling frequency
    default: 2
    bounds: value > 0.0

-l  type: float
    desc: signal minimum
    default: 0
    bounds: no range checking

-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
    desc: lets user choose data type of image
    allowed values:
     'float' (select data type),
      or 'complex' (choose data type)

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

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

RESTRICTIONS
can only generate VFF_TYP_FLOAT and VFF_TYP_COMPLEX type images.

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