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

NAME

6       im_close - close an image descriptor
7

SYNOPSIS

9       #include <vips/vips.h>
10
11       int im_close(image)
12       IMAGE *image;
13

DESCRIPTION

15       im_close(3)  frees  all the resources attached to the image descriptor.
16       This may involve closing  files,  freeing  memory  buffers,  triggering
17       close  callback  lists, unmapping files, freeing regions, and so on. If
18       all this succeeds, then the function returns zero.  If  something  goes
19       wrong,  the  function  returns  non-zero  and  sets  im_errormsg(3). If
20       im_close(3) fails, the image descriptor is left in an undefined state.
21
22       In the case that the image descriptor corresponds to a file  opened  by
23       im_openout(3)  that  has  been  written to, the function sets an output
24       description file as follows:  If the output image  filename  is  termi‐
25       nated  with  ".v",   the  string  held  by the Hist member of the image
26       descriptor is copied to a corresponding file ending with ".desc" in the
27       same  directory.   In all other cases, an output .desc file is not cre‐
28       ated.
29
30       If a NULL pointer is passed to  im_close(3),  it  returns  successfully
31       immediately.
32

RETURN VALUE

34       The function returns 0 on success and -1 on error.
35

37       N. Dessipris, K. Martinez, J. Cupitt
38

SEE ALSO

40       im_mmapin(3),  im_openin(3),  im_openout(3),  im_setbuf(3), im_open(3),
41       im_incheck(3), im_pincheck(3).
42

AUTHOR

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