49 lines
1.5 KiB
Groff
49 lines
1.5 KiB
Groff
.TH IM_CP_DESC 3 "11 April 1990"
|
|
.SH NAME
|
|
im_cp_desc, im_append_Hist \- copy most of an image descriptor to another
|
|
image descriptor.
|
|
.SH SYNOPSIS
|
|
.B #include <vips/vips.h>
|
|
|
|
int im_cp_desc_array( IMAGE *out, IMAGE *in[] );
|
|
|
|
int im_cp_descv( IMAGE *out, IMAGE *in1, ... );
|
|
|
|
.B int im_cp_desc( IMAGE *out, IMAGE *in );
|
|
|
|
.B int im_append_Hist( IMAGE *out, IMAGE *in );
|
|
|
|
.SH DESCRIPTION
|
|
.B 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.
|
|
|
|
.B im_cp_descv(3)
|
|
is a varargs conveniece function for
|
|
.B im_cp_desc_array(3).
|
|
|
|
.B im_cp_desc(3)
|
|
is a convenience function which calls
|
|
.B im_cp_descv( image1, image2, NULL ).
|
|
|
|
.B 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.
|
|
|
|
.SH RETURN VALUE
|
|
The function returns 0 on success and -1 on error.
|
|
.SH COPYRIGHT
|
|
.br
|
|
N. Dessipris
|
|
.SH AUTHOR
|
|
N. Dessipris \- 11/04/1990
|