ldcpad(3)

LIBRARY ROUTINE
ldcpad - 1D Constant Pad.

LIBRARY CALL
#include "vinclude.h"
int ldcpad ( image, length, offset, rc,ic,procdir )
int length, offset,procdir;
float rc,ic;
struct xvimage *image;

INPUT

image
    pointer to image to be padded.

length
    desired length of the data set.

offset
    desired offset of existing data into padded data.

rc  real part of padding constant.

ic  imaginary part of padding constant

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

OUTPUT

image
    pointer to image after padding.

Return value:
    0 on normal return, 1 if an error occured.

MODIFICATIONS

Jeremy Worley Mon Feb 17 23:26:34 MST 1992
    return type on ldcpad changed from implicit int to explicit int.

DESCRIPTION
performs a constant value padding of a 1D data sequence. The length of the new signal ensemble must be greater or equal to the length of the original signals plus the offset. The constant value can be any real or complex number. Complex data is assumed to be in rectangular form. If the data type is real, then the imaginary constant value is ignored.

Data can be processed with either band or vector orientation. The default data processing direction is in the vector direction. This means that data stored in multiband format will be processed as a set of data sequences, where each sequence corresponds to a pixel location, and the points of each sequence are defined by the bands corresponding to that 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
dcpad(1), intro(3), vipl(3), verror(3), vutils(3)

RESTRICTIONS
dcpad supports signal ensembles of type float or complex only.

AUTHOR
Jeremy Worley, Donna Koechner, Ramiro Jordan

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