img_crop()

Synopsis:

#include <img/img.h>

int img_crop( const img_t    *src, 
              img_t          *dst, 
              const unsigned  x, 
              const unsigned  y );

Since:

BlackBerry 10.0.0

Arguments:

src: The address of the source img_t structure to crop.
dst: The address of the destination img_t structure, which requires the width (IMG_W) and height (IMG_H) to be specified at a minimum.
x: The horizontal coordinate in the source image to begin the crop operation.
y: The vertical coordinate in the source image to begin the crop operation.

Library:

libimg

Use the -l img option to qcc to link against this library.

Description:

This function crops a source image at a given set of source coordinates x, y to the dimensions specified by the destination image.

Returns:

IMG_ERR_OK

Success

IMG_ERR_PARM

source image width, height, and/or format not set.
destination image width, and/or height not set.
destination image larger than source image.
crop co-ordinates plus size of destination image exceed source image bounds.

IMG_ERR_NOSUPPORT

Destination image format not supported

IMG_ERR_MEM

Memory allocation failure

Classification:

Image library

Safety:
Interrupt handler	No
Signal handler	No
Thread	No