resize-gd

annotate resize-gd.1 @ 10:6b8e8fcd6d4d

added error handling
author meillo@marmaro.de
date Sat, 14 Jun 2008 18:08:03 +0200
parents
children 7cc162bbff25
rev   line source
meillo@6 1 .TH RESIZE\-GD 1 "resize-gd\-0.1" "2008\-06\-14" "resize-gd"
meillo@6 2
meillo@6 3 .SH NAME
meillo@6 4 resize-gd \- resizes images using the gd library
meillo@6 5
meillo@6 6 .SH SYNOPSIS
meillo@6 7 .B resize-gd <size> PICTURES
meillo@6 8
meillo@6 9 .B resize-gd <width>x<height> PICTURES
meillo@6 10
meillo@6 11 .SH DESCRIPTION
meillo@6 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!
meillo@6 13 .PP
meillo@6 14 If <size> is given, aspect ratio of the images is preserved and only shrinking is done. Smaller images remain unmodified.
meillo@6 15 .PP
meillo@6 16 If <width>x<height> ist given, the images are resized to match that dimensions. The images probably get stretched and enlarged.
meillo@6 17 .PP
meillo@6 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).
meillo@6 19 Unsupported files get skipped.
meillo@6 20 .PP
meillo@6 21 This program is meant to be a small(er) alternative to the
meillo@6 22 .BR mogrify -resize
meillo@6 23 command of ImageMagick. Mainly because ImageMagick has lots of dependencies, while the GD-Library has less.
meillo@6 24
meillo@6 25 .SH OPTIONS
meillo@6 26 .TP
meillo@6 27 .B \-\-help
meillo@6 28 Show summary of options.
meillo@6 29 .TP
meillo@6 30 .B \-\-version
meillo@6 31 Show program name and version.
meillo@6 32
meillo@6 33 .SH EXAMPLES
meillo@6 34 Create some thumbnails, preserving aspect ratio:
meillo@6 35 .IP
meillo@6 36 mkdir thumbs
meillo@6 37
meillo@6 38 cp *.jpg *.png thumbs
meillo@6 39
meillo@6 40 resize-gd 150 thumbs/*
meillo@6 41
meillo@6 42 .PP
meillo@6 43 Make some pictures squared:
meillo@6 44 .IP
meillo@6 45 cp -r somepics/ somepics-squared
meillo@6 46
meillo@6 47 resize-gd 400x400 somepics-squared/*
meillo@6 48
meillo@6 49 .SH EXIT CODE
meillo@6 50 .TP
meillo@6 51 .B 1
meillo@6 52 Any other error
meillo@6 53 .TP
meillo@6 54 .B 2
meillo@6 55 The size (parameter 1) had no valid format. It has to be either <size> or <width>x<height>.
meillo@6 56
meillo@6 57 .SH BUGS
meillo@6 58 Please report any bug you find to the author.
meillo@6 59
meillo@6 60 .SH SEE ALSO
meillo@6 61 .BR mogrify (1),
meillo@6 62 .BR ImageMagick (1).
meillo@6 63
meillo@6 64 .SH AUTHOR
meillo@6 65 resize-gd and this man page were written by markus schnalke <meillo@marmaro.de>
meillo@6 66 .PP
meillo@6 67 Website: http://prog.marmaro.de/resize-gd