manpagez: man pages & more
man im_extract(3)
Home | html | info | man
im_extract(3)                                                    im_extract(3)




NAME

       im_extract_areabands,  im_extract_bands,  im_extract_area  -  extract a
       portion of an image


SYNOPSIS

       #include <vips/vips.h>

       int im_extract_areabands( IMAGE *in, IMAGE *out,
         int left, int top, int width, int height, int band, int nbands )

       int im_extract_area( IMAGE *in, IMAGE *out,
         int left, int top, int width, int height )

       int im_extract_bands( IMAGE *in, IMAGE *out,
         int chsel, int nbands )



DESCRIPTION

       im_extract_areabands(3) extracts the rectangular portion of  the  image
       defined  by  left,  top,  width,  and height of image in and writes the
       result to image out.  The area must lie entirely within in  the  image.
       Selects the set of nbands bands starting at band number band (numbering
       bands from zero).

       Works for any size image, any number of bands, any type. Works for LAB-
       PACK coded images too! But disallows band extraction in this case.

       im_extract_area(3)  is  a  convenience  function which extracts an area
       from an image, leaving the bands the same.

       im_extract_bands(3) takes nbands out of an image,  starting  from  band
       band.   So,  for  example, nbands == 2, bands == 1 will form a two band
       image from an RGB image, where the two bands are the G and the B bands.



RETURN VALUE

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


SEE ALSO

       im_insert(3),       im_lrjoin(3),      im_lrmerge(3),      im_stats(3),
       im_region_region(3).


COPYRIGHT

       J. Cupitt,


AUTHOR

       J. Cupitt - 11/04/1990



                                 11 April 1990                   im_extract(3)

im_extract 7.14.5 - Generated Sun Sep 7 09:09:52 CDT 2008
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.