ldfilconv(3)

LIBRARY ROUTINE
ldfilconv - 1D Filter Coefficient Conversion

LIBRARY CALL
#include "vinclude.h"
int ldfilconv ( image, out_option, arith_type, procdir )
int out_option, arith_type, procdir;
struct xvimage *image;

INPUT

image
    pointer to VIFF structure containing image data to be processed.

arith_type
    type of arithmetic to be used on complex data. 0 specifies scalar arithmetic and 1 specifies complex arithmetic.

out_option
    specifies the output file to be generated. 0 specifies lattice to transversal coefficient conversion, and 1 specifies transversal to lattice conversion.

procdir
    process direction: 0 indicated vector oriented processing, 1 indicates band oriented processing.

OUTPUT

image
    pointer to VIFF structure containing image data after processing.

Return Value:
    1 on success, 0 on failure.

MODIFICATIONS

Mon Jan 27 09:50:26 MST 1992 Worley
    changed declarations of partran and tranpar in calling routines to static.

DESCRIPTION
dfilconv 1D Filter Coefficient Conversion. Converts 1D filter coefficients from the transversal (tapped-delay) filter realization to the lattice realization and vice versa. It can operate on Real and Complex data. If complex data, the user has the option of using complex arithmetic or scalar arithmetic (treat the real number and imaginary number independently).

NOTE: complex data is expected to be in rectangular (not polar) form.

dfilconv does not work on explicit location data and will return an error when such a file is encountered. No output file will be created. dfilconv works only on VFF_TYP_FLOAT or VFF_TYP_COMPLEX data files.

Input/Output Files

The input file must be of type VFF_TYP_FLOAT or VFF_TYP_COMPLEX. The output file returned will be of size specified by the user. If the data is of type VFF_TYP_COMPLEX and complex aithmetic is selected then the output file will be of type VFF_TYP_FLOAT. *********************************************************************

Process direction

Data can be processed with either band or vector orientation (-d option). The default data processing direction is in the vector direction (-d = 0). pixel location. The direction of processing can be changed so that each band is processed as a signal (instead of each vector being a signal) by setting the -d option to 1.

SEE ALSO
dfilconv(1), intro(3), vipl(3), verror(3), vutils(3)

RESTRICTIONS
works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT.

ldfilconv does not work on explicit location data and will return an error when such a data file is encountered.

AUTHOR
Ramiro Jordan

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