im_cp_desc, im_append_Hist - copy most of an image descriptor to
another image descriptor.
int im_cp_desc_array( IMAGE *out, IMAGE *in );
int im_cp_descv( IMAGE *out, IMAGE *in1, ... );
int im_cp_desc( IMAGE *out, IMAGE *in );
int im_append_Hist( IMAGE *out, IMAGE *in );
im_cp_desc_array(3) takes an output image and a NULL-terminated list of
input images, which must contain at least one input image.
It copies the fields describing the size, bands, type, resolution, and
coding from the first input image to the output image. History and meta
from all images are copied over. If two input images have the same meta
tag, the earlier one takes precedence.
im_cp_descv(3) is a varargs conveniece function for
im_cp_desc(3) is a convenience function which calls im_cp_descv(
image1, image2, NULL ).
im_append_Hist(3) appends the history attached to image2 to the end of
the history on image1. It is used by image processing functions which
take more than one image as input, and which need to make sure that all
the input history appears in the output.
The first line of image2 history is not copied, as this conventionally
holds background information which is not part of the file history.
The function returns 0 on success and -1 on error.
N. Dessipris - 11/04/1990
11 April 1990