vips(1) [debian man page]

VIPS(1) 						      General Commands Manual							   VIPS(1)

NAME

       vips - run vips operations from the command line

SYNOPSIS

       vips [options] [command] [command-options] [command-args]

DESCRIPTION

       vips(1)	is  the  VIPS  universal  main program. You can use it to run any VIPS operation from the command line, to query the VIPS function
       database, and to maintain parts of the VIPS library.

       To run a VIPS function, the first argument should be the name of the function and following arguments should be	the  function  parameters.
       For example:

	 $ vips im_invert lena.v lena2.v

OPTIONS

       -p PLUGIN, --plugin=PLUGIN
	      Load PLUGIN. Note that plugins in $VIPSHOME/lib are loaded automatically.

       -v, --version
	      Show VIPS version.

COMMANDS

       list PACKAGE
	      List operations defined in PACKAGE. PACKAGE can also be "classes", "packages" or "all".

       cpph PACKAGE
	      Print C++ header for PACKAGE. PACKAGE can also be a function name, or "all".

       cppc PACKAGE
	      Print C++ binding for PACKAGE. PACKAGE can also be a function name, or "all".

       operation-name operation-arguments
	      Execute  a named operation, for example im_invert, or add. Names prefixed with "im_" are called via the vips7 interface, names with-
	      out the prefix use the new vips8 interface.

EXAMPLES

       Run a vips7 operation. The vips7 interface does not suport optional arguments.

	 $ vips im_invert lena.v lena2.v

       Run a vips8 operation. Operation options must follow the operation name.

	 $ vips add --imtest=option.jpg lena.v lena2.v out.v

       Get a "usage" message for an operation

	 $ vips add
	 VipsAdd (add), add two images
	   add left right out
	 where:
	   left :: VipsImage (input)
	   right :: VipsImage (input)
	   out :: VipsImage (output)
	 optional arguments:
	   imtest :: VipsImage (input)
	   booltest :: gboolean (input)

RETURN VALUE

       returns 0 on success and non-zero on error.

SEE ALSO

       header(1)

COPYRIGHT

       The National Gallery and Birkbeck College, 1989-1996.

								   30 June 1993 							   VIPS(1)

VIPSTHUMBNAIL(1)					      General Commands Manual						  VIPSTHUMBNAIL(1)

NAME

       vipsthumbnail - make thumbnails of image files

SYNOPSIS

       vipsthumbnail [flags] imagefile1 imagefile2 ...

DESCRIPTION

       vipsthumbnail(1) processes each imagefile in turn, shrinking each image to fit within a 128 by 128 pixel square.  The shrunk image is writ-
       ten to a new file named tn_imagefile.jpg.  This program is typically faster and uses less memory than other image thumbnail programs.

       For example:

	$ vipsthumbnail fred.png jim.tif

       will read image files fred.png and jim.tif and write thumbnails to the files tn_fred.jpg and tn_jim.jpg.

	$ vipsthumbnail --size=64 -o thumbnails/%s.png fred.jpg

       will read image file fred.jpg and write a 64 x 64 pixel thumbnail to the file thumbnails/fred.png.

       On Unix machines, vips will create temporary files in "/tmp" by default. Use the environment variable TMPDIR to change  this  location.	On
       Windows, vips uses GetTempPath() to pick a location, see the MS documentation.

       Use  the  --vips-disc-threshold command-line switch, or the IM_DISC_THRESHOLD environment variable, to make vipsthumbnail use memory rather
       than temporary files.

OPTIONS

       -s N, --size=N
	      Set the output thumbnail size to N x N pixels. The image is shrunk so that it just fits within this area, Images which  are  smaller
	      than this are expanded.

       -o FORMAT, --output=FORMAT
	      Set the output format string. The input filename has any file type suffix removed, then that value is substitued into FORMAT replac-
	      ing %s.  The default value is tn_%s.jpg meaning JPEG output, with tn_ prepended.	You  can  add  format  options	too,  for  example
	      tn_%s.jpg:20 will write JPEG images with Q set to 20.

       -p I, --interpolator=I
	      Resample with interpolator I.  Use vips --list classes to see a list of valid interpolators. The default is bilinear.

       -n, --nosharpen
	      By default, vipsthumbnail(1) will sharpen thumbnails slightly to make them look more pleasing. This option disables this sharpening.

       -e PROFILE, --eprofile=PROFILE
	      Export  thumbnails  with this ICC profile. Images are only colour-transformed if there is both an output and an input profile avail-
	      able. The input profile can either be embedded in the input image or supplied with the --iprofile option.

       -i PROFILE, --iprofile=PROFILE
	      Import images with this ICC profile, if no profile is embdedded in the image.  Images are only colour-transformed if there  is  both
	      an output and an input profile available. The output profile should be supplied with the --oprofile option.

       -l, --nodelete
	      Don't  delete the profile from the output image. Since all output images will generally have the same profile, vipsthumbnail(1) will
	      usually delete it. This option leaves the profile inside the image.

       -v, --verbose
	      vipsthumbnail(1) normally runs silently, except for warning and error messages. This option makes it print a list of the	operations
	      it performs on each image.

RETURN VALUE

       returns 0 on success and non-zero on error.

SEE ALSO

       header(1)

								    13 May 2010 						  VIPSTHUMBNAIL(1)