
vgpwl(1)                     Khoros                      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 fre-
     quency 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.

Khoros                    Release: 1.0                          1

