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

       -f FORMAT, --format=FORMAT
              Set the output format string. The input filename has any file type suffix  removed,
              then  that  value  is  substitued into FORMAT replacing %s. If FORMAT is a relative
              path, the name of the input directory is prepended. In other  words,  any  path  in
              FORMAT is relative to the directory of the current input file.

              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. Error can mean one or more conversions failed.

SEE ALSO

       vipsheader(1)

                                           13 May 2010                           VIPSTHUMBNAIL(1)