Man Linux: Main Page and Category List

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
       LABPACK 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)