lvexpand(3)

LIBRARY ROUTINE
lvexpand - Expand an image by pixel replication

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

INPUT

image
    pointer to image structure to be expanded

scale
    scale factor by which to expand the image (integer), must be postitive and non-zero

OUTPUT

image
    points to the image structure that has been processed. The output data type is the same as the input data type.

Return Value:
    1 on success, 0 on failure

MODIFICATIONS
Scott Wilson - Added multiband support 20-Sep-90

DESCRIPTION
lvexpand expands the size of the image pointer to by image by an integer factor by replicating pixels in blocks.

The scale factor must be a positive, non-zero integer.

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
vexpand(1), intro(3), vipl(3), verror(3), vutils(3) lvshrink(1), lvresize(1)

RESTRICTIONS
lvexpand does not work on BIT or COMPLEX data types. lvexpand does not work on explicit location data.

AUTHOR
Scott Wilson

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