resize-gd

view resize-gd.1 @ 15:c50716420346

new exit code (4) if all files failed in resizing
author meillo@marmaro.de
date Mon, 23 Jun 2008 21:03:05 +0200
parents 6f5c3a02e4d5
children
line source
1 .TH RESIZE\-GD 1 "resize\-gd\-0.2" "2008\-06\-15" "resize\-gd"
3 .SH NAME
4 resize\-gd \- resizes images using the gd library
6 .SH SYNOPSIS
7 .B resize\-gd <size> PICTURES
9 .B resize\-gd <width>x<height> PICTURES
11 .SH DESCRIPTION
12 The program resizes given images to a specific size. The files are modified, so copy the files before if you want to keep the original pictures!
13 .PP
14 If <size> is given, aspect ratio of the images is preserved and only shrinking is done. Smaller images remain unmodified.
15 .PP
16 If <width>x<height> ist given, the images are resized to match that dimensions. The images probably get stretched and enlarged.
17 .PP
18 Only JPEG and PNG files are supported. The filetype is detected by the filename suffix which has to be `.jpg', `.jpeg' or `.png'.
19 Unsupported files get skipped.
20 .PP
21 This program is meant to be a small(er) alternative to the
22 .BR mogrify \-resize
23 command of ImageMagick. Mainly because ImageMagick has lots of dependencies, while the GD\-Library has less.
25 .SH OPTIONS
26 .TP
27 .B \-\-help
28 Show summary of options.
29 .TP
30 .B \-\-version
31 Show program name and version.
33 .SH EXAMPLES
34 Create some thumbnails, preserving aspect ratio:
35 .IP
36 mkdir thumbs
38 cp *.jpg *.png thumbs
40 resize\-gd 150 thumbs/*
42 .PP
43 Make some pictures squared:
44 .IP
45 cp \-r somepics/ somepics\-squared
47 resize\-gd 400x400 somepics\-squared/*
49 .SH EXIT CODE
50 .TP
51 .B 1
52 Any other error
53 .TP
54 .B 2
55 The size (parameter 1) had no valid format. It has to be either <size> or <width>x<height>.
56 .TP
57 .B 3
58 Not enough memory available to resize the image.
59 .TP
60 .B 4
61 None of the given files was resized successful (or was already small enough).
63 .SH BUGS
64 Please report any bug you find to the author.
66 .SH SEE ALSO
67 .BR mogrify (1),
68 .BR ImageMagick (1).
70 .SH AUTHOR
71 resize\-gd and this man page were written by markus schnalke <meillo@marmaro.de>
72 .PP
73 Website: http://prog.marmaro.de/resize\-gd