| .TH IM_TILE_CACHE 3 "19 May 2006" |
| .SH NAME |
| im_tile_cache \- cache an image, tilewise |
| .SH SYNOPSIS |
| #include <vips/vips.h> |
| |
| int |
| .br |
| im_tile_cache( IMAGE *in, IMAGE *out, |
| .br |
| int tile_width, int tile_height, int max_tiles ); |
| |
| .SH DESCRIPTION |
| .B tile_cache(3) |
| behaves rather like |
| .B im_copy(3) |
| between images |
| .B in |
| and |
| .B out, |
| except that it keeps a cache of computed pixels. This cache is made of up to |
| .B max_tiles |
| tiles (a value of -1 for |
| .B max |
| means any number of tiles), and each tile is of size |
| .B tile_width |
| by |
| .B tile_height |
| pixels. Each cache tile is made with a single call to |
| .B im_prepare(3). |
| |
| This is a lower-level operation than |
| .B im_cache(3) |
| since it does no subdivision. It is suitable for caching the output of |
| operations like |
| .B im_exr2vips(3) |
| on tiled images. |
| |
| .SH RETURN VALUE |
| The function returns 0 on success, and non-zero on error, setting |
| im_error(). |
| .SH SEE ALSO |
| im_prepare(3) |
| .SH AUTHOR |
| J Cupitt, 2006 |