Method

VipsImagethumbnail_image

Declaration [src]

int
vips_thumbnail_image (
  VipsImage* in,
  VipsImage** out,
  int width,
  ...
)

Description [src]

Optional arguments:

  • height: %gint, target height in pixels
  • size: VipsSize, upsize, downsize, both or force
  • no_rotate: %gboolean, don’t rotate upright using orientation tag
  • crop: VipsInteresting, shrink and crop to fill target
  • linear: %gboolean, perform shrink in linear light
  • import_profile: %gchararray, fallback import ICC profile
  • export_profile: %gchararray, export ICC profile
  • intent: VipsIntent, rendering intent
  • fail_on: VipsFailOn, load error types to fail on

Exactly as vips_thumbnail(), but read from an existing image.

This operation is not able to exploit shrink-on-load features of image load libraries, so it can be much slower than vips_thumbnail() and produce poorer quality output. Only use it if you really have to.

See also: vips_thumbnail().

This method is not directly available to language bindings.

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
 

Target width in pixels.

...
 

NULL-terminated list of optional named arguments.

Return value

Returns: int
 

0 on success, -1 on error.