1IM_CP_DESC(3)              Library Functions Manual              IM_CP_DESC(3)
2
3
4

NAME

6       im_cp_desc,  im_append_Hist  -  copy  most  of  an  image descriptor to
7       another image descriptor.
8

SYNOPSIS

10       #include <vips/vips.h>
11
12       int im_cp_desc(image1, image2)
13       IMAGE *image1, *image2;
14
15       int im_append_desc(image1, image2)
16       IMAGE *image1, *image2;
17
18

DESCRIPTION

20       im_cp_desc(3) copies the fields describing the size, bands, type, reso‐
21       lution,  history, and coding from image2 to image1. No other fields are
22       copied.
23
24       This function is primarily used in applications where  a  copy  of  the
25       details of an image are necessary for a newly created image.  Called by
26       most im_functions. Returns  an  error  if  an  uninitialised  IMAGE  is
27       copied.
28
29       im_append_Hist(3)  appends the history attached to image2 to the end of
30       the history on image1. It is used by image processing  functions  which
31       take more than one image as input, and which need to make sure that all
32       the input history appears in the output.
33
34       The first line of image2 history is not copied, as this  conventionally
35       holds background information which is not part of the file history.
36
37

RETURN VALUE

39       The function returns 0 on success and -1 on error.
40

42       N. Dessipris
43

AUTHOR

45       N. Dessipris - 11/04/1990
46
47
48
49                                 11 April 1990                   IM_CP_DESC(3)
Impressum