resize-gd

annotate 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
rev   line source
meillo@14 1 .TH RESIZE\-GD 1 "resize\-gd\-0.2" "2008\-06\-15" "resize\-gd"
meillo@6 2
meillo@6 3 .SH NAME
meillo@13 4 resize\-gd \- resizes images using the gd library
meillo@6 5
meillo@6 6 .SH SYNOPSIS
meillo@13 7 .B resize\-gd <size> PICTURES
meillo@6 8
meillo@13 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@14 18 Only JPEG and PNG files are supported. The filetype is detected by the filename suffix which has to be `.jpg', `.jpeg' or `.png'.
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@13 22 .BR mogrify \-resize
meillo@13 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@13 40 resize\-gd 150 thumbs/*
meillo@6 41
meillo@6 42 .PP
meillo@6 43 Make some pictures squared:
meillo@6 44 .IP
meillo@13 45 cp \-r somepics/ somepics\-squared
meillo@6 46
meillo@13 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@11 56 .TP
meillo@11 57 .B 3
meillo@11 58 Not enough memory available to resize the image.
meillo@15 59 .TP
meillo@15 60 .B 4
meillo@15 61 None of the given files was resized successful (or was already small enough).
meillo@6 62
meillo@6 63 .SH BUGS
meillo@6 64 Please report any bug you find to the author.
meillo@6 65
meillo@6 66 .SH SEE ALSO
meillo@6 67 .BR mogrify (1),
meillo@6 68 .BR ImageMagick (1).
meillo@6 69
meillo@6 70 .SH AUTHOR
meillo@13 71 resize\-gd and this man page were written by markus schnalke <meillo@marmaro.de>
meillo@6 72 .PP
meillo@13 73 Website: http://prog.marmaro.de/resize\-gd