| .TH IM_GRID 3 "4 August 2005" |
| .SH NAME |
| im_grid \- split a vertical image into a grid of smaller images |
| .SH SYNOPSIS |
| .B #include <vips/vips.h> |
| |
| int |
| .br |
| im_grid( IMAGE *in, IMAGE *out, |
| .br |
| int tile_height, int across, int down ) |
| .SH DESCRIPTION |
| .B im_grid(3) |
| slices image |
| .B in |
| into a set of tiles, each the same width as |
| .B in |
| and of height |
| .B tile_height |
| and rearranges the tiles into a grid with |
| .B across |
| tiles across and |
| .B down |
| tiles down. |
| |
| It is useful for loading volumetric images (for example, CT or PET scans) |
| where more than 2 dimensions need to be displayed. |
| |
| The current implementation is optimised for the case where image |
| .B in |
| is thin and tall and |
| .B across |
| and |
| .B down |
| are large. |
| |
| .SH RETURN VALUE |
| The function returns 0 on success and -1 on error. |
| .SH SEE ALSO |
| im_extract_area(3), im_zoom(3) |
| .SH COPYRIGHT |
| Imperial College 2005 |
