Resample operations [src]

Resample operations

These operations build on each other in a set of layers.

First, vips_affine() applies an affine transform to an image. This is any sort of 2D transform which preserves straight lines; so any combination of stretch, sheer, rotate and translate. You supply an interpolator for it to use to generate pixels, see vips_interpolate_new(). It will not produce good results for very large shrinks: you’ll see aliasing.

vips_reduce() is like vips_affine(), but it can only shrink images, it can’t enlarge, rotate, or skew. It’s very fast and uses an adaptive kernel for interpolation.

vips_shrink() is a fast block shrinker. It can quickly reduce images by large integer factors. It will give poor results for small size reductions: again, you’ll see aliasing.

Next, vips_resize() specialises in the common task of image reduce and enlarge. It strings together combinations of vips_shrink(), vips_reduce(), vips_affine() and others to implement a general, high-quality image resizer.

Finally, vips_thumbnail() combines load and resize in one operation, and adds colour management and correct handling of alpha transparency. Because load and resize happen together, it can exploit tricks like JPEG and TIFF shrink-on-load, giving a (potentially) huge speedup. vips_thumbnail_image() is only there for emergencies, don’t use it unless you really have to.

As a separate thing, vips_mapim() can apply arbitrary 2D image transforms to an image.

Classes

Callbacks

Functions

Constants

Enumerations