Method

VipsImageshrink

Declaration [src]

int
vips_shrink (
  VipsImage* in,
  VipsImage** out,
  double hshrink,
  double vshrink,
  ...
)

Description [src]

Shrink in by a pair of factors with a simple box filter.

For non-integer factors, vips_shrink() will first shrink by the integer part with a box filter, then use vips_reduce() to shrink by the remaining fractional part.

This is a very low-level operation: see vips_resize() for a more convenient way to resize images.

This operation does not change xres or yres. The image resolution needs to be updated by the application.

::: tip “Optional arguments” * ceil: gboolean, round-up output dimensions

::: seealso vips_resize(), vips_reduce().

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.
hshrink double
 

Horizontal shrink.

vshrink double
 

Vertical shrink.

... none
 

NULL-terminated list of optional named arguments.

Return value

Returns: int
 

0 on success, -1 on error.