
vrtoc(1)                     Khoros                      vrtoc(1)

PROGRAM
     vrtoc - Convert REAL data to COMPLEX form

SYNTAX
     vrtoc

     -i1            input image

     -o             resulting output image

     [-i2]          input image

     [-t]           Choose the type of conversion from real to
                    complex:
                    1 (Real to real (imaginary=0 or 2nd image)),
                    2 (Real to imaginary (real=0 or 2nd image)),
                    3 (Real to magnitude (phase=0 or 2nd image)),
                    or 4 (Real to phase (magnitude=1 or 2nd
                    image))
                       [default = 1]

     [-V]           Gives the version for vrtoc

     [-U]           Gives the usage for vrtoc

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vrtoc performs simple conversions of REAL data to COMPLEX
     form.  A non-COMPLEX image is transformed into a COMPLEX
     image by one of four methods:

     1    Move the first input image into the real part of the
          complex output image. If a second input image is
          present, then move it into the imaginary part -  other-
          wise leave the imaginary part as zero.

     2    Move the first input image into the imaginary part of
          the complex output image. If a second input image is
          present, then move it into the real part - otherwise
          leave the real part as zero.

     3    Move the first input image into the magnitude part of
          the complex output image. If a second input image is
          present, then move it into the phase part - otherwise
          leave the phase part as zero.

     4    Move the first input image into the phase part of the
          complex output image. If a second input image is
          present, then move it into the magnitude part - other-
          wise leave the magnitude part as one.

REQUIRED ARGUMENTS
     -i1    type: infile
            desc: input image

     -o     type: outfile
            desc: resulting output image

OPTIONAL ARGUMENTS
     -i2    type: infile
            desc: input image

     -t     type: integer
            desc: Choose the type of conversion from real to com-
            plex
            allowed values:
            1 (Real to real (imaginary=0 or 2nd image)),
            2 (Real to imaginary (real=0 or 2nd image)),
            3 (Real to magnitude (phase=0 or 2nd image)),
            or 4 (Real to phase (magnitude=1 or 2nd image))

EXAMPLES
     vrtoc -i feath.xv -o complex.xv -t 3

     creates "complex.xv" with constant magnitude but with phase
     given by "feath.xv"

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvrtoc(3)
     vctor(1),vconvert(1)

RESTRICTIONS
     Input images must not be BIT, COMPLEX, or transform types,
     and must have no map.

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

Khoros                    Release: 1.0                          1

