Method

VipsImagesmartcrop

Declaration [src]

int
vips_smartcrop (
  VipsImage* in,
  VipsImage** out,
  int width,
  int height,
  ...
)

Description [src]

Crop an image down to a specified width and height by removing boring parts.

Use interesting to pick the method vips uses to decide which bits of the image should be kept.

You can test xoffset / yoffset on out to find the location of the crop within the input image.

::: tip “Optional arguments” * interesting: VipsInteresting to use to find interesting areas (default: VipsInteresting) * premultiplied: gboolean, input image already has premultiplied alpha * attention_x: gint, output, horizontal position of attention centre when using attention based cropping * attention_y: gint, output, vertical position of attention centre when using attention based cropping

::: seealso vips_extract_area().

Parameters

out VipsImage
 

Output image.

 The argument will be set by the function.
 The instance takes ownership of the data, and is responsible for freeing it.
width int
 

Width of area to extract.

height int
 

Height of area to extract.

... none
 

NULL-terminated list of optional named arguments.

Return value

Returns: int
 

0 on success, -1 on error.