im_tile_cache3
Cache an image, tilewise
Usage
#include <vips/vips.h>
int
im_tile_cache( IMAGE *in, IMAGE *out,
int tile_width, int tile_height, int max_tiles );
Overview
tile_cache(3) behaves rather like im_copy(3) between images in and out, except that it keeps a cache of computed pixels. This cache is made of up to max_tiles tiles (a value of -1 for max means any number of tiles), and each tile is of size tile_width by tile_height pixels. Each cache tile is made with a single call to im_prepare(3).
This is a lower-level operation than im_cache(3) since it does no subdivision. It is suitable for caching the output of operations like im_exr2vips(3) on tiled images.
Return value
The function returns 0 on success, and non-zero on error, setting im_error().
Releases
Unchanged in 2 releases since Debian 5.0 (Lenny).