1VIPSTHUMBNAIL(1)            General Commands Manual           VIPSTHUMBNAIL(1)
2
3
4

NAME

6       vipsthumbnail - make thumbnails of image files
7

SYNOPSIS

9       vipsthumbnail [flags] imagefile1 imagefile2 ...
10

DESCRIPTION

12       vipsthumbnail(1) processes each imagefile in turn, shrinking each image
13       to fit within a 128 by 128 pixel square.  The shrunk image  is  written
14       to a new file named tn_imagefile.jpg.  This program is typically faster
15       and uses less memory than other image thumbnail programs.
16
17       For example:
18
19        $ vipsthumbnail fred.png jim.tif
20
21       will read image files fred.png and jim.tif and write thumbnails to  the
22       files tn_fred.jpg and tn_jim.jpg.
23
24        $ vipsthumbnail --size=64 -o thumbnails/%s.png fred.jpg
25
26       will  read  image  file fred.jpg and write a 64 x 64 pixel thumbnail to
27       the file thumbnails/fred.png.
28
29

OPTIONS

31       -s N, --size=N
32              Set the output thumbnail size to N x N pixels.
33
34              You can use "MxN" to specify a rectangular  bounding  box.   The
35              image  is  shrunk  so that it just fits within this area, images
36              which are smaller than this are expanded.
37
38              Use "xN" or "Mx" to just resize on one axis.
39
40              Append "<" to only resize if the input image is smaller than the
41              target,  append  ">" to only resize if the input image is larger
42              than the target.
43
44
45       -o FORMAT, --output=FORMAT
46              Set the output format string. The input filename  has  any  file
47              type  suffix  removed, then that value is substitued into FORMAT
48              replacing %s.  If FORMAT is a relative path,  the  name  of  the
49              input directory is prepended. In other words, any path in FORMAT
50              is relative to the directory of the current input file.
51
52              The default value is tn_%s.jpg meaning  JPEG  output,  with  tn_
53              prepended.   You   can  add  format  options  too,  for  example
54              tn_%s.jpg[Q=20] will write JPEG images with Q set to 20.
55
56
57       -e PROFILE, --eprofile=PROFILE
58              Export thumbnails with this ICC profile. Images are only colour-
59              transformed  if  there  is  both  an output and an input profile
60              available. The input profile can either be embedded in the input
61              image or supplied with the --iprofile option.
62
63
64       -i PROFILE, --iprofile=PROFILE
65              Import  images with this ICC profile, if no profile is embdedded
66              in the image.  Images are only colour-transformed  if  there  is
67              both  an  output and an input profile available. The output pro‐
68              file should be supplied with the --oprofile option.
69
70
71       -c, --crop
72              Crop the output image down. The image is shrunk so  as  to  com‐
73              pletely  fill  the bounding box in both axes, then any excess is
74              cropped off.
75
76
77       -d, --delete
78              Delete the output profile from the image. This can save a  small
79              amount of space.
80
81
82       -t, --rotate
83              Auto-rotate images using EXIF orientation tags.
84
85
86       -a, --linear
87              Shrink  images  in  linear  light colour space. This can be much
88              slower.
89
90

RETURN VALUE

92       returns 0 on success and non-zero on error. Error can mean one or  more
93       conversions failed.
94
95

SEE ALSO

97       vipsheader(1)
98
99
100
101                                  13 May 2010                 VIPSTHUMBNAIL(1)
Impressum