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       On Unix machines,  vips  will  create  temporary  files  in  "/tmp"  by
30       default.  Use  the environment variable TMPDIR to change this location.
31       On Windows, vips uses GetTempPath() to pick a location, see the MS doc‐
32       umentation.
33
34       Use    the    --vips-disc-threshold   command-line   switch,   or   the
35       IM_DISC_THRESHOLD environment variable, to make vipsthumbnail use  mem‐
36       ory rather than temporary files.
37
38

OPTIONS

40       -s N, --size=N
41              Set  the  output  thumbnail  size  to N x N pixels. The image is
42              shrunk so that it just fits within this area, Images  which  are
43              smaller than this are expanded.
44
45
46       -o FORMAT, --output=FORMAT
47              Set  the  output  format string. The input filename has any file
48              type suffix removed, then that value is substitued  into  FORMAT
49              replacing  %s.  The default value is tn_%s.jpg meaning JPEG out‐
50              put, with tn_ prepended. You can add  format  options  too,  for
51              example tn_%s.jpg:20 will write JPEG images with Q set to 20.
52
53
54       -p I, --interpolator=I
55              Resample  with interpolator I.  Use vips --list classes to see a
56              list of valid interpolators. The default is bilinear.
57
58
59       -n, --nosharpen
60              By default, vipsthumbnail(1) will sharpen thumbnails slightly to
61              make them look more pleasing. This option disables this sharpen‐
62              ing.
63
64
65       -e PROFILE, --eprofile=PROFILE
66              Export thumbnails with this ICC profile. Images are only colour-
67              transformed  if  there  is  both  an output and an input profile
68              available. The input profile can either be embedded in the input
69              image or supplied with the --iprofile option.
70
71
72       -i PROFILE, --iprofile=PROFILE
73              Import  images with this ICC profile, if no profile is embdedded
74              in the image.  Images are only colour-transformed  if  there  is
75              both  an  output and an input profile available. The output pro‐
76              file should be supplied with the --oprofile option.
77
78
79       -l, --nodelete
80              Don't delete the profile from the output image. Since all output
81              images  will  generally  have the same profile, vipsthumbnail(1)
82              will usually delete it. This option leaves  the  profile  inside
83              the image.
84
85
86       -v, --verbose
87              vipsthumbnail(1)  normally runs silently, except for warning and
88              error messages. This option makes it print a list of the  opera‐
89              tions it performs on each image.
90
91

RETURN VALUE

93       returns 0 on success and non-zero on error.
94

SEE ALSO

96       header(1)
97
98
99
100                                  13 May 2010                 VIPSTHUMBNAIL(1)
Impressum