This document introduces the functions available in the VIPS image processing library. For detailed information on particular functions, refer to the UNIX on-line manual pages. Enter (for example):
example% man im_abs
|
for information on the function im_abs().
All the comand-line vips operations will print help text too. For example:
example% vips im_extract
usage: vips im_extract input output left top width height band where: input is of type "image" output is of type "image" left is of type "integer" top is of type "integer" width is of type "integer" height is of type "integer" band is of type "integer" extract area/band, from package "conversion" flags: (PIO function) (coordinate transformer) (area operation) (result can be cached) vips: error calling function im_run_command: too few arguments |
Once you have found a function you need to use, you can call it from a C program (see §2.1), you can call it from C++ or Python (see §1.1), you can call it from the nip2 ((see the nip Manual), or SIAM graphical user-interfaces, or you can run it from the UNIX command line with the vips program. For example:
john% vips im_vips2tiff cam.v t1.tif none
john% vips im_tiff2vips t1.tif t2.v.v 0 john% vips im_equal cam.v t2.v t3.v john% vips im_min t3.v 255 |
VIPS may have been set up at your site with a set of links which call the vips program for you. You may also be able to type:
john% im_vips2tiff cam.v t1.tif none
john% im_tiff2vips t1.tif t2.v.v 0 john% im_equal cam.v t2.v t3.v john% im_min t3.v |
There are a few VIPS programs which you cannot run with vips, either because their arguments are a very strange, or because they are complete mini-applications (like vips2dj). These programs are listed in table 4.1, see the man pages for full details.
|