lvctor(3)

LIBRARY ROUTINE
lvctor - Convert COMPLEX data to REAL form

LIBRARY CALL
#include "vinclude.h"
lvctor(image,type)
struct xvimage *image;
int type;

INPUT

image
    pointer to xvimage structure to be processed

type
    specifies which type of conversion to use

OUTPUT

image
    holds the result of the convert operation.

Return Value:
    1 on success, 0 on failure.

MODIFICATIONS

10-Mar-92 Scott Wilson Added DCOMPLEX support, fixed incorrect documentation, corrected improper malloc().

DESCRIPTION
lvctor performs simple mappings of COMPLEX data to REAL form. A COMPLEX image is transformed into a REAL image by one of four methods:

1   Assign the real part of the input to the output data.

2   Assign the imaginary part of the input to the output data.

3   Assign the magnitude of the input to the output data.

4   Assign the phase of the input to the output data.

The output is the same type as the input (regarding single or double floats).

Note that image is used for both the input xvimage structure and the resulting output xvimage structure. This is done to save space, but you must be careful not to overwrite important data.

SEE ALSO
vctor(1), intro(3), vipl(3), verror(3), vutils(3) lvrtoc(1),lvconvert(1)

RESTRICTIONS
Input images must be of type COMPLEX or DCOMPLEX.

AUTHOR
Scott Wilson

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