---
name: "im_subsample"
section: "3"
platform: "linux"
package: "libvips-dev"
version: "7.20.7-1+b3"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/im_subsample"
---

# im\_subsample(3)

subsample image by integer factor

## NAME

im\_subsample - subsample image by integer factor

## SYNOPSIS

\#include \<vips/vips.h\>

int im\_subsample(in, out, xsub, ysub)\
 IMAGE \*in, \*out;\
 int xsub, ysub;

## DESCRIPTION

**im\_subsample()** sub-samples image in by an x and y integer factor. It is much faster than im\_shrink(), especially for large partial images.

It works for any image type.

## RETURN VALUE

The function returns 0 on success and -1 on error.

## SEE ALSO

[im\_shrink(3)](/im_shrink/3.md), [im\_similarity(3)](/im_similarity/3.md), [im\_zoom(3)](/im_zoom/3.md)

## COPYRIGHT

1989-1996 The National Gallery and Birkbeck College