46 lines
932 B
Groff
46 lines
932 B
Groff
|
.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
|