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  written  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.

OPTIONS

       -s N, --size=N
              Set the output thumbnail size to N x N  pixels.  You  can  use  MxN  to  specify  a
              rectangular  bounding  box.   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 replacing %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[Q=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.

       -r, --sharpen=none|mild|MASKFILE
              Images can look a little soft after shrinking.  This  option  lets  you  specify  a
              sharpening mask. Use "none" to disable sharpening, or "mild" to sharpen lightly, or
              give the filename of a custom mask file to use. The default is "mild".  The  built-
              in mild sharpen mask is:

               3 3 24 0
               -1 -1 -1
               -1 32 -1
               -1 -1 -1

       -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  available.  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.

       -c, --crop
              Crop  the  output  image  down.  The  image  is shrunk so as to completely fill the
              bounding box in both axies, then any excess is cropped off.

       -d, --delete
              Delete the output profile from the image. This can save a small amount of space.

       -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)