Mercurial > resize-gd

annotate resize-gd.1 @ 7:c0045d8d3ce2 0.1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
improved comment at begin of source; some cleanups
author meillo@marmaro.de
date Sat, 14 Jun 2008 12:33:33 +0200
parents e020f26c2c6a
children 7cc162bbff25
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
1 .TH RESIZE\-GD 1 "resize-gd\-0.1" "2008\-06\-14" "resize-gd"
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
2
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
3 .SH NAME
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
4 resize-gd \- resizes images using the gd library
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
5
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
6 .SH SYNOPSIS
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
7 .B resize-gd <size> PICTURES
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
8
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
9 .B resize-gd <width>x<height> PICTURES
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
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
18 Only JPEG and PNG files are supported. The filetype is detected by the filename suffix which has to be either `.jpg' or `.png' (in lowercase letters).
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
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
22 .BR mogrify -resize
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
23 command of ImageMagick. Mainly because ImageMagick has lots of dependencies, while the GD-Library has less.
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
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
40 resize-gd 150 thumbs/*
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
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
45 cp -r somepics/ somepics-squared
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
46
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
47 resize-gd 400x400 somepics-squared/*
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>.
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
56
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
57 .SH BUGS
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
58 Please report any bug you find to the author.
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
59
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
60 .SH SEE ALSO
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
61 .BR mogrify (1),
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
62 .BR ImageMagick (1).
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
63
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
64 .SH AUTHOR
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
65 resize-gd and this man page were written by markus schnalke <meillo@marmaro.de>
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
66 .PP
e020f26c2c6a added manpage
meillo@marmaro.de
parents:
diff changeset
67 Website: http://prog.marmaro.de/resize-gd