Mercurial > resize-gd

annotate resize-gd.1 @ 17:159402d54c29 default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
replaced atoi with strtol, which is more secure
author meillo@marmaro.de
date Tue, 22 Jul 2008 10:07:27 +0200
parents c50716420346
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
14
6f5c3a02e4d5 filename suffix is now detected in lower or upper case letters
meillo@marmaro.de
parents: 13
diff changeset
1 .TH RESIZE\-GD 1 "resize\-gd\-0.2" "2008\-06\-15" "resize\-gd"
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
2
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
3 .SH NAME
13
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
4 resize\-gd \- resizes images using the gd library
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
5
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
6 .SH SYNOPSIS
13
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
7 .B resize\-gd <size> PICTURES
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
8
13
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
9 .B resize\-gd <width>x<height> PICTURES
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
10
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
11 .SH DESCRIPTION
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
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!
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
13 .PP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
14 If <size> is given, aspect ratio of the images is preserved and only shrinking is done. Smaller images remain unmodified.
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
15 .PP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
16 If <width>x<height> ist given, the images are resized to match that dimensions. The images probably get stretched and enlarged.
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
17 .PP
14
6f5c3a02e4d5 filename suffix is now detected in lower or upper case letters
meillo@marmaro.de
parents: 13
diff changeset
18 Only JPEG and PNG files are supported. The filetype is detected by the filename suffix which has to be `.jpg', `.jpeg' or `.png'.
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
19 Unsupported files get skipped.
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
20 .PP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
21 This program is meant to be a small(er) alternative to the
13
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
22 .BR mogrify \-resize
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
23 command of ImageMagick. Mainly because ImageMagick has lots of dependencies, while the GD\-Library has less.
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
24
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
25 .SH OPTIONS
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
26 .TP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
27 .B \-\-help
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
28 Show summary of options.
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
29 .TP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
30 .B \-\-version
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
31 Show program name and version.
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
32
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
33 .SH EXAMPLES
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
34 Create some thumbnails, preserving aspect ratio:
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
35 .IP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
36 mkdir thumbs
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
37
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
38 cp *.jpg *.png thumbs
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
39
13
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
40 resize\-gd 150 thumbs/*
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
41
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
42 .PP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
43 Make some pictures squared:
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
44 .IP
13
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
45 cp \-r somepics/ somepics\-squared
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
46
13
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
47 resize\-gd 400x400 somepics\-squared/*
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
48
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
49 .SH EXIT CODE
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
50 .TP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
51 .B 1
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
52 Any other error
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
53 .TP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
54 .B 2
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
55 The size (parameter 1) had no valid format. It has to be either <size> or <width>x<height>.
11
7cc162bbff25 new error code
meillo@marmaro.de
parents: 6
diff changeset
56 .TP
7cc162bbff25 new error code
meillo@marmaro.de
parents: 6
diff changeset
57 .B 3
7cc162bbff25 new error code
meillo@marmaro.de
parents: 6
diff changeset
58 Not enough memory available to resize the image.
15
c50716420346 new exit code (4) if all files failed in resizing
meillo@marmaro.de
parents: 14
diff changeset
59 .TP
c50716420346 new exit code (4) if all files failed in resizing
meillo@marmaro.de
parents: 14
diff changeset
60 .B 4
c50716420346 new exit code (4) if all files failed in resizing
meillo@marmaro.de
parents: 14
diff changeset
61 None of the given files was resized successful (or was already small enough).
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
62
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
63 .SH BUGS
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
64 Please report any bug you find to the author.
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
65
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
66 .SH SEE ALSO
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
67 .BR mogrify (1),
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
68 .BR ImageMagick (1).
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
69
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
70 .SH AUTHOR
13
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
71 resize\-gd and this man page were written by markus schnalke <meillo@marmaro.de>
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
72 .PP
13
c4834b4f4b54 added backslashes to dashes in manpage
meillo@marmaro.de
parents: 11
diff changeset
73 Website: http://prog.marmaro.de/resize\-gd